Conteúdo


Práticas Comprovadas do IBM Business Analytics

Aplicativo de SDK do IBM Cognos 10 BI para Mesclar Relatórios

Natureza do documento: prática comprovada; produto: IBM Cognos 10 BI; área de interesse: desenvolvimento

Comments

Conteúdos da série:

Esse conteúdo é a parte # de # na série: Práticas Comprovadas do IBM Business Analytics

Fique ligado em conteúdos adicionais dessa série.

Esse conteúdo é parte da série:Práticas Comprovadas do IBM Business Analytics

Fique ligado em conteúdos adicionais dessa série.

Propósito

Este documento e o aplicativo de SDK do IBM Cognos 10 que o acompanha fornecem a capacidade para mesclar diversos relatórios do IBM Cognos 10 BI que foram criados no Report Studio em um único relatório. Isto é útil para criar uma apostila de relatórios, que é composta por diversos relatórios. Um exemplo de uma apostila de relatórios seria um pacote de demonstrativos mensal enviado aos indivíduos pela instituição financeira que contém um demonstrativo da conta corrente, um demonstrativo da conta de investimento e um demonstrativo do cartão de crédito.

Aplicabilidade

Esse aplicativo trabalho com os relatórios do IBM Cognos 10 BI 10.1.x e 10.2 criados com o Report Studio.

Uso, suporte e feedback

O aplicativo é fornecido estritamente “no estado em que se encontra”, e o Suporte do IBM Cognos não é capaz de oferecer suporte para ele. Se tiver perguntas ou comentários, use o recurso de comentários do developerWorks na parte inferior desta página.

Instalação

O aplicativo é implementado como um arquivo WAR (Archive web) que pode ser usado com um contêiner do servlet, como Tomcat, ou um servidor de aplicativos, como o IBM WebSphere. Primeiro, crie o arquivo WAR na instalação do IBM Cognos 10 usando os scripts fornecidos e, então, implemente-o no servidor.

Os procedimentos descritos neste documento abrangem a implantação do aplicativo no contêiner do servlet Tomcat que, normalmente, é instalado com o IBM Cognos 10 Dispatcher. Consulte a documentação do contêiner do servlet específico ou o servidor de aplicativos para obter instruções sobre a implementação do arquivo WAR em destinos alternativos.

O processo de instalação é o seguinte:

  • Descompacte a instalação no servidor IBM Cognos 10
  • Configure os arquivos de propriedades
  • Crie o arquivo WAR
  • Implemente o arquivo WAR em um servidor de aplicativos ou um contêiner do servlet

Descompactar arquivos

Descompacte o arquivo ZIP que contém o aplicativo c10MergeReports em um local temporário adequado em uma máquina que já tenha uma instalação existente do IBM Cognos 10 Dispatcher. Copie o diretório war/c10MergeReports e cole-o no diretório de instalação do IBM Cognos 10 sob <c10_install>/war.

Configurar arquivos de propriedades

Neste ponto, é possível configurar o aplicativo antes de criar o arquivo WAR. As configurações padrão deverão estar corretas na maioria das instâncias. No entanto, se for necessário fazer alterações nas definições de configuração no arquivo c10MergeReports.properties ou nas configurações de criação de log no arquivo log4j.properties, os arquivos estarão localizados no diretório <c10_install>/war/c10MergeReports/classes .

No arquivo c10MergeReports.properties, há cinco propriedades que podem ser modificadas:

c10.url - Usada pelo aplicativo c10MergeReports para se conectar ao IBM Cognos 10. O valor padrão é http://localhost:9300/p2pd/servlet/dispatch. O valor a ser usado é o External Dispatcher URI da máquina do IBM Cognos 10 que lidará com as solicitações do aplicativo c10MergeReports. O External Dispatcher URI pode ser encontrado usando a ferramenta de Configuração do IBM Cognos.

C10.imagebase - Usada pelo aplicativo c10MergeReports para recuperar imagens e folhas de estilo do IBM Cognos 10. O valor padrão é http://localhost:80/cognos10. O valor a ser usado é o URI de um gateway do IBM Cognos 10.

debug.flag - Independentemente das configurações de detalhe de log4j, a maioria da criação de log é desativada a menos que esta propriedade seja definida como verdadeira. Esta propriedade deve se apenas como verdadeira para fins de resolução de problemas e deve sempre ser definida como false, em um ambiente de produção.

log.location - Local do arquivo de log criado por log4j conforme especificado no arquivo WEB-INF/classes/log4j.properties. Observe que os nomes de diretórios devem ter uma barra de trilha.

stylesheet.main - Contém o nome da folha de estilo que é usada para gerar as páginas do assistente IBM Cognos 10 BI Merge Reports.

No arquivo log4j.properties , as configurações não precisarão ser alteradas se o arquivo WAR for implementado no contêiner do servlet Tomcat que está instalado com o IBM Cognos 10 Dispatcher.

Criar e implantar o arquivo WAR

Crie o arquivo WAR executando o script <c10_install>/war/c10MergeReports/build.bat (Windows) ou <c10_install>/war/c10MergeReports/build.sh (UNIX/Linux). Isso criará o arquivo WAR <c10_install>/war/c10MergeReports/c10MergeReports.war. Posicione-o no diretório <c10_install>/webapps do JViews Maps. Após um breve período, o servidor IBM Cognos 10 Tomcat irá descompactar o arquivo WAR automaticamente.

Autenticação de configuração

O aplicativo não fornece qualquer método de autenticação e depende de conexão única com o IBM Cognos Connection.

Copie o arquivo c10MergeReports.xml como <c10_install>/templates/ps.

Edite o arquivo <c10_install>/templates/ps/c10MergeReports.xml , e para a linha que é possível ler <CRNenv c_cmd="http://localhost:9300/c10MergeReports/Manager"> , altere localhost:9300 para o número da porta e servidor do contêiner do servlet ou o servidor de aplicativo hospedado no aplicativo c10MergeReports.

Considerações para a implementação em um ambiente independente

Se for instalar em um ambiente de produção altamente usado, considere instalar em um outro contêiner do servlet. Isso pode ser uma instância Tomcat independente ou um servidor de aplicativos completo, como o IBM WebSphere Application Server. Geralmente, o procedimento é tão simples quanto implementar qualquer aplicativo da web – no caso do Tomcat, é possível apenas deixar cair o arquivo WAR no diretório webapps igual ao IBM Cognos 10.

Se estiver instalando em um contêiner do servlet independente ou no servidor de aplicativos, provavelmente, será necessário alterar o caminho para o arquivo de log em WEB-INF/classes/log4j.properties. Por padrão, o nome do arquivo de log é especificado usando o caminho relativo ../logs/c10MergeReports.log. Enquanto isso funciona quando o aplicativo está instalado ao lado do IBM Cognos 10, pode ser necessário alterar para um caminho relativo ou um caminho completo diferente, como C:/logs/c10MergeReports.log.

Outra configuração alternativa é instalar em uma instalação IBM Cognos 10 dedicada. Como o aplicativo c10MergeReports pode se comunicar com diversos servidores IBM Cognos 10 e não apenas com o qual está instalado nele, é possível ter uma instância do IBM Cognos 10 dedicada para executar este aplicativo. Verifique o licenciamento para determinar se essa é uma alternativa viável.

Usando o aplicativo

Sobre o processo de mesclagem

Exclusividade

Qualquer relatório do Report Studio pode ser mesclado com qualquer outro relatório do Report Studio, incluindo relatórios que contém prompts, variáveis ou formatação condicional. Quaisquer páginas, páginas de prompt, variáveis e consultas serão renomeadas com um número precedente para evitar duplicatas. Por exemplo,

  • 'Query1' do primeiro relatório será renomeada para '1_Query1'
  • 'Page1' do primeiro relatório será renomeada para '1_Page1'

Páginas de prompt comuns

Quando mesclar relatórios com páginas de prompt, o aplicativo não irá verificar se os relatórios a serem mesclados possuem parâmetros de prompt em comum. As páginas e os parâmetros de prompt serão mesclados do jeito que estão. O autor do relatório pode remover as páginas de prompt depois no Report Studio e, se quiser, vincular todas as páginas do relatório com uma página/parâmetro de prompt. Por exemplo,

  • Um relatório de demonstrativo da conta de poupança que contém uma
    • Página de prompt de dados
    • Página de demonstrativo
  • Um relatório de demonstrativo da conta corrente que contém uma
    • Página de prompt de dados
    • Página de demonstrativo
  • Mesclar esses relatórios resultará em um único relatório de demonstrativo da conta de poupança e corrente que contém uma
    • Página de prompt de dados para o relatório do demonstrativo da conta de poupança
    • Página de prompt de dados para o relatório do demonstrativo da conta corrente
    • Página de demonstrativo para o relatório do demonstrativo da conta de poupança
    • Página de demonstrativo para o relatório do demonstrativo da conta corrente

Acessando o aplicativo

O aplicativo c10MergeReports pode ser ativado a partir do navegador usando a seguinte URL para um gateway do IBM Cognos 10

  • http://gatewayName/vdirName/cgi-bin/cognos.cgi?b_action=xts.run&m=portal/bridge.xts&c_env=c10MergeReports.xml&c_mode=post
    • Altere gatewayName para o nome do servidor executando um gateway do IBM Cognos 10
    • Mude o valor de vdirName para o nome do diretório virtual que foi especificado ao instalar o gateway do IBM Cognos 10 (padrão = ibmcognos10)

Executando o Merge Report Wizard

Ao abrir a URL em um navegador, um conjunto de telas semelhantes às seguintes deverá ser visível. Observe que poderá haver uma página de logon intermediária se o usuário não tiver efetuado o logon no IBM Cognos 10 ainda. Clicar no botão Cancel em qualquer uma das telas do Merge Report Wizard será uma tentativa de fechar a janela do navegador.

  1. Na tela Select a package (Figura 1), selecione o pacote na lista suspensa que contém os relatórios que deseja mesclar.
    Figura 1: tela Select a package na qual o usuário seleciona o pacote que contém os relatórios a serem mesclados
  2. Selecione e ordene os relatórios a serem mesclados na tela Select the reports conforme mostrado na Figura 2.
    Figura 2: tela Select the reports que permite que o usuário selecione dois ou mais relatórios a serem mesclados
  3. Na tela Specify a name and description (Figura 3), use o campo Name para fornecer um nome ao relatório mesclado, o campo Description: para fornecer uma descrição do relatório e o campo Screen Tip: para fornecer uma dica de tela que aparecerá em uma caixa amarela quando o mouse for mantido em cima do nome do relatório. A descrição e a dica de tela são opcionais. Clique no link Próximo.
    Figura 3: tela Specify name and description na qual o usuário fornece um nome ao relatório mesclado e uma descrição e dica de tela opcionais
  4. A página Review the summary (Figura 4) permite que você verifique se os relatórios escolhidos são os corretos e se o nome do relatório está correto. Clique no botão Concluir para mesclar os relatórios e salvar o relatório mesclado na Content Store como um filho do pacote selecionado.
    Figura 4: a tela Review the summary na qual o usuário pode verificar as entradas das telas anteriores antes de mesclar e salvar o relatório

Resources

Para obter mais informações sobre o IBM Cognos 10 e o IBM WebSphere,
IBM Cognos 10 BI - http://www-142.ibm.com/software/products/us/en/subcategory/SWQ20
IBM WebSphere - http://www.ibm.com/software/websphere

Para obter mais informações sobre as tecnologias usadas neste aplicativo,
Tomcat - http://tomcat.apache.org
log4j 1.2 - http://logging.apache.org/log4j/1.2


Recursos para download


Comentários

Acesse ou registre-se para adicionar e acompanhar os comentários.

static.content.url=http://www.ibm.com/developerworks/js/artrating/
SITE_ID=80
Zone=Information Management
ArticleID=953524
ArticleTitle=Práticas Comprovadas do IBM Business Analytics: Aplicativo de SDK do IBM Cognos 10 BI para Mesclar Relatórios
publish-date=11262013