Quando o utilitário de conversão de indicadores é executado como um servidor, ele pode ser utilizado de duas formas.
A primeira é no caso de desejar manter o IBM®Cognos®Series 7 em execução. Os usuários acessam
os indicadores por meio do PowerPlay®Enterprise Server e depois clicam em um botão personalizado
que os redireciona para um indicador do IBM Cognos Business Intelligence.
A segunda é no caso de desejar aposentar o ambiente IBM Cognos Series 7. Dessa maneira, quando os usuários acessarem um indicador, eles serão automaticamente redirecionados para um indicador do IBM Cognos BI.
Para usar o utilitário de uma dessas duas formas, primeiro é necessário configurar o servidor criando um arquivo de configuração com o nome do servidor, o número da porta que será utilizada, o nome de um arquivo de log e o idioma que será utilizado para mensagens de log. Os valores padrão são localhost para o nome do servidor, número de porta 7777, bookmarkcgi.log para o arquivo de log e inglês para o idioma das mensagens do log.
Para fornecer acesso ao servidor, um arquivo bookmarkcgi.exe foi incluído no diretório
local_c10\cgi-bin. Bookmarkcgi.exe pode ser acessado usando o mesmo URL do gateway que o
aplicativo IBM Cognos BI, exceto com o cgi alterado para bookmarkcgi.exe em vez de cognos.cgi. Por exemplo, se o IBM Cognos BI for acessado no site http://nome_do_servidor/ibmcognos/cgi-bin/ cognos.cgi, o indicador cgi será acessado em http://nome_do_servidor/ibmcognos/cgi-bin/
Observação: Se mais de um ambiente IBM Cognos Series 7 tiver sido migrado para o IBM Cognos
BI, recomendamos a utilização de um arquivo bookmarkcgi distinto para cada ambiente. Isso permite que um URL CGI de indicador seja adicionado à lista de gateways para cada ambiente IBM Cognos Series 7 do arquivo de configuração de conversão. A adição dos URLs CGI de indicadores nesse arquivo garante que o utilitário de conversão possa procurar o ambiente IBM Cognos Series 7 correto ao executar a conversão.
Etapas para configurar o servidor
1. No diretório local_s7\cgi-bin, crie um arquivo de texto chamado bookmarkcgi.conf e adicione as seguintes linhas:
PPBOOKMARKTOOL_SERVER=<server_name> PPBOOKMARKTOOL_PORT=<port_number> CGI_LOGFILE=<logfile_name>
CGI_LOCALE=<language>
A opção de idioma utiliza um código de duas letras. Por exemplo, FR para francês, DE para alemão, ES para espanhol e JA para japonês.
Cada entrada deve estar em sua própria linha.
2. No diretório local_c10\bin, inicie o utilitário de conversão de indicadores no prompt de comandos:
pp7bkmmigtool.exe SERVER caminho\PPS7TOC8CFG.xml número_da_porta
Onde PPS7TOC8CFG.xml é o arquivo de configuração gerado pela migração ou o arquivo criado manualmente(p. 89 ), caso a tarefa de migração não tenha sido executada.
O utilitário de conversão de indicadores é iniciado e deve permanecer em execução para converter os indicadores conforme são acessados pelos usuários. Os erros são registrados no arquivo pp7bkmtool.log.
Etapas para permitir que usuários alterem indicadores para o IBM Cognos BI
1. Abra a ferramenta de administração do PowerPlay Enterprise Server.
2. Visualize as propriedades do servidor, clique em Definições de Cubos e expanda a pasta Barras
de Ferramentas.
3. Na propriedade Personalizado 1, altere a configuração para Ativado.
Isso criará um botão personalizado na barra de ferramentas que será exibido quando estiver visualizando um cubo.
4. No diretório localização_do_s7\webcontent\ppwb, abra o arquivo ppwbcustom.js em um editor.
5. Localize as seguintes linhas:
function custom1() { alert("Custom action 1"); // please replace // parent. location.href="http://www.cognos.com/" // example url }
e substitua-as pelas seguintes:
function custom1() { var tparent = self.window; if (typeof(topparent) == "undefined"){ tparent = parent; } else { tparent = topparent; }
var bkmURL = tparent.location.href; var bkmCGIURL = "<bookmarkcgi URL>"; if (bkmURL.indexOf('?') != -1) bkmCGIURL += bkmURL.substr(bkmURL.indexOf ('?')); tparent.location.href = bkmCGIURL; }
sendo que<bookmarkcgi URL>é o URL para o arquivo bookmarkcgi.exe do diretório local_c10\cgi-bin.
Por exemplo, se o IBM Cognos BI for acessado a partir de http://nome_do_servidor/ibmcognos/ cgi-bin/cognos.cgi, o indicador cgi será acessado em http://nome_do_servidor/ibmcognos/cgi- bin/bookmarkcgi.exe.
Observação: As aspas nas linhas acima são obrigatórias. Os sinais de maior e menor, > e <,
indicam um valor que deve ser alterado.
Depois de abrir um indicador do IBM Cognos Series 7, é possível convertê-lo e redirecioná-lo a um indicador equivalente do IBM Cognos BI utilizando o novo botão personalizado.
Etapas para redirecionar automaticamente indicadores para o IBM Cognos BI
1. No diretório local_c10\bin, faça uma cópia do arquivo bookmarkcgi.exe e renomeie-o para ppdsweb.cgi.
2. Copie o arquivo ppdsweb.chi para cada um dos diretórios localização_do_s7\cgi-bin de cada um dos computadores servidores do IBM Cognos Series 7.
3. Para exibir as mensagens no idioma apropriado, copie todos os arquivos dll, ou os arquivos cat no sistema operacional UNIX®, que começam com PPWebCGIMsg do diretório
local_c10\cgi-bin para o diretório local_s7\cgi-bin.
Todos os indicadores do IBM Cognos Series 7 foram automaticamente convertidos e redirecionados para o IBM Cognos BI quando forem abertos.
Observação: Isso se aplica somente a indicadores que foram criados no gateway CGI. Indicadores
criados em gateways ISAPI ou NSAPI não serão convertidos. É possível converter esses indicadores ao alterar o URI para http://nome_servidor/ibmcognos/cgi-bin/bookmarkcgi.exe nos indicadores antigos. Não altere o parâmetro BZ.