IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera...

159
IBM Cognos PowerPlay Versão 10.2.2 Guia de Migração e Administração

Transcript of IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera...

Page 1: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

IBM Cognos PowerPlayVersão 10.2.2

Guia de Migração e Administração

���

Page 2: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

NotaAntes de usar estas informações e o produto suportado por elas, leia as informações em “Avisos” na página 145.

Informações do produto

Este documento se aplica ao IBM Cognos Business Intelligence Versão 10.2.2 e também pode se aplicar às liberaçõessubsequentes.

Licensed Materials - Property of IBM

© Copyright IBM Corporation 2005, 2014.

Page 3: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Índice

Introdução . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii

Capítulo 1. O que há de novo? . . . . . . . . . . . . . . . . . . . . . . . . . . 1Recursos Descontinuados na Versão 10.2.0 . . . . . . . . . . . . . . . . . . . . . . . . . 1

As Ferramentas de Linha de Comandos do Migration Assistant . . . . . . . . . . . . . . . . . 1Ações Abrir com o Report Studio e Abrir com Analysis Studio . . . . . . . . . . . . . . . . . 1

Novos Recursos na Versão 10.1.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1Exportar para o Formato Open XML do Microsoft Excel 2007 . . . . . . . . . . . . . . . . . . 2Suporte para a Migração do IBM Cognos Series 7 versão 5 para o IBM Cognos 10.1.1 . . . . . . . . . . 2

Recursos Alterados na Versão 10.1.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . 2Melhorada a Migração de Supressão de Zeros para o Report Studio . . . . . . . . . . . . . . . . 2

Novos recursos na versão 10.1.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2IBM Cognos Business Insight . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2Suporte para Migração do IBM Cognos Series 7 Versão 4 MR4 para o IBM Cognos Business Intelligence 10.1.0 . 2Novas opções de migração . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3Suporte para Migração de Conteúdo de Diversos Servidores IBM Cognos Series 7 . . . . . . . . . . . 3Execução de Tarefas no IBM Cognos PowerPlay Usando URLs . . . . . . . . . . . . . . . . . 3Mudança de configurações para o conteúdo em Minhas Pastas para um usuário específico . . . . . . . . 3

Recursos alterados na versão 10.1.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3Suporte para tipos de pacotes adicionais . . . . . . . . . . . . . . . . . . . . . . . . . 3Otimização do desempenho ao migrar conteúdo . . . . . . . . . . . . . . . . . . . . . . 4Página Resumo mais detalhado da migração. . . . . . . . . . . . . . . . . . . . . . . . 4

Capítulo 2. O Que é o IBM Cognos PowerPlay?. . . . . . . . . . . . . . . . . . . 5

Capítulo 3. O Que é Diferente no IBM Cognos PowerPlay? . . . . . . . . . . . . . . 7Arquitetura . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7Portais web . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10Origens de Dados . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10Segurança . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11Fluxo de solicitação. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11Serviço de migração . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12PowerPlay Studio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12PowerPlay Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14Instalação e configuração . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16Administração do PowerPlay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Propriedades do servidor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19Propriedades das pastas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21Propriedades de cubos e relatórios. . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Acesso drill-through . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23Entendendo o Acesso Drill-through no IBM Cognos BI . . . . . . . . . . . . . . . . . . . . 23Exemplo - Como drill through entre pacotes OLAP e relacionais. . . . . . . . . . . . . . . . . 26

Capítulo 4. Administrando o IBM Cognos PowerPlay . . . . . . . . . . . . . . . . 31Iniciar o IBM Cognos PowerPlay Administration . . . . . . . . . . . . . . . . . . . . . . . 31Considerações sobre a administração de instalações distribuídas . . . . . . . . . . . . . . . . . . 31Permissão para que usuários executem tarefas de migração . . . . . . . . . . . . . . . . . . . 32

Recomendação - Crie grupos ou funções para atribuir capacidades em vez de usuários individuais . . . . . 32Definindo Configurações Avançadas para o Serviço PowerPlay . . . . . . . . . . . . . . . . . . 33

Definir Configurações Avançadas . . . . . . . . . . . . . . . . . . . . . . . . . . . 34Customizar as Configurações de Cubos e Relatórios do PowerPlay em Pastas Públicas . . . . . . . . . . 35

Customizar as Configurações de Cubos e Relatórios do PowerPlay em Minhas Pastas . . . . . . . . . 36Alterar a Aparência do PowerPlay Studio . . . . . . . . . . . . . . . . . . . . . . . . 38Ativação do drill through. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

© Copyright IBM Corp. 2005, 2014 iii

Page 4: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Customização da Barra de Ferramentas . . . . . . . . . . . . . . . . . . . . . . . . . 43Configurações de Cubos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44Configurações de relatórios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

Customize a Aparência do IBM Cognos BI . . . . . . . . . . . . . . . . . . . . . . . . . 54

Capítulo 5. Migrando do IBM Cognos Series 7 PowerPlay para o IBM CognosPowerPlay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55Por que Migrar o Conteúdo do IBM Cognos Series 7 PowerPlay para o IBM Cognos PowerPlay?. . . . . . . 55

Usando Recursos do PowerPlay no IBM Cognos BI . . . . . . . . . . . . . . . . . . . . . 56Abordagem de Migração . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

Movendo para o IBM Cognos PowerPlay . . . . . . . . . . . . . . . . . . . . . . . . . 57O que é migrado e para onde é migrado? . . . . . . . . . . . . . . . . . . . . . . . . . 58Antes de migrar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

Definir Aliases para Servidores do IBM Cognos Series 7 . . . . . . . . . . . . . . . . . . . 64Migrar conteúdo para o IBM Cognos PowerPlay . . . . . . . . . . . . . . . . . . . . . . . 65

Criar uma Tarefa de Migração . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67Especificar a Origem de Migração . . . . . . . . . . . . . . . . . . . . . . . . . . . 67Selecionar Opções de Migração . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68Selecionar o Conteúdo para Migrar . . . . . . . . . . . . . . . . . . . . . . . . . . 70Iniciar a Migração . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71Recomendação - Mantenha os Cubos e os Relatórios em seu Ambiente de Origem até a Conclusão da Migração 71

Migrando Relatórios Locais para o IBM Cognos BI . . . . . . . . . . . . . . . . . . . . . . 72Conversão de arquivos PPR para PPX para migração . . . . . . . . . . . . . . . . . . . . 72Migrar Relatórios Locais para o IBM Cognos BI . . . . . . . . . . . . . . . . . . . . . . 73

Usando o Utilitário de Conversão do Marcador no IBM Cognos PowerPlay . . . . . . . . . . . . . . 74Execução do utilitário de conversão de marcadores como um aplicativo . . . . . . . . . . . . . . 74Execução do utilitário de conversão de marcadores como um servidor. . . . . . . . . . . . . . . 76Criação manual de arquivos de configuração de conversão . . . . . . . . . . . . . . . . . . 79

Capítulo 6. Configurando as Amostras do IBM Cognos PowerPlay . . . . . . . . . . 81Criação de uma conexão de origem de dados para o PowerCube de amostra . . . . . . . . . . . . . 81Importação de relatórios de amostra . . . . . . . . . . . . . . . . . . . . . . . . . . . 82

Importando o PowerPlay e as Amostras de Migração . . . . . . . . . . . . . . . . . . . . 82Importando as Amostras de Drill Through . . . . . . . . . . . . . . . . . . . . . . . . 83

Teste de um relatório de amostra . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83Configuração de PowerCubes e relatórios de amostra para migração . . . . . . . . . . . . . . . . 84

Capítulo 7. Configuração de criação de log . . . . . . . . . . . . . . . . . . . . 85Configurar a Criação de Log do IBM Cognos BI . . . . . . . . . . . . . . . . . . . . . . . 85

Especificar o Destino para Mensagens de Log do IBM Cognos BI . . . . . . . . . . . . . . . . 85Ativar Criação de Log para o Serviço PowerPlay . . . . . . . . . . . . . . . . . . . . . . 86Ativar a Criação de Log para Atividade de Cubo e de Relatório do PowerPlay . . . . . . . . . . . . 87Modelo de auditoria e relatórios de auditoria de amostra . . . . . . . . . . . . . . . . . . . 87Esquema de Dados para Mensagens de Log do IBM Cognos PowerPlay . . . . . . . . . . . . . . 88

Configuração da Criação de Log de Estilo do IBM Cognos Series 7. . . . . . . . . . . . . . . . . 95Ativar Auditoria para o Servidor . . . . . . . . . . . . . . . . . . . . . . . . . . . 96Ativar Auditoria para Cubos e Relatórios . . . . . . . . . . . . . . . . . . . . . . . . 97

Capítulo 8. Administração em Lote do PowerPlay . . . . . . . . . . . . . . . . . 105O utilitário ppadmtool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105

Convenções . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107Comandos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107

Comandos substituídos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110Comandos alterados . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111Requisitos de Configuração para Usar SSL para o Utilitário PowerPlay Server Batch Administration . . . . . 111

Extrair um Certificado SSL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111Criar um Keystore para o Certificado . . . . . . . . . . . . . . . . . . . . . . . . . 112Modificar os Parâmetros para o Utilitário de Administração em Lote . . . . . . . . . . . . . . . 112

iv IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 5: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Apêndice A. Solução de problemas . . . . . . . . . . . . . . . . . . . . . . . 113Problemas ao Migrar do IBM Cognos Series 7 PowerPlay para o IBM Cognos PowerPlay . . . . . . . . . 113

Criação de log de migração. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113Conteúdo que não pode ser migrado . . . . . . . . . . . . . . . . . . . . . . . . . 115Erros no mapeamento de cubo . . . . . . . . . . . . . . . . . . . . . . . . . . . 115O nome da pasta criada para o conteúdo migrado não está no idioma correto . . . . . . . . . . . . 116Não Foi Possível Migrar o Conteúdo Porque o Código do Idioma Não Está Configurado ou Mapeado no IBMCognos Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117Alocação de Memória do Serviço de Migração do IBM Cognos Series 7 . . . . . . . . . . . . . . 118As propriedades de drill through podem precisar ser alteradas depois da migração . . . . . . . . . . 118Erro ao migrar do Upfront . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119Não Será Possível Migrar o Conteúdo do Upfront se o PowerPlay Enterprise Server Não Estiver Protegido . . 119Impossível conectar ao servidor Upfront durante migração se o Upfront estiver protegido para conexão únicaou conexão do SO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119Newsboxes Pessoais Não Aparecem na Visualização em Árvore do Upfront no IBM Cognos MigrationAssistant . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119Problemas ao migrar relatórios com nomes de caminho interno que excedem os 255 caracteres . . . . . . 120Os detalhes do histórico não aparecem na tarefa de migração . . . . . . . . . . . . . . . . . 120Informações de contato do Upfront não migradas . . . . . . . . . . . . . . . . . . . . . 121Apóstrofo no nome da pasta não migrado . . . . . . . . . . . . . . . . . . . . . . . . 121Pasta Vazia Chamada "cubos" Criada Após a Migração do IBM Cognos Connection . . . . . . . . . . 121Erro ao Iniciar o Serviço de Migração do Series 7 . . . . . . . . . . . . . . . . . . . . . 121Visualizações customizadas migradas uma segunda vez aparecem como links quebrados . . . . . . . . 122A mensagem de erro não é clara ao migrar o conteúdo do Upfront de um ambiente distribuído de instalaçãodo Series 7 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122Não é Possível Migrar Relatórios no UNIX Quando Nomes de Caminhos Contiverem DeterminadosCaracteres Europeus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122Rank aplicado a um eixo tendo um subconjunto customizado e uma ou mais categorias não migrado para oAnalysis Studio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123Migração de relatórios com uma única medida no eixo X ou Y não executada no Report Studio . . . . . . 123Pastas na NewsBox pessoal do Upfront não migradas . . . . . . . . . . . . . . . . . . . . 124A migração de marcadores gera URLs inválidos . . . . . . . . . . . . . . . . . . . . . . 124Exibição incorreta da saída em PDF do relatório migrado . . . . . . . . . . . . . . . . . . 124Configuração de geração de arquivos PDF leves não migrados . . . . . . . . . . . . . . . . . 125

Problemas ao Trabalhar no IBM Cognos PowerPlay Administration . . . . . . . . . . . . . . . . 126As Solicitações do PowerPlay Não Aparecem no Status do Sistema ou nas Listas de Atividades . . . . . . 126Algumas Atividades do PowerPlay Não Estão Registradas . . . . . . . . . . . . . . . . . . 126Erro de conexão quando o nome do arquivo do PowerCube inclui caracteres chineses simplificados . . . . 126

Problemas ao Trabalhar no IBM Cognos PowerPlay Studio . . . . . . . . . . . . . . . . . . . 127Erro Depois de Inserir um Cálculo no PowerPlay Studio . . . . . . . . . . . . . . . . . . . 127Erro ao abrir links no e-mail de relatórios programados . . . . . . . . . . . . . . . . . . . 127Erro de página ao editar o título do gráfico em japonês . . . . . . . . . . . . . . . . . . . 127Sequências longas estão truncadas . . . . . . . . . . . . . . . . . . . . . . . . . . 127Texto em hebraico exibido em gráficos . . . . . . . . . . . . . . . . . . . . . . . . . 127Após exportar para PDF, o rótulo correspondente a categoria OUTRO em um gráfico de setores muda para orótulo da categoria . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128Exibição ilegível ou inacessível . . . . . . . . . . . . . . . . . . . . . . . . . . . 128Delimitador Usado para Exportar para CSV Diferente do IBM Cognos Series 7 . . . . . . . . . . . 128Erro de Firewall do Cognos Application ao Salvar um Relatório do PowerPlay Studio . . . . . . . . . 128

Apêndice B. Executando Tarefas no IBM Cognos BI Usando URLs . . . . . . . . . 129Recomendações para URLs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129Programa CGI e gateways alternativos . . . . . . . . . . . . . . . . . . . . . . . . . . 130Métodos de URL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130

Método de URL parametrizado . . . . . . . . . . . . . . . . . . . . . . . . . . . 130Validação de URL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131Iniciando Componentes do IBM Cognos BI . . . . . . . . . . . . . . . . . . . . . . . . 132

Iniciando o PowerPlay Studio . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132

Índice v

Page 6: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Apêndice C. Mapeamento de caracteres Shift-JIS japoneses . . . . . . . . . . . . 135Reconfiguração dos caracteres Shift-JIS para mapeamento Unicode . . . . . . . . . . . . . . . . 137

Edição manual do arquivo shift-jis.xml . . . . . . . . . . . . . . . . . . . . . . . . . 139Solução de problemas ao migrar caracteres Shift-JIS . . . . . . . . . . . . . . . . . . . . . 139

O arquivo shift-jis.xml não parece afetar os mapeamentos usados . . . . . . . . . . . . . . . . 139Uma mensagem de erro multibyte aparece durante a migração . . . . . . . . . . . . . . . . . 140O Serviço de Migração do IBM Cognos Series 7 não Pode Abrir um Arquivo do PowerPlay ContendoCaracteres Problemáticos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140Nenhum mapeamento de cubo localizado para um relatório. . . . . . . . . . . . . . . . . . 141Caracteres não migrados corretamente quando se usa uma origem de migração diferente . . . . . . . . 141Problemas ao Migrar Cubos com Caracteres Não ASCII no UNIX . . . . . . . . . . . . . . . . 142Não é possível migrar porque já existe um objeto de relatórios do Content Manager com o mesmo nome . . 143

Avisos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145

Índice Remissivo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149

vi IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 7: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Introdução

Este documento deve ser usado com o IBM® Cognos PowerPlay.

Como usar este documento

Este documento contém procedimentos passo a passo e outras informações paraajudá-lo a migrar o conteúdo do IBM Cognos Series 7 PowerPlay para o IBMCognos PowerPlay e administrar o PowerPlay no IBM Cognos BusinessIntelligence.

Este documento irá ajudá-lo a entender:v as diferenças entre o IBM Cognos Series 7 e o IBM Cognos PowerPlayv As opções disponíveis para migração de conteúdo.v como usar os recursos de administração no IBM Cognos PowerPlay

Público-alvo

Para usar este documento efetivamente, deve-se estar familiarizado com aadministração do IBM Cognos Series 7 PowerPlay, sua infraestrutura de segurançae a tecnologia da informação e com os conceitos de banco de dados e relatórios.

Localizando Informações

Para localizar a documentação do produto na web, incluindo toda a documentaçãotraduzida, acesse o IBM Knowledge Center (http://www.ibm.com/support/knowledgecenter).

Recursos de Acessibilidade

Este produto não suporta atualmente os recursos de acessibilidade que ajudam osusuários com alguma deficiência física, como mobilidade reduzida ou visãolimitada, a usar este produto.

Instruções para Procura de Versões Futuras

Esta documentação descreve a funcionalidade atual do produto. Referências a itensque não estão disponíveis atualmente podem estar incluídas. Não se deve inferirimplicações de qualquer disponibilidade futura. Tais referências não representamum compromisso, uma promessa ou uma obrigação legal de entrega de qualquermaterial, código ou funcionalidade. O desenvolvimento, a liberação e asincronização de recursos ou funcionalidade ficam ao arbítrio exclusivo da IBM.

Renúncia de Responsabilidade de Amostras

A Companhia de Aventuras de Amostra, a Companhia das Grandes Aventuras, aVendas GA, qualquer variação dos nomes Aventuras ou Grandes Aventuras e aAmostra de Planejamento representam operações de negócios fictícias com dadosde amostra usados para desenvolver aplicativos de amostra para a IBM e para osclientes IBM. Esses registros fictícios incluem dados de amostra para transações devendas, distribuição de produtos, e recursos humanos e financeiros. Qualquersemelhança com nomes, endereço, números de contato ou valores de transações

© Copyright IBM Corp. 2005, 2014 vii

Page 8: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

reais é mera coincidência. Outros arquivos de amostras podem conter dadosficcionais gerados manualmente ou por máquinas, dados fatuais compilados deorigens acadêmicas ou públicas, ou ainda dados usados com a permissão doportador dos direitos autorais, para uso como dados de amostra a fim dedesenvolver aplicativos de amostras. Os nomes de produtos a que são feitasreferências podem ser marcas registradas de seus respectivos proprietários. A cópianão autorizada é proibida.

viii IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 9: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Capítulo 1. O que há de novo?

Esta seção contém uma lista de recursos novos e modificadospara esta liberação. Aseção auxiliará no planejamento de estratégias de implementação de aplicativos eatualizações e de solicitações de treinamento dos usuários.

Informações do O Que Há de Novo para liberações passadas, incluindo versões 8.3e 8.4, estão disponíveis acessando a documentação no IBM Cognos InformationCenters (http://pic.dhe.ibm.com/infocenter/cogic/v1r0m0/index.jsp).

Para obter informações sobre o upgrade, consulte o Guia de Instalação e Configuraçãodo IBM Cognos PowerPlay.

Para revisar uma lista atualizada de ambientes suportados pelos produtos IBMCognos, como sistemas operacionais, correções, navegadores, servidores da web,servidores de diretório, servidores de banco de dados e servidores de aplicativos,visite o IBM Cognos Customer Center (http://www.ibm.com/software/data/cognos/customercenter).

Recursos Descontinuados na Versão 10.2.0Conforme anunciado no release 10.1.1 do IBM Cognos Business Intelligence, algunsrecursos foram descontinuados no release 10.2.0 do IBM Cognos BusinessIntelligence 10.2.0.

As Ferramentas de Linha de Comandos do MigrationAssistant

As ferramentas de linha de comandos do IBM Cognos Migration Assistant nãoestão incluídas na liberação 10.2.0 do IBM Cognos Business Intelligence.

Para migrar o conteúdo do IBM Cognos Series 7 Impromptu ou do IBM CognosSeries 7 Architect para o IBM Cognos Business Intelligence 10.2.0, a versão 10.1.1do IBM Cognos Business Intelligence das ferramentas de migração para migrarpara 10.1.1. Após a migração, atualize o conteúdo 10.1.1 para o IBM CognosBusiness Intelligence 10.2.0.

É possível continuar a migrar o conteúdo do IBM Cognos Series 7 PowerPlay parao IBM Cognos PowerPlay usando o Migration Assistant que é incluído com o IBMCognos BI PowerPlay. Para obter informações adicionais, consulte a publicaçãoIBM Cognos PowerPlay Migration and Administration Guide.

Ações Abrir com o Report Studio e Abrir com Analysis StudioAs opções para abrir um relatórioPowerPlay no IBM Cognos Report Studio ou IBMCognos Analysis Studio não estão disponíveis na liberação 10.2.0 do IBM CognosBusiness Intelligence.

Novos Recursos na Versão 10.1.1Os novos recursos desde a última liberação são os seguintes.

© Copyright IBM Corp. 2005, 2014 1

Page 10: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Exportar para o Formato Open XML do Microsoft Excel 2007Para facilitar a exportação de dados do IBM Cognos PowerPlay Client ou doPowerPlay Studio para versões recentes do Microsoft Excel, é possível agoraselecionar o Excel 2007 e Superior como um formato de destino. Selecionar essaopção resultará na criação de arquivos Open XML (.xlsx), que são nativos para oMicrosoft Excel 2007.

Suporte para a Migração do IBM Cognos Series 7 versão 5para o IBM Cognos 10.1.1

Esta versão do IBM Cognos Migration Assistant suporta a migração do IBMCognos Series 7 versão 5 para o IBM Cognos Business Intelligence 10.1.1.

Recursos Alterados na Versão 10.1.1As mudanças dos recursos desde a última liberação são as seguintes.

Melhorada a Migração de Supressão de Zeros para o ReportStudio

Em liberações anteriores, a supressão de zeros era migrada para o IBM CognosReport Studio usando expressões que replicavam a supressão baseada em totais.Opções de supressão do IBM Cognos Series 7 PowerPlay, como valores zero edivisão por zero, são agora migradas para as mesmas opções no Report Studio.

Além disso, opções de supressão de nulos são agora ativadas quando o MigrationAssistant cria pacotes durante uma migração. Ao criar um novo relatório no ReportStudio usando um pacote criado pelo Migration Assistant, o menu Suprimir ficadisponível e é possível escolher a opção de supressão de zero que você desejaaplicar.

Novos recursos na versão 10.1.0Os novos recursos desde a última liberação são os seguintes.

IBM Cognos Business InsightO IBM Cognos Business Insight é um novo ambiente de consumo de relatórios quefornece uma experiência integrada de Inteligência de Negócios para usuários denegócios. Essa ferramenta baseada na Web permite que você use conteúdo do IBMCognos e origens de dados externas para criar painéis sofisticados e interativos.

Os usuários do IBM Cognos Connection podem iniciar o IBM Cognos BusinessInsight de dentro do IBM Cognos Connection. Para obter informações sobre comoiniciar o IBM Cognos Business Insight, consulte o Guia do Usuário do IBM CognosConnection. Para obter informações sobre como usar o IBM Cognos BusinessInsight, consulte o Guia do Usuário do IBM Cognos Business Insight.

Suporte para Migração do IBM Cognos Series 7 Versão 4 MR4para o IBM Cognos Business Intelligence 10.1.0

Esta versão do IBM Cognos Migration Assistant suporta migração do IBM CognosSeries 7 versão 4 MR4 para o IBM Cognos Business Intelligence 10.1.0.

2 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 11: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Novas opções de migraçãoNo Assistente de migração, existem novas opções para proporcionar um maiorcontrole do processo de migração. Por exemplo, é possível incluir ou excluir fontesao migrar relatórios e decidir quais informações de segurança serão migradas.Tarefas relacionadas:“Migrar conteúdo para o IBM Cognos PowerPlay” na página 65Usando o IBM Cognos Migration Assistant, é possível migrar conteúdo do IBMCognos Series 7 PowerPlay que foi publicado no IBM Cognos Connection ou IBMCognos Series 7 Upfront, ou conteúdo do IBM Cognos Series 7 PowerPlayEnterprise Server.

Suporte para Migração de Conteúdo de Diversos ServidoresIBM Cognos Series 7

Agora é possível migrar o conteúdo a partir de diversos servidores IBM CognosSeries 7. Para obter os melhores resultados, defina aliases do servidor para evitarcolisões de nome ao migrar conteúdo que tenha o mesmo nome ou estrutura depastas.Tarefas relacionadas:“Definir Aliases para Servidores do IBM Cognos Series 7” na página 64Defina aliases para servidores do IBM Cognos Series 7 para identificar maisfacilmente as origens das quais você está migrando. Ao definir aliases, é possívelevitar colisões de nomes ao migrar conteúdo de diversos servidores Series 7 com omesmo nome ou estrutura de pasta em uma única migração.

Execução de Tarefas no IBM Cognos PowerPlay Usando URLsAs URLs fornecem uma maneira rápida e eficiente de iniciar componentes do IBMCognos BI e abrir o conteúdo especificado, como relatórios, métricas, pastas oupáginas.Conceitos relacionados:Apêndice B, “Executando Tarefas no IBM Cognos BI Usando URLs”, na página 129As URLs fornecem uma maneira rápida e eficiente para iniciar componentes doIBM Cognos Business Intelligence e abrir o conteúdo especificado, como relatórios,métricas, pastas ou páginas.

Mudança de configurações para o conteúdo em MinhasPastas para um usuário específico

A administração do IBM Cognos PowerPlay inclui agora um recurso de procuraque pode ser usado para administrar o conteúdo por usuário.Tarefas relacionadas:“Customizar as Configurações de Cubos e Relatórios do PowerPlay em PastasPúblicas” na página 35Há várias opções disponíveis para permitir a customização da aparência, dodesempenho e da funcionalidade do aplicativo IBM Cognos PowerPlay.

Recursos alterados na versão 10.1.0Listados abaixo estão as mudanças dos recursos desde a última liberação.

Suporte para tipos de pacotes adicionaisO IBM Cognos PowerPlay agora suporta pacotes com base em algumascombinações de origens de dados mistas.

Capítulo 1. O que há de novo? 3

Page 12: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

No PowerPlay Studio e no PowerPlay Client, agora é possível abrir um pacotebaseado em um PowerCube e outros tipos de origens de dados, como uma oumais origens de dados relacionais. O PowerPlay Studio e o PowerPlay Client nãosuportam pacotes baseados em mais de um PowerCube.

Otimização do desempenho ao migrar conteúdoAgora é possível migrar até 5.000 objetos em uma única tarefa de migração. Paramaximizar o desempenho, é necessária a configuração do IBM Cognos BusinessIntelligence.Conceitos relacionados:“Antes de migrar” na página 62Antes de iniciar uma tarefa de migração, execute as tarefas a seguir para prepararseus ambientes de origem e destino e assegurar uma migração bem-sucedida.

Página Resumo mais detalhado da migraçãoA página de migração Revisar o resumo fornece mais informações sobre as opçõese o conteúdo selecionado para migrar. A página também inclui o número total deobjetos que serão migrados para que você possa se certificar de que o limite de 5mil objetos de migração não será ultrapassado.Tarefas relacionadas:“Iniciar a Migração” na página 71Depois de selecionar o local de origem, opções e conteúdo do IBM Cognos Series 7a ser migrado, é possível iniciar a migração.

4 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 13: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Capítulo 2. O Que é o IBM Cognos PowerPlay?

O IBM Cognos PowerPlay fornece recursos de análise e exploração já conhecidosdos autores, analistas e usuários do relatório do IBM Cognos Series 7 PowerPlay,em um ambiente do IBM Cognos Business Intelligence. Com a integração com oIBM Cognos BI, o PowerPlay pode aproveitar a arquitetura e os recursos do IBMCognos BI enquanto preserva os aplicativos e a experiência de usuário existentesno PowerPlay.

O IBM Cognos BI oferece aos usuários do PowerPlay recursos adicionais paramaximizar a produtividade no novo ambiente. Os auxiliares de navegação e derelatórios do PowerPlay Studio e do PowerPlay Client, como botões da barra deferramentas, têm a mesma aparência e função no ambiente do IBM Cognos BI,como no IBM Cognos Series 7.

A arquitetura orientada a serviços do IBM Cognos BI possibilita a integração doPowerPlay no ambiente do IBM Cognos BI. Essa integração oferece um baixo custode propriedade enquanto aprimora os recursos do PowerPlay. Entre os benefícios,essa arquitetura:v permite que o serviço do PowerPlay no ambiente do IBM Cognos BI continue a

usar o mesmo mecanismo de consulta como no IBM Cognos Series 7.Como resultado, relatórios e outros conteúdos do IBM Cognos Series 7PowerPlay, como cubos, marcadores, políticas de segurança e hierarquias doUpfront, migram facilmente para o ambiente do IBM Cognos BI.

v inclui PowerPlay como um studio do IBM Cognos BI e permite que oPowerPlay interaja com outros studios do IBM Cognos BI.Por exemplo, os usuários podem abrir relatórios do PowerPlay em outrosstudios que estejam disponíveis para eles. Os usuários podem também fazer drillthrough a partir do PowerPlay para outros studios. No IBM Cognos BI, paradisponibilizar o drill through para os usuários, é necessário menos envolvimentodos modeladores e administradores do que no IBM Cognos Series 7.

v mantém a análise de dados e os recursos de exploração do IBM Cognos Series 7PowerPlayOs autores de relatórios podem continuar a trabalhar com uma interfaceconhecida para produzir relatórios, além de alavancar os recursos de outrosstudios do IBM Cognos BI.

v fornece um único ponto de acesso para todas as configurações de administraçãodo IBM Cognos BI.O IBM Cognos Administration é uma interface baseada na Web sem instalaçãode software que fornece acesso flexível a configurações de administração.

© Copyright IBM Corp. 2005, 2014 5

Page 14: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

6 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 15: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Capítulo 3. O Que é Diferente no IBM Cognos PowerPlay?

O IBM Cognos PowerPlay traz os recursos comprovados de exploração e análisedo IBM Cognos Series 7 PowerPlay para o ambiente do IBM Cognos BusinessIntelligence.

O IBM Cognos PowerPlay mantém a aparência e a funcionalidade familiares doIBM Cognos Series 7 PowerPlay para autores e usuários dos relatórios e oferecetambém a arquitetura e escalabilidade aprimoradas de servidor do ambiente doIBM Cognos Business Intelligence.

Esta seção destaca as diferenças que podem ser notadas quando se trabalha com oIBM Cognos PowerPlay.

ArquiteturaO IBM Cognos Business Intelligence possui uma arquitetura com multicamadas.Para fins de descrição, ele pode ser separado em três camadas: servidor da web,aplicativos e dados. As camadas são baseadas em funções de negócios e sãogeralmente separadas por firewalls de rede. Interfaces com o usuário do IBMCognos BI, como o PowerPlay Studio, ficam acima das camadas.

© Copyright IBM Corp. 2005, 2014 7

Page 16: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Para obter informações adicionais sobre a arquitetura, consulte o Guia deArquitetura e Implementação do IBM Cognos BI.

Servidores web e gateways

A comunicação da Web no IBM Cognos BI é feita geralmente por meio degateways, que residem em um ou mais servidores da Web. O PowerPlay Client usauma conexão ao gateway para abrir, criar e publicar relatórios remotos. Osusuários do PowerPlay Studio acessam seus relatórios conectando-se ao portal doIBM Cognos BI em seus navegadores da Web. A comunicação da Web tambémpode ocorrer diretamente com um dispatcher do IBM Cognos BI, embora essaopção seja menos comum do que usar um gateway.

Quando um gateway do IBM Cognos BI recebe uma solicitação, elev criptografa senhas para garantir a segurançav extrai informações necessárias para enviar a solicitação para um dispatcher do

IBM Cognos BIv Anexa variáveis de ambiente ao servidor web.v Opcionalmente inclui um namespace padrão na solicitação para garantir que o

servidor autentique o usuário no namespace correto.v passa solicitações para um dispatcher do IBM Cognos BI para processamento

Camada 1: Servidor web

Camada 2: Aplicativos

Studios IBM Cognos BIPowerPlay Studio

Componentes donível do aplicativo do IBM Cognos BI com dispatcher e Content Manager

interfaces com o usuário do IBM Cognos BI

Camada 3: Dados

Gateways do IBM Cognos BI

Firewall de Rede

Firewall de Rede

Firewall de Rede

JDBC

Armazenamentode conteúdo

API

Bancos de dados de consulta para outros studios do IBM Cognos BI

Cubos

Figura 1. Arquitetura do IBM Cognos BI

8 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 17: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Aplicativos, dispatchers e Content Manager

Embora o IBM Cognos Series 7 use grupos de servidores, o IBM Cognos BI usauma camada do aplicativo.

A camada de aplicativo do IBM Cognos BI inclui:v um ou mais servidores IBM Cognos BI que estão executando um dispatcher.

O dispatcher do IBM Cognos BI inicia todos os serviços do IBM Cognos BIconfigurados e ativados em um computador, incluindo o serviço PowerPlay e oserviço de migração. O dispatcher redireciona as solicitações para o serviçoapropriado para processamento. Se houver mais de um computador doscomponentes da camada de aplicativos em seu ambiente, o dispatcher tambémpoderá redirecionar solicitações para outro dispatcher para executar determinadasolicitação. As solicitações podem ser redirecionadas para dispatchers específicoscom base em necessidades de balanceamento de carga ou requisitos de pacoteou grupos de usuário.Ao configurar um gateway do IBM Cognos BI, você deve fornecer o universalresource identifier (URI) de pelo menos um computador do IBM Cognos BIApplication Tier Component que está executando um dispatcher. Também épossível listar outros computadores da camada de aplicativo do ambiente naordem inversa de preferência. As solicitações serão enviadas ao primeirodispatcher da lista. Se houver falha nesse dispatcher, as solicitações serãoredirecionadas para o próximo dispatcher da lista. O status do primeirodispatcher é monitorado pelo gateway e as solicitações são redirecionadas devolta para o dispatcher quando o mesmo volta a operar.Quando um dispatcher é iniciado, o registro é feito com o Content Manager.Como consequência, cada dispatcher sabe dos outros dispatchers do ambiente.Se um dispatcher falhar ou ficar indisponível, as solicitações serãoredirecionadas para outros dispatchers até que o dispatcher com falha se registrenovamente com o Content Manager.

v Content Manager, o componente que gerencia o armazenamento de conteúdo doIBM Cognos BI. O Content Manager também é usado para publicar modelos erelatórios, recuperar ou armazenar especificações de relatório e gerenciarinformações de programação.O Content Manager também contém o Access Manager, o componente desegurança principal. Ao contrário do IBM Cognos Series 7 Access Manager, oIBM Cognos BI Access Manager otimiza o provedor de segurança existente parafornecer segurança para o conteúdo do IBM Cognos BI. O IBM Cognos BIAccess Manager usa um conjunto consistente de recursos de segurança e APIs,incluindo autenticação do usuário, autorização e criptografia. Ele tambémfornece suporte para o namespace IBM Cognos, que controla recursos do usuárioe define os usuários, grupos e funções usadas no IBM Cognos BI. O IBM CognosBI não requer um namespace IBM Cognos Series 7, no entanto, é possível usarum namespace IBM Cognos Series 7 como seu provedor de autenticação.

Armazenamento de Conteúdo

O Content Manager armazena informações em um banco de dados dearmazenamento de conteúdo, localizado geralmente na camada de dados daarquitetura do IBM Cognos BI. O armazenamento de conteúdo é um banco dedados relacional em que o conteúdo do IBM Cognos BI, informações de conexãode origens de dados, incluindo PowerCubes do IBM Cognos e recursos do usuário,são mantidos.

Capítulo 3. O Que é Diferente no IBM Cognos PowerPlay? 9

Page 18: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Portais webO portal da Web do IBM Cognos Business Intelligence é o IBM CognosConnection. O IBM Cognos Connection substitui o Upfront e o Índice doPowerPlay Web como o portal para acessar relatórios do PowerPlay.

Além de ser o portal para relatórios publicados, o IBM Cognos Connection forneceacesso a pacotes usados para construir novos relatórios, a outros studios do IBMCognos BI e ao IBM Cognos Administration, que permite que os administradoresdefinam opções de configuração para os servidores IBM Cognos BI e configurempropriedades de cubo e de relatório para o conteúdo do PowerPlay.

O IBM Cognos Administration permite também que você execute o IBM CognosMigration Assistant para mover o conteúdo do IBM Cognos Series 7 PowerPlaypara o IBM Cognos PowerPlay.

Origens de DadosNo IBM Cognos Business Intelligence, PowerCubes é a origem de dados suportadapara o IBM Cognos PowerPlay Studio e o PowerPlay Client. Como outros studiosdo IBM Cognos BI, o PowerPlay Studio acessa uma origem de dados por meio deum pacote. O PowerPlay Client pode abrir os PowerCubes locais diretamente ouacessar os PowerCubes remotos conectando-se a um pacote.

Os administradores criam e gerenciar entradas da origem de dados ao definirconexões com origens de dados específicas, usando o IBM Cognos Administration.Quando um administrador cria uma entrada da origem de dados usando umaconexão a um PowerCube, ele tem a opção de criar um pacote ao mesmo tempo.Opcionalmente, um modelador pode usar a ferramenta de modelagem demetadados do IBM Cognos BI, o Framework Manager, para criar um modelo e, emseguida, criar um pacote. Um modelador pode combinar diferentes origens dedados em um pacote. O PowerPlay Studio e o PowerPlay Client suportam pacotescom base na origem de dados do PowerCube ou pacotes de origens de dadosmistos baseados em uma origem de dados do PowerCube e em outros tipos deorigens de dados, como uma origem de dados relacional. O IBM CognosPowerPlay Studio e o IBM Cognos PowerPlay Client não suportam pacotes criadosa partir de origens de dados relacionais ou origens de dados OLAP diferentes dosPowerCubes.

Normalmente, uma entrada da origem de dados usa somente uma conexão deorigem de dados. Um administrador pode definir uma entrada de origem dedados que inclua mais de uma conexão de origem de dados. Por exemplo: oadministrador cria uma nova entrada de origem de dados chamada Vendas GA. Oadministrador inclui duas conexões de origem de dados em Vendas GA, uma paraGO_Sales_East.mdc e uma para GO_Sales_West.mdc, e cria um pacote do VendasGA. Quando um usuário do PowerPlay Studio ou do PowerPlay Client abrir opacote Vendas GA, ele será solicitado a selecionar GO_Sales_West ouGO_Sales_East.

É possível usar os PowerCubes criados no IBM Cognos Series 7 ou no IBM CognosBI Transformer. Alguns recursos do IBM Cognos Series 7 PowerCube não sãosuportados no IBM Cognos BI PowerPlay. Por exemplo, os PowerCubescompactados não são uma origem de dados suportada no IBM Cognos BI.

10 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 19: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

SegurançaNo IBM Cognos Series 7, os administradores designam um usuário a classes deusuários a partir de um namespace como parte da infraestrutura de segurança. Aclasse de usuário determina a visualização do usuário dos dados do cubo.

A segurança do IBM Cognos Business Intelligence é diferente do IBM CognosSeries 7. Os administradores do IBM Cognos BI designam recursos a usuários,grupos e funções para permitir a execução de ações, como leitura ou gravação, emobjetos de armazenamento de conteúdo, como pastas e relatórios. As informaçõesde usuários, como nomes de usuário e senhas, são mantidas usando o provedor deautenticação e os administradores do IBM Cognos BI designam funções aosusuários e grupos em seu namespace no namespace do IBM Cognos BI. Para obterinformações adicionais sobre segurança, consulte o Guia de Administração eSegurança do IBM Cognos.

A segurança do IBM Cognos BI permite também o uso de mais de um namespacepara sua segurança. Quando os usuários efetuam login, solicita-se que escolhamum namespace. Os recursos dos usuários poderão ser diferentes para cadanamespace.

O IBM Cognos BI pode usar o namespace existente do IBM Cognos Series 7,entretanto, será necessário continuar a usar o IBM Cognos Series 7 Access Managerpara administrar o namespace.

As informações de segurança do conteúdo do PowerPlay serão mantidas quandovocê migrar para o IBM Cognos BI. Somente usuários e classes com referência nosNewsBoxes e NewsItems sendo migrados são migrados. Os cubos protegidos porsenha permanecerão protegidos por senha. Se você usar segurança de classe deusuários nos cubos, a segurança será mantida e será necessário continuar a usar onamespace do IBM Cognos Series 7 em seu ambiente do IBM Cognos BI.

Observe que a migração de informações de segurança é opcional quando vocêmigra para o IBM Cognos BI.

No IBM Cognos PowerPlay, não é possível acessar uma senha de cubo que estejaarmazenada no IBM Cognos Series 7 Access Manager. Um administrador deveincluir a senha de cubo na conexão da origem de dados no IBM CognosAdministration. Além disso, não é possível abrir cubos locais que estejamprotegidos contra um namespace usando o IBM Cognos PowerPlay Client. Comoalternativa, é possível usar cubos locais protegidos por senha.

Fluxo de solicitaçãoNo IBM Cognos Series 7, as solicitações recebidas são enviadas do gateway para oservidor PowerPlay e do servidor PowerPlay para um processador de consultas.Na configuração padrão, o processador de consultas envia a resposta diretamentepara o gateway, ignorando o servidor PowerPlay.

Para fazer isso, o gateway aguarda conexões em um soquete de servidor e oprocessador abre a conexão do soquete de volta para o gateway. Isso requer portasde saída abertas em firewalls entre a camada web e os componentes da camada deaplicativos. No IBM Cognos Business Intelligence, as respostas sempre voltam pelamesma conexão do soquete pela qual a solicitação foi recebida. Isso equivale aativar a opção de configuração de restringir a porta de saída no IBM CognosSeries 7.

Capítulo 3. O Que é Diferente no IBM Cognos PowerPlay? 11

Page 20: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Serviço de migraçãoMigração é um serviço na arquitetura orientada a serviços do IBM CognosBusiness Intelligence. O serviço de migração migra conteúdo do PowerPlay do IBMCognos Series 7 para o IBM Cognos PowerPlay. O serviço de migração migratambém relatórios do PowerPlay para uma especificação de relatório do IBMCognos BI quando o usuário abre o relatório no Report Studio ou no AnalysisStudio. O serviço de migração usa o mesmo planejamento, criação de log e outrosrecursos que todos os outros serviços do IBM Cognos BI usam. Há recursos doIBM Cognos BI que os administradores podem usar para restringir os usuários quepodem migrar relatórios.

Nota: Há dois serviços de migração; um é um serviço do IBM Cognos Series 7 e ooutro é um serviço do IBM Cognos BI. Os dois serviços devem ser iniciados antesda migração do conteúdo do IBM Cognos Series 7 PowerPlay Enterprise Server. Oserviço do IBM Cognos Series 7 não será necessário se você estiver migrandorelatórios do PowerPlay publicados no IBM Cognos Connection para o ReportStudio ou o Analysis Studio. O serviço de migração do IBM Cognos Series 7 éiniciado no gerenciador do Microsoft Windows Services ou no sistema operacionalUNIX usando o comando ./configure.sh --start. O serviço de migração do IBMCognos BI é executado por um dispatcher do IBM Cognos BI e é iniciadoautomaticamente ao iniciar o serviço do IBM Cognos BI.

PowerPlay StudioO IBM Cognos PowerPlay Studio permite visualizar, explorar e distribuir relatóriosdo PowerPlay usando seu navegador da Web, da mesma maneira que o IBMCognos Series 7 PowerPlay Web.

Você acessa o PowerPlay Studio a partir do IBM Cognos Connection, o portal doIBM Cognos Business Intelligence. Ao abrir o PowerPlay Studio o IBM CognosConnection será substituído no navegador da Web. Esse comportamento ésemelhante a abrir um relatório do PowerPlay do Upfront no IBM Cognos Series 7.Não é possível configurar o PowerPlay Studio para ser aberto em uma nova janela.

Embora a experiência do usuário seja bastante familiar para os usuários doPowerPlay Web, há algumas diferenças no PowerPlay Studio.

Interface com o Usuário do IBM Cognos BI

A aparência padrão da interface do PowerPlay Studio é consistente com os outrosstudios do IBM Cognos BI. Comparado com o PowerPlay Web, há diferenças nascores, fontes e ícones usados na interface, bem como na aparência de saídas PDF,XLS e HTML. O administrador do PowerPlay pode alterar a configuração parausar tipos de interfaces alternativos que preservam a aparência do IBM CognosSeries 7.

A maioria das opções de menu e mensagens do aplicativo permanece igual às doIBM Cognos Series 7 PowerPlay Web. Como no IBM Cognos Series 7, oadministrador pode configurar o tipo de interface no IBM Cognos Administration.

Origens de dados suportadas

Os PowerCubes são a única origem de dados suportada pelo IBM CognosPowerPlay.

12 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 21: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Diferentemente do IBM Cognos Series 7, no IBM Cognos BI, os autores do relatórionão se conectam diretamente a um PowerCube. Ao invés disso, eles se conectam aum pacote que os administradores ou modeladores criam utilizando uma conexãode origem de dados para o PowerCube. Todos os studios do IBM Cognos BIacessam origens de dados por meio de pacotes.

Depois de iniciar o PowerPlay Studio, um usuário pode ver todos os pacotesdisponíveis no Cognos Connection. Entretanto, o usuário não pode selecionarpacotes que não sejam suportados para uso no PowerPlay Studio.

Agentes e notificações

No IBM Cognos BI, o Event Studio fornece a funcionalidade de agente enotificação, que é semelhante à oferecida pelo IBM Cognos NoticeCast no IBMCognos Series 7. Entretanto, eles são gerenciados de forma diferente no IBMCognos BI e o PowerPlay Studio não inclui comandos ou botões de barra deferramentas para agentes ou notificações. Além disso, o PowerPlay Studio Viewernão suporta os itens de observação do IBM Cognos BI.

A integração do Event Studio para relatórios do PowerPlay não suporta relatórioscriados usando pacotes que usam mais de uma conexão de origem de dados ourelatórios criados usando uma origem de dados do PowerCube protegida porsenha. Para os relatórios do PowerPlay que usam um pacote protegido, você deveefetuar logon com as credenciais apropriadas antes de iniciar o Event Studio ouexecutar agentes do Event Studio.

Drill through

O IBM Cognos BI inclui um serviço de drill-through que é usado por todos osstudios do IBM Cognos BI. Ao clicar no botão de drill-through no PowerPlayStudiov se apenas um destino de drill-through estiver disponível, o relatório ou o pacote

de destino se abriráv se mais de um destino de drill-through estiver disponível, será exibida uma lista

de destinos de drill-through a serem escolhidos.

Tanto no IBM Cognos Series 7 quanto no IBM Cognos BI, um modelador podedefinir drill through em um cubo usando o Transformer, com qualquerconfiguração adicional configurada na ferramenta de administração. Além disso, sevocê migrar o conteúdo do IBM Cognos Series 7 para o IBM Cognos BI, qualquerconfiguração de drill through definida no PowerPlay Enterprise Server para oscubos ou relatórios será migrada para o IBM Cognos BI.

No IBM Cognos BI, é possível criar definições de drill through baseadas empacotes no menu Iniciar no IBM Cognos Connection. Com este tipo de drillthrough, não será necessário reconstruir o cubo e nem incluir ou alterar os destinosde drill through.

Reparação de erros

Quando ocorrerem erros no IBM Cognos BI, será exibida uma caixa de diálogo queinclui um botão Detalhes e um rastreamento detalhado. As informações detalhadase o rastreamento estarão disponíveis para erros do IBM Cognos PowerPlay.

Capítulo 3. O Que é Diferente no IBM Cognos PowerPlay? 13

Page 22: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Nome de arquivo do cubo no título do relatório

No IBM Cognos PowerPlay Studio, o nome especificado na propriedade de nomedo PowerCube no Transformer é usado ao inserir o Nome do Arquivo de Cubo notítulo do relatório. No IBM Cognos Series 7, o Nome do Arquivo de Cubobaseia-se no nome que foi configurado quando o cubo foi inserido no PowerPlayEnterprise - Administração do Servidor.

Visualização de relatórios em PDF

Por razões de coerência com outros studios do IBM Cognos BI, o Cognos Viewerexibe relatórios do PowerPlay no formato PDF. Nos relatórios do PowerPlay, oCognos Viewer inclui ferramentas semelhantes quando comparado com o IBMCognos Series 7 PowerPlay Web Viewer. Por exemplo, um usuário pode optar porabrir o relatório no PowerPlay Studio para exploração futura.

O administrador pode alterar a configuração do visualizador de relatório padrãode Cognos Viewer para PowerPlay Studio Report Viewer para fornecer umvisualizador de relatórios semelhante ao IBM Cognos Series 7 PowerPlay WebViewer.

As opções Salvar e Salvar como não estão disponíveis para relatórios doPowerPlay em qualquer visualizador de relatórios.

Codificação para exportação no formato CSV

No IBM Cognos Series 7, exportar para o formato de arquivo .csv usava acodificação nativa do servidor.

No PowerPlay Studio, exportar para o formato de arquivo .csv usa a codificaçãoUTF-16, que é consistente com o comportamento existente do IBM Cognos BI.

Renderização para exportar no formato XLS

No IBM Cognos Series 7 PowerPlay Web, ao exportar um relatório para o formatode arquivo .xls e optar por abrir o arquivo, ele é aberto em uma janela de softwarede planilha Microsoft Excel.

No IBM Cognos PowerPlay Studio, ao exportar um relatório para o formato dearquivo .xls e optar por abrir o arquivo, ele é aberto em uma janela do navegadorMicrosoft Excel. Abrir o arquivo em uma janela do navegador é consistente comexportar de outros studios do IBM Cognos BI.

PowerPlay ClientO IBM Cognos PowerPlay permite visualizar, explorar, formatar e distribuirrelatórios do PowerPlay, da mesma maneira que o IBM Cognos Series 7PowerPlay.

As informações a seguir descrevem as diferenças no PowerPlay entre o IBMCognos Business Intelligence e o IBM Cognos Series 7.

Origens de dados suportadas

Os PowerCubes são a única origem de dados OLAP suportada pelo IBM CognosPowerPlay. Os PowerCubes compactados não são suportados. É possível abrir os

14 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 23: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

PowerCubes diretamente, assim como acontece no IBM Cognos Series 7. Paraacessar dados em um PowerCube remoto, conecte-se a um pacote criado pelosadministradores ou modeladores usando uma conexão de origem de dados aoPowerCube.

Abrindo Relatórios do IBM Cognos Portal

No IBM Cognos Series 7, várias opções de execução estão disponíveis pararelatórios do PowerPlay publicados no Upfront. A opção Executar Relatório noWindows abre o relatório no PowerPlay Client. Para usar essa opção, deve-se ter oPowerPlay Client instalado no computador e o administrador precisa ativar aopção de execução.

No IBM Cognos BI, as opções de execução no Cognos Connection para umrelatório do PowerPlay não incluem a opção de abertura do relatório no PowerPlayClient. Entretanto, é possível abrir os relatórios remotos diretamente no PowerPlayClient. Após ter aberto e modificado um relatório remoto, será possível tambémsubstituir o relatório já existente no portal para disponibilizar as atualizaçõesdisponíveis para todos os usuários ou publicar um novo relatório.

Formato PowerPlay Report (.PPR)

Os relatórios do IBM Cognos Series 7 PowerPlay no formato .ppr devem primeiroser convertidos no formato .ppx para usar o relatório no IBM Cognos PowerPlay. Ainstalação do IBM Cognos PowerPlay Client inclui uma macro que converterelatórios do formato .ppr em .ppx.

Publicação de relatórios como HTML

No IBM Cognos Series 7 PowerPlay Client, é possível salvar relatórios localmenteno formato HTML para que os usuários possam visualizar esses relatórios em umnavegador da Web sem instalar o PowerPlay.

O IBM Cognos PowerPlay não inclui uma funcionalidade equivalente à opção depublicar como HTML.

Acesso offline aos dados

É possível trabalhar offline no IBM Cognos PowerPlay Client usando PowerCubeslocais desprotegidos ou protegidos por senha (arquivos .mdc). Além disso, épossível trabalhar offline com um relatório do PowerPlay, salvando-o como umsubcubo. Essa opção é útil se não for possível obter uma cópia do cubo original, seo cubo original for muito grande e possuir mais dados do que os necessários paratrabalhar offline ou se o cubo original for protegido por um namespace. Para obterinformações adicionais sobre como criar e trabalhar com subcubos, consulte o Guiado Usuário do IBM Cognos PowerPlay Client.

Se a segurança for necessária para cubos locais, recomenda-se o uso da proteçãopor senha.

O PowerPlay Connect Não é Mais Usado

No IBM Cognos Series 7 PowerPlay, você usava o PowerPlay Connect parafornecer acesso a outros cubos OLAP especificando informações de servidor e debanco de dados necessárias para acessar dados em um banco de dados do servidorOLAP.

Capítulo 3. O Que é Diferente no IBM Cognos PowerPlay? 15

Page 24: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

No IBM Cognos BI, o IBM Cognos Administration ou o Framework Manager éusado para criar conexões de origens de dados para os PowerCubes.

Nome do arquivo MDC em títulos, cabeçalhos e rodapés

No IBM Cognos PowerPlay, o nome especificado na propriedade de nome doPowerCube no Transformer é usado ao inserir o Nome do Arquivo MDC em umtítulo, cabeçalho ou rodapé.

No IBM Cognos Series 7, ao trabalhar com um cubo remoto, o Nome do ArquivoMDC baseia-se no nome que foi configurado quando o cubo foi inserido noPowerPlay Enterprise Server Administration. Para cubos locais, o nome do arquivoMDC é o nome do arquivo de cubo sem a extensão .mdc.

Trabalho com dados protegidos por namespaces diferentes

O IBM Cognos PowerPlay Client inclui novas opções no menu Arquivo: EfetuarLogon e Efetuar Logoff. Se os pacotes forem protegidos usando namespacesdiferentes, será necessário efetuar logon em cada namespace separadamente. Aoselecionar Logoff ou Efetuar logon, será exibido um prompt perguntando se desejasalvar os relatórios abertos pois as credenciais de segurança serão alteradas.

Tipos de gráfico suportados

No IBM Cognos Series 7, é possível usar tipos de arquivos .bmp ou .wmf aoinserir uma imagem em uma exibição, por exemplo, em um título.

O IBM Cognos PowerPlay não suporta o tipo de gráfico .wmf. Se você usargráficos .wmf no IBM Cognos Series 7, converta-os em um formato suportado parauso no IBM Cognos BI: .bmp, .gif, .jpg ou .png.

Comunicação com gateways e servidores

No IBM Cognos Series 7, é possível conectar-se a vários servidores diferentes, poiso PowerPlay Client se comunica com o dispatcher. Você inclui conexões aosdispatchers do PowerPlay Enterprise Server especificando o nome do computadordo dispatcher e a porta que ele usa para atender às solicitações de cada conexão.

No IBM Cognos BI, é possível configurar o PowerPlay Client para apontar paraapenas um gateway.

Instalação e configuraçãoA instalação e configuração do IBM Cognos PowerPlay aproveita os recursos doIBM Cognos Business Intelligence, incluindo os programas de instalaçãomultilíngue e as ferramentas do IBM Cognos BI.

Instalação multilíngue

No IBM Cognos BI, os componentes do servidor são multilíngues e o produtoinstalado é fornecido em todos os idiomas suportados. Isso permite que osusuários alterem o idioma no portal do IBM Cognos BI.

O IBM Cognos PowerPlay Client instala apenas um idioma e os usuários sãosolicitados a selecionar um idioma ao instalá-lo.

16 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 25: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Configuração do PowerPlay Studio

É possível configurar propriedades de cubo e relatório para o PowerPlay Studiousando a guia PowerPlay no IBM Cognos Administration.

Logon Comum do Windows

No IBM Cognos Series 7, o Servidor de Logon Comum do Windows retéminformações de conexão para que os usuários possam mover-se com maisfacilidade entre os produtos e componentes do IBM Cognos no Windows. Essecomponente se integra ao Access Manager.

O Servidor de Logon Comum do Windowsnão é usado no IBM Cognos BI. O IBMCognos BI é baseado em sua maior parte na Web e usa um passaporte parasessões. Os usuários são solicitados a efetuar logon quando seu passaporte expiraou para mover entre aplicativos cliente do Windows, como o PowerPlay Client e oFramework Manager.

Instalação e configuração de amostras

A instalação de Amostras do IBM Cognos BI inclui PowerCubes e relatórios quepodem ser usados para ajudá-lo a entender algumas das diferenças entre o IBMCognos Series 7 PowerPlay e o IBM Cognos PowerPlay.

Para obter informações adicionais sobre como configurar as amostras, consulte oGuia de Instalação e Configuração do IBM Cognos PowerPlay.

O relatório Configurações de Impressão não é mais necessário no IBM CognosPowerPlay.

Configurações de CGI

No IBM Cognos Series 7 versão 4, os administradores podem alterar asconfigurações referentes ao método de acesso a arquivos temporários usando apropriedade a seguir no IBM Cognos Series 7 Configuration Manager:

PowerPlay Enterprise Server.Gateway.General.Temporary File Access

A propriedade pode ser configurada como um dos três modos: Compartilhado,CGI e Obtenção/Dispatcher.

O IBM Cognos BI não inclui uma opção de configuração equivalente para oPowerPlay. O comportamento no IBM Cognos BI é comparável ao modoObtenção/Dispatcher, que é mais seguro do que o modo Compartilhado.

Administração do PowerPlayNo IBM Cognos Series 7, os administradores usam o PowerPlay Enterprise ServerAdministration para especificar configurações de tempo de execução. No IBMCognos Business Intelligence, os administradores gerenciam configurações detempo de execução, incluindo configurações do PowerPlay, no IBM CognosAdministration. O IBM Cognos Administration fornece aos administradores acessoconveniente a todas as configurações de tempo de execução no mesmo local.

Muitas configurações do IBM Cognos BI para PowerPlay serão conhecidas dosadministradores do IBM Cognos Series 7 PowerPlay. Por exemplo: as opções de

Capítulo 3. O Que é Diferente no IBM Cognos PowerPlay? 17

Page 26: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

interface genérica e melhoradas estão disponíveis. Além disso, é possível tambémescolher os botões da barra de ferramentas que ficarão visíveis aos usuários e osdestinos de drill through do IBM Cognos Series 7 que estarão disponíveis.

Substituição ou atualização de cubos

Se estiver usando o IBM Cognos Transformer, versão 8.4 ou posterior, será possívelatualizar os PowerCubes usando novos recursos de implementação sem precisarreiniciar os serviços, desativar cubos ou usar scripts. Se estiver usando osPowerCubes do IBM Cognos Series 7 no IBM Cognos BI, também será possívelaproveitar os novos recursos de implementação usando um utilitário chamadopcactivate.

Para obter informações adicionais sobre como atualizar cubos, consulte o Guia deAdministração e Segurança do IBM Cognos BI ou o Guia do Usuário do IBM CognosTransformer.

Balanceamento de carga

No IBM Cognos Series 7 PowerPlay Enterprise Server, é possível incluir referênciasespelho para distribuir a carga de processamento. No IBM Cognos BI, é possívelespecificar regras de roteamento para direcionar solicitações a dispatchers emgrupos de servidores identificados. As regras de roteamento podem ser definidaspor pacote, grupo de usuário ou função de usuário.

No IBM Cognos BI, se sua instalação incluir mais de um dispatcher, será possívelespecificar a proporção de solicitações que cada dispatcher tratará alterando suacapacidade de processamento. Também será possível configurar o número deconexões de cliente para balancear a carga do servidor.

Gerenciamento da acessibilidade aos dados compartilhados

Em um ambiente com diversos servidores IBM Cognos Series 7, você gerencia aacessibilidade a partir de diversos locais para os dados compartilhados usandoMontar em. No IBM Cognos BI, o gerenciamento de conteúdo é simplificado, poistodo o conteúdo é armazenado em um armazenamento de conteúdo central.

Organização do conteúdo

No PowerPlay Enterprise Server, você organiza e administra grupos de cubos erelatórios usando pastas e coleções. O uso de pastas e coleções permite a mudançadas configurações de todos os objetos descendentes a partir de uma única caixa dediálogo. O IBM Cognos BI usa pastas e pacotes em Pastas Públicas, Minhas Pastasou em Minhas Páginas para organizar o conteúdo. É possível substituir asconfigurações herdadas de um objeto-pai. O IBM Cognos BI não usa Coleções.

Configurações de controle de processos

No IBM Cognos Series 7, as configurações de grupo de controle de processopodem ser diferentes para cada servidor do PowerPlay. No IBM CognosPowerPlay, as configurações de cubo e relatório são armazenadas noarmazenamento de conteúdo e gerenciadas pelo Content Manager. Como resultado,as configurações se aplicam a todas as instâncias do servidor PowerPlay. Alémdisso, no IBM Cognos BI é possível configurar o dispatcher para controlar onúmero de encadeamentos de afinidade superior e inferior, que controlam quantassolicitações simultâneas são tratadas para cada processo de servidor.

18 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 27: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Configurações de impressão

No IBM Cognos Series 7, os usuários podem imprimir relatórios do PowerPlayWeb Explorer exportando o relatório para um PDF e, em seguida, imprimindo oPDF. As configurações do PDF exportado são determinadas pelas configuraçõesaplicadas ao relatório Configurações de Impressão na raiz da hierarquia do Índiceno PowerPlay Enterprise - Administração do Servidor. Por exemplo: se a orientaçãode página paisagem for configurada no relatório Configurações de impressão,todos os relatórios exportados para PDF usarão a orientação de paisagem.

No IBM Cognos Power Play, você define as configurações de impressão na guiaPowerPlay no IBM Cognos Administration.

Visualização da especificação do relatório

No IBM Cognos Series 7 PowerPlay, para visualizar a especificação do relatóriopara depuração ou outros diagnósticos, um administrador deve extrair aespecificação do relatório manualmente do arquivo .ppx.

O PowerPlay Studio, como outros studios do IBM Cognos Business Intelligence,inclui uma opção para visualizar a especificação do relatório. A especificação derelatório em formato XML aparece em uma janela independente do navegador.Para visualizar a especificação do relatório, no PowerPlay Studio, clique no botãoArquivo e clique em Mostrar Especificação.

Propriedades do servidorAs informações a seguir descrevem propriedades do servidor do IBM CognosSeries 7 PowerPlay Enterprise Server Administration que não têm umaconfiguração equivalente ou são gerenciadas de forma diferente no IBMCognos Business Intelligence.

As seguintes propriedades do servidor do grupo Opções na guia Configuraçõesnão têm uma configuração equivalente no IBM Cognos BI.v Local do recurso (/ppwb)

v Pasta de relatórios importados

v Caixa de diálogo de segurança

v Endereço de e-mail do administrador

v Seleção de preferências

v Buscar arquivos

v Índice

v Caminho de fontes

As seguintes propriedades do servidor do grupo Opções na guia Configuraçõessão gerenciadas de forma diferente no IBM Cognos BI.

Tabela 1. Propriedades de Servidor: Grupo de Opções

PowerPlay Enterprise -Administração do Servidor IBM Cognos BI

Local de arquivos temporários Configurado no IBM Cognos Configuration no grupode propriedades Ambiente.

Capítulo 3. O Que é Diferente no IBM Cognos PowerPlay? 19

Page 28: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Tabela 1. Propriedades de Servidor: Grupo de Opções (continuação)

PowerPlay Enterprise -Administração do Servidor IBM Cognos BI

Nível de auditoria Os níveis de criação de log são configurados no IBMCognos Administration, mas a auditoria do PowerPlaytambém pode ser usada.

Restringir o Máximo de Conexõesdo Cliente

Configure o número de conexões de baixa e altaafinidades para o serviço do PowerPlay com umaconfiguração avançada para o serviço do PowerPlay.

Restringir Tempo Limite Inativoda Conexão (min)

Configure o limite de tempo na fila do serviço doPowerPlay com uma configuração avançada para oserviço do PowerPlay.

Prompt para a Classe do Usuário Os grupos e as funções do IBM Cognos BI são usadospara autenticação e autorização.

Silenciar Comutador da Classe deUsuário

Os grupos e as funções do IBM Cognos BI são usadospara autenticação e autorização.

Compilação Dinâmica de Folhasde Estilo

Configuração avançada para o serviço do PowerPlay.

A propriedade do servidor Local dos arquivos de auditoria do grupo Gerador deRegistros da Auditoria na guia Configurações não tem uma configuraçãoequivalente no IBM Cognos BI. O IBM Cognos BI usa uma combinação de criaçãode log do IBM Cognos BI e do IBM Cognos Series 7 PowerPlay.

As seguintes propriedades do servidor nos grupos Gerador de Log de Auditoria ePowerPlay Web Viewer na guia Configurações são gerenciadas de forma diferenteno IBM Cognos BI.

Tabela 2. Propriedades de Servidor: Grupos de Gerador de Log de Auditoria e Visualizadorda Web do PowerPlay

PowerPlay Enterprise -Administração do Servidor IBM Cognos BI

Tamanho máximo de cadaarquivo em kiloBytes (kB)

Configuração avançada para o serviço do PowerPlay.

Intervalo de exclusão de arquivostemporários (dias)

Configuração avançada para o serviço do PowerPlay.

As seguintes propriedades do servidor do grupo Publicação na guiaConfigurações são gerenciadas de forma diferente no IBM Cognos BI.

Tabela 3. Propriedades de Servidor: Grupo de Publicação

PowerPlay Enterprise -Administração do Servidor IBM Cognos BI

Portal padrão O IBM Cognos Connection e o portal do IBMCognos BI.

URI do Gateway do IBM CognosReportNet/IBM Cognos 8

Configurado no IBM Cognos Configuration no grupode propriedades Ambiente.

20 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 29: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Tabela 3. Propriedades de Servidor: Grupo de Publicação (continuação)

PowerPlay Enterprise -Administração do Servidor IBM Cognos BI

URI do Dispatcher do IBMCognos ReportNet/IBM Cognos 8

Configurado no IBM Cognos Configuration no grupode propriedades Ambiente.

Conceitos relacionados:Capítulo 7, “Configuração de criação de log”, na página 85As mensagens de log do IBM Cognos Business Intelligence fornecem informaçõessobre os status de componentes, incluindo a atividade do PowerPlay e umavisualização de alto nível de eventos importantes.Tarefas relacionadas:“Definir Configurações Avançadas” na página 34Defina configurações avançadas para o IBM Cognos PowerPlay service in IBMCognos Administration.

Propriedades das pastasAs pastas no IBM Cognos Series 7 e no IBM Cognos Business Intelligence sãousadas para organizar e administrar objetos relacionados em uma hierarquia.

As informações a seguir descrevem as Propriedades da Pasta a partir do IBMCognos Series 7 PowerPlay Enterprise Server Administration que não têm umaconfiguração equivalente ou são gerenciadas de forma diferente no IBMCognos BI.

As propriedades Montar em e Pai da guia Geral não têm uma configuraçãoequivalente no IBM Cognos BI. Todos os dados do aplicativo IBM Cognos BI sãoarmazenados no armazenamento de conteúdo e gerenciados pelo serviço ContentManager.

As seguintes propriedades na guia Geral são gerenciadas de forma diferente noIBM Cognos BI.

Tabela 4. Propriedades da Pasta: Guia Geral

PowerPlay Enterprise -Administração do Servidor IBM Cognos BI

Nome e DescriçãoAparecem nas propriedades do pacote do IBMCognos BI ou no relatório no IBM Cognos Connection

Origem da Pasta Armazenada no armazenamento de conteúdo.

Referências Espelho da Pasta O IBM Cognos BI usa regras de roteamento,capacidade de processamento para dispatchers econfigurações de conexão de afinidade para obalanceamento de carga. Para obter informaçõesadicionais, consulte o Guia de administração e segurança.

As propriedades a seguir na guia Configurações não têm uma configuraçãoequivalente no IBM Cognos BI.v Compartilhamento

v Grupo de Servidores do Upfront

v Modelo de Publicação do Upfront

Capítulo 3. O Que é Diferente no IBM Cognos PowerPlay? 21

Page 30: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

v NewsBox do Upfront para Cubos

v NewsBox do Upfront para Relatórios

As propriedades a seguir na guia Configurações são gerenciadas de formadiferente no IBM Cognos BI.v Pasta Cognos ReportNet/Cognos BI para Cubos

v Pasta Cognos ReportNet/Cognos BI para relatórios

Ao criar um pacote a partir da origem de dados do PowerCube e publicar o pacoteou ao publicar um relatório no IBM Cognos Connection você especifica a pasta emque o pacote ou o relatório é publicado.

Propriedades de cubos e relatóriosAs informações a seguir descrevem as propriedades de cubo e de relatório do IBMCognos Series 7 PowerPlay Enterprise Server Administration que não têm umaconfiguração equivalente ou são gerenciadas de forma diferente no IBMCognos Business Intelligence.

As propriedades Origem do Relatório, Origem do Cubo e Pai na guia Geral nãotêm uma configuração equivalente no IBM Cognos BI. Todos os dados doaplicativo IBM Cognos BI são armazenados no armazenamento de conteúdo egerenciados pelo serviço Content Manager.

As seguintes propriedades na guia Geral são gerenciadas de forma diferente noIBM Cognos BI.

Tabela 5. Propriedades de Cubo e Relatório: Guia Geral

PowerPlay Enterprise -Administração do Servidor IBM Cognos BI

Nome Aparece na página Configurar Propriedades no IBMCognos Connection.

Descrição Aparece na página Configurar Propriedades no IBMCognos Connection.

Referências de espelho O IBM Cognos BI usa regras de roteamento,capacidade de processamento para dispatchers econfigurações de conexão de afinidade para obalanceamento de carga. Para obter mais informações,consulte o Guia de Administração e Segurança

As propriedades a seguir na guia Configurações das Propriedades do Relatórionão têm uma configuração equivalente no IBM Cognos BI.

Tabela 6. Propriedades do Relatório: Guia COnfigurações

PowerPlay Enterprise -Administração do Servidor IBM Cognos BI

Compartilhamento Os relatórios são mantidos no armazenamento deconteúdo.

Envio de relatório página porpágina

O IBM Cognos BI sempre usa envio por bytes.

22 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 31: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Tabela 6. Propriedades do Relatório: Guia COnfigurações (continuação)

PowerPlay Enterprise -Administração do Servidor IBM Cognos BI

Explorar no formato Windows Os usuários do IBM Cognos PowerPlay Client podemabrir relatórios remotos

As propriedades de Publicação na guia Configurações não têm configuraçõesequivalentes no IBM Cognos BI.

Acesso drill-throughO acesso drill through no IBM Cognos Business Intelligence é diferente do IBMCognos Series 7.Tarefas relacionadas:“Ativação do drill through” na página 39É possível controlar as opções de drill through para o conteúdo do IBM CognosBusiness Intelligence e do IBM Cognos Series 7.

Entendendo o Acesso Drill-through no IBM Cognos BIO acesso drill-through ajuda na construção de aplicativos de inteligência denegócios maiores que um simples relatório. Aplicativos de drill-through são umarede de relatórios e pacotes vinculados pelos quais os usuários podem navegar,retendo seu contexto e foco, para explorar e analisar as informações.

Para obter informações adicionais sobre o acesso drill-through no IBM CognosBusiness Intelligence, incluindo exemplos de cenários diferentes de drill-through,procedimentos para a configuração do acesso drill-through e orientação para adepuração de uma configuração de drill-through, consulte o Guia de Administração eSegurança do IBM Cognos BI.

O que é preciso saber

Para que um link drill-through funcione, é necessário saber:v qual será o relatório ou objeto de origemv qual será o relatório ou objeto de destinov como os dados se relacionam nos pacotes que contêm esses objetos

Dependendo dos dados subjacentes, pode ser criada uma configuração dedrill-through e fazer com que o IBM Cognos BI corresponda os dados (drillthrough dinâmico) ou crie parâmetros no relatório ou pacote de destino (drillthrough parametrizado). O PowerPlay Studio suporta acesso drill-throughdinâmico.

v se o relatório de destino será executado ou abertoO destino do acesso drill-through geralmente é uma configuração de relatóriosalvo. O relatório pode ser criado no Report Studio, Query Studio, PowerPlayStudio ou Analysis Studio. O destino do acesso drill-through também pode serum pacote que contenha um PowerCube. Nesse caso, será criada umavisualização padrão do PowerCube.

v se os usuários do link de drill-through no relatório de origem têm as permissõesapropriadas para visualizar ou executar o relatório de destino

v se o destino estiver sendo executado, em que formato ele é executado e comquais filtros ele será executado

Capítulo 3. O Que é Diferente no IBM Cognos PowerPlay? 23

Page 32: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Se não desejar executar o relatório de destino sob solicitação, poderá criar um linkpara um marcador de favorito na saída salva. Para obter informações adicionais,consulte o Guia de Administração e Segurança do IBM Cognos BI.

Origens e destinos

No IBM Cognos BI, há várias combinações diferentes de origem e de destino. Porexemplo: é possível drill throughv entre relatórios criados em pacotes diferentes em oposição a tipos de origens de

dados diferentes, como a partir de análises em oposição a um cubo para umrelatório detalhado em oposição a uma origem de dados relacional.

v a partir de um relatório existente para outro relatório utilizando o Report Studio.v entre relatórios do Cognos Viewer criados no Report Studio, Query Studio,

PowerPlay Studio e Analysis Studiov a partir de cubos do IBM Cognos PowerPlay Web para relatórios do IBM

Cognos BIv do Metric Studio para outros relatórios do IBM Cognos BI transmitindo

parâmetros usando URLs.Para obter informações adicionais, consulte o Guia do usuário do Metric Studio.

Comportamento de Drill-through do IBM Cognos Series 7 e doIBM Cognos BI

No IBM Cognos BI, é possível configurar o acesso drill-through que é muitosemelhante ao IBM Cognos Series 7, usando definições de drill-through dinâmicoem que os nomes de itens de dados são correspondentes. Também é possíveldefinir parâmetros no objeto de destino para controlar os links de drill-throughmais de perto. Em ambos os casos, os dados devem ser adequados e os valorestransmitidos devem ser exclusivos. Os valores não correspondentes sãodescartados. Para obter informações adicionais sobre como configurar links dedrill-through no IBM Cognos BI, consulte o Guia de Administração e de Segurança. Alista a seguir mostra algumas pequenas diferenças:v criação de definições de drill-through

No IBM Cognos Series 7, as definições de drill-through são criadas noPowerCube e ativadas pelo administrador. No IBM Cognos BI PowerPlay, asdefinições de drill-through são criadas no pacote com base em uma origem dedados do PowerCube ou em qualquer outra origem de dados, ou em umrelatório do Report Studio.

v Restrição de acesso.No IBM Cognos Series 7, o uso de links de drill-through é configurado noPowerCube, pelo administrador. É possível continuar a desativar ou ativar odrill-through para origens de dados do PowerCube usando configurações daferramenta de administração do PowerPlay. No Cognos BI, o proprietário ouadministrador de um objeto pode definir se ele está disponível para uso comoum destino ou uma origem de drill-through. Para obter informações adicionais,consulte o Guia do usuário do respectivo studio.Também é possível ocultar um objeto, por exemplo, para que ele fique visívelapenas como destino de drill-through. Como no IBM Cognos Series 7, também épossível configurar o escopo de uma configuração de drill-through para umamedida ou dimensão da origem.

v configuração de parâmetros para destinos de drill-throughNo IBM Cognos Series 7, é possível definir o destino de um link dedrill-through. Quando o drill through é realizado no destino, o sistema

24 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 33: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

corresponde os itens do contexto da origem aos itens disponíveis no destino eutiliza qualquer correspondência para filtrar o destino. Esse tipo de drill-throughtambém está disponível no IBM Cognos BI (acesso de drill-through dinâmico).No Cognos BI, também é possível definir parâmetros no objeto de destino edefinir como eles se conectam aos metadados no objeto de origem, para ter maiscontrole sobre o link de drill-through (acesso de drill-through e parametrizado).

v seleções múltiplasNo IBM Cognos Series 7, é possível selecionar várias categorias de uma ou maisdimensões e usá-las para fazer drill through para um objeto de destino. NoPowerPlay Studio, isso só é possível com definições de drill-throughparametrizadas.

v Disponibilidade de destinos de drill-throughNo IBM Cognos Series 7, o ícone de drill-through ficará desativado se nãohouver nenhuma configuração de drill-through. No IBM Cognos BI, o ícone dedrill-through ficará ativado, a menos que o acesso drill-through tenha sidodesativado pelo administrador ou proprietário do objeto de destino.

v depuração de acesso de drill-throughNo IBM Cognos Series 7, o assistente de drill-through ajudou administradores eautores de drill-through a criarem destinos válidos a partir do PowerPlay pararelatórios do IBM Cognos ReportNet ou do IBM Cognos BI. No IBM Cognos BI,um assistente de drill-through não é necessário para definir o relatório dedestino. Entretanto, é possível utilizar um recurso de depuração para obterinformações sobre os valores que estão sendo transmitidos e sobre asinformações mapeadas entre a origem e o destino. O administrador do IBMCognos BI pode configurar permissões para esse recurso.

Definições de drill-through

As definições de drill-through podem existir em um pacote de origem, no relatóriode origem do Report Studio ou em um PowerCube que foi migrado do IBMCognos Series 7. É necessário considerar o uso do IBM Cognos BI para qualquernovo aplicativo de drill-through, para poder utilizar acesso de drill-throughparametrizado para obter mais controle, criar definições de drill-through que nãoexigem a construção de PowerCubes etc.

As definições de drill-through no PowerCube são gerenciadas na guia PowerPlayno IBM Cognos Administration. Para obter informações adicionais, consulte o Guiade Migração e Administração do IBM Cognos PowerPlay e o Guia do Usuário do IBMCognos Transformer.

Se o link de drill-through foi configurado no IBM Cognos BI, uma configuração dedrill-through deverá estar associada ao relatório ou pacote de origem, e poderá terparâmetros mapeados de uma origem para um destino (drill-throughparametrizado). O autor do Report Studio pode criar uma configuração dedrill-through nos relatórios. Um usuário do IBM Cognos BI pode criar umaconfiguração de drill-through em um pacote no IBM Cognos Connection (Iniciar,Definições de Drill-through), que estará disponível em qualquer relatório dopacote.

Os parâmetros são definidos no relatório de destino quando se desejar controlar afiltragem do item de destino. Quando um mapeamento de parâmetro existe naconfiguração de drill-through, o valor do item de dados não é utilizado paramapeamento. Por exemplo: se houver um valor em Linha de produto e Tipo delinha de produto, os metadados de Linha de produto poderão ser mapeados na

Capítulo 3. O Que é Diferente no IBM Cognos PowerPlay? 25

Page 34: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

origem para um parâmetro criado no destino. Além disso, o escopo poderá serconfigurado para que os relatórios de destino sejam exibidos apenas em pontospredefinidos. Para obter informações adicionais, consulte o Guia do Usuário doReport Studio ou o Guia de Administração e Segurança do IBM Cognos BI.

Exemplo - Como drill through entre pacotes OLAP erelacionais

Você deseja fazer drill through de um relatório do IBM Cognos PowerPlay Studiochamado Margem de Lucro e Receita por País ou Região para um relatório doReport Studio chamado Receita Total por País ou Região.

A configuração de drill through é configurada no pacote, de modo que os detalhesda receita fiquem disponíveis para qualquer relatório no mesmo pacote.

O relatório de margem de lucro é baseado no pacote Vendas e marketing (cubo) eo relatório de destino é baseado no pacote relacional Armazém de Dados da GA(consulta). Portanto, é necessário verificar se os dados correspondem. O relatóriode destino não contém nenhum parâmetro de prompt, então será necessárioconfigurar uma configuração de drill-through usando o drill through dinâmico.Isso significa que quando o link de drill-through for feito, o IBM Cognos BusinessIntelligence corresponderá nomes de itens no contexto da origem com os itensdisponíveis no destino. Para obter informações e exemplos adicionais, consulte oGuia de Administração e Segurança do IBM Cognos Business Intelligence.

Você deve ter as amostras do IBM Cognos BI a partir do arquivo zip deimplementação IBM_Cognos_DrillThroughSamples instaladas para continuar esteexercício. Para verificar o relatório de destino, é necessário ter acesso ao ReportStudio.

Nota: É possível configurar as definições de drill-through sem verificar osrelatórios de destino. Entretanto, se você configurar o acesso de drill-through entrepacotes ou objetos criados em diferentes ferramentas de autoria, deverá estar cientede como os metadados serão correspondidos.

A figura a seguir mostra o relatório de destino com dados para o contexto daorigem, que é Rendas do Plano de Promoção para várias promoções.

26 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 35: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Procedimento1. Abra o relatório de destino, Receita Total por País ou Região:

v Vá para o IBM Cognos Connection.v Em Pastas públicas, navegue até o pacote Armazém de Dados da GA

(consulta) e abra a pasta Amostras de relatório do Report Studio.v Selecione o relatório Receita Total por País ou Região e abra-o no Report

Studio.2. Confirme os nomes dos itens de dados que serão usados para filtrar o

contexto da origem:v No Gerenciador de Páginas, selecione o item do relatório.v Na área de janela Propriedades, verifique o nome da propriedade nome.

O relatório de destino mostra dados para o contexto da origem:Linha de Produto, Região e País.

Figura 2. Relatórios de Origem e Destino para uma Definição de Drill Through

Capítulo 3. O Que é Diferente no IBM Cognos PowerPlay? 27

Page 36: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

v Observe os itens chamados Região, País ou Região do Varejista e Linha deProduto.

3. Feche o relatório de destino.4. Abra o relatório de origem, Margem de Lucro e Receita por País ou Região:

v Vá para o IBM Cognos Connection.v Em Pastas públicas, abra o pacote Vendas e marketing (cubo) e abra a

pasta Amostras de relatório do PowerPlay Studio.v Selecione o relatório Margem de Lucro e Receita por País ou Região e

abra-o no PowerPlay Studio.5. Confira os dados no relatório. (Por exemplo, clique com o botão direito em

um nome de varejista e selecione Explicações para ver a estrutura dos dados.)6. Mantenha o relatório Margem de Lucro e Receita por País ou Região aberto

para teste.7. No IBM Cognos Connection, navegue para o pacote Vendas e Marketing

(Cubo).8. Clique em Ativar, Definições de Drill Through.9. Clique em Novas Definições de Drill Through.

Dica: caso não veja o botão Nova configuração de Drill through, verifique sevocê está na raiz da pasta e não ainda na pasta Amostras de Relatório doPowerPlay Studio.

10. No assistente configuração de Drill Through, digite um nome, como DrillThrough para Receita Total por País ou Região, e uma descrição e clique emAvançar.Dica: Esse é o nome que os usuários verão na página Ir para, por exemplo,quando tiverem de selecionar mais de um destino de drill-through. Assimcomo qualquer outro objeto no IBM Cognos Connection, é possível criartraduções desse nome.

11. Clique em Configurar o Destino, Selecionar um Relatório... e, na tela exibida,configure o relatório de destino para Receita Total por País ou Região napasta Amostras de Relatório do Report Studio do pacote Armazém de Dadosda GA (Consulta) e, em seguida, clique em OK.

12. Clique em Configurar o Escopo e, na tela exibida, configure o escopo para[sales_and_marketing].[Varejistas].[Varejistas].[País ou região do varejista] e,em seguida, clique em OK.

13. Clique em Avançar.No campo Ação, selecione Executar com filtro dinâmico.

14. Deixe todas as outras configurações como os valores padrão e clique emConcluir.

15. Acesse o relatório Margem de Lucro e Renda por País ou Região, e clique noícone drill through.v Se a configuração de drill through criada for o único destino de drill

through disponível, os relatórios de destino serão executados.v Se houver mais de um destino de drill through disponível, aparecerá uma

lista de possíveis destinos para o pacote e os dados que estão no escopo.Clique na configuração de drill through criada e o destino será executadousando o contexto selecionado.

Resultados

Os usuários de relatórios no PowerPlay Studio podem fazer drill through dorelatório Margem de Lucro e Receita por País ou Região para o relatório de

28 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 37: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

destino definido (Receita Total por País ou Região para Linha de Produto). Alémdisso, o relatório de destino está disponível como um destino de drill through paraqualquer relatório novo ou existente com base no pacote Vendas e Marketing(Cubo), cada vez que País ou Região do Varejista fizer parte do escopo.

A configuração de drill through criada deve ser idêntica à configuração de drillthrough de amostra Dynamicdrill no pacote Vendas e Marketing (Cubo).

Capítulo 3. O Que é Diferente no IBM Cognos PowerPlay? 29

Page 38: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

30 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 39: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Capítulo 4. Administrando o IBM Cognos PowerPlay

O IBM Cognos PowerPlay é administrado usando o IBM Cognos Administration,que é acessado por meio do portal do IBM Cognos Business Intelligence.

Iniciar o IBM Cognos PowerPlay AdministrationTodas as configurações de tempo de execução do IBM Cognos BusinessIntelligence, incluindo opções de configuração e opções do studio, são gerenciadasusando o IBM Cognos Administration. O IBM Cognos Administration é umaferramenta baseada na Web que permite administrar a segurança, as configuraçõesdo servidor e as opções de implementação.

Antes de Iniciar

Para acessar o IBM Cognos Administration, você deve efetuar login como usuárioque tenha permissões de administrador.

Procedimento1. Conecte-se ao portal do IBM Cognos BI.2. Inicie o IBM Cognos Administration:

v Na página Bem-vindo, clique em Administrar o conteúdo do IBM Cognos.v No IBM Cognos Connection, na barra de ferramentas, clique em Iniciar, IBM

Cognos Administration.3. Clique na guia PowerPlay.

Considerações sobre a administração de instalações distribuídasÉ possível usar as opções do IBM Cognos Administration para customizar umambiente distribuído. Use as opções de administração para aprimorar odesempenho e facilitar o gerenciamento do ambiente distribuído.

Para obter algumas opções de administração, há considerações adicionais para oscomponentes do IBM Cognos PowerPlay. Para obter mais informações, consulte oGuia de Administração e Segurança do IBM Cognos Business Intelligence.

Como trabalhar com grupos de servidores

Para ambientes que incluem vários dispatchers, é possível criar grupos deservidores para usufruir de recursos como o roteamento avançado do dispatcher.

Se você criar grupos de servidores, deverá assegurar que pelo menos umdispatcher do PowerPlay não pertença a um grupo de servidor nomeado. Isso énecessário para assegurar que todas as solicitações do PowerPlay sejamprocessadas corretamente. Por exemplo, um marcador criado no PowerPlay Studionão inclui detalhes do grupo de servidores. Quando um marcador for iniciado, umdispatcher do PowerPlay que não pertença a um grupo de servidores nomeadoprocessará a solicitação.

© Copyright IBM Corp. 2005, 2014 31

Page 40: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Permissão para que usuários executem tarefas de migraçãoOs usuários ou grupos de usuários que desejarem executar tarefas de migraçãoprecisam da concessão de capacidades apropriadas.

Esses usuários ou grupos devem ter permissões de Executar e Desviar para asseguintes capacidades:v Usuários, Grupos e Funções

v Conexões de Origens de Dados

v Tarefas de administração

Procedimento1. No IBM Cognos Administration, na guia Segurança, clique em Recursos.2. Clique em Administração.3. Clique na seta próxima de Usuários, Grupos e Funções e clique em Configurar

propriedades.4. Na caixa de diálogo Configurar propriedades, clique na guia Permissões.

Os usuários ou grupos com capacidades atribuídas são exibidos. Os usuáriosdevem ter permissões de Executar e Desviar para poderem migrar conteúdo.

5. Clique em Incluir para incluir usuários ou grupos.Pode ser necessário selecionar Substitui as permissões de acesso obtidas daentrada pai para poder incluir novos usuários e alterar permissões.Para obter informações adicionais, clique em Ajuda ou consulte o Guia deadministração e segurança.

6. Para cada usuário ou grupo que desejar incluir, selecione permissões deExecutar e Desviar e depois clique em Aplicar.

7. Clique em OK para retornar à lista de capacidades.8. Clique na seta próxima de Conexão de Origem de dados, clique em

Configurar Propriedades e repita as etapas de 5 a 7 acima.9. Clique na seta próxima de Tarefas de administração, clique em Configurar

Propriedades e repita as etapas de 5 a 7 acima.Tarefas relacionadas:“Migrar conteúdo para o IBM Cognos PowerPlay” na página 65Usando o IBM Cognos Migration Assistant, é possível migrar conteúdo do IBMCognos Series 7 PowerPlay que foi publicado no IBM Cognos Connection ou IBMCognos Series 7 Upfront, ou conteúdo do IBM Cognos Series 7 PowerPlayEnterprise Server.

Recomendação - Crie grupos ou funções para atribuircapacidades em vez de usuários individuais

Se precisar ativar diversos usuários para poder executar tarefas de migração, serápossível criar um grupo no namespace IBM Cognos e designar os recursosapropriados a esse grupo. Por exemplo, crie um grupo chamado Operadores demigração e, em seguida, inclua usuários individuais do namespace corporativo nogrupo.

Para obter informações sobre como incluir grupos ao namespace IBM Cognos,consulte a seção Administração de Segurança do Guia de Administração e Segurança.

32 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 41: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Definindo Configurações Avançadas para o Serviço PowerPlayÉ possível usar configurações avançadas para customizar o ambiente do IBMCognos PowerPlay.

Algumas configurações avançadas replicam as opções de configuração doPowerPlay Enterprise Server Administration no IBM Cognos Series 7. Outrasconfigurações avançadas são exclusivas do ambiente do IBM Cognos BusinessIntelligence.

Tabela 7. Configurações Avançadas para o Serviço PowerPlay

Recurso IBM Cognos Series 7Configuração avançada do IBM Cognos BI(parâmetro e valor)

Restrição máxima de conexões de cliente

Especifica o número máximo de conexõesdisponíveis para clientes remotos.

SRV.Options. MaxRestrictClientConnections

Exemplo de valor: IN,50

Restrição de limite de tempo da conexão(em min.)

Configura o número de minutos para queuma conexão remota inativa seja finalizada.

SRV.Options.RestrictClientTimeout

Exemplo de valor: IN,60

PowerPlay Web Viewer - Intervalo deexclusão de arquivos temporários (dias)

SRV.PWR.TempFileDeletionTime

Exemplo de valor: IN,30

PowerPlay Web Explorer - Intervalo deexclusão de arquivos temporários (segundos)

SRV.PWQ.TempFileDeletionTime

Exemplo de valor: IN,900

Compilação dinâmica de folhas de estilo.

Especifica se as folhas de estilo devem ounão ser pré-compiladas. Para aprimorar odesempenho, essa configuração deve sempreestar ativada. A configuração deve serdesativada somente se estiverexperimentando folhas de estilo.

SRV.Options. UseCompiledStylesheets

As opções são IN, 1 para ativado ou IN, 2para desativado

Acessibilidade de PDF do PowerPlay PowerPlayServer_Accessible_PDF

As opções são IN, 1 para ativado ou IN, 2para desativado

Nível da auditoria

Especifica o nível de detalhes de umacriação de log de auditoria. As opções sãoNenhum, Resumo e Detalhe.

SRV.Options.AuditLevel

No IBM Cognos BI, as configurações sãodescritas a seguir.

IN,0 configura a criação de log da auditoriapara Nenhum.

IN,1 configura-o para Resumo.

IN,2 configura-o para Detalhe.

Capítulo 4. Administrando o IBM Cognos PowerPlay 33

Page 42: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Tabela 7. Configurações Avançadas para o Serviço PowerPlay (continuação)

Recurso IBM Cognos Series 7Configuração avançada do IBM Cognos BI(parâmetro e valor)

Tamanho máximo de cada arquivo de log deauditoria em KB

SRV.Audit.MaxFileSize

Exemplo de valor: IN,256

Servidor PowerPlay - Porta PPSDSRemote

No IBM Cognos Series 7, a configuraçãoPorta PPDSRemote está no arquivo cern.ini.

SRV.PPDSRM.ServerPort

Um exemplo de valor é IN,8020

Use esse parâmetro para restringir a portapara comunicação entre o PowerPlay Cliente o servidor PowerPlay, como quando oambiente incluir um firewall.

Delimitador usado para exportar para o CSV

No IBM Cognos Series 7, os arquivos CSVsão criados na codificação nativa docomputador PowerPlay Enterprise Server. Odelimitador para arquivos CSV depende doseparador de listas para o código do idiomaatual, mais comumente uma vírgula.

SRV.Options.CSVDelimeter

Por padrão, o IBM Cognos PowerPlay usasaída delimitada por guia para exportar parao arquivo CSV.

Para alterar o delimitador para vírgula (,)use SRV.Options.CSVDelimeter TX,,

Para alterar o delimitador para ponto evírgula (;) use SRV.Options.CSVDelimeterTX,;

Conceitos relacionados:Capítulo 7, “Configuração de criação de log”, na página 85As mensagens de log do IBM Cognos Business Intelligence fornecem informaçõessobre os status de componentes, incluindo a atividade do PowerPlay e umavisualização de alto nível de eventos importantes.“Delimitador Usado para Exportar para CSV Diferente do IBM Cognos Series 7” napágina 128Por padrão, o IBM Cognos PowerPlay usa um delimitador por tabulação paraexportar para o arquivo CSV. Esse comportamento é consistente com outros studiosdo IBM Cognos.

Definir Configurações AvançadasDefina configurações avançadas para o IBM Cognos PowerPlay service in IBMCognos Administration.

Procedimento1. No IBM Cognos Administration, na guia Status, clique em Sistema.2. Clique na seta ao lado de Todos os servidores, clique em Serviços e depois

clique em PowerPlay.

34 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 43: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

3. Clique na seta ao lado de Serviço do PowerPlay e clique em Configurarpropriedades.

4. Clique na guia Configurações.5. Na coluna Valor, clique em Editar para as Configurações avançadas.6. Selecione Substituir as configurações obtidas da entrada pai.7. Na coluna Parâmetro, digite o nome do parâmetro e na coluna Valor, digite o

valor da configuração.Para valores numéricos, o formato da coluna Valor é "IN,#", sendo que # é onúmero associado à configuração desejada. Por exemplo, para configurar otamanho máximo de arquivos de log de auditoria no IBM Cognos BI para 256kilobytes, você deve inserir o Parâmetro como SRV.Audit.MaxFileSize e oValor como IN,256. Para os valores de texto, como o delimitador a ser usadopara exportar para o arquivo CSV, o formato da coluna Valor é "TX,#" , sendoque # é o símbolo do texto.

Tarefas relacionadas:“Ativar Auditoria para Cubos e Relatórios” na página 97Quando a auditoria é ativada, as informações de atividade são continuamenteregistradas no arquivo ppes_audit.log.

Customizar as Configurações de Cubos e Relatórios do PowerPlay emPastas Públicas

Há várias opções disponíveis para permitir a customização da aparência, dodesempenho e da funcionalidade do aplicativo IBM Cognos PowerPlay.

Para acomodar diferentes grupos de usuários, é possível customizar configuraçõespara o conteúdo em Pastas públicas por pasta, pacote, cubo e relatório. Pode-setambém customizar configurações para o conteúdo no local Minhas Pastas paraum usuário específico.

Figura 3. Local de Serviço do PowerPlay

Capítulo 4. Administrando o IBM Cognos PowerPlay 35

Page 44: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Por padrão, um objeto adquire suas configurações do objeto pai. Por exemplo, umpacote adquire as configurações de cubo e de relatório da pasta pai. É possívelalterar as configurações para um cubo ou relatório individual para que tenhamconfigurações diferentes do pai.

Mudanças comuns incluemv alterar a aparência do PowerPlay Studio selecionando uma opção de interface

diferente.v ativar o drill through para permitir que usuários visualizem informações

relacionadas ao relatório atual.v customizar a barra de ferramentas para limitar as opções disponíveis a usuários

ou para criar uma nova opção de barra de ferramentas.

Algumas configurações de cubo e relatório têm considerações de segurançarelacionadas.v Visualizador de Renderização de PDF

Se você alterar essa configuração de Cognos Viewer para PowerPlay StudioReport Viewer, a saída de PDF será salva em formato não criptografado em umlocal fora do armazenamento de conteúdo do IBM Cognos Business Intelligence.Esse comportamento é consistente com o IBM Cognos Series 7 e pode exigiradministração adicional para garantir que o nível de segurança apropriado sejaaplicado ao conteúdo.

v Título Especificado do Usuário de Codificação HTML

Se alterar essa configuração de Ativado para Desativado, um título de relatóriopode incluir um script malicioso que seria executado no momento doprocessamento do relatório.

Procedimento1. Na administração do PowerPlay, selecione um item na lista Objetos

Configuráveis.2. Modifique uma propriedade e use uma das seguintes ações para alterar as

configurações de cubo ou relatório.v Para aplicar as mudanças somente à entrada selecionada na lista Objetos

Configuráveis, clique em Salvar.v Para aplicar as mudanças aos descendentes da entrada selecionada na lista

Objetos Configuráveis, clique em Reconfigurar Descendentes e então cliqueem Salvar.

v Para restaurar as configurações padrão de uma entrada, selecione umapropriedade individual e clique em Reconfigurar ou clique em ReconfigurarTudo para restaurar as configurações padrão de todas as propriedades. Épossível utilizar a opção Reconfigurar Descendentes para aplicar as mesmasmudanças aos descendentes. Para aplicar as mudanças, clique em Salvar.

Resultados

As mudanças são aplicadas à pasta, cubo ou relatório selecionado.

Customizar as Configurações de Cubos e Relatórios doPowerPlay em Minhas Pastas

Para acomodar grupos de usuários diferentes, é possível customizar configuraçõespara o conteúdo no local Minhas Pastas para um usuário específico.

36 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 45: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Há várias opções disponíveis para permitir a customização da aparência, dodesempenho e da funcionalidade do aplicativo IBM Cognos PowerPlay. É possívelcustomizar também as configurações para o conteúdo em Pastas Públicas porpasta, pacote, cubo e relatório.

Por padrão, um objeto adquire suas configurações do objeto pai. Por exemplo, umpacote adquire as configurações de cubo e de relatório da pasta pai. É possívelalterar as configurações para um cubo ou relatório individual para que tenhamconfigurações diferentes do pai.

Mudanças comuns incluemv alterar a aparência do PowerPlay Studio selecionando uma opção de interface

diferente.v ativar o drill through para permitir que usuários visualizem informações

relacionadas ao relatório atual.v customizar a barra de ferramentas para limitar as opções disponíveis a usuários

ou para criar uma nova opção de barra de ferramentas.

Algumas configurações de cubo e relatório têm considerações de segurançarelacionadas.v Visualizador de Renderização de PDF

Se você alterar essa configuração de Cognos Viewer para PowerPlay StudioReport Viewer, a saída de PDF será salva em formato não criptografado em umlocal fora do armazenamento de conteúdo do IBM Cognos Business Intelligence.Esse comportamento é consistente com o IBM Cognos Series 7 e pode exigiradministração adicional para garantir que o nível de segurança apropriado sejaaplicado ao conteúdo.

v Título Especificado do Usuário de Codificação HTML

Se alterar essa configuração de Ativado para Desativado, um título de relatóriopode incluir um script malicioso que seria executado no momento doprocessamento do relatório.

Procedimento1. Obtenha um caminho de procura para o usuário que é proprietário do local

Minhas Pastas que deseja customizar.O caminho da procura está disponível nas propriedades do usuário da guiaSegurança do IBM Cognos Administration. A seguir há um exemplo de umcaminho de procura para um usuário:CAMID("series7:u:authid=3212592089")Para obter mais informações, consulte o Guia de Administração e Segurança doIBM Cognos BI.

2. Na administração do PowerPlay, insira o caminho da procura na caixa deprocura e clique em Procurar.O nome do usuário e o conteúdo de Minhas Pastas aparece na guia Resultadosda Procura.

3. Selecione um item na lista Objetos Configuráveis.4. Modifique uma propriedade e use uma das seguintes ações para alterar as

configurações de cubo ou relatório.v Para aplicar as mudanças somente à entrada selecionada na lista Objetos

Configuráveis, clique em Salvar.

Capítulo 4. Administrando o IBM Cognos PowerPlay 37

Page 46: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

v Para aplicar as mudanças aos descendentes da entrada selecionada na listaObjetos Configuráveis, clique em Reconfigurar Descendentes e então cliqueem Salvar.

v Para restaurar as configurações padrão de uma entrada, selecione umapropriedade individual e clique em Reconfigurar ou clique em ReconfigurarTudo para restaurar as configurações padrão de todas as propriedades. Épossível utilizar a opção Reconfigurar Descendentes para aplicar as mesmasmudanças aos descendentes. Para aplicar as mudanças, clique em Salvar.

Resultados

As mudanças são aplicadas à pasta, cubo ou relatório selecionados no local MinhasPastas.Conceitos relacionados:“Configurações de Cubos” na página 44É possível usar as configurações de cubos para customizar o aplicativo IBMCognos PowerPlay.“Configurações de relatórios” na página 50É possível usar as configurações de relatório para customizar o aplicativo IBMCognos PowerPlay.

Alterar a Aparência do PowerPlay StudioÉ possível escolher entre três opções diferentes de interface para o IBM CognosPowerPlay Studio.

A opção de interface é configurada nas configurações do cubo. Isso permite aescolha de interfaces diferentes para grupos de usuários que usam cubosdiferentes. Por exemplo, para acomodar usuários que estão mais familiarizadoscom o Series 7, pode-se optar por utilizar a opção Série 7 - Avançado.v Aprimorado - IBM Cognos PowerPlay Studio

Aprimorado - IBM Cognos PowerPlay Studio é a interface padrão e éconsistente com outros studios do IBM Cognos Business Intelligence.

v Série 7 - Avançado

A interface Série 7 - Avançado preserva a aparência e aspecto do Series 7.v Genérico

A interface Genérico é baseada em um estilo HTML genérico.

Procedimento1. No IBM Cognos Administration, clique na guia PowerPlay.2. Clique numa pasta ou pacote na lista Objetos Configuráveis.

Se a pasta-raiz for selecionada, a propriedade será herdada por todos osdescendentes, mas também pode ser substituída por propriedades de umdescendente.

3. Na guia Configurações de Cubos, no grupo Exibir (web), próximo dapropriedade Tipo, clique na seta e selecione uma opção de interface.

4. Clique em Salvar.

Resultados

Quando os usuários abrirem um relatório ou pacote no PowerPlay Studio, ainterface selecionada será usada.

38 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 47: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Ativação do drill throughÉ possível controlar as opções de drill through para o conteúdo do IBM CognosBusiness Intelligence e do IBM Cognos Series 7.

Por padrão, todas as opções de drill through estão desativadas. Se você migrou oconteúdo do IBM Cognos PowerPlay do IBM Cognos Series 7 para o IBMCognos BI usando o Migration Assistant, algumas configurações de drill-throughforam incluídas na migração.

Para garantir que o acesso de drill-through entre o conteúdo localizado emcomputadores diferentes funcione corretamente, você deve especificar domínios ehosts válidos no IBM Cognos Application Firewall - Propriedades doComponente no IBM Cognos Configuration.

O IBM Cognos BI fornece a funcionalidade drill through que é diferente do drillthrough do IBM Cognos Series 7.

Procedimento1. No IBM Cognos Administration, clique na guia PowerPlay.2. Na lista Objetos Configuráveis, selecione uma pasta ou pacote.3. Clique na guia Configurações de Cubos, ative as opções de drill through e

especifique informações de conexão.4. Clique na guia Configurações de relatórios e ative as opções de drill through

desejadas.A tabela abaixo descreve as configurações de drill through. Algumasconfigurações, como informações de conexão, se aplicam somente à guiaConfigurações de Cubos

Requisito: As configurações do gateway usadas para suportar drill through,como Destino do PowerPlay Web, devem corresponder às configurações daURL do gateway no IBM Cognos Series 7 Configuration Manager.

Tabela 8. Configurações de Drill Through

Configuração de drill through Descrição

Cubos do PowerPlay Permite que usuários façam drill through em detalhes deoutro cubo. Utilize para ativar ou desativar acesso adrill-through no aplicativo cliente.

Os PowerCubes criados com o PowerPlay Transformer eoutras origens OLAP modificadas com o PowerPlayConnect podem permitir o drill through.

Capítulo 4. Administrando o IBM Cognos PowerPlay 39

Page 48: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Tabela 8. Configurações de Drill Through (continuação)

Configuração de drill through Descrição

Destino do PowerPlay Web Especifica a URL do programa de gateway do PowerPlayWeb, como http://host_name/ibmcognos/cgi-bin/ppdscgi.exe

Dependendo de como a rede estiver configurada, tambémpode ser necessário incluir o nome de domínio, porexemplo, http://nome_host.suaempresa.com/ibmcognos/cgi-bin/ppdscgi.exe

Para especificar um número de porta diferente da porta80 padrão do servidor web, insira o número junto aonome do servidor, por exemplo, http://nome_host:número_porta/ibmcognos/cgi-bin/ppdscgi.exe

Se seu servidor web utilizar SSL (Secure Sockets Layer),especifique o protocolo HTTPS com o nome do servidor,por exemplo, https://nome_host/ibmcognos/cgi-bin/ppdscgi.exe

Newsbox de Drill Through doPowerPlay Web

Especifica que os usuários podem executar o drillthrough a partir do PowerPlay para destinos que nãoestejam na pasta do servidor raiz. As definições de cubopodem fazer referência a destinos de drill-throughcontidos em uma hierarquia de NewxBox Upfront.

Grupo de Servidores de DrillThrough do PowerPlay Web

Esse é o mesmo valor de Grupo de Servidores doUpfront, conforme especificado no IBM Cognos Series 7Configuration Manager.

Pasta CRN de Drill Throughdo PowerPlay Web

Especifica a pasta em que os destinos de drill-throughestão no IBM Cognos ReportNet ou no IBM Cognos BI.

IBM Cognos Query Permite que os usuários façam drill through em detalhesno IBM Cognos Query. Utilize para ativar ou desativaracesso a drill-through no aplicativo cliente.

Servidor do IBM CognosQuery

Especifica a URL do programa de gateway do IBMCognos Query, como http://host_name/ibmcognos/cgi-bin/cqcgi.exe

Dependendo de como sua rede estiver configurada,também pode ser necessário incluir o nome de domínio,por exemplo, http://nome_host.suaempresa.com/ibmcognos/cgi-bin/cqcgi.exe

Para especificar um número de porta diferente da porta80, padrão, insira o número junto do nome do servidor,por exemplo, http://nome_host:número_porta/ibmcognos/cgi-bin/cqcgi.exe

Se seu servidor web utilizar SSL (Secure Sockets Layer),especifique o protocolo HTTPS com o nome do servidor,por exemplo, https://nome_host/ibmcognos/cgi-bin/cqcgi.exe

40 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 49: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Tabela 8. Configurações de Drill Through (continuação)

Configuração de drill through Descrição

Relatórios do Impromptu Web Permite que os usuários façam drill through em detalhesem um relatório do Impromptu. Utilize essa configuraçãopara ativar ou desativar acesso a drill-through noaplicativo cliente.

NewsBox de Drill Through deRelatórios do Impromptu Web

Especifica o Newsbox Upfront do conjunto de relatóriospublicados que contém o relatório de destino dodrill-through. Por exemplo, se o relatório de drill-throughgo.imr estiver localizado na pasta Grandes Aventuras,digite Grandes Aventuras nesta caixa. O nome do arquivoimr também deve estar escrito no cubo se tiver sidoconstruído utilizando as propriedades de drill-through decubo/medida no Transformer e tiver sido, portanto,incluída no momento da criação.

Servidor de Relatórios doImpromptu Web

Especifica a URL do programa de gateway doImpromptu Web nos sistemas operacionais MicrosoftWindows e UNIX, como http://host_name/ibmcognos/cgi-bin/imrap.cgi

Dependendo de como sua rede estiver configurada,também pode ser necessário incluir o nome de domínio,por exemplo, http://nome_host.suaempresa.com/ibmcognos/cgi-bin/imrap.cgi

Para especificar um número de porta diferente da porta80, padrão, insira o número junto do nome do servidor,por exemplo, http://nome_host:número_porta/ibmcognos/cgi-bin/imrap.exe

Se seu servidor web utilizar Secure Sockets Layer (SSL),especifique o protocolo HTTPS com o nome do servidor,por exemplo, https://nome_host/ibmcognos/cgi-bin/imrap.cgi

IBM Cognos ReportNet/IBMCognos Connection

Permite que os usuários façam drill through em detalhesno IBM Cognos ReportNet ou no IBM Cognos BI. Utilizeessa configuração para ativar ou desativar acesso adrill-through no aplicativo cliente.

Capítulo 4. Administrando o IBM Cognos PowerPlay 41

Page 50: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Tabela 8. Configurações de Drill Through (continuação)

Configuração de drill through Descrição

URI do IBM CognosReportNet/IBMCognos Gateway

Especifica a URL do programa de gateway IBM CognosReportNet ou IBM Cognos BI no Windows e no UNIX,como http://host_name/ibmcognos/cgi-bin/cognos.cgi

Dependendo de como sua rede está configurada, podeser necessário incluir o nome do domínio, comohttp://host_name.yourorg.com/ibmcognos/cgi-bin/cognos.cgi

Para especificar um número de porta diferente da portapadrão 80, anexe o número ao nome do servidor, comohttp://host_name:port_number/ibmcognos/cgi-bin/cognos.cgi

Se seu servidor da web estiver usando Secure SocketsLayer (SSL), especifique o protocolo HTTPS com o nomedo servidor, por exemplo, https://host_name/ibmcognos/cgi-bin/cognos.cgi

Pasta do IBM CognosReportNet/IBMCognos Connection

Especifica a pasta do IBM Cognos ReportNet ou IBMCognos BI que contém o relatório de drill-through dedestino.

IBM Cognos ReportNet/IBMCognos Assistance

Especifica que, quando os usuários clicarem em DrillThrough em um cubo, a página Auxiliar com o DrillThrough é aberta. Utilize essa página para identificar osparâmetros que estão definidos no relatório dedrill-through.

Pacotes do PowerPlay Studio Permite que os usuários façam drill through em detalhesem outro relatório do PowerCube ou do IBM CognosPowerPlay.

Pasta do Pacote do PowerPlayStudio Especifica a pasta do IBM Cognos BI que contém os

PowerCubes de drill-through ou os relatórios do IBMCognos PowerPlay.

Definições de Drill Throughdo IBM Cognos

Permite que os usuários selecionem, a partir de uma listaexistente do IBM Cognos BI, definições de drill throughou criem uma nova configuração.

5. Execute um dos seguintes procedimentos:v Para aplicar as mudanças ao objeto configurável selecionado e seus

descendentes, clique em Reconfigurar Descendentes e, em seguida, cliqueem Salvar.

v Para aplicar as mudanças somente aos objetos configuráveis selecionados,clique em Salvar.

Conceitos relacionados:“Acesso drill-through” na página 23O acesso drill through no IBM Cognos Business Intelligence é diferente do IBMCognos Series 7.

42 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 51: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Customização da Barra de FerramentasÉ possível controlar a disponibilidade de funcionalidade no IBM CognosPowerPlay Studio ativando ou desativando botões da barra de ferramentas. Amaioria dos botões da barra de ferramentas é ativada por padrão, incluindo asopções de barra de ferramentas disponíveis no IBM Cognos Series 7 PowerPlayWeb.

Além disso, há opções exclusivas para o IBM Cognos Business Intelligence. Porexemplo, Abrir com o Analysis Studio oferece aos usuários a opção de abrir umrelatório do PowerPlay no Analysis Studio. Além de controlar funcionalidades, épossível customizar a aparência da área da barra de ferramentas.

Procedimento1. Na lista Objetos Configuráveis, selecione uma pasta ou pacote.2. Em Configurações de Cubos, modifique as configurações da barra de

ferramentas.

Tabela 9. Configurações da Barra de Ferramentas

Propriedade Barra deferramentas Descrição

Imagem Ativa ou desativa a imagem especificada naconfiguração Arquivo de imagem de plano de fundo.

Arquivo de Imagem de Plano deFundo

Especifica o nome da imagem .gif ou .jpg que seráusada como o plano de fundo da área da barra deferramentas.

Você deve copiar imagens para a pastac10_location\webcontent\ppwb\images. Não inclua ocaminho ao especificar o nome do arquivo.

Você deve ativar a propriedade de transparência parausar uma imagem de plano de fundo.

Cor do Plano de Fundo Especifica a cor do plano de fundo da área da barra deferramentas.

Transparência Especifica se a cor do plano de fundo é transparente ounão.

Botões predefinidos Relaciona os botões de barra de ferramentasdisponíveis.

Botões customizados Permite ativar as funções customizadas da barra deferramentas incluídas no arquivo ppwbcustom.js

3. Salve as mudanças.

Criação de um botão de barra de ferramentas customizadoÉ possível incluir até oito botões customizados na barra de ferramentas do IBMCognos PowerPlay para permitir que os usuários realizem tarefas comuns. Porexemplo, pode-se incluir botões para permitir que usuários criem um link para umsumário do departamento ou enviem o URL do cubo para um colega. É possívelanexar qualquer código JavaScript a um botão customizado.

Procedimento1. Na pasta installation_location\webcontent\ppwb, abra o arquivo ppwbcustom.js

em um editor de texto.

Capítulo 4. Administrando o IBM Cognos PowerPlay 43

Page 52: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

2. Em uma das funções customizadas, crie um JavaScript para o comandocustomizado e, em seguida, salve o arquivo ppwbcustom.js.

3. Na lista Objetos Configuráveis na administração do PowerPlay, selecione umapasta ou um pacote.

4. Em Configurações de Cubos, no grupo Barra de ferramentas, ative a entradacustomizada apropriada para a função modificada no arquivo ppwbcustom.js eentão clique em Salvar.

5. Escolha se deseja aplicar a mudança a todos os descendentes e clique emSalvar.

Configurações de CubosÉ possível usar as configurações de cubos para customizar o aplicativo IBMCognos PowerPlay.

As informações da tabela seguinte descrevem a propriedade Opções.

Tabela 10. Configurações de Cubo: Propriedades de Opções

Propriedade Opções Descrição

Título Especifica um título. Também é possível incluirvariáveis no título.

Título Especificado do Usuáriode Codificação HTML

Se ativado, apenas um conjunto limitado de tags HTMLpermitidas nos títulos dos relatórios poderá serpublicado na web. Se estiver desativado, qualquer tagHTML será permitida no título.

Salvar como PowerCube Especifica que os usuários do PowerPlay Client podemsalvar o cubo como um subcubo.

Se essa opção estiver ativada, os usuários poderão seconectar ao cubo remoto e salvar partes dele como umsubcubo, ou seja, como um PowerCube local (arquivo.mdc) em seus discos rígidos. Isso permite que usuáriosse desconectem do servidor e acessem o subcubo emseus computadores. Posteriormente, eles podemsincronizar novamente com o cubo remoto no servidor.

Apenas PowerCubes criados com o PowerPlayTransformer podem ser salvos como subcubos.

Obter Dados Permite que usuários explorem um relatório semmostrar dados em uma exibição de tabela cruzada.Quando essa opção estiver ativada, o usuário poderáselecionar Obter dados depois no menu Opções eObter dados dentro da exibição.

44 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 53: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Tabela 10. Configurações de Cubo: Propriedades de Opções (continuação)

Propriedade Opções Descrição

Nível de AuditoriaEspecifica o nível de auditoria do cubo. Se a auditoriafor ativada, serão registradas informações que podemajudá-lo a analisar e solucionar problemas.

As seguintes opções de auditoria estão disponíveis:

Nenhum não registra informações.

Resumo registra solicitações feitas aos cubos.

Detalhe registra estatísticas sobre as medidas,dimensões e níveis de um cubo que são acessados peloPowerPlay Studio. Isso permite determinar quais áreasde um cubo são utilizadas com mais ou menosfrequência e pode ajudar no desenvolvimento de umaestratégia para criar cubos mais eficientes.

Tempo(s) Limite(s) deSolicitação Enfileirada

Determina o período, em segundos, que uma solicitaçãode cubo ou relatório irá permanecer na fila. Se essassolicitações não forem processadas dentro do períodoespecificado, os usuários receberão uma mensagempedindo para tentarem novamente.

Linha de Dimensão emExportação CSV

Especifica se as informações da linha de dimensão serãoincluídas quando um usuário exportar um arquivo deValor Separado por Vírgula (.csv) a partir do PowerPlayStudio.

Layout de Renderização de PDF Especifica como os PDFs são processados.

Automático é baseado na ferramenta de autoria.

Layout da Web usa o PDF no estilo do PowerPlayStudio.

Layout do Cliente usa o PDF no estilo do PowerPlayClient.

Visualizador de Renderizaçãode PDF

Especifica as opções de PDF para o visualizador dorelatório.

O IBM Cognos Viewer usa o visualizador de estilo doIBM Cognos Business Intelligence.

O PowerPlay Studio Report Viewer usa o visualizadorde estilo do IBM Cognos Series 7.

As informações da tabela seguinte descrevem a propriedade Controle deProcessos.

Capítulo 4. Administrando o IBM Cognos PowerPlay 45

Page 54: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Tabela 11. Configurações de Cubo: Propriedades de Controle de Processo

Propriedade Controle deprocessos Descrição

Tempo Limite de Conexão (min) Configura o número de minutos que a conexão de umusuário a cubos permanece ativa para usuários doPowerPlay Studio. Quando o limite de tempo daconexão esgotar, o usuário poderá ser solicitado adigitar novamente a senha do cubo, não as informaçõessobre autenticação.

O tempo limite de conexão não se aplica às conexões aoservidor do PowerPlay Client.

Mínimo de Processos Configura o número mínimo de processos quepermanecem em execução depois de serem executados.

Máximo de ProcessosConfigura o número máximo de processos que podemser executados ao mesmo tempo.

Tempo Limite da Solicitação (s) Configura o tempo máximo que o servidor perdeprocessando solicitações. Se essas solicitações não foremprocessadas dentro do período especificado, os usuáriosreceberão uma mensagem pedindo para tentaremnovamente.

Tempo Limite de ProcessoInativo (min)

Configura durante quantos minutos um processopermanece ativo entre solicitações. Quando o limite detempo de um processo se esgota, a memória que erautilizada se torna disponível para o servidor.

O número de processos especificados em Númeromínimo de processos permanecerá ativo mesmo se assolicitações não estiverem sendo processadas.

Tempo de Reciclagem (min) Especifica o tempo máximo de duração, em minutos,que um processo pode ser executado antes de serfinalizado. É possível reduzir o valor padrão se essesprocessos consumirem muitos recursos.

O valor padrão é 1440 minutos (24 horas). Paradesativar a configuração de tempo de reciclagem,configure o valor para zero (0).

As informações da tabela seguinte descrevem a propriedade Exibir (Web).

Tabela 12. Configurações de Cubo: Propriedades de Exibição (Web)

Propriedade Exibir (web) Descrição

Resolução de Tela Otimiza a aparência de botões e exibições. Utilize paraselecionar a resolução mais comum das estações detrabalho de usuários.

Se a resolução não corresponder à resolução donavegador web, os botões e as exibições serão exibidosem uma escala diferente do texto. Se não tiver certezade qual resolução utilizar, recomenda-se usar 800 x 600.

46 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 55: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Tabela 12. Configurações de Cubo: Propriedades de Exibição (Web) (continuação)

Propriedade Exibir (web) Descrição

Tipo Especifica uma das seguintes interfaces de usuário:

Genérico restringe a geração de páginas HTML paracódigo suportado por navegadores da Web maisantigos. Se essa configuração for ativada, os usuáriosnão terão o processamento de DHTML independente donavegador utilizado. Se possuir cubos grandes, oDHTML pode reduzir o desempenho do servidor. Sevocê ativar Genérico, será possível melhorar odesempenho.

A interface Aprimorado - IBM Cognos PowerPlayStudio usa a aparência e comportamento de outrosstudios do IBM Cognos.

A interface Avançada - Series 7 usa o aspecto e aaparência do IBM Cognos Series 7.

As informações da tabela seguinte descrevem a propriedade Tamanho das Páginas.

Tabela 13. Configurações de Cubo: Propriedades de Tamanho da Página

Propriedade Tamanho daspáginas Descrição

Limite de Linhas

Limite de Colunas

Limita o número de linhas e colunas que são exibidosem uma página. Utilize para aprimorar o desempenho ea leitura de grandes relatórios.

As páginas de relatório incluem botões de navegaçãoque permitem que usuários se movam adiante e paratrás. Por exemplo, depois de abrir um relatório, osusuários podem ir para as próximas 20 colunas ou 50linhas. Os botões também estão disponíveis para irdiretamente para a primeira ou última página dascolunas ou linhas.

Os limites de página configurados são somente padrões.Os usuários podem redefinir os limites depois deabrirem relatórios paginados.

As informações da tabela seguinte descrevem a propriedade Tamanho do Menu.

Capítulo 4. Administrando o IBM Cognos PowerPlay 47

Page 56: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Tabela 14. Configurações de Cubo: Propriedades de Tamanho do Menu

Propriedade Tamanho do menu Descrição

Limite de Caracteres Limita o número de caracteres exibidos para nomes decategorias em menus suspensos na interface genérica eno visualizador de dimensão e de menus suspensos dainterface avançada.

A largura da caixa é determinada pelo nome decategoria mais longo, até o máximo configurado.Qualquer categoria mais longa que o limite máximoaparece truncada. Pode ser necessário aumentar esselimite se forem precisos mais caracteres para distinguiras categorias. Também é possível diminuir o limite se ascategorias forem facilmente distintas com menoscaracteres.

Limite de Itens Limita o número de categorias mostradas por nível. Usepara evitar problemas do navegador web associadoscom a exibição de um grande número de itens da listaem menus suspensos na interface genérica e novisualizador de dimensão e menus suspensos nainterface avançada.

Se não for possível redesenhar os cubos para que asdimensões contenham menos categorias, é possívellimitar o número de categorias incluídas em cada nível.

Por exemplo, limita-se as categorias da caixa dedimensão para 50. Qualquer nível que exceder 50categorias fica truncado para exibir apenas as 50primeiras categorias. É exibida uma opção no final dalista para que usuários possam visualizar as próximascategorias. O nome da opção depende da versão donavegador da Web do usuário.

As informações da tabela seguinte descrevem a propriedade Área das dimensões.

Tabela 15. Configurações de Cubo: Propriedades de Área de Dimensão

Propriedade Área dasdimensões Descrição

Banner do Relatório Mostra o banner do PowerPlay Studio que contém onome do cubo conectado atualmente.

Imagem Ativa ou desativa a imagem especificada naconfiguração Arquivo de imagem de plano de fundo.

Arquivo de Imagem de Plano deFundo

Especifica o nome de arquivo de uma imagem .gif ou.jpg que será utilizada como o plano de fundo da áreana qual a lista de dimensões aparece.

Você deve copiar imagens para a pastac10_location\webcontent\ppwb\images. Não inclua ocaminho ao especificar o nome do arquivo.

Você deve ativar a propriedade de transparência parausar uma imagem de plano de fundo.

48 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 57: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Tabela 15. Configurações de Cubo: Propriedades de Área de Dimensão (continuação)

Propriedade Área dasdimensões Descrição

Cor do Plano de Fundo Especifica a cor do plano de fundo da área na qual alista de dimensões aparece.

Transparência Especifica se a cor do plano de fundo é transparente ounão.

As informações da seguinte tabela descrevem a propriedade Quadro de tabelacruzada.

Tabela 16. Configurações de Cubo: Propriedades de Quadro de Tabela Cruzada

Propriedade Quadro de tabelacruzada Descrição

Cor do Link Especifica a cor do texto com hiperlink como, porexemplo, rótulos de categoria.

Cor do TextoEspecifica a cor do texto sem hiperlink como, porexemplo, valores de dados.

Imagem Ativa ou desativa a imagem especificada naconfiguração Arquivo de imagem de plano de fundo.

Arquivo de Imagem de Plano deFundo

Especifica o nome da imagem .gif ou .jpg que seráusada como o plano de fundo do quadro de tabelacruzada.

Você deve copiar imagens para a pastainstallation_location\webcontent\ppwb\images. Nãoinclua o caminho ao especificar o nome do arquivo.

Você deve ativar a propriedade de transparência parausar uma imagem de plano de fundo.

Cor do Plano de Fundo Especifica a cor do plano de fundo da área na qual alista de dimensões aparece.

Transparência Especifica se a cor do plano de fundo é transparente ounão.

As informações da seguinte tabela descrevem a propriedade Tabela Cruzada.

Tabela 17. Configurações de Cubo: Propriedades de Tabela Cruzada

Propriedade Tabela Cruzada Descrição

Imagem Ativa ou desativa a imagem especificada naconfiguração Arquivo de imagem de plano de fundo.Essa configuração se aplica apenas à interface Genérica.

Capítulo 4. Administrando o IBM Cognos PowerPlay 49

Page 58: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Tabela 17. Configurações de Cubo: Propriedades de Tabela Cruzada (continuação)

Propriedade Tabela Cruzada Descrição

Arquivo de Imagem de Plano deFundo

Especifica o nome da imagem .gif ou .jpg que seráusada como o plano de fundo de exibições de tabelacruzada.

Você deve copiar imagens para a pastainstallation_location\webcontent\ppwb\images. Nãoinclua o caminho ao especificar o nome do arquivo.

Você deve ativar a propriedade de transparência parausar uma imagem de plano de fundo.

Cor do Plano de Fundo Especifica a cor do plano de fundo da área na qual alista de dimensões aparece.

Transparência Especifica se a cor do plano de fundo é transparente ounão.

As informações da tabela seguinte descrevem a propriedade Quadro de gráficos.

Tabela 18. Configurações de Cubo: Propriedades de Quadro de Gráficos

Propriedade Quadro de gráficos Descrição

Cor do Link Especifica a cor do texto com hiperlink como, porexemplo, rótulos de categoria.

Cor do TextoEspecifica a cor do texto sem hiperlink como, porexemplo, valores de dados.

Imagem Ativa ou desativa a imagem especificada naconfiguração Arquivo de imagem de plano de fundo.

Arquivo de Imagem de Plano deFundo

Especifica o nome da imagem .gif ou .jpg que seráusada como o plano de fundo de exibições de gráfico.

Você deve copiar imagens para a pastainstallation_location\webcontent\ppwb\images. Nãoinclua o caminho ao especificar o nome do arquivo.

Você deve ativar a propriedade de transparência parausar uma imagem de plano de fundo.

Cor do Plano de Fundo Especifica a cor do plano de fundo da área na qual alista de dimensões aparece.

Transparência Especifica se a cor do plano de fundo é transparente ounão.

Configurações de relatóriosÉ possível usar as configurações de relatório para customizar o aplicativo IBMCognos PowerPlay.

As informações da tabela seguinte descrevem a propriedade Opções.

50 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 59: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Tabela 19. Configurações de Relatório: Propriedades de Opções

Propriedade Opções Descrição

Explorar no Formato HTMLInterativo

Especifica se usuários poderão explorar relatórios emPDF em um formato HTML interativo. Essa opçãotambém afeta a habilidade dos usuários abriremrelatórios no formato HTML interativo no caso de orelatório ser publicado no portal.

Nível de AuditoriaEspecifica o nível de auditoria do relatório. Se aauditoria for ativada, serão registradas informaçõesque podem ajudá-lo a analisar e solucionar problemas.As seguintes opções de auditoria estão disponíveis:

Nenhum não registra informações.

Resumo registra solicitações feitas em relatórios.

Detalhe registra estatísticas sobre as medidas,dimensões e níveis de um cubo que são acessados peloPowerPlay Studio. Isso permite determinar quais áreasde um cubo são utilizadas com mais ou menosfrequência e pode ajudar no desenvolvimento de umaestratégia para criar cubos mais eficientes.

Tempo Limite de Solicitação naFila

Determina o período, em segundos, que umasolicitação de cubo ou relatório irá permanecer na fila.Se essas solicitações não forem processadas dentro doperíodo especificado, os usuários receberão umamensagem pedindo para tentarem novamente.

Tamanho da Página Especifica o tamanho da página para impressão derelatórios em PDF.

Orientação de Página Especifica a orientação padrão da página paraimpressão de relatórios em PDF.

Exibir Borda do(s) Quadro(s) Especifica se a caixa de seleção Exibir borda do(s)quadro(s) é disponibilizada, permitindo que usuáriosincluam uma borda em seus relatórios.

Explicar Links de Drill Especifica se os relatórios exibidos em PDF conterãolinks de Explicações de drill nos rótulos de linha oucoluna.

Linha de Status Especifica se a linha de status é mostrada.

Quebra Automática de Linha Especifica se os rótulos PDF podem ser quebrados.

Incluir Camadas Se ativado, os PDFs terão camadas semelhantes às doPowerPlay Client.

Capítulo 4. Administrando o IBM Cognos PowerPlay 51

Page 60: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Tabela 19. Configurações de Relatório: Propriedades de Opções (continuação)

Propriedade Opções Descrição

Layout de Renderização de PDF Especifica como os PDFs são processados.

Automático é baseado na ferramenta de autoria.

Layout do Cliente usa o PDF no estilo do PowerPlayClient.

Layout da Web usa o PDF no estilo do PowerPlayStudio.

Visualizador de Renderização dePDF

Especifica as opções de PDF para o visualizador dorelatório.

O Cognos Viewer usa o visualizador de estilo do IBMCognos Business Intelligence.

O PowerPlay Studio Report Viewer usa ovisualizador de estilo do IBM Cognos Series 7.

Paginação Permite definir opções para paginação de PDFs.

As informações da tabela seguinte descrevem a propriedade Controle deProcessos.

Tabela 20. Configurações de Relatório: Propriedades de Controle de Processo

Propriedade Controle deprocessos Descrição

Tempo Limite de Conexão (min) Configura o número de minutos que a conexão de umusuário a relatórios permanece ativa para usuários doPowerPlay Studio. Quando o limite de tempo daconexão esgotar, o usuário poderá ser solicitado adigitar novamente a senha do cubo, não asinformações sobre autenticação.

O tempo limite de conexão não se aplica às conexõesao servidor do PowerPlay Client.

Mínimo de Processos Configura o número mínimo de processos quepermanecem em execução depois de serem abertos.

Máximo de ProcessosConfigura o número máximo de processos que podemser abertos ao mesmo tempo.

Tempo Limite de Processo Inativo(min)

Configura durante quantos minutos um processopermanece ativo entre solicitações. Quando o limite detempo de um processo se esgota, a memória que erautilizada se torna disponível para o servidor.

O número de processos especificados em Númeromínimo de processos permanecerá ativo mesmo se assolicitações não estiverem sendo processadas.

52 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 61: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Tabela 20. Configurações de Relatório: Propriedades de Controle deProcesso (continuação)

Propriedade Controle deprocessos Descrição

Tempo de Reciclagem (min) Especifica o tempo máximo de duração doprocessamento de um processo antes que ele sejafinalizado. É possível reduzir o valor padrão se essesprocessos consumirem muitos recursos.

O valor padrão é 1440 minutos (24 horas). Paradesativar a configuração de tempo de reciclagem,configure o valor para zero (0).

As informações da tabela seguinte descrevem a propriedade Exibir.

Tabela 21. Configurações de Relatório: Propriedades de Exibição

Propriedade Exibir Descrição

Resolução de TelaOtimiza a aparência de botões e exibições. Utilize paraselecionar a resolução mais comum das estações detrabalho de usuários.

Se a resolução não corresponder à resolução donavegador web, os botões e as exibições serão exibidosem uma escala diferente do texto.

Se não tiver certeza de qual resolução utilizar,recomenda-se usar 800 x 600.

As informações da tabela seguinte descrevem a propriedade Relatório.

Tabela 22. Configurações de Relatório: Propriedades do Relatório

Propriedade Relatório Descrição

Geração de Arquivos PDF Leves Permite que fontes do sistema no servidor sejamincorporadas ao relatório em PDF. Quando desativada,todas as fontes do servidor serão incorporadas.Quando ativado, apenas as fontes especificadas naseção Configurações de Fontes do IBM CognosConfiguration serão usadas.

Os textos do relatório podem não ser processadoscorretamente se a inclusão de fontes do sistema nãoestiver habilitada.

Simulação de Padrão Especifica se o servidor simula padrões usados norelatório ou substitui um retângulo preenchido pelopadrão nos relatórios do PowerPlay Client. Quandoativado, os padrões são reproduzidos como bitmaps norelatório em PDF. Quando desativado, um retângulopreenchido aparece no relatório em PDF. A utilizaçãode simulação de padrões permite uma reproduçãoprecisa dos padrões usados no relatório original, mastambém demanda mais recursos e aumenta o tamanhodo arquivo PDF.

Capítulo 4. Administrando o IBM Cognos PowerPlay 53

Page 62: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Conceitos relacionados:“Exibição incorreta da saída em PDF do relatório migrado” na página 124Ao executar um relatório migrado em PDF, o PDF não é exibido corretamente. Otexto aparece como um conjunto de pontos e uma mensagem de erro é exibidainformando que a fonte AndaleWT não está disponível.

Customize a Aparência do IBM Cognos BIÉ possível customizar a interface do IBM Cognos Business Intelligence paraadequá-la às necessidades de um cliente internacional ou de um determinadorevendedor. É possível fazer mudanças nas cores, fontes, imagens e na aparênciageral de um ou mais componentes do IBM Cognos BI.

Uma das opções de customização que podem ser usadas é a criação de estiloscustomizados. Recomendamos utilizar os recursos de estilo existentes como pontode início. Altere as folhas de estilo, gráficos e fontes conforme necessário, mascertifique-se de que a estrutura do diretório de estilos customizados seja a mesmados diretórios de estilos predefinidos.

Para criar um estilo customizado para o IBM Cognos PowerPlay, trabalhe comduas localizações de pastas. Você deve se certificar de que as duas pastas têm osarquivos necessários para suportar o estilo customizado.

Para criar um estilo customizado para o IBM Cognos PowerPlay, use as seguintesetapas em vez do procedimento Criar um Estilo Customizado no Guia deAdministração e Segurança do IBM Cognos BI.

Procedimento1. No diretório installation_location/webcontent/skins, faça uma cópia de um

diretório de estilo existente.2. Renomeie o diretório copiado.3. No diretório installation_location/ppserver/skins, faça uma cópia do diretório

que tenha o mesmo nome do diretório copiado na etapa 1.4. Renomeie o diretório copiado usando o mesmo nome da etapa 2.5. No novo diretório installation_location/webcontent/skins, modifique as folhas

de estilo, os gráficos ou as fontes, conforme necessário.6. No IBM Cognos Administration, inclua um novo objeto de estilo e associe-o ao

diretório de estilo criado na etapa 2.

54 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 63: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Capítulo 5. Migrando do IBM Cognos Series 7 PowerPlay parao IBM Cognos PowerPlay

Antes de mover os aplicativos do IBM Cognos Series 7 PowerPlay para o IBMCognos PowerPlay, você deve considerar suas opções para determinar a melhorestratégia para seu conteúdo. É possível migrar todos os aplicativos ao mesmotempo ou migrá-los um de cada vez. Também é possível construir novosaplicativos no IBM Cognos Business Intelligence e continuar a usar o IBM CognosSeries 7 PowerPlay para alguns aplicativos.

Ao migrar aplicativos existentes e mover usuários para o IBM Cognos BI, existemopções sobre como proceder.v Não é necessário migrar todos ou quaisquer aplicativos PowerPlay.v É possível criar novos aplicativos PowerPlay no IBM Cognos BI.v Pode-se migrar partes do conteúdo para comparar os resultados com os

relatórios existentes.v É possível migrar todo o conteúdo existente do PowerPlay para o IBM Cognos

PowerPlay imediatamente e aproveitar os serviços PowerPlay e a arquiteturaIBM Cognos BI.

Use o IBM Cognos Migration Assistant para migrar o conteúdo do PowerPlay doIBM Cognos Series 7 Upfront ou IBM Cognos PowerPlay Enterprise Server, ou oconteúdo do IBM Cognos Series 7 publicado anteriormente no IBM CognosConnection. Uma vez no IBM Cognos PowerPlay, a experiência do usuário é amesma ao mover do IBM Cognos PowerPlay Web para o IBM Cognos PowerPlayStudio, ou do IBM Cognos Series 7 para versões do IBM Cognos BI do IBMCognos PowerPlay Client.

Os relatórios de clientes locais não são migrados pelo IBM Cognos MigrationAssistant. Os usuários do IBM Cognos PowerPlay Client serão solicitados afornecer um pacote do IBM Cognos BI ao abrirem seus relatórios do IBM CognosSeries 7 que usam um cubo remoto como origem de dados.

Por que Migrar o Conteúdo do IBM Cognos Series 7 PowerPlay para oIBM Cognos PowerPlay?

O IBM Cognos Business Intelligence foi desenvolvido com a arquiteturacomprovada e expansível de serviços da Web apresentada com o IBM CognosReportNet. Em comparação com o IBM Cognos Series 7, os usuários corporativostrabalham de forma diferente com o IBM Cognos BI:v Um único produto fornece todas as capacidades de inteligência de negócios:

relatório, análise, scorecards, áreas de trabalho, gerenciamento de evento denegócio e integração de dados. Os usuários escolhem as capacidades queprecisam.

v Como os metadados são definidos uma vez, os usuários têm uma visãocompleta e consistente dos dados corporativos. Eles não têm que ir até produtosou locais diferentes para visualizar dados diferentes.

v Usuários individuais podem optar pelas ferramentas e informações de quenecessitam. Eles não precisam aprender a usar ferramentas genéricas projetadas

© Copyright IBM Corp. 2005, 2014 55

Page 64: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

para usuários altamente técnicos. Essa inteligência comercial flexível atende àsnecessidades de uma variedade maior de funções de uma organização.

Mover do IBM Cognos Series 7 PowerPlay para o IBM Cognos PowerPlay é menosarriscado e com menor custo de migração. É necessária uma reciclagem mínimapara ajudar os usuários finais a mover do Índice do IBM Cognos Upfront ou doIBM Cognos PowerPlay Web para o IBM Cognos Connection. Muitas propriedadesdo aplicativo PowerPlay do IBM Cognos PowerPlay Enterprise Server são iguaisno IBM Cognos PowerPlay. O gerenciamento do servidor, o balanceamento decarga, o failover, o ajuste de desempenho e o monitoramento são agoraadministrados remotamente usando o IBM Cognos Administration e seus relatóriossão armazenados em um banco de dados central, o armazenamento de conteúdodo IBM Cognos BI.

Além disso, há vários aprimoramentos para drill through no IBM Cognos BI,incluindo filtragem dinâmica de relatórios de destino e remoção da necessidade deos administradores incluírem destinos de drill-through usando o IBM CognosTransformer.

Usando Recursos do PowerPlay no IBM Cognos BIMigrar usuários e aplicativos do IBM Cognos Series 7 PowerPlay para o IBMCognos PowerPlay permite preservar a experiência de usuário do PowerPlay, mastambém aproveita vários outros aspectos do IBM Cognos Business Intelligence.

PowerCubes

No IBM Cognos BI, todas as origens de dados são acessadas por meio de pacotes.O pacote contém informações de conexão que identificam a origem de dados,como um PowerCube. As informações de conexão do cubo incluem a localizaçãodo cubo no sistema de arquivos.

Ao migrar para o IBM Cognos BI, os seus PowerCubes são mapeados para pacotes.Os pacotes contêm informações de conexão de PowerCubes. Em seguida, osusuários podem criar novos relatórios utilizando os pacotes. Usuários com acesso aoutros studios do IBM Cognos BI também podem usar esses pacotes para criarnovos relatórios de seus PowerCubes originais do IBM Cognos Series 7 comoorigens de dados. Isso permite estender o uso dos cubos existentes.

Por padrão, o nome da origem de dados, como o nome do cubo, é usado para criaro pacote no IBM Cognos BI. Durante a migração, pode-se aceitar o padrão oualterar o mapeamento do cubo para um pacote existente.

Os arquivos de cubo (.mdc) não são migrados nem movidos durante a migração.Sua localização não muda. Suas informações de conexão, no entanto, serãomigradas para o ambiente do IBM Cognos BI. Para garantir que seus aplicativosfuncionem no ambiente do IBM Cognos BI, os cubos devem estar em um localacessível pelos servidores do IBM Cognos BI.

As credenciais não precisam criar uma conexão ou um pacote de origens de dadosno IBM Cognos BI, mas podem precisar acessar o pacote.

Abordagem de MigraçãoA abordagem de migração recomendada envolve:v Criando novos aplicativos no IBM Cognos Business Intelligence

56 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 65: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

A melhor maneira de aprender e entender um novo produto é obtendoexperiência prática. Esta etapa envolve o congelamento do desenvolvimento deaplicativo nos produtos IBM Cognos Series 7 e a criação de novos aplicativos noIBM Cognos BI. A criação de novos aplicativos no IBM Cognos BI permiteaprender sobre os recursos e benefícios do IBM Cognos BI e determinar qualabordagem de migração usar para os aplicativos existentes.

v Migrar usuários e aplicativos do PowerPlay e para o IBM Cognos PowerPlayA migração de usuários e aplicativos do PowerPlay e para o IBM CognosPowerPlay fornece os benefícios da arquitetura e do desempenho do IBMCognos BI enquanto preserva a experiência do usuário do PowerPlay. Depois demigrar para o IBM Cognos PowerPlay, é possível aproveitar a vantagem demuitos outros aspectos do IBM Cognos BI.

Movendo para o IBM Cognos PowerPlayMover o Conteúdo do IBM Cognos Series 7 PowerPlay para o IBM CognosPowerPlay envolve as seguintes etapas chave:v Planejar a migração

Você deve planejar com cuidado o que deseja fazer com os aplicativos existentesdo IBM Cognos Series 7 PowerPlay e como movê-los para o IBM CognosPowerPlay. Isso significa considerar qual conteúdo é mais indicado para o IBMCognos PowerPlay e que outras opções estão disponíveis no IBM CognosBusiness Intelligence.Como parte do planejamento de sua migração, visite o IBM Cognos CustomerCenter (www.ibm.com/software/data/cognos/customercenter/) para obter maisinformações, ferramentas de migração e assistência.

v Entendendo as diferenças esperadas entre o IBM Cognos Series 7 PowerPlay e oIBM Cognos PowerPlayEmbora haja várias semelhanças entre o IBM Cognos Series 7 PowerPlay e oIBM Cognos PowerPlay, há algumas diferenças na experiência do portal, naadministração do servidor e na experiência do usuário final.

v Migrando o conteúdo para o IBM Cognos PowerPlayMigrar o conteúdo do IBM Cognos Series 7 PowerPlay para o IBM CognosPowerPlay é opcional. É possível migrar apenas parte ou todo o conteúdo doIBM Cognos Series 7 PowerPlay para o IBM Cognos PowerPlay, ou optar porcriar novo conteúdo no PowerPlay Studio.Você migra o conteúdo do IBM Cognos Series 7 PowerPlay usando o IBMCognos Migration Assistant para fornecer orientação durante o processo. Se aquantidade de conteúdo for pequena, pode-se migrar tudo de uma só vez oualguns aplicativos individuais por vez. Para obter melhores resultados, agrupe oconteúdo para a migração para que cada tarefa de migração termine dentro deum período razoável. Para manter o desempenho, não recomendamos amigração de mais de 5.000 objetos em uma única tarefa de migração. Objetos sãorelatórios, cubos, pastas ou NewsBoxes. A migração de conteúdo é efetuada porum administrador.A migração suporta relatórios no formato ppx. Se você trabalhar com relatóriosno formato ppr, deverá primeiro converter os relatórios ppr em ppx usando umamacro fornecida com o PowerPlay Client antes da migração.É possível migrar relatórios locais do PowerPlay Client abrindo-os no IBMCognos PowerPlay Client. Se o relatório usar uma conexão remota com umPowerCube, o IBM Cognos PowerPlay Client solicitará um pacote do IBMCognos BI. Se houver vários relatórios que usam conexões remotas, será possívelconverter todos os relatórios usando a macro do IBM Cognos Script Editor.

Capítulo 5. Migrando do IBM Cognos Series 7 PowerPlay para o IBM Cognos PowerPlay 57

Page 66: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

v Usando o conteúdo migrado no IBM Cognos PowerPlay Client ou no PowerPlayStudioOs usuários do PowerPlay Web terão muita familiaridade com a funcionalidadee as capacidades de exploração do PowerPlay Studio. De forma semelhante, osusuários do PowerPlay Client terão a mesma experiência ao mover do IBMCognos Series 7 para o IBM Cognos BI.

v Administrando o conteúdo no IBM Cognos PowerPlayNo IBM Cognos Series 7 PowerPlay, você administrou o conteúdo usando aferramenta de administração do PowerPlay Enterprise Server. A ferramentapermitia configurar propriedades para cubos e relatórios, bem como configurarpropriedades de como os servidores PowerPlay funcionavam.No IBM Cognos PowerPlay, a maior parte da administração é feita no IBMCognos Administration. Enquanto as configurações de cubos e relatórios forammantidas, o comportamento dos servidores PowerPlay utiliza agora ainfraestrutura do IBM Cognos BI.

Conceitos relacionados:Capítulo 3, “O Que é Diferente no IBM Cognos PowerPlay?”, na página 7O IBM Cognos PowerPlay traz os recursos comprovados de exploração e análisedo IBM Cognos Series 7 PowerPlay para o ambiente do IBM Cognos BusinessIntelligence.“Migrando Relatórios Locais para o IBM Cognos BI” na página 72São fornecidas duas macros para migrar relatórios locais do PowerPlay para o IBMCognos PowerPlay. Uma delas converterá do formato ppr para o formato ppx, queé necessário pelo IBM Cognos PowerPlay. A outra alterará as referências remotasde cubo nos relatórios ppx para referências de pacote para o ambiente do IBMCognos PowerPlay.“Usando Recursos do PowerPlay no IBM Cognos BI” na página 56Migrar usuários e aplicativos do IBM Cognos Series 7 PowerPlay para o IBMCognos PowerPlay permite preservar a experiência de usuário do PowerPlay, mastambém aproveita vários outros aspectos do IBM Cognos Business Intelligence.

O que é migrado e para onde é migrado?Dependendo da origem selecionada para migração do conteúdo do IBM CognosMigration Assistant, objetos diferentes serão migrados.

Ao mover um aplicativo PowerPlay do IBM Cognos Series 7 PowerPlay para oIBM Cognos PowerPlay, seus relatórios serão muito parecidos após a migração.

Conteúdo Migrado do IBM Cognos Connection

Se o conteúdo do IBM Cognos Series 7 for publicado no IBM Cognos Connection,ele ainda será executado no IBM Cognos Series 7. Se você migrar esse conteúdo,poderá obter ainda mais benefícios com a arquitetura do IBM Cognos BI. Escolha oIBM Cognos Connection para migrar o conteúdo do IBM Cognos Series 7 que foipublicado no IBM Cognos BI em um ambiente de interoperabilidade.

Os seguintes objetos são migrados do IBM Cognos Connection:v Relatórios e PowerCubes

Relatórios migrados para o IBM Cognos BI são idênticos aos relatórios do IBMCognos Series 7, exceto que os relatórios do IBM Cognos Series 7 fazemreferência a cubos como origens de dados e relatórios do IBM Cognos BI fazemreferência a pacotes.

58 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 67: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Apenas os cubos usados pelos relatórios selecionados para migração no IBMCognos Migration Assistant serão migrados. Os cubos que foram publicados noIBM Cognos BI, mas não foram usados por nenhum relatório não serãomigrados.Os cubos são migrados para os pacotes. Não é necessário criar conexões deorigem de dados aos cubos ou publicar pacotes. O IBM Cognos MigrationAssistant cria as conexões de origem de dados e os pacotes.

v PastasO assistente de migração recria a estrutura de pastas de origem no local dedestino.

v Minhas pastasO conteúdo do IBM Cognos Series 7 PowerPlay de cada usuário no localMinhas Pastas será migrado para uma pasta Conteúdo Migrado no localMinhas Pastas.

v Configurações de relatóriosTodas as propriedades de relatório e todas as propriedades das pastas nas quaisos relatórios estão contidos até, sem incluir, a pasta-raiz, são aplicadas aorelatório.As propriedades configuradas na pasta-raiz são aplicadas à pasta Conteúdomigrado, que é a pasta padrão de migração do conteúdo.

Nota: O processo de migração não migrará propriedades herdadas quando aorigem de migração for o IBM Cognos Connection.

Conteúdo migrado do Upfront

Migrar o conteúdo do Upfront migrará todo o conteúdo do IBM Cognos Series 7PowerPlay que foi publicado no Upfront, assim como URLs, atalhos e NewsBoxes.NewsBoxes podem ser públicas ou pessoais.

Os seguintes objetos do PowerPlay são migrados do Upfront:v Relatórios e PowerCubes

Relatórios migrados para o IBM Cognos BI são idênticos aos relatórios do IBMCognos Series 7, exceto que os relatórios do IBM Cognos Series 7 fazemreferência a cubos como origens de dados e relatórios do IBM Cognos BI fazemreferência a pacotes.Os cubos são migrados para os pacotes. Não é necessário criar conexões deorigem de dados aos cubos ou publicar pacotes. O IBM Cognos MigrationAssistant cria as conexões de origem de dados e os pacotes.

v NewsIndexO NewsIndex é migrado para uma estrutura semelhante no local de destino. Seo NewsIndex contiver objetos além de pastas, como cubos ou relatórios, umapasta chamada NewsItems Adicionais do Upfront será criada no IBM CognosConnection para esses objetos.

Nota: A pasta NewsItems Adicionais do Upfront ficará vazia se os objetos quenão são pastas no Upfront não forem suportados pelo processo de migração. Porexemplo, objetos de documentação como o Guia para Documentação não sãomigrados.

v NewsBoxes

Capítulo 5. Migrando do IBM Cognos Series 7 PowerPlay para o IBM Cognos PowerPlay 59

Page 68: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

O processo de migração mapeia a estrutura de conteúdo do Upfront para umaestrutura de pasta do IBM Cognos Connection. Preservando a organizaçãoexistente do Upfront, é mais fácil completar tarefas administrativas, como aplicarsegurança para o conteúdo migrado.

v NewsBoxes pessoaisO conteúdo da NewsBox Pessoal é migrado para o IBM Cognos BI comoconteúdo de Minhas Pastas de cada usuário. Cada usuário do IBM Cognos BIterá seu próprio local Minhas Pastas que outros usuários não poderão acessar.

Dica: Pode-se também migrar o conteúdo da NewsBox Pessoal para a PastaPública ou não migrar o conteúdo.A tarefa de migração cria uma conta no IBM Cognos BI para usuários que játenham efetuado logon. Para obter informações adicionais sobre usuários econtas no IBM Cognos BI, consulte o Guia de Administração e Segurança do IBMCognos.

v AtalhosAtalhos são migrados somente se os relatórios de destino para os quais osatalhos apontam forem migrados na mesma tarefa de migração.

v SegurançaA segurança será migrada se você estiver usando o namespace do IBM CognosSeries 7 como uma origem de autenticação no ambiente do IBM Cognos BI.Somente usuários e classes com referência nos NewsBoxes e NewsItems sendomigrados são migrados.As permissões de acesso configuradas no conteúdo do Upfront são migradaspara o IBM Cognos BI, conforme mostrado na seguinte tabela:

Tabela 23. Mapeamento de Permissões de Acesso

Upfront IBM Cognos BI

Ler Acessar, Ler

Gravar Acessar, Ler, Gravar

Executar Acessar, Ler, Executar

Proprietário Acessar, Ler, Gravar, Executar, Configurar Política

Para obter informações adicionais sobre permissões de acesso do IBM Cognos BI,consulte o Guia de Administração e Segurança do IBM Cognos.

Dica: É possível escolher quais informações de segurança do Upfront serãomigradas.

v Visualizações do cuboAs visualizações de cubos são migradas para URLs que iniciam o PowerPlayStudio com o pacote apropriado.

v Visualizações customizadasAs visualizações customizadas tornam-se visualizações de relatórios durante amigração e devem ser migradas na mesma tarefa do relatório de destino.

v Configurações de relatóriosTodas as propriedades de relatório e todas as propriedades das pastas nas quaisos relatórios estão contidos até, sem incluir, a pasta-raiz, são aplicadas ao

60 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 69: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

relatório. As propriedades são obtidas das propriedades configuradas norelatório indicado em Nome do relatório de origem, na página Propriedadesavançadas do relatório do Upfront.As propriedades configuradas na pasta-raiz são aplicadas à pasta Conteúdomigrado, que é a pasta padrão de migração do conteúdo.As propriedades dos relatórios publicados no Upfront, como links de relatório,não são migradas.

Conteúdo Migrado do PowerPlay Enterprise Server

Os seguintes objetos são migrados do PowerPlay Enterprise Server:v Relatórios e PowerCubes

Os relatórios e cubos que estão presentes no PowerPlay Enterprise Server sãomigrados. Isso pode incluir relatórios e cubos que foram publicados no Upfront.

Nota: O IBM Cognos PowerPlay não abre relatórios no formato ppr. Para poderabrir relatórios ppr, você deve primeiro convertê-los para o formato ppx.Relatórios migrados para o IBM Cognos BI são idênticos aos relatórios do IBMCognos Series 7, exceto que os relatórios do IBM Cognos Series 7 fazemreferência a cubos como origens de dados e relatórios do IBM Cognos BI fazemreferência a pacotes.Os cubos são migrados para os pacotes. Não é necessário criar conexões deorigem de dados aos cubos ou publicar pacotes. O IBM Cognos MigrationAssistant cria as conexões de origem de dados e os pacotes.

v PastasO processo de migração mapeia a estrutura de conteúdo do PowerPlayEnterprise Server para uma estrutura de pasta do IBM Cognos Connection.

v AtalhosAtalhos de relatórios ou cubos são resolvidos durante a tarefa de migração de talforma que o destino do atalho seja migrado no lugar do atalho. Por exemplo, nocaso de uma pasta que contém um relatório e outra pasta que contém um atalhopara o relatório, se for selecionada somente a pasta que contém o atalho durantea migração o atalho não será migrado. Entretanto, o relatório que era a origemdo atalho será migrado, mesmo se estiver em uma pasta não selecionada.Atalhos de pasta não são migrados.

v ConfiguraçõesA pasta raiz, a pasta, o cubo e as configurações do relatório, sejam elesexplicitamente definidos ou herdados, são migrados para o IBM CognosPowerPlay.

Objetos do PowerPlay que não são migrados

Além de cubos e relatórios, um aplicativo IBM Cognos Series 7 PowerPlay incluiobjetos e informações relacionadas, como folhas de estilo e informações deconfiguração.

Os seguintes objetos não são migrados para o IBM Cognos BI:v folhas de estilo em cascata usadas pelo PowerPlay Enterprise Server

O IBM Cognos BI inclui opções de customização que podem ser usadas paraatingir resultados semelhantes.

v Estilos do PowerPlay ClientConceitos relacionados:

Capítulo 5. Migrando do IBM Cognos Series 7 PowerPlay para o IBM Cognos PowerPlay 61

Page 70: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

“Configuração de geração de arquivos PDF leves não migrados” na página 125A configuração de geração de arquivos PDF leves de um relatório não serámigrada quando for herdada da pasta pai em vez de ser configuradaexplicitamente.“Conteúdo que não pode ser migrado” na página 115Você está migrando conteúdo e recebe mensagens de erro de que um objeto nãoserá migrado.Tarefas relacionadas:“Conversão de arquivos PPR para PPX para migração” na página 72O IBM Cognos PowerPlay não abre relatórios no formato ppr. Para poder abrirrelatórios ppr, você deve primeiro convertê-los para o formato ppx.

Antes de migrarAntes de iniciar uma tarefa de migração, execute as tarefas a seguir para prepararseus ambientes de origem e destino e assegurar uma migração bem-sucedida.__ v Assegure-se de que tenha configurado a segurança do IBM Cognos

PowerPlay Enterprise Server.__ v Execute o utilitário AM_NamespaceCorruptionDetect para verificar se o

namespace IBM Cognos Series 7 não está danificado.Um namespace corrompido para causar resultados inesperados. Para obterinformações adicionais, consulte o Access Manager Administrator Guide.

__ v Execute o utilitário Limpeza de usuário na administração do servidor Upfrontpara excluir recursos de usuário não utilizados.Para obter informações adicionais, consulte o Upfront Server AdministrationGuide.

__ v Verifique se os relatórios e cubos do ambiente são válidos.A remoção de relatórios ou cubos que não são mais válidos antes da migraçãopode torná-la mais tranqüila.

__ v Disponibilize todos os cubos para os servidores IBM Cognos BusinessIntelligence.O processo de migração não moverá fisicamente cubos usados no ambientedo IBM Cognos Series 7. Portanto, você deve assegurar-se de que osservidores do IBM Cognos BI tenham acesso aos mesmos locais de LAN oudiscos locais que os servidores do IBM Cognos Series 7.

__ v Ao migrar do Upfront, altere as configurações pessoais das NewsBoxesPessoais para torná-las visíveis no IBM Cognos Migration Assistant.As NewsBoxes Pessoais e o conteúdo são migrados, embora não estejamvisíveis no IBM Cognos Migration Assistant. Em ambientes com conteúdoextenso, isso limita a possibilidade de dividir uma migração em peçasgerenciáveis.

Dica: No IBM Cognos Migration Assistant, é possível optar por não migrarNewsBoxes Pessoais.

__ v Assegure-se de que os servidores cujo conteúdo está sendo migrado e osservidores do IBM Cognos BI estejam protegidos pelo firewall da rede.Os processos de migração não criptografam ao mover os relatórios e outroconteúdo do IBM Cognos Series 7 para o IBM Cognos BI.Para obter informações adicionais, consulte o Architecture and DeploymentGuide.

62 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 71: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

As tarefas a seguir garantem que as configurações específicas do código do idiomanos ambientes de origem e de destino serão idênticas.__ v Para o IBM Cognos BI no sistema operacional UNIX, assegure-se de que todas

as partes do código de idioma (idioma, país ou código de região e conjuntode caracteres) no IBM Cognos BI sejam idênticas às do ambiente do IBMCognos Series 7.

Dica: Talvez seja necessário instalar fontes de idioma adicionais para suportaro conjunto de caracteres usado no IBM Cognos Series 7. Para obterinformações adicionais, consulte o IBM Cognos BI Installation andConfiguration Guide.O código de idioma configurado no IBM Cognos Series 7 ConfigurationManager deve corresponder ao código de idioma do produto, código deidioma do conteúdo e código de idioma do servidor no IBM Cognos BI. Alémdisso, você deve criar um arquivo de propriedades de idioma no IBM CognosBI para o código de idioma no qual o ambiente do Series 7 está configurado.Do contrário, o nome da pasta que contém o conteúdo migrado pode nãoestar no idioma esperado.

__ v Se estiver migrando relatórios que usam o sistema de codificação Shift-JISpara caracteres japoneses, talvez seja necessário mapear alguns caracteresShift-JIS para Unicode, o sistema de codificação usado pelo IBM Cognos BI.

As tarefas a seguir garantem que os componentes de migração serão instalados,configurados e ativados nos computadores adequados.__ v Instale os componentes de migração em todos os computadores em que os

componentes de servidor do IBM Cognos Series 7 ou do IBM Cognos BI estãoinstalados. Os componentes de migração incluem um componente do IBMCognos Series 7 e um componente do IBM Cognos BI, que devem estarinstalados no servidor apropriado. Para obter informações adicionais, consulteo Guia de Instalação e Configuração do IBM Cognos PowerPlay.A migração a partir do Upfront depende de um componente do IBM CognosSeries 7 chamado Deployment Manager estar disponível. O DeploymentManager é instalado por padrão com as ferramentas de administração do IBMCognos Series 7. O servidor IBM Cognos Series 7 do qual você está migrandoconteúdo deve ter as ferramentas de administração do IBM Cognos Series 7instaladas para assegurar que o Deployment Manager esteja disponível.

__ v Se você estiver migrando de diversos servidores do IBM Cognos Series 7 emuma única tarefa de migração, defina aliases do servidor para identificar maisfacilmente as origens das quais você está migrando e para evitar colisões denomes.

As tarefas a seguir garantem a posse das informações de login apropriadas para aexecução de uma tarefa de migração.__ v Forneça um nome de usuário e uma senha do IBM Cognos Series 7 ou IBM

Cognos Connection durante a migração.O nome do usuário escolhido deve ser um membro da classe de usuário raizou um administrador para migrar conteúdo do Upfront ou do PowerPlayEnterprise Server.

__ v Efetue login no IBM Cognos BI como um usuário autenticado.Você deve efetuar logon como um usuário autenticado para migrarinformações pessoais, como Newsboxes Pessoais do IBM Cognos Upfront einformações de contato do relatório.

Capítulo 5. Migrando do IBM Cognos Series 7 PowerPlay para o IBM Cognos PowerPlay 63

Page 72: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

As tarefas a seguir ajudam a maximizar o desempenho ao executar uma tarefa demigração.__ v Configure o nível de criação de log do serviço de migração para Mínimo.

Esse nível de criação de log monitora a inicialização e a interrupção dosistema e do serviço, erros de tempo de execução, gerenciamento da conta dousuário e uso do tempo de execução do IBM Cognos BI e solicitações de uso.Se precisar solucionar um problema com o serviço de migração, selecione umnível de criação de log detalhado somente para esse serviço, mantendo asmensagens de log a uma quantidade mínima. Para obter informações sobre aconfiguração de níveis de criação de log, consulte o Guia de Administração eSegurança do IBM Cognos. As mensagens do serviço de migração utilizam onome 'mis' nos arquivos de log.

__ v Para obter os melhores resultados, configura o tipo de configuração doserviço do IBM Cognos BI como Configuração Média.O tipo de configuração que deve ser usado depende do hardware utilizado edo conteúdo que deseja migrar. Se ocorrerem erros de memória ao executaruma tarefa de migração, talvez seja necessário alterar a configuração doserviço do IBM Cognos BI.Para obter informações sobre como definir o tipo de configuração, consulte oGuia de Instalação e Configuração do IBM Cognos PowerPlay.

__ v Para o IBM Cognos BI no sistema operacional UNIX, configure todos osrecursos disponíveis para o shell atual e todos os processos iniciados por elecomo ilimitado.É possível confirmar essas configurações ao executar o comando a seguir noprompt de comandos:ulimit -Ha

Conceitos relacionados:Apêndice C, “Mapeamento de caracteres Shift-JIS japoneses”, na página 135Ao migrar relatórios ou cubos cujos nomes contêm caracteres japoneses, podemocorrer problemas, porque não há um padrão da indústria para o mapeamento desequências de bytes de caracteres Shift-JIS para e de Unicode.Tarefas relacionadas:“Newsboxes Pessoais Não Aparecem na Visualização em Árvore do Upfront noIBM Cognos Migration Assistant” na página 119Quando se cria uma tarefa de migração com o Upfront como origem, asNewsboxes pessoais não aparecem na visualização de árvore dos Newsboxes.“Problemas ao Migrar Cubos com Caracteres Não ASCII no UNIX” na página 142Se o serviço do IBM Cognos Series 7 PowerPlay Enterprise Server estiver usandoum nome de caminho não ASCII para acessar um PowerCube e o servidor IBMCognos Business Intelligence estiver em execução em um código de idioma queuse um conjunto de caracteres diferente, o servidor IBM Cognos BI não conseguirálocalizar o PowerCube referenciado no disco.“O nome da pasta criada para o conteúdo migrado não está no idioma correto” napágina 116Quando o ambiente do IBM Cognos Series 7 ou do IBM Cognos BusinessIntelligence estiver em um código de idioma diferente do inglês, a pasta criada noIBM Connection para o conteúdo migrado será chamada Conteúdo Migrado.

Definir Aliases para Servidores do IBM Cognos Series 7Defina aliases para servidores do IBM Cognos Series 7 para identificar maisfacilmente as origens das quais você está migrando. Ao definir aliases, é possível

64 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 73: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

evitar colisões de nomes ao migrar conteúdo de diversos servidores Series 7 com omesmo nome ou estrutura de pasta em uma única migração.

O processo de migração cria uma série de pastas para o conteúdo migrado. Onome da pasta-pai da pasta com conteúdo é uma concatenação do nome doservidor Series 7, do número da porta do servidor e do nome de rendição doSeries 7. Por exemplo, se você migrar uma pasta Upfront chamada XYZ. No IBMCognos Connection, o conteúdo migrado aparece em

Pastas Públicas > Conteúdo Migrado > Upfront>MyServer_8010_cer5 > XYZ

A mesma convenção de nomes é utilizada para pacotes criados para cubosmigrados e para as conexões de origem de dados para os cubos. É possível definiro alias do servidor para substituir um nome concatenado em todos esses casos.

Os aliases do servidor não podem conter os seguintes caracteres especiais:

{ } : ; / \ < > " . | * ?

Procedimento1. Abra o arquivo local_s7/migs7/migs7service_configuration.xml.2. Localize e remova o comentário da seção <server-aliases>.

Dica: Para obter informações adicionais sobre como definir aliases, leia oscomentários para a seção. Por exemplo, os comentários explicam o queacontecerá se você definir o mesmo alias para dois servidores diferentes doSeries 7.

3. Para cada alias de servidor que deseja definir, especifique a seguinteinformações:v nome do servidor do Series 7v Número da porta do servidor.v nome de rendição do Series 7v alias do servidor

Se um valor não é especificado para o alias, um alias será gerado. O aliasserá a concatenação do nome do servidor, do número da porta do servidor edo nome de rendição do Series 7.

Os espaços iniciais ou finais serão removidos. Por exemplo, se você especificar<alias> PPES1 </alias>como o alias, o alias real será <alias>PPES1</alias>.

4. Salve o arquivo.Salve o arquivo em UTF-8. Se quiser salvar o arquivo na codificação usada pelocódigo do idioma, como Shift-JIS, altere a codificação especificada na primeiralinha do arquivo.<?xml version="1.0" encoding="UTF-8"?>

Migrar conteúdo para o IBM Cognos PowerPlayUsando o IBM Cognos Migration Assistant, é possível migrar conteúdo do IBMCognos Series 7 PowerPlay que foi publicado no IBM Cognos Connection ou IBMCognos Series 7 Upfront, ou conteúdo do IBM Cognos Series 7 PowerPlayEnterprise Server.

Ao usar o Migration Assistant, é possível usar alguns dos seguintes recursos doIBM Cognos Business Intelligence:

Capítulo 5. Migrando do IBM Cognos Series 7 PowerPlay para o IBM Cognos PowerPlay 65

Page 74: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

v ProgramaçãoQuando a migração é iniciada, é possível escolher por executá-la imediatamenteou programar sua execução para um momento mais conveniente, como durantehoras de baixa utilização.Ao planejar uma migração, é possível selecionar uma prioridade de execução de1 a 5. Uma migração com prioridade 1 é executada antes de uma entrada comprioridade 5. Se houver mais de uma migração com a mesma prioridade, asmigrações serão executadas na mesma ordem em que foram enviadas. O valorpadrão é 3. Os usuários devem ter permissões adequadas para modificarprioridades de programação.

v Criação de logArquivos de log podem ajudar a solucionar problemas registrando as atividadesque são realizadas quando há migração de conteúdo. As operações que o serviçode migração executa são registradas no arquivo cogserver.log ou no banco dedados de criação de log que você configurou no ambiente do IBM Cognos BI.Para obter os melhores resultados, monitore esses logs regularmente e mantenhaas pastas nas quais eles são criados. Por exemplo, se estiver migrando muitosrelatórios, o tamanho dos arquivos de log pode crescer rapidamente.

v Histórico de execuçãoO IBM Cognos BI mantém um histórico de execução para tarefas, comomigrações. O histórico de execução inclui informações como a hora dasolicitação, hora de início, hora de conclusão e se a migração foi executada comêxito. Pode-se procurar no histórico de execuções por uma tarefa para ver oserros ou mensagens de aviso relacionadas a ela.

Para migrar conteúdo do IBM Cognos Connection, assegure-se de que oscomponentes de migração estejam instalados na mesma instância do IBM CognosBI da qual deseja migrar. Não é possível migrar conteúdo de outra instância doIBM Cognos BI.

Você também deve se certificar de que todos os usuários que executarão umamigração têm as capacidades necessárias.

Para obter melhores resultados, não remova cubos e relatórios do ambiente do IBMCognos Series 7 até que tenha concluído a migração.

Nota: Se você executar uma tarefa de migração e, em seguida, executar outratarefa de migração usando o mesmo local de destino, qualquer conteúdo que tenhasido migrado será substituído. Os objetos que serão substituídos incluem relatórios,cubos, configurações de servidor, origens de dados e pastas. Se houver mudançanas configurações do IBM Cognos BI após a migração do conteúdo, a tarefa demigração substituirá as configurações pelas configurações originais. Por exemplo,você migra o conteúdo de uma pasta do PowerPlay Enterprise Server. Após amigração, usa o IBM Cognos Administration para modificar algumas configuraçõesde cubo, relatório ou pasta para o conteúdo migrado. Se você migrar o conteúdodessa pasta do PowerPlay Enterprise Server novamente, as configurações originaisserão substituídas por quaisquer configurações que tenham sido alteradas no IBMCognos BI para o conteúdo daquela pasta. As configurações de relatório e cubo sóserão substituídas se o mesmo relatório ou cubo for migrado novamente. Asconfigurações de pasta serão substituídas se algum conteúdo for migrado para apasta no IBM Cognos BI.Conceitos relacionados:

66 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 75: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

“Criação de log de migração” na página 113Os eventos encontrados ao migrar do IBM Cognos Series 7 PowerPlay para o IBMCognos PowerPlay são registrados em dois arquivos, c10_location\logs\cogserver.log e s7_location/migs7/log.txt.Tarefas relacionadas:“Permissão para que usuários executem tarefas de migração” na página 32Os usuários ou grupos de usuários que desejarem executar tarefas de migraçãoprecisam da concessão de capacidades apropriadas.

Criar uma Tarefa de MigraçãoPara migrar o conteúdo do IBM Cognos Series 7, você deve criar uma tarefa demigração.

Procedimento1. No IBM Cognos Administration, na guia Configuração, clique em

Administração de Conteúdo.

2. Na barra de ferramentas, clique no ícone Nova Migração .3. Na caixa Nome, digite um nome para a tarefa de migração.

Opcionalmente, pode ser inserida uma Descrição e uma Dica de tela.Se não desejar utilizar a pasta de destino exibida em Localização para salvar atarefa de migração, clique em Selecionar outra pasta e clique em Nova Pastapara criar uma nova localização.

Resultados

Depois de criada uma tarefa de migração, você deve especificar a origem demigração.

Especificar a Origem de MigraçãoEspecifique a origem do conteúdo do IBM Cognos Series 7 que você deseja migrar.

Procedimento1. Na página Especificar um Servidor de Migração do Series 7, digite o nome do

servidor IBM Cognos Series 7 em que os componentes de migração do IBMCognos Series 7 estão instalados, e o número da porta usado pelo serviço demigração do IBM Cognos Series 7. O padrão é 21567.O nome do servidor IBM Cognos Series 7 especificado não precisa corresponderaos nomes de servidores especificados no IBM Cognos Series 7 ConfigurationManager. Os nomes devem direcionar somente para o mesmo endereço IP paraque sejam considerados como o mesmo computador.Dica: A entrada no arquivo migs7service_configuration.xml localizado na pastas7_location\migs7 determina a porta que o serviço de migração usa.

2. Na página Selecionar uma origem de migração, escolha a origem na listasuspensa Migrar o conteúdo do PowerPlay de.v Selecione IBM Cognos Connection para migrar o conteúdo do IBM Cognos

Series 7 PowerPlay que foi publicado no IBM Cognos Connection.v Selecione Upfront para migrar o conteúdo do Upfront, incluindo o conteúdo

do Upfront e o conteúdo publicado do PowerPlay.v Selecione PowerPlay Enterprise Server para migrar o conteúdo do

PowerPlay Enterprise Server.

Capítulo 5. Migrando do IBM Cognos Series 7 PowerPlay para o IBM Cognos PowerPlay 67

Page 76: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Para o nome de usuário e a senha, digite credenciais válidas para o servidor deorigem. Para migrar conteúdo do Upfront ou do PowerPlay Enterprise Server, onome do usuário escolhido deve ser um membro da classe de usuário raiz.

Resultados

Depois de especificada a origem de migração, selecione as opções de migração.

Selecionar Opções de MigraçãoÉ possível escolher opções sobre como migrar fontes PDF e informações desegurança do relatório do IBM Cognos Series 7.

Procedimento1. Em Fontes PDF do relatório do IBM Cognos Series 7 PowerPlay, escolha

como deseja migrar as fontes PDF do relatório do Series 7 PowerPlay.Essa opção controla como a opção de geração de arquivos leves em formatoPDF é migrada.v Se a origem de migração for o PowerPlay Enterprise Server e você quiser

migrar as configurações do relatório em PDF do Series 7 PowerPlay para oIBM Cognos PowerPlay como estão, clique em Reter as configurações deorigem PDF do Series 7.

Nota: Se o relatório de origem tiver a opção Geração de Arquivos PDF Levesativada e a configuração Layout de PDF for Layout do Cliente, o relatóriopoderá não ser processado corretamente no IBM Cognos BI. A fonteAndaleWT usada em relatórios do PowerPlay não é uma fonte padrão dosistema operacional Microsoft Windows. Para evitar esse problema, incluafontes em relatórios migrados.Se a origem de migração for IBM Cognos Connection, a opção Geração deArquivos PDF Leves não será migrada quando for herdada, em vez deexplicitamente configurada.

v Para desativar a opção Geração de Arquivos PDF Leves no IBM CognosPowerPlay, clique em Incluir fontes.As fontes são incorporadas aos relatórios e serão processadas corretamenteno PDF. Note que as fontes incluídas irão aumentar o tamanho do relatório.

v Para ativar a opção Geração de Arquivos PDF Leves no IBM CognosPowerPlay, clique em Excluir fontes.As fontes não são incorporadas na saída em PDF dos relatórios. A saída emPDF pode não ser exibida corretamente se o computador usado para avisualização do PDF não possuir as fontes necessárias instaladas.

2. Na seção Configurações de segurança, escolha como deseja migrar asinformações de segurança.Algumas opções ficam disponíveis apenas quando o namespace do IBMCognos Series 7 está definido no IBM Cognos BI.

Nota: Se você estiver migrando para a versão de 64 bits do IBM Cognos BI,não poderá migrar informações de segurança porque os namespaces do IBMCognos Series 7 não são suportados no IBM Cognos BI de 64 bits.v Em Cubos PowerPlay protegidos do namespace do IBM Cognos Series 7,

escolha como deseja migrar os cubos protegidos.Para migrar cubos protegidos apenas se o namespace do cubo de cada cubofor definido no IBM Cognos BI, clique em Migrar para origem de dados e

68 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 77: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

restringir método de autenticação para namespace de origem. Para cadacubo migrado, a conexão da origem de dados para o pacote é criada com aopção de signon configurada para restringir a autenticação do PowerCubepara o namespace.Para migrar todos os cubos protegidos, clique em Migrar para a origem dedados e configurar o método de autenticação para todos os namespacesaplicáveis. Para cada cubo migrado, a conexão da origem de dados para opacote é criada com a opção de signon configurada para autenticar todos osnamespaces aplicáveis. Após a migração, talvez seja necessário configurar asinformações de segurança no IBM Cognos BI para tornar os pacotesutilizáveis.

v Em NewsBoxes pessoais do Upfront, escolha onde deseja migrar asNewsBoxes pessoais ao migrar o conteúdo Upfront.Para migrar o conteúdo das NewsBoxes pessoais para a pasta Minhas pastasde cada usuário, clique em Migrar para Minhas pastas do IBM Cognos.Para migrar o conteúdo das NewsBoxes pessoais para a Pasta pública, cliqueem Migrar para a pasta pública do IBM Cognos. O conteúdo herdará asconfigurações de permissão do IBM Cognos BI da pasta pai.Se não quiser migrar o conteúdo das NewsBoxes pessoais, clique em Nãohouve migração. As NewsBoxes pessoais não estarão visíveis quando oconteúdo que deseja migrar for selecionado.

v Em Privilégios de acesso de segurança do Upfront, escolha se deseja migraras classes de usuário e as informações da lista de controle de acesso doUpfront (ACL).Para migrar classes de usuários e informações do Upfront ACL, clique emMigrar para as permissões do IBM Cognos. Apenas usuários comprivilégios suficientes poderão acessar objetos migrados no IBM CognosConnection quando o IBM Cognos BI estiver protegido.Se não quiser migrar as classes de usuário e as informações do Upfront ACL,clique em Não houve migração. Os objetos migrados no IBM CognosConnection herdarão as configurações de permissão do IBM Cognos BI dapasta pai de cada objeto.

v Em Informações de contato de relatório do Upfront, escolha se desejamigrar as informações de contato da classe do usuário.Para migrar informações de contato, clique em Migrar para as informaçõesde contato do IBM Cognos. As informações de contato são migradas para asinformações de contato do objeto migrado no IBM Cognos Connection.Se não quiser migrar as informações de contato, clique em Não houvemigração. As informações de contato para cada objeto migrado serãoconfiguradas como Nenhum. Observe que se for migrado o mesmo conteúdodo Upfront mais uma vez com a opção de migrar informações de contato,elas não serão migradas.

Resultados

Depois de especificadas as opções de migração, selecione o conteúdo a sermigrado.Conceitos relacionados:“Configuração de geração de arquivos PDF leves não migrados” na página 125A configuração de geração de arquivos PDF leves de um relatório não serámigrada quando for herdada da pasta pai em vez de ser configuradaexplicitamente.

Capítulo 5. Migrando do IBM Cognos Series 7 PowerPlay para o IBM Cognos PowerPlay 69

Page 78: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

“Informações de contato do Upfront não migradas” na página 121Você migra o conteúdo do IBM Cognos Series 7 Upfront e seleciona a opção paranão migrar informações de contato da classe de usuário. Você migrou o mesmoconteúdo do Upfront uma segunda vez com a opção de migrar informações decontato da classe de usuário, mas as informações não foram migradas.

Selecionar o Conteúdo para MigrarSelecione o conteúdo que você deseja migrar.

Procedimento1. Na página Selecionar o conteúdo, selecione as pastas ou NewsBoxes que serão

migrados.O conteúdo exibido na árvore de origem depende das opções de segurançaselecionadas na etapa anterior.Não é possível selecionar cubos ou relatórios individuais dentro de uma pasta.Entretanto, é possível migrar cubos que não possuem relatórios criados a partirdeles.Se selecionar uma pasta vazia ou um NewsBox, ele não será migrado e nãoserá exibido no logo como falha de migração.Se não desejar utilizar a pasta de destino exibida em Localização para migrarconteúdo público, clique em Selecionar outra pasta para escolher outralocalização ou criar uma nova para o conteúdo público migrado.O conteúdo privado é migrado para o local Minhas Pastas de cada usuário noIBM Cognos BI. Não é possível selecionar outro local para migrar conteúdoprivado.

Nota: As entradas colocadas nas Pastas Públicas são de interesse de diversosusuários e podem ser visualizadas por muitos deles. Se não deseja que oconteúdo migrado fique disponível para outros usuários, escolha ou crie umlocal de destino com permissões mais restritas.

2. Na página Especifique os mapeamentos de cubo, execute um dosprocedimentos a seguir:v Para aceitar o mapeamento padrão de cubo, clique em Avançar.

O caminho e o nome de cada PowerCube de origem são usados para criar onome padrão do pacote de destino.

v Para selecionar outro pacote, clique em Selecionar um pacote na colunaAções.O pacote deve existir. É possível alterar o local clicando no link do caminhode navegação e localizando o pacote que se deseja utilizar para omapeamento.

Dica: É possível reconfigurar sua seleção para o mapeamento de cubopadrão clicando em Reconfigurar.

Resultados

Depois de selecionar o conteúdo a ser migrado, é possível iniciar a migração.Conceitos relacionados:“Usando Recursos do PowerPlay no IBM Cognos BI” na página 56Migrar usuários e aplicativos do IBM Cognos Series 7 PowerPlay para o IBMCognos PowerPlay permite preservar a experiência de usuário do PowerPlay, mastambém aproveita vários outros aspectos do IBM Cognos Business Intelligence.

70 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 79: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Iniciar a MigraçãoDepois de selecionar o local de origem, opções e conteúdo do IBM Cognos Series 7a ser migrado, é possível iniciar a migração.

Procedimento1. Na página Revisar o resumo, faça o seguinte:

v Se estiver satisfeito com as seleções, clique em Avançar.v Para corrigir as seleções, clique em Voltar.

Dica: O contador Relatórios e outros objetos relacionados ao PowerPlay incluirelatórios, atalhos, URLs, visualizações de cubos e visualizações customizadas.

2. Na página Selecionar uma ação, selecione como deseja completar a migração eclique em Concluir.v Para salvar a tarefa de migração e migrar o conteúdo imediatamente ou

posteriormente, clique em Salvar e executar uma vez.v Para salvar a tarefa de migração e migrar o conteúdo em um horário

específico, clique em Salvar e programar.v Para salvar a tarefa de migração sem executá-la, clique em Somente salvar.A migração pode demorar muito tempo dependendo do número de objetos queestiver migrando.

Resultados

Quando a tarefa de migração for concluída, uma pasta Conteúdo migrado serácriada no local especificado e conterá a mesma estrutura de diretórios davisualização migrada. Um arquivo de implementação contendo o conteúdomigrado também será criado. O nome do archive será o nome da tarefa demigração juntamente com o registro de data e hora da criação do archive. Se atarefa de migração for executada novamente depois, um novo arquivo deimplementação será criado.

Para integrar o conteúdo migrado com o conteúdo existente do IBM Cognos BI,mova o conteúdo da pasta Conteúdo Migrado para pastas novas ou existentes emPastas Públicas. Pode ser necessário atualizar algumas definições de configuraçãopara o conteúdo migrado. As definições de configuração migradas do IBM CognosSeries 7 são consideradas configurações customizadas no IBM Cognos BI. Umamudança na configuração em um nível superior ao do conteúdo migrado, como dePastas Públicas, não afetará uma configuração customizada. Por exemplo, deve-seredefinir a configuração de nível de auditoria para o conteúdo migrado antes de asmudanças para a configuração de nível de auditoria para Pastas Públicas seremaplicadas no conteúdo migrado. Para obter mais informações sobre como alterar asdefinições de configuração, consulte o Guia de Administração e Segurança do IBMCognos BI.

Se a migração não for bem-sucedida, será possível visualizar o histórico deexecução da tarefa de migração ou acessar a pasta c10_location\logs e verificar oarquivo cogserver.log.

Recomendação - Mantenha os Cubos e os Relatórios em seuAmbiente de Origem até a Conclusão da Migração

Para assegurar uma migração bem-sucedida, deve haver conteúdo válido noambiente do IBM Cognos Series 7.

Capítulo 5. Migrando do IBM Cognos Series 7 PowerPlay para o IBM Cognos PowerPlay 71

Page 80: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Para obter melhores resultados, não remova conteúdo válido, seja cubos ourelatórios, do ambiente do IBM Cognos Series 7 até que tenha concluído amigração.

Migrando Relatórios Locais para o IBM Cognos BISão fornecidas duas macros para migrar relatórios locais do PowerPlay para o IBMCognos PowerPlay. Uma delas converterá do formato ppr para o formato ppx, queé necessário pelo IBM Cognos PowerPlay. A outra alterará as referências remotasde cubo nos relatórios ppx para referências de pacote para o ambiente do IBMCognos PowerPlay.

Se você estiver usando relatórios ppx locais com PowerCubes locais, basta abriresses relatórios no PowerPlay Client, a menos que o cubo esteja protegido contraum namespace.Conceitos relacionados:“Segurança” na página 11No IBM Cognos Series 7, os administradores designam um usuário a classes deusuários a partir de um namespace como parte da infraestrutura de segurança. Aclasse de usuário determina a visualização do usuário dos dados do cubo.

Conversão de arquivos PPR para PPX para migraçãoO IBM Cognos PowerPlay não abre relatórios no formato ppr. Para poder abrirrelatórios ppr, você deve primeiro convertê-los para o formato ppx.

Uma macro chamada ppr2ppx.mac é fornecida para permitir a conversão derelatórios no formato ppr para o formato ppx. A macro permite converter todos osarquivos ppr de um diretório. A macro também converterá qualquer arquivo pprque estiver dentro das pastas do diretório de origem inserido.

Para usar essa macro, o IBM Cognos Series 7 PowerPlay Client deve ser instaladono mesmo computador em que a macro é executada. O IBM Cognos Series 7PowerPlay é necessário para acessar os relatórios com formato ppr.

Procedimento1. Acesse o diretório c10_location\PPClient\Macros no computador em que

instalou o IBM Cognos PowerPlay.2. Abra o arquivo ppr2ppx.mac no IBM Cognos Series 7 CognosScript Editor.

As instruções para utilização da macro na linha de comandos são fornecidas naprópria macro. Para obter informações adicionais sobre macros, consulte oPowerPlay Macro Reference Guide.

Dica: É possível usar outras ferramentas suportadas, como o Microsoft VisualBasic para executar macros.

3. Localize a linha em que se lêstrSourceDir = ""

e digite um diretório de origem no qual estão localizados os arquivos ppr. Porexemplo: altere a linha parastrSourceDir = "c:\myreports"

4. Localize a linha em que se lêstrOutputDir = ""

e digite o diretório para o qual deseja que os relatórios convertidos sejamcopiados. Por exemplo: altere a linha para

72 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 81: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

strOutputDir = "c:\mymigratedreports"5. Se tiver aplicado segurança aos PowerCubes, localize a linha em que se lê

objPPlayApp.SetMDCAccessInfo

e remova o comentário da linha removendo ’ do início da linha, e digite asinformações de segurança necessárias para o PowerCube.Para obter informações adicionais sobre elementos da macro, consulte oPowerPlay Macro Reference Guide.

6. Se não desejar ser questionado sobre informações de segurança que faltam,localize a linha em que se lêobjPPlayApp.LogonPrompt = False

e remova o comentário da linha removendo o ’ do início. Isso permitirá que amacro seja executada sem supervisão. Os relatórios que acessam cubos segurossem as credenciais adequadas não serão convertidos, mas serão registrados.

7. Salve e execute a macro.Os arquivos ppx convertidos serão criados no diretório de saída indicado equalquer mensagem de log será incluída no arquivo ppr2ppx.log no diretóriode saída.

Migrar Relatórios Locais para o IBM Cognos BISe você tiver arquivos ppx locais que acessam cubos remotos, uma macro seráfornecida para fazer upgrade do relatório para usar o ambiente do IBM CognosPowerPlay. A macro altera a referência do cubo para uma referência de pacote doIBM Cognos Business Intelligence e converte a codificação de relatório em UTF-8.

Procedimento1. Acesse o diretório c10_location\PPClient\Macros no computador em que

instalou o IBM Cognos PowerPlay.2. Abra o arquivo ppx_upgrade.mac no IBM Cognos Series 7 CognosScript Editor.

As instruções para utilização da macro na linha de comandos são fornecidas naprópria macro. Para obter informações adicionais sobre macros, consulte oPowerPlay Macro Reference Guide.

Dica: É possível usar outras ferramentas suportadas, como o Microsoft VisualBasic para executar macros.

3. Localize a linha em que se lêstrSourceDir = ""

e digite um diretório de origem no qual estão localizados os arquivos ppx. Porexemplo: altere a linha parastrSourceDir = "c:\myreports"

4. Localize a linha em que se lêstrOutputDir = ""

e digite o diretório para o qual deseja que os relatórios migrados sejamcopiados. Por exemplo: altere a linha parastrOutputDir = "c:\mymigratedreports"

5. Localize a linha em que se lêstrMigrationFile = ""

e digite o caminho e o nome do arquivo de configuração de conversão que écriado quando se executa uma tarefa de migração. O arquivo é chamadoPPS7TOC8CFG.xml e é criado no diretório c10_location\configuration.Por exemplo: altere a linha para

Capítulo 5. Migrando do IBM Cognos Series 7 PowerPlay para o IBM Cognos PowerPlay 73

Page 82: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

strMigrationFile = "c:\Arquivos de Programas\ibm\cognos\c10\configuration\PPS7TOC8CFG.xml"

6. Salve e execute a macro.Os arquivos ppx atualizados serão criados no diretório de saída indicado equalquer mensagem de log será incluída no arquivo ppx_upgrade.log nodiretório de saída.

Tarefas relacionadas:“Usando o Utilitário de Conversão do Marcador no IBM Cognos PowerPlay”Você usa o utilitário de conversão de marcador para converter marcadores doPowerPlay Enterprise Server em um formato que possa ser lido pelo IBM CognosPowerPlay Studio.

Usando o Utilitário de Conversão do Marcador no IBM CognosPowerPlay

Você usa o utilitário de conversão de marcador para converter marcadores doPowerPlay Enterprise Server em um formato que possa ser lido pelo IBM CognosPowerPlay Studio.

Ao executar uma tarefa de migração, um arquivo de configuração é geradoespecificando os mapeamentos de origem de dados do ambiente do IBM CognosSeries 7 para o ambiente do IBM Cognos Business Intelligence. Esse arquivopermite atualizar os marcadores para o seu ambiente do IBM Cognos PowerPlay.

Se possuir marcadores armazenados em uma localização central ou compartilhada,é possível usar o utilitário de conversão de marcadores como um aplicativo queutiliza um arquivo de texto com uma lista de marcadores como entrada .

Alternativamente, é possível usar o utilitário como um servidor para redirecionaros marcadores do IBM Cognos Series 7 para um local do IBM Cognos BI parapermitir que os usuários convertam seus próprios marcadores durante seu uso.

Um arquivo de configuração de conversão de marcadores é gerado quando seexecuta uma tarefa de migração chamada PPS7TOC8CFG.xml. Você deve verificarse os valores adequados foram utilizados no arquivo antes de executar o utilitáriode conversão de marcadores.

Cada vez que uma tarefa de migração é executada, o arquivo de configuração deconversão é anexado às novas informações e qualquer valor conflitante ésubstituído com valores da nova tarefa de migração.

Se nenhuma tarefa de migração for executada, esse arquivo não será gerado. Sedesejar usar o utilitário de conversão de marcadores, mas ainda não executou umatarefa de migração, será necessário criar um arquivo de configuração de conversãode marcadores manualmente.

Execução do utilitário de conversão de marcadores como umaplicativo

Ao executar o utilitário de conversão de marcador como um aplicativo, eleconverte todos os marcadores do IBM Cognos Series 7 contidos no arquivo detexto de entrada ao mesmo tempo.

74 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 83: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Você deve especificar o arquivo de configuração de conversão, o arquivo de textode entrada e um arquivo de texto de saída que serão criados automaticamenteapós a execução do utilitário.

Como o sistema operacional Linux não é uma plataforma suportada para o IBMCognos Series 7 PowerPlay, o utilitário de conversão de marcador não é suportadono Linux.

Antes de Iniciar

Antes de poder executar o utilitário de conversão de marcadores como umaplicativo, você deve criar um arquivo de texto de entrada. O arquivo de textocontém uma lista de marcadores do IBM Cognos Series 7, um por linha.

Procedimento1. Crie um arquivo em um editor de texto.2. Insira a URL de cada marcador em uma nova linha do arquivo:

http://series7server1/cognos/cgi-bin/ppdscgi.exe?bookmark1_idhttp://series7server1/cognos/cgi-bin/ppdscgi.exe?bookmark2_idhttp://series7server1/cognos/cgi-bin/ppdscgi.exe?bookmark3_idhttp://series7server1/cognos/cgi-bin/ppdscgi.exe?bookmarkn_id

3. Salve o arquivo.Esse arquivo será utilizado como arquivo_de_entrada.txt nas seguintes etapas.

4. Acesse o diretório c10_location\bin.5. Execute o utilitário de conversão de marcadores digitando o seguinte no

prompt de comandos:pp7bkmmigtool.exe APP path\PPS7TOC8CFG.xml path\input_file.txtpath\output_file.txtSe migrou para outro idioma que não o inglês, será necessário incluir umparâmetro de idioma no comando para processar corretamente o arquivo deconfiguração de conversão de marcador. Por exemplo, se migrou conteúdo emfrancês, digite o comando comopp7bkmmigtool.exe APP path\PPS7TOC8CFG.xml path\input_file.txtpath\output_file.txt frA opção de idioma utiliza um código de duas letras. Por exemplo, fr parafrancês, de para alemão, es para espanhol e ja para japonês. Quando especificarum parâmetro de idioma, as mensagens de log também ficarão naquele idioma.Os erros são registrados no arquivo PP7BkmTool.log no diretórioc10_location\bin.

Resultados

O arquivo de saída é gerado, contendo os marcadores convertidos do IBM CognosBusiness Intelligence.Tarefas relacionadas:“Criação manual de arquivos de configuração de conversão” na página 79Um arquivo de configuração de conversão de marcadores é geradoautomaticamente quando se executa uma tarefa de migração. No entanto, senenhuma tarefa de migração for executada, esse arquivo não será gerado.

Capítulo 5. Migrando do IBM Cognos Series 7 PowerPlay para o IBM Cognos PowerPlay 75

Page 84: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

“A migração de marcadores gera URLs inválidos” na página 124Após executar o utilitário de migração de marcadores, o URL de cada marcadormigrado não será válido. Especificamente, o gateway em cada URL nãocorresponde ao gateway real do IBM Cognos Business Intelligence. O gatewayusado é o gateway padrão, que normalmente é http://localhost:80/ibmcognos/cgi-bin/cognos.cgi.

Execução do utilitário de conversão de marcadores como umservidor

Quando o utilitário de conversão de marcadores é executado como um servidor,ele pode ser utilizado de duas formas.

A primeira é se você deseja manter o IBM Cognos Series 7 em execução. Osusuários acessam um marcador por meio do PowerPlay Enterprise Server e, emseguida, clicam em um botão customizado que os redireciona para um marcadordo IBM Cognos Business Intelligence.

A segunda é se você deseja obsoletar o ambiente do IBM Cognos Series 7. Dessamaneira, quando os usuários acessam um marcador, eles são automaticamenteredirecionados para um marcador do IBM Cognos BI.

Para usar o utilitário de uma dessas duas maneiras, você deve primeiro configuraro servidor.

Para fornecer acesso ao servidor, um arquivo bookmarkcgi.exe é incluído nodiretório c10_location\cgi-bin. O bookmarkcgi.exe pode ser acessado ao usar amesma URL do gateway do aplicativo IBM Cognos BI, exceto com o alterado parabookmarkcgi.exe, em vez de cognos.cgi. Por exemplo, se você acessar o IBMCognos BI a partir de http://server_name/ibmcognos/cgi-bin/cognos.cgi, o cgi domarcador será acessado como http://server_name/ibmcognos/cgi-bin/bookmarkcgi.exe.

Nota: Se mais de um ambiente do IBM Cognos Series 7 tiver sido migrado para oIBM Cognos BI, recomendamos o uso de um bookmarkcgi separado para cadaambiente. Isso permite a inclusão de uma URL do CGI do marcador na lista degateways de cada ambiente do IBM Cognos Series 7 no arquivo de configuração deconversão. A inclusão de URLs de CGI do marcador nesse arquivo assegura que outilitário de conversão possa consultar o ambiente correto do IBM Cognos Series 7ao executar a conversão.Tarefas relacionadas:“Criação manual de arquivos de configuração de conversão” na página 79Um arquivo de configuração de conversão de marcadores é geradoautomaticamente quando se executa uma tarefa de migração. No entanto, senenhuma tarefa de migração for executada, esse arquivo não será gerado.“A migração de marcadores gera URLs inválidos” na página 124Após executar o utilitário de migração de marcadores, o URL de cada marcadormigrado não será válido. Especificamente, o gateway em cada URL nãocorresponde ao gateway real do IBM Cognos Business Intelligence. O gatewayusado é o gateway padrão, que normalmente é http://localhost:80/ibmcognos/cgi-bin/cognos.cgi.

Configurar o ServidorPara usar o utilitário de conversão de marcador, você deve primeiro configurar oservidor criando um arquivo de configuração que contém o nome do servidor, o

76 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 85: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

número da porta a ser usada para um arquivo de log e um idioma a ser usadopara 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 oidioma das mensagens do log.

Procedimento1. No diretório s7_location\cgi-bin, crie um arquivo de texto chamado

bookmarkcgi.conf e inclua 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 parafrancê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 c10_location\bin, inicie o utilitário de conversão de marcador noprompt de comandos:pp7bkmmigtool.exe SERVER path\PPS7TOC8CFG.xml port_number

Onde PPS7TOC8CFG.xml é o arquivo de configuração gerado pela migração ouo arquivo criado manualmente , caso a tarefa de migração não tenha sidoexecutada.O utilitário de conversão de marcadores é iniciado e deve permanecer emexecução para converter os marcadores conforme são acessados pelos usuários.Os erros são registrados no arquivo pp7bkmtool.log.

Resultados

Agora é possível permitir que os usuários alterem os marcadores para o IBMCognos Business Intelligence ou redirecionem automaticamente os marcadores parao IBM Cognos BI.

Permitir que os Usuários Alterem os Marcadores no IBM CognosBIDepois de configurar o servidor, é possível permitir que os usuários alterem osmarcadores para o IBM Cognos Business Intelligence.

Procedimento1. Abra a ferramenta PowerPlay Enterprise Server Administration.2. Visualize as propriedades do servidor, clique em Configurações de Cubos e

expanda a pasta Barras de Ferramentas.3. Na propriedade Customizado 1, altere a configuração para Ativado.

Isso criará um botão customizado na barra de ferramentas que seráexibido quando estiver visualizando um cubo.

4. No diretório s7_location\webcontent\ppwb, abra o arquivo ppwbcustom.js emum 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:

Capítulo 5. Migrando do IBM Cognos Series 7 PowerPlay para o IBM Cognos PowerPlay 77

Page 86: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

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;}

em que <bookmarkcgi URL> é a URL para o arquivo bookmarkcgi.exe nodiretório c10_location\cgi-bin.Por exemplo, se você acessar o IBM Cognos BI a partir de http://server_name/ibmcognos/cgi-bin/cognos.cgi, o cgi do marcador será acessado comohttp://server_name/ibmcognos/cgi-bin/bookmarkcgi.exe.Nota: As aspas nas linhas são obrigatórias. Os sinais de maior e menor, < e >,indicam um valor que deve ser alterado.

Resultados

Depois de abrir qualquer marcador do IBM Cognos Series 7, é possível convertê-loe redirecioná-lo para um marcador equivalente do IBM Cognos BI usando o novobotão customizado.

Redirecionar Automaticamente os Marcadores para o IBMCognos BIDepois de configurar o servidor, é possível redirecionar automaticamente osmarcadores para o IBM Cognos Business Intelligence.

Procedimento1. No diretório c10_location\cgi-bin, faça uma cópia do arquivo bookmarkcgi.exe e

renomeie-o como ppdsweb.cgi.2. Copie ppdsweb.cgi para cada um dos diretórios s7_location\cgi-bin em cada um

dos computadores do servidor IBM Cognos Series 7.3. Para exibir quaisquer mensagens no idioma apropriado, copie todos os

arquivos dll, ou os arquivos cat no sistema operacional UNIX, que começamcom PPWebCGIMsg do diretório c10_location\cgi-bin para os diretórioss7_location\cgi-bin.

Resultados

Todos os marcadores no IBM Cognos Series 7 são agora convertidos eredirecionados automaticamente para o IBM Cognos BI ao serem abertos.

Nota: Isso se aplica apenas a marcadores que foram criados com relação aogateway CGI. Marcadores criados em gateways ISAPI ou NSAPI não serãoconvertidos. É possível converter esses marcadores alterando o URI parahttp://server_name/ibmcognos/cgi-bin/bookmarkcgi.exe nos marcadores antigos.Não altere o parâmetro BZ.

78 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 87: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Criação manual de arquivos de configuração de conversãoUm arquivo de configuração de conversão de marcadores é geradoautomaticamente quando se executa uma tarefa de migração. No entanto, senenhuma tarefa de migração for executada, esse arquivo não será gerado.

Se desejar usar o utilitário de conversão de marcadores, mas ainda não executouuma tarefa de migração, será necessário criar um arquivo de configuração deconversão de marcadores manualmente.

Procedimento1. Com um editor de XML, crie um arquivo de configuração de conversão

conforme mostrado abaixo.<?xml version="1.0" encoding="UTF-8"?><bkmk_mig_tool><c8gateway>http://servername:port_number/ibmcognos/cgi-bin/cognos.cgi</c8gateway><section><s7encoding value="windows-1252"/><s7gateways><gateway>http://servername/cognos/cgi-bin/ppdscgi.exe</gateway><gateway>http://series7alt1/cognos/cgi-bin/ppdscgi.exe</gateway></s7gateways><datasources><datasource s7path="/cube1name" c8SearchPath="/content/folder[@name=’

foldername’]/package[@name=’cube1name’]" c8StoreId="iGHSJKDNGJSAMDHSJRGANDJDFGJAS"/>

<datasource s7path="/cube2name" c8SearchPath="/content/folder[@name=’foldername’]/package[@name=’cube2name’]" c8StoreId="iGAUIHMTJUTOSLATMSDJFIGGHYUIR"/></datasources></section></bkmk_mig_tool>

nos quais:v o elemento c8gateway é a URL do computador de gateway do IBM Cognos

Business Intelligence.Todos os marcadores convertidos são executados por meio desse gateway.Somente um gateway pode ser especificado.

v o elemento s7encoding é a codificação nativa dos ambientes do IBM CognosSeries 7 incluídos no arquivo.O utilitário de conversão de marcadores converterá o marcador dacodificação nativa para a codificação UTF-8, que é necessária no IBM CognosBI.

Dica: É possível verificar a codificação usada no ambiente do IBM CognosSeries 7. No Configuration Manager, em Cognos Shared, clique em Códigodo Idioma.

v o elemento s7gateways é o gateway do ambiente do IBM Cognos Series 7.Se você usar gateways alternativos, inclua um elemento gateway paraseries7alt1. Por exemplo, inclua uma linha como a seguinte no elementos7gateways:<gateway>http://otherservername/cognos/cgi-bin/ppdscgi.exe</gateway>

O utilitário de conversão usa essa lista para determinar o ambiente do IBMCognos Series 7 ao qual o marcador pertenceu e qual lista de mapeamentousar.

v o elemento datasources mostra os cubos no ambiente do IBM Cognos Series7 que foram migrados. O elemento datasource contém as informações sobreo cubo.

Capítulo 5. Migrando do IBM Cognos Series 7 PowerPlay para o IBM Cognos PowerPlay 79

Page 88: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

s7path contém o nome completo do arquivo da janela Propriedades do Cubona ferramenta de administração do IBM Cognos Series 7 PowerPlayEnterprise Server. Por exemplo, se o cubo Grandes Aventuras existir dentrode uma pasta chamada Cubos, o caminho seria /Cubos/Grandes Aventuras.c8SearchPath contém o caminho do pacote correspondente no IBM CognosBI. No portal do IBM Cognos BI, é possível clicar no ícone Configurar

propriedades ao lado de qualquer pacote para mostrar a caixa dediálogo Configurar Propriedades e clicar em Visualizar o caminho daprocura, o ID e a URL para consultar o valor Caminho da Procura.c8StoreId contém o valor ID da caixa de diálogo Visualizar o caminho daprocura, o ID e a URL. Esse valor é exclusivo para cada objeto doarmazenamento de conteúdo do IBM Cognos.

2. Salve o arquivo, nomeando-o como PPS7TOC8CFG.xml.3. Converta seus marcadores ao executar o utilitário de conversão de marcadores

como um aplicativo ou como um servidor.Conceitos relacionados:“Execução do utilitário de conversão de marcadores como um servidor” na página76Quando o utilitário de conversão de marcadores é executado como um servidor,ele pode ser utilizado de duas formas.Tarefas relacionadas:“Execução do utilitário de conversão de marcadores como um aplicativo” napágina 74Ao executar o utilitário de conversão de marcador como um aplicativo, eleconverte todos os marcadores do IBM Cognos Series 7 contidos no arquivo detexto de entrada ao mesmo tempo.

80 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 89: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Capítulo 6. Configurando as Amostras do IBM CognosPowerPlay

Depois de instalar as amostras do CD de Amostras do IBM Cognos BusinessIntelligence, configure as amostras.

Criação de uma conexão de origem de dados para o PowerCube deamostra

Para poder abrir relatórios de amostra no IBM Cognos PowerPlay Studio, vocêdeve criar uma conexão de origem de dados com o PowerCube de amostra.

Procedimento1. Conecte-se ao portal do IBM Cognos BI.2. Inicie o IBM Cognos Administration:

v Na página Bem-vindo, clique em Administrar o conteúdo do IBM Cognos.v No IBM Cognos Connection, na barra de ferramentas, clique em Iniciar,

IBM Cognos Administration.3. No IBM Cognos Administration, clique na guia Configuração.

4. Clique no botão Nova Origem de Dados .5. Na caixa Nome, digite great_outdoors_sales_en e, em seguida, clique em

Avançar.O nome deve estar em minúsculas e incluir caracteres de sublinhado.

6. Na caixa Tipo, selecione IBM Cognos PowerCube e clique em Avançar.7. Na caixa de endereço, digite o caminho e o nome do arquivo para o

PowerCube great_outdoors_sales_en.mdc.Por exemplo, se você estiver criando uma conexão para amostras instaladasno local de instalação padrão no computador local, digite C:\Arquivos deProgramas\ibm\cognos\c10\webcontent\samples\datasources\cubes\PowerCubes\EN\great_outdoors_sales_en.mdc

8. Para confirmar que todos os parâmetros foram inseridos corretamente, cliqueem Testar a conexão.Após testar a conexão, clique em Fechar nas páginas Visualizar os resultadose Testar a conexão para retornar à página da sequência de conexões.

9. Clique em Concluir.10. Na página Concluir, clique em OK. Não selecione Criar um pacote.

Resultados

A entrada great_outdoors_sales_en é exibida na lista Conexões de Origens deDados.Tarefas relacionadas:“Importação de relatórios de amostra” na página 82É possível disponibilizar os relatórios de amostra para uso no Cognos Viewer ouno IBM Cognos PowerPlay Studio importando-os por meio de um arquivo deimplementação.

© Copyright IBM Corp. 2005, 2014 81

Page 90: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Importação de relatórios de amostraÉ possível disponibilizar os relatórios de amostra para uso no Cognos Viewer ouno IBM Cognos PowerPlay Studio importando-os por meio de um arquivo deimplementação.

Os dados de amostra do PowerPlay são compactados em um arquivo deimplementação para PowerPlay e migração e um arquivo de implementação paraexemplos de drill-through. Importe os arquivos de implementação no IBM CognosAdministration para que os usuários possam acessar os relatórios.

Outro método para tornar os relatórios disponíveis no Cognos Viewer ou noPowerPlay Studio é publicá-los usando o PowerPlay Client.

Antes de Iniciar

Antes de importar o conteúdo, verifique se o PowerCube de amostra foiconfigurado .Tarefas relacionadas:“Criação de uma conexão de origem de dados para o PowerCube de amostra” napágina 81Para poder abrir relatórios de amostra no IBM Cognos PowerPlay Studio, vocêdeve criar uma conexão de origem de dados com o PowerCube de amostra.

Importando o PowerPlay e as Amostras de MigraçãoUse o seguinte procedimento para importar o IBM Cognos PowerPlay e asamostras de migração.

Procedimento1. No computador em que as amostras estão instaladas, acesse o diretório

c10_location\webcontent\samples\content.Por exemplo, se as amostras foram instaladas no local de instalação padrão, ocaminho será C:\Program Files\ibm\cognos\c10\webcontent\samples\content

2. Copie o IBM_Cognos_PowerPlay.zip para o diretório c10_location\deployment no computador em que o componente Content Manager estáinstalado.

3. Conecte-se ao portal do IBM Cognos BI.4. Inicie o IBM Cognos Administration:

v Na página Bem-vindo, clique em Administrar o conteúdo do IBM Cognos.v No IBM Cognos Connection, na barra de ferramentas, clique em Iniciar,

IBM Cognos Administration.5. Clique na guia Configuração.6. Clique em Administração de Conteúdo.

7. Clique no botão Nova Importação .8. Selecione IBM_Cognos_PowerPlay e clique em Avançar.9. Mantenha o nome padrão e o local e, em seguida, clique em Avançar.

10. Selecione as pastas de Amostras e clique em Avançar.11. Mantenha as opções padrão e clique em Avançar.12. Revise o resumo e clique em Avançar.13. Selecione Salvar e executar uma vez e clique em Concluir.

82 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 91: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

14. Selecione Agora e clique em Executar.15. Clique em OK.

Resultados

IBM_Cognos_PowerPlay aparece em Administração e uma pasta Amostrasaparece em Pastas Públicas no IBM Cognos Connection.

Importando as Amostras de Drill ThroughUse o procedimento a seguir para importar as amostras de drill through.

Procedimento1. No computador em que as amostras estão instaladas, acesse o diretório

c10_location\webcontent\samples\content.Por exemplo, se as amostras foram instaladas no local de instalação padrão, ocaminho será C:\Program Files\ibm\cognos\c10\webcontent\samples\content

2. Copie o IBM_Cognos_DrillThroughSamples.zip para o diretórioc10_location\deployment no computador em que o componente ContentManager está instalado.

3. Conecte-se ao portal do IBM Cognos BI.4. Inicie o IBM Cognos Administration:

v Na página Bem-vindo, clique em Administrar o conteúdo do IBM Cognos.v No IBM Cognos Connection, na barra de ferramentas, clique em Iniciar,

IBM Cognos Administration.5. Clique em Configuração.6. Clique em Administração de Conteúdo.

7. Clique no novo botão de importação .8. Selecione IBM_Cognos_DrillThroughSamples e clique em Avançar.9. Mantenha o nome padrão e o local e, em seguida, clique em Avançar.

10. Selecione a pasta Amostras e clique em Avançar.11. Mantenha as opções padrão e clique em Avançar.12. Revise o resumo e clique em Avançar.13. Selecione Salvar e executar uma vez e clique em Concluir.14. Selecione Agora e clique em Executar.15. Clique em OK.

Teste de um relatório de amostraÉ possível testar a importação abrindo um relatório de amostra no Cognos Viewerou IBM Cognos PowerPlay Studio. O Cognos Viewer é o visualizador padrão aoabrir um relatório no IBM Cognos Connection.

Procedimento1. Para testar um relatório no Cognos Viewer, faça o seguinte:

a. Conecte-se ao portal do IBM Cognos BI e inicie o IBM Cognos Connection.b. Na página Bem-vindo, clique em Conteúdo do IBM Cognos.c. Na lista Pastas públicas, abra Amostras, PowerPlay.d. Clique em great_outdoors_sales_en.

Capítulo 6. Configurando as Amostras do IBM Cognos PowerPlay 83

Page 92: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

e. Clique em qualquer relatório na lista. O relatório será aberto no IBMCognos Viewer.

2. Para testar um relatório no PowerPlay Studio, faça o seguinte:a. Conecte-se ao portal do IBM Cognos BI e inicie o IBM Cognos Connection.b. Na página Bem-vindo, clique em Conteúdo do IBM Cognos.c. No IBM Cognos Administration, na barra de ferramentas, clique em Iniciar,

IBM Cognos Connection.d. Acesse Pastas Públicas, Amostras, PowerPlay.e. Clique em Mais para a entrada great_outdoors_sales_en.f. Clique em Visualizar o conteúdo do pacote.g. Clique no botão Abrir com o PowerPlay Studio para qualquer relatório na

lista. O relatório é aberto no PowerPlay Studio.

Configuração de PowerCubes e relatórios de amostra para migraçãoPara poder fazer uma migração de amostras do IBM Cognos Series 7 para o IBMCognos PowerPlay, você deve copiar o PowerCube e os relatórios de amostras doIBM Cognos Series 7 do computador com a instalação das amostras do IBMCognos BI para o computador com o IBM Cognos Series 7 PowerPlay EnterpriseServer.

Após configurar os PowerCubes e relatórios de amostra, é possível migrar osrelatórios. Após a migração, os usuários podem visualizar os relatórios no CognosViewer ou no PowerPlay Studio. Por padrão, os relatórios migrados estão noformato PDF.

Procedimento1. No computador em que as amostras do IBM Cognos BI estão instaladas, copie

o conteúdo a seguir para o computador com o IBM Cognos Series 7.v todos os relatórios do c10_location\webcontent\samples\powerplay_reports\

powerplay_7\reports_for_remote_cubes\language

v great_outdoors_7.mdc do diretório c10_location\webcontent\samples\datasources\cubes\PowerCubes\language

2. No IBM Cognos Series 7 PowerPlay Administration, inclua o cubo e osrelatórios no PowerPlay Enterprise Server.

3. Para atualizar o mapeamento do cubo, no IBM Cognos Series 7 PowerPlayClient, abra cada relatório usando uma conexão remota paragreat_outdoors_7.mdc e, em seguida, salve o relatório.

Resultados

O cubo e os relatórios estão agora prontos para serem usados no IBM CognosSeries 7.

84 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 93: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Capítulo 7. Configuração de criação de log

As mensagens de log do IBM Cognos Business Intelligence fornecem informaçõessobre os status de componentes, incluindo a atividade do PowerPlay e umavisualização de alto nível de eventos importantes.

As mensagens de log podem fornecer informações sobre tentativas de iniciar eparar serviços, conclusão de solicitações de processamento e indicadores para errosfatais. Os logs de auditoria, que estão disponíveis em um banco de dados decriação de log, fornecem informações sobre a atividade do usuário e do relatório.

Para obter informações adicionais sobre a criação de log do IBM Cognos BI,incluindo uma descrição de níveis de criação de log e configuração de relatórios deauditoria, consulte o Guia de Administração e Segurança do IBM Cognos BI.

É possível ativar a auditoria de estilo do IBM Cognos Series 7 para o serviço, oscubos e os relatórios do PowerPlay. Como a criação de log do IBM Cognos BIfornece as mesmas informações sobre a atividade do PowerPlay, talvez não hajavantagem em usar a auditoria de estilo do IBM Cognos Series 7. Usar apenas acriação de log do IBM Cognos BI oferece vantagens como o acesso às informaçõesde auditoria para todos os componentes do IBM Cognos BI em um único banco dedados. Diferente da auditoria do IBM Series 7 PowerPlay com componentesdistribuídos, há acesso quase instantâneo às informações de criação de log derelatório, pois não é necessário executar uma coleção separada para moverinformações de arquivos de log diferentes para um banco de dados comum.

Configurar a Criação de Log do IBM Cognos BIVocê configura níveis de criação de log no IBM Cognos Business IntelligenceAdministration para especificar os eventos e as mensagens para registro no arquivode log ou no banco de dados de log.

Um evento é uma ocorrência no ambiente do IBM Cognos BI que é significativo osuficiente para ser controlado, como o início e a interrupção de um serviço.

Para obter informações sobre como configurar a criação de log de outroscomponentes, como informações de sessão e de rastreamento do usuário com acriação de log do Content Manager, consulte o Guia de Administração e Segurança doIBM Cognos BI.

Especificar o Destino para Mensagens de Log do IBMCognos BI

O destino de mensagens de log foi configurado durante a instalação do IBMCognos PowerPlay. O destino padrão é um arquivo no computador local. O IBMCognos Business Intelligence também pode ser configurado para enviar mensagensde log para um banco de dados.

Para obter informações adicionais sobre opções de destino para mensagens de logou alterar o destino, consulte o Guia de Instalação e Configuração do IBM CognosPowerPlay.

© Copyright IBM Corp. 2005, 2014 85

Page 94: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Ativar Criação de Log para o Serviço PowerPlayVocê configura níveis de criação de log para especificar os eventos e as mensagenspara registro no serviço PowerPlay no arquivo de log ou no banco de dados delog, como o início ou a interrupção de um serviço.

A tabela seguinte mostra a informações registrada para cada nível de criação delog.

Tabela 24. Informações Registradas para Cada Nível de Criação de Log

Detalhes Mínima Básico Solicitação Rastreio Completo

Início e encerramentodo sistema e deserviços, erros detempo de execução

X X X X X

Gerenciamento decontas do usuário euso do tempo deexecução do IBMCognos BusinessIntelligence

X X X X

Solicitações de uso X X X X

Solicitações erespostas de serviço

X X

Todas as solicitaçõespara todos oscomponentes com osvalores de seusparâmetros

X X

outras consultas paraos componentes doIBM Cognos BI(consulta nativa)

X X

É possível manter o desempenho do sistema gerenciando a quantidade de criaçõesde log executadas pelo servidor. Como a criação de log extensivo afeta odesempenho do servidor, aumentar o nível de criação de log pode afetarnegativamente o desempenho do IBM Cognos BI.

O nível de criação de log padrão é Mínimo. Se a configuração padrão não fornecera informações solicitada, aumente o nível da criação de log gradualmente. Porexemplo, mover para o nível de criação de log solicitado fornecerá informaçõessobre a atividade de dimensão, nível e medida. Use o nível de criação de logCompleto somente para fins de solução de problemas detalhados, pois podecomprometer significativamente o desempenho do servidor.

Procedimento1. Inicie o IBM Cognos Connection.2. No canto superior direito, clique em Iniciar e em IBM Cognos Administration.

86 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 95: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

3. Na guia Status, clique em Sistema.4. No canto superior esquerdo da área de janela Scorecard, selecione Serviços e

clique em PowerPlay.5. Clique na seta ao lado de Serviço do PowerPlay para visualizar o menu Ações

e clique em Configurar propriedades.6. Clique na guia Configurações.7. No menu Categoria, clique em Criação de log.8. No menu Valor, selecione o nível de criação de log desejado para o serviço.

A menos que esteja solucionando problemas, Solicitação é um nível de criaçãode log adequado para a maioria das instalações.

9. Clique em OK.Conceitos relacionados:“Algumas Atividades do PowerPlay Não Estão Registradas” na página 126Se você visualizar o arquivo de log ou o banco de dados de log e informaçõessobre a atividade do IBM Cognos PowerPlay que você deseja controlar nãoaparecerem, é possível aumentar o nível de criação de log para registrar maisinformações.

Ativar a Criação de Log para Atividade de Cubo e de Relatóriodo PowerPlay

Por padrão, a criação de log não é ativada para cubos e relatórios. Para controlar aatividade de cubo e de relatório, você deve ativar a criação de log de auditoriapara cubos e relatórios na administração do IBM Cognos PowerPlay.

Pode-se efetuar auditoria resumida ou detalhada. A criação de log resumidaregistra todas as solicitações do servidor feitas para cubos e relatórios a partir detodos os usuários do PowerPlay. Os logs de criação de log detalhados registram asmedidas e as dimensões acessadas pelo PowerPlay Studio.

Procedimento1. No IBM Cognos Administration, clique na guia PowerPlay.2. Na lista Objetos Configuráveis, selecione uma pasta ou pacote.

As configurações serão aplicadas a todos os objetos contidos na pasta ou pacoteselecionados. É possível alterar um nível de auditoria para itens individuaisposteriormente para diferenciá-los do nível pai.

3. Clique na guia Configurações de Cubos ou Configurações de relatórios.4. Para Nível da auditoria, selecione Resumo ou Detalhe.5. Clique em OK.

Modelo de auditoria e relatórios de auditoria de amostraO IBM Cognos PowerPlay inclui um modelo de amostra e relatórios de auditoriade amostra que podem ser usados com a criação de log do IBM Cognos BusinessIntelligence.

Modelo de auditoria de amostra

O IBM Cognos BI inclui um modelo de auditoria de amostra no FrameworkManager. A localização padrão é c10_location/webcontent/samples/Models/Audit/Audit.cpf.

Capítulo 7. Configuração de criação de log 87

Page 96: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Relatórios de auditoria de amostra

A tabela a seguir lista os relatórios de auditoria de amostra do PowerPlay edescreve o conteúdo de cada relatório.

Tabela 25. Relatórios de Auditoria de Amostra

Nome do relatório deauditoria Descrição

Acesso ao PowerPlay Mostra quem acessou o PowerPlay, a que hora efetuaram logonno portal e qual pacote acessaram.

Uso do PowerPlay Mostra quais usuários acessaram quais pacotes e as dimensões,os níveis e as medidas que acessaram no pacote.

Esquema de Dados para Mensagens de Log do IBM CognosPowerPlay

A seção a seguir fornece informações sobre definições e interações de tabelas paramensagens de log do IBM Cognos PowerPlay.

Essas informações complementam as informações do esquema de dados paraoutros componentes do IBM Cognos Business Intelligence que aparecem no Guiade Administração e Segurança do IBM Cognos BI.

Definições de tabelasAs mensagens de log são registradas em uma tabela do banco de dados de criaçãode log sob determinadas condições. Essas condições dependem do nível de criaçãode log configurado no portal da web.

Para obter informações sobre os níveis de criação de log, consulte o IBM CognosBusiness Intelligence Administration and Security Guide.

Quando um usuário efetua logon no IBM Cognos BI, um ID de sessão é designadoe registrado em todas as mensagens de log. É possível utilizar a ID de sessão paraidentificar todas as ações executadas por um usuário.

As definições de tabela de banco de dados criadas no banco de dados de criaçãode log do IBM Cognos BI para PowerPlay são descritas na tabela a seguir, comuma referência cruzada para definições de coluna associadas.

Tabela 26. Definições de Tabela para o Banco de Dados de Criação de Log

Nome da tabela Descrição

COGIPF_POWERPLAY Armazena informações sobre solicitações dopacote, do relatório e da visualização derelatório do PowerPlay

COGIPF_POWERPLAY_DIM_USAGE Armazena informações sobre dimensõesusadas nas solicitações do pacote, dorelatório e da visualização de relatório doPowerPlay

88 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 97: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Tabela 26. Definições de Tabela para o Banco de Dados de Criação de Log (continuação)

Nome da tabela Descrição

COGIPGF_POWERPLAY_LEVEL_USAGE Armazena informações sobre os níveisusados nas solicitações do pacote, dorelatório e da visualização de relatório doPowerPlay

COGIPF_POWERPLAY_MEASURE_USAGE Armazena informações sobre as medidas doPowerPlay usadas nas solicitações do pacote,do relatório e da visualização de relatório doPowerPlay

COGIPF_MIGRATION Armazena informações sobre as operaçõesde serviço de migração

Interações entre tabelasAs informações a seguir descrevem colunas de cada tabela do IBM CognosPowerPlay no banco de dados de criação de log.

Tabela COGIPF_POWERPLAY:

A tabela COGIPF_POWERPLAY contém as seguintes colunas.

Tabela 27. Colunas na Tabela COGIPF_POWERPLAY

Nome da coluna Descrição e tipo de dado

COGIPF_HOST_ IPADDR O endereço IP do host onde a mensagem delog é gerada

VARCHAR2 (15)

COGIPF_HOST_ PORT O número da porta do host

NUMBER

COGIPF_PROC_ID A ID do processo atribuída pelo sistemaoperacional

NUMBER

COGIPF_LOCAL TIMESTAMP A data e a hora locais de quando amensagem de log foi gerada

Enquanto o relatório está sendo executado, éa hora em que a execução foi iniciada.Depois de completada a execução dorelatório, esta é a hora em que a mesma foiencerrada.

Para calcular a hora de início da execuçãode um relatório cuja execução já foicompletada, subtraia COGIPF_RUNTIME deCOGIPF_LOCALTIMESTAMP.

DATA

Capítulo 7. Configuração de criação de log 89

Page 98: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Tabela 27. Colunas na Tabela COGIPF_POWERPLAY (continuação)

Nome da coluna Descrição e tipo de dado

COGIPF_TIMEZONE_ OFFSET Fuso horário, a partir do GMT.

NUMBER

COGIPF_SESSIONID Número de identificação da sessão

VARCHAR2 (255)

COGIPF_ REQUESTID Número de identificação da solicitação

VARCHAR2 (255) UNIQUE NOT NULL

COGIPF_STEPID Número de identificação da etapa em umaexecução de tarefa (vazia se não houver)

VARCHAR2 (255)

COGIPF_ SUBREQUESTID Número de identificação da subsolicitaçãodo componente

VARCHAR2 (255)

COGIPF_THREADID O número de identificação do servidor ondea solicitação é executada

VARCHAR2 (255)

COGIPF_ COMPONENTID Nome do componente que gera a indicação

VARCHAR2 (4)

COGIPF_ BUILDNUMBER O maior número da construção docomponente que gera a indicação

NUMBER

COGIPF_ LOG_LEVEL Nível da indicação

NUMBER

COGIPF_ TARGET_TYPE O objeto no qual se executa a operação

VARCHAR2 (255)

COGIPF_ REPORTPATH O caminho do relatório

VARCHAR2 (512)

COGIPF_STATUS O status da operação: em branco se aexecução não tiver sido concluída, sucesso,aviso ou falha

VARCHAR2 (255)

90 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 99: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Tabela 27. Colunas na Tabela COGIPF_POWERPLAY (continuação)

Nome da coluna Descrição e tipo de dado

COGIPF_ RUNTIME O número de milissegundos necessáriospara executar o relatório

NUMBER

COGIPF_REPORTNAME O nome do relatório

VARCHAR2 (255)

COGIPF_PACKAGE O pacote ao qual o relatório está associado

VARCHAR2 (512)

COGIPF_DATASOURCE A origem de dados à qual o relatório estáassociado

VARCHAR2 (512)

COGIPF_DATASOURCE_CONNECTION A conexão da origem de dados à qual orelatório está associado

VARCHAR2 (512)

COGIPF_CUBEPATH O caminho até o PowerCube local ao qual orelatório está associado

VARCHAR2 (512)

COGIPF_OPERATION A ação executada no objeto

VARCHAR2 (128)

COGIPF_MESSAGE Detalhes do erro

VARCHAR2 (2000)

COGIPF_REQUEST_TYPE NUMBER

COGIPF_SUB_COMPONENTID VARCHAR2 (64)

Tabela COGIPF_POWERPLAY_DIM_USAGE:

A tabela COGIPF_POWERPLAY_DIM_USAGE contém as seguintes colunas.

Tabela 28. Colunas na Tabela COGIPF_POWERPLAY_DIM_USAGE

Nome da coluna Descrição e tipo de dado

COGIPF_SESSIONID Número de identificação da sessão

VARCHAR2 (255)

Capítulo 7. Configuração de criação de log 91

Page 100: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Tabela 28. Colunas na Tabela COGIPF_POWERPLAY_DIM_USAGE (continuação)

Nome da coluna Descrição e tipo de dado

COGIPF_REQUESTID Número de identificação da solicitação

VARCHAR2 (255) UNIQUE NOT NULL

COGIPF_DIM_CODE O código da dimensão associado àsolicitação

VARCHAR2 (256) UNIQUE NOT NULL

COGIPF_DIM_NAME O nome da dimensão associado à solicitação

VARCHAR2 (256)

COGIPF_DIM_COUNT A contagem da dimensão associada àsolicitação

NUMBER

Tabela COGIPF_POWERPLAY_LEVEL_USAGE:

A tabela COGIPF_POWERPLAY_LEVEL_USAGE contém as seguintes colunas.

Tabela 29. Colunas na Tabela COGIPF_POWERPLAY_LEVEL_USAGE

Nome da coluna Descrição e tipo de dado

COGIPF_SESSIONID Número de identificação da sessão

VARCHAR2 (255)

COGIPF_REQUESTID Número de identificação da solicitação

VARCHAR2 (255) UNIQUE NOT NULL

COGIPF_DIM_CODE O código da dimensão associado àsolicitação

VARCHAR2 (256) UNIQUE NOT NULL

COGIPF_LEVEL_CODE O código do nível associado à solicitação

VARCHAR2 (256) UNIQUE NOT NULL

COGIPF_LEVEL_NAME O nome do nível associado à solicitação

VARCHAR2 (256)

COGIPF_LEVEL_COUNT A contagem do nível associada à solicitação

NUMBER

92 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 101: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Tabela COGIPF_POWERPLAY_MEASURE_USAGE:

A tabela COGIPF_POWERPLAY_MEASURE_USAGE contém as seguintes colunas.

Tabela 30. Colunas na Tabela COGIPF_POWERPLAY_MEASURE_USAGE

Nome da coluna Descrição e tipo de dado

COGIPF_SESSIONID Número de identificação da sessão

VARCHAR2 (255)

COGIPF_REQUESTID Número de identificação da solicitação

VARCHAR2 (255)

COGIPF_MEASURE_CODE O código da medida associado à solicitação

VARCHAR2 (256)UNIQUE NOT NULL

COGIPF_MEASURE_NAME O nome da medida associado à solicitação

VARCHAR2 (256)

COGIPF_MEASURE_COUNT A contagem da medida associada àsolicitação

NUMBER

Tabela COGIPF_MIGRATION::

A tabela COGIPF_MIGRATION contém as seguintes colunas.

Tabela 31. Colunas da Tabela COGIPF_MIGRATION

Nome da coluna Descrição e tipo de dado

COGIPF_HOST_ IPADDR O endereço IP do host onde a mensagem delog é gerada

VARCHAR(128)

COGIPF_HOST_ PORT O número da porta do host

INT(4)

COGIPF_PROC_ID A ID do processo atribuída pelo sistemaoperacional

INT(4)

COGIPF_LOCALTIMESTAMP A data e a hora locais de quando amensagem de log foi gerada

DATETIME(8)

Capítulo 7. Configuração de criação de log 93

Page 102: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Tabela 31. Colunas da Tabela COGIPF_MIGRATION (continuação)

Nome da coluna Descrição e tipo de dado

COGIPF_TIMEZONE_ OFFSET Fuso horário, a partir do GMT.

INT(4)

COGIPF_SESSIONID Número de identificação da sessão

VARCHAR(255)

COGIPF_ REQUESTID Número de identificação da solicitação

VARCHAR(255)

COGIPF_STEPID Número de identificação da etapa em umaexecução de tarefa (vazia se não houver)

VARCHAR(255)

COGIPF_ SUBREQUESTID Número de identificação da subsolicitaçãodo componente

VARCHAR(255)

COGIPF_THREADID O número de identificação do servidor ondea solicitação é executada

VARCHAR(255)

COGIPF_ COMPONENTID Nome do componente que gera a indicação

VARCHAR(64)

COGIPF_ BUILDNUMBER O maior número da construção docomponente que gera a indicação

INT(4)

COGIPF_ LOG_LEVEL Nível da indicação

INT(4)

COGIPF_OPERATION A ação executada no objeto

VARCHAR(64)

COGIPF_TARGET_TYPE O tipo de objeto a ser migrado

VARCHAR(64)

COGIPF_TARGET_PATH O caminho do objeto migrado no IBMCognos Business Intelligence

nVARCHAR(1024)

94 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 103: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Tabela 31. Colunas da Tabela COGIPF_MIGRATION (continuação)

Nome da coluna Descrição e tipo de dado

COGIPF_TARGET_NAME O nome do objeto migrado no IBM CognosBI

nVARCHAR(255)

COGIPF_STATUS O status da operação

VARCHAR(64)

COGIPF_DETAILS Informações detalhadas sobre a operação

nVARCHAR(2000)

COGIPF_PACKAGE O pacote criado como parte da tarefa demigração

nVARCHAR(512)

COGIPF_MIGRATION_TASK O nome da tarefa de migração

nVARCHAR(1024)

COGIPF_MSGNUM O número da mensagem

INT(4)

COGIPF_SOURCE_TYPE O tipo de origem de migração (IBM CognosConnection, Upfront ou PowerPlayEnterprise Server)

VARCHAR(64)

COGIPF_SOURCE_PATH O caminho do objeto no IBM CognosSeries 7

nVARCHAR(1024)

COGIPF_SOURCE_NAME O nome do objeto no IBM Cognos Series 7

nVARCHAR(255)

Configuração da Criação de Log de Estilo do IBM Cognos Series 7A auditoria do PowerPlay de estilo do IBM Cognos Series 7 fornece informaçõessobre a atividade do servidor, do cubo e de relatórios e sobre o desempenho dosistema dos serviços PowerPlay.

Essas informações ajudam a tomar decisões antes e depois de implementar cubos erelatórios na web, para aprimorar o desempenho do sistema. Por exemplo, se vocêsouber que apenas metade dos 20 cubos publicados em seu ambiente IBMCognos Business Intelligence são acessados pelos usuários, poderá parar apublicação e a manutenção dos cubos não utilizados.

Capítulo 7. Configuração de criação de log 95

Page 104: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

A auditoria do PowerPlay reúne dados em arquivos de texto. O utilitárioPPESAuditFileProcessor pode ser utilizado para carregar os detalhes de auditoriapara um banco de dados.

Para que as informações de auditoria sejam registradas em log, elas devem estarativadas no servidor e no cubo ou nos níveis de relatório. Pode-se efetuar auditoriaresumida ou detalhada.

A criação de log de resumo de cubos e relatórios registra todas as solicitações deservidor feitas a cubos e relatórios a partir de todos os clientes do PowerPlay. Oslogs de criação de log detalhados registram as medidas e as dimensões acessadaspelo PowerPlay Studio.

A criação de log resumida do servidor registra todas as mensagens de inicializaçãoe encerramento do servidor. Enquanto que a criação de log detalhada registratodas as solicitações feitas ao servidor.

Siga esse processo para configurar a auditoria:v Configure um banco de dados de auditoria usando os scripts instalados com o

IBM Cognos PowerPlay para criar um banco de dados relacional.v Obtenha uma sequência de conexões para o banco de dados de auditoria.v Execute o utilitário de linha de comandos PPESAuditFileProcessor para

transferir dados de auditoria de arquivos de texto para um banco de dados deauditoria.

v Crie relatórios para avaliar a atividade de cubos, relatórios e do sistema.

Ativar Auditoria para o ServidorQuando a auditoria é ativada, as informações de atividade são continuamenteregistradas no arquivo ppes_audit.log. Por padrão, os arquivos de log são criadosno diretório c10_location\logs\powerplay. Um novo arquivo de log é aberto cadavez que o servidor é iniciado ou quando o tamanho do arquivo de log ultrapassa aconfiguração de tamanho máximo de arquivo.

Procedimento1. No IBM Cognos Administration, na guia Status, clique em Sistema.2. Clique na seta ao lado de Todos os servidores, clique em Serviços e depois

clique em PowerPlay.

96 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 105: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

3. Clique na seta ao lado de Serviço do PowerPlay e clique em Configurarpropriedades.

4. Clique na guia Configurações.5. Na coluna Valor, clique em Editar para as Configurações avançadas.6. Selecione Substituir as configurações obtidas da entrada pai.7. Na coluna Parâmetro, digite SRV.Options.AuditLevel.

Na coluna Valor, digite um dos seguintes:v IN,0 para configurar a criação de log da auditoria para Nenhumv IN,1 para configurá-lo para Resumidov IN,2 para configurá-lo para Detalhado

Ativar Auditoria para Cubos e RelatóriosQuando a auditoria é ativada, as informações de atividade são continuamenteregistradas no arquivo ppes_audit.log.

Por padrão, os arquivos de log são criados no diretório c10_location\logs\powerplay. Um novo arquivo de log é aberto cada vez que o servidor é iniciado ouquando o tamanho do arquivo de log ultrapassa a configuração de tamanhomáximo de arquivo.

Procedimento1. No IBM Cognos Administration, clique na guia PowerPlay.2. Na lista Objetos Configuráveis, selecione uma pasta ou pacote.

As configurações serão aplicadas a todos os objetos contidos na pasta ou pacoteselecionados.

3. Clique na guia Configurações de Cubos ou Configurações de relatórios.4. Para Nível da auditoria, selecione Resumo ou Detalhe.5. Opcionalmente, altere os valores padrão do tamanho máximo de cada arquivo

de auditoria e as configurações de Local dos arquivos de auditoria.6. Clique em OK.

Figura 4. Local de Serviço do PowerPlay

Capítulo 7. Configuração de criação de log 97

Page 106: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Tarefas relacionadas:“Definir Configurações Avançadas” na página 34Defina configurações avançadas para o IBM Cognos PowerPlay service in IBMCognos Administration.

Configuração de bancos de dados de auditoriaConfigure um banco de dados de auditoria utilizando os scripts fornecidos.

Os seguintes scripts de criação de tabela de banco de dados estão disponíveis napasta c10_location\ppserver\schemas:v db2_udb.sqlv mssql.sqlv oracle.sql

Obtenção de sequências de conexões para o banco de dados deauditoriaPara utilizar o utilitário PPESAuditFileProcessor, é necessário ter uma sequência deconexões a banco de dados. A sequência pode ser obtida pela criação de umaconexão com o banco de dados com o banco de dados de auditoria no IBM CognosAdministration. Não é necessário manter a conexão com o banco de dados depoisde ter a sequência de conexões de banco de dados.

Procedimento1. No IBM Cognos Administration, clique na guia Configuração.

2. Clique no botão de nova origem de dados .3. Na caixa Nome, digite um nome para o banco de dados e clique em Avançar.4. Na caixa Tipo, selecione o tipo de banco de dados que irá utilizar para o banco

de dados de auditoria e depois clique em Avançar.5. Digite as informações de conexão ao banco de dados e qualquer informações de

conexão necessária para o banco de dados de auditoria.Para obter informações adicionais sobre informações de conexão com o bancode dados, consulte o Guia de Administração e Segurança do IBM Cognos BusinessIntelligence.

6. Clique em Testar a conexão.A sequência de conexões a banco de dados será exibida em Sequência deconexões.Registre ou copie a sequência de conexões. Esse é o valor necessário quando outilitário PPESAuditFileProcessor for usado.Clicar em Fechar na caixa de diálogo Visualizar os resultados irá exibir apágina de sequência de conexão novamente.

7. Clique em Testar para verificar se a sequência de conexões é válida.Não é necessário concluir as etapas do assistente depois de ter obtido asequência de conexões a banco de dados. A sequência é utilizada quando outilitário PPESAuditFileProcessor for utilizado a partir da linha de comandos.

Execução do utilitário PPESAuditFileProcessorExecute o utilitário de linha de comandos PPESAuditFileProcessor para processarinstâncias de arquivos de log de auditoria geradas pelo IBM Cognos PowerPlay efazer upload das informações para um banco de dados.

98 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 107: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

O utilitário processa todas as instâncias dos arquivos ppes_auditxxx.log em umformato de banco de dados comum.

Procedimento1. Acesse o diretório c10_location\bin.2. Digite o comando para executar o utilitário e inclua as opções da linha de

comandos.Por exemplo,PPESAuditFileProcessor -dbname OracleDataSource -dbconnect "^UserID:^?Password:;LOCAL;OR;ORACLE@%s@cyborg/%s" -dbuser Admin -dbpassAdminPW -auditlocation C:\cognos\c10\logs\powerplay\ppesaudit

Tabela 32. Opções de Linha de Comandos para o Utilitário PPESAuditFileProcessor

Opções da linha de comandos Descrição

-dbname O nome do banco de dados.

-dbconnect A sequência de conexões do banco de dadosque contém o tipo e as informações deconexão com o banco de dados.

-dbuser Um nome de usuário do banco de dadosque tenha acesso de leitura e gravação aobanco de dados.

-dbpass A senha do nome de usuário do banco dedados.

-auditlocation A localização dos arquivos de log deauditoria gerados. Os arquivos estãolocalizados em c10_location\logs\powerplay.

-errorlog O nome do arquivo de log.

-nbrows O número de linhas processadas para cadatransação.

-exitonerror Pára o processamento quando ocorrer umerro.

Entendendo o banco de dados de auditoriaO banco de dados de auditoria inclui várias tabelas.

Tabela de dispatcher

A tabela de dispatcher, chamada de PPES_DISPATCHER, captura as seguintesinformações dos arquivos de log de auditoria.

Tabela 33. Colunas na Tabela PPES_DISPATCHER

Nome da coluna Descrição

MACHINE_NAME VARCHAR(100). Especifica o dispatcher quecriou o log.

Capítulo 7. Configuração de criação de log 99

Page 108: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Tabela 33. Colunas na Tabela PPES_DISPATCHER (continuação)

Nome da coluna Descrição

MACHINE_PORT INTEGER. Especifica a porta da qual odispatcher estava recebendo.

SERVER_START_DATE_TIME DATETIME. Especifica a data e hora que oservidor foi iniciado.

TIME_ZONE VARCHAR(100). Especifica o fuso horárioutilizado para todas as entradas do log.

PPES_VERSION VARCHAR(20). Especifica a versão do PPES.

LOGFILE_VERSION INTEGER. Especifica a versão do arquivo delog.

LOGFILE_GENERATION INTEGER. Especifica o número do arquivode log gerado.

Tabela da sessão

A tabela da sessão, chamada de PPES_SESSION, captura as seguintes informaçõesdos arquivos de log de auditoria.

Tabela 34. Colunas na Tabela PPES_SESSION

Nome da coluna Descrição

SESSION_ID VARCHAR(100). Especifica a ID da sessão.

USER_NAME VARCHAR(100). Especifica o nome dousuário da solicitação. Os nomes de usuáriosão gravados para solicitações da web eremotas.

Tabela de solicitações

A tabela de solicitações, chamada de PPES_REQUEST, captura as seguintesinformações dos arquivos de log de auditoria.

Tabela 35. Colunas na Tabela PPES_REQUEST

Nome da coluna Descrição

PPES_SESSION.SESSION_ID VARCHAR(100). Especifica a ID da sessão.

REQUEST_ID VARCHAR(100). Especifica a ID dasolicitação.

START_DATE_TIME DATETIME. Especifica a data e hora deinício da solicitação.

100 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 109: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Tabela 35. Colunas na Tabela PPES_REQUEST (continuação)

Nome da coluna Descrição

END_DATE_TIME DATETIME. Especifica a data e a hora deencerramento da solicitação.

REQUEST_STATUS INTEGER. Especifica o status da solicitação.falha = 0, bem-sucedida = 1

USER_CLASS VARCHAR(100). Especifica a classe dousuário.

REDISPATCH INTEGER. Especifica se o QP inicial lidoucom a solicitação (1 ou 0).

REQUEST_TYPE INTEGER. Especifica o tipo de solicitação.web = 0, remota = 1, admin = 2

ACTION VARCHAR(20). Especifica o tipo de ação:GET, SET ou Publicar.

MIRRORS VARCHAR(500). Especifica um ou maisespelhos disponíveis.

MESSAGE VARCHAR(500). Especifica detalhes demensagens fornecidos no log.

MACHINE_NAME VARCHAR(100). Especifica o nome doservidor.

MACHINE_PORT INTEGER. Especifica a porta do servidor.

SERVER_START_DATE_TIME DATETIME. Especifica a data e hora deinício do servidor.

Tabela de origem de administração

A tabela de origem de administração, chamada de PPES_ADMIN_SOURCE,captura as seguintes informações dos arquivos de log de auditoria.

Tabela 36. Colunas na Tabela PPES_ADMIN_SOURCE

Nome da coluna Descrição

SESSION_ID VARCHAR(100). Especifica a ID da sessãode solicitação.

REQUEST_ID VARCHAR(100). Especifica a ID dasolicitação.

SOURCE_NAME VARCHAR(256). Especifica o nome daorigem.

Capítulo 7. Configuração de criação de log 101

Page 110: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Tabela 36. Colunas na Tabela PPES_ADMIN_SOURCE (continuação)

Nome da coluna Descrição

SOURCE_TYPE VARCHAR(10). Especifica o tipo da origem(cubo, relatório ou pasta).

Tabela de origem de usuário

A tabela de origem de usuário, chamada de PPES_USER_SOURCE, captura asseguintes informações dos arquivos de log de auditoria.

Tabela 37. Colunas na Tabela PPES_USER_SOURCE

Nome da coluna Descrição

SESSION_ID VARCHAR(100). Especifica a ID da sessãode solicitação.

SOURCE_NAME VARCHAR(256). Especifica o nome daorigem.

SOURCE_TYPE VARCHAR(10). Especifica o tipo da origem(cubo, relatório ou pasta).

SOURCE_FILENAME VARCHAR(500). Especifica o nome dearquivo da origem.

Tabela de utilização de dimensão

A tabela de utilização de dimensão, chamada de PPES_DIM_USAGE, captura asseguintes informações dos arquivos de log de auditoria.

Tabela 38. Colunas na Tabela PPES_DIM_USAGE

Nome da coluna Descrição

SESSION_ID VARCHAR(100). Especifica a ID da sessãode solicitação.

REQUEST_ID VARCHAR(100). Especifica a ID dasolicitação.

DIM_CODE VARCHAR(256). Especifica o código dedimensão.

DIM_COUNT INTEGER Especifica a contagem dedimensão.

DIM_NAME VARCHAR(256). Especifica o nome dadimensão.

102 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 111: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Tabela de utilização de nível

A tabela de utilização de nível, chamada de PPES_LEVEL_USAGE, captura asseguintes informações dos arquivos de log de auditoria.

Tabela 39. Colunas na Tabela PPES_LEVEL_USAGE

Nome da coluna Descrição

SESSION_ID VARCHAR(100). Especifica a ID da sessãode solicitação.

REQUEST_ID VARCHAR(100). Especifica a ID dasolicitação.

DIM_CODE VARCHAR(256). Especifica o código dedimensão.

LEVEL_CODE VARCHAR(256). Especifica o código denível.

LEVEL_NAME VARCHAR(256). Especifica o nome do nível.

LEVEL_COUNT INTEGER. Especifica a contagem de nível.

Tabela de utilização de medidas

A tabela de utilização de medidas, chamada de PPES_MEASURE_USAGE, capturaas seguintes informações dos arquivos de log de auditoria.

Tabela 40. Colunas na Tabela PPES_MEASURE_USAGE

Nome da coluna Descrição

SESSION_ID VARCHAR(100). Especifica a ID da sessãode solicitação.

REQUEST_ID VARCHAR(100). Especifica a ID dasolicitação.

MEASURE_CODE VARCHAR(256). Especifica o código demedidas.

MEASURE_NAME VARCHAR(256). Especifica o nome dasmedidas.

MEASURE_COUNT INTEGER. Especifica a contagem demedidas.

Capítulo 7. Configuração de criação de log 103

Page 112: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

104 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 113: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Capítulo 8. Administração em Lote do PowerPlay

Esta seção descreve as opções de administração disponíveis no utilitário deadministração em lote do IBM Cognos PowerPlay. Com o utilitário deadministração em lote, é possível executar comandos de administração para o IBMCognos PowerPlay a partir do prompt de comandos do sistema operacionalMicrosoft Windows ou do shell de comandos do sistema operacional UNIX em vezde usar o IBM Cognos Administration em uma sessão do navegador. Além disso, épossível redirecionar o stdin para usar comandos em lote e redirecionar o stdoutpara um arquivo de log.

Em um sistema operacional UNIX, acesse o utilitário de administração em loteusando o script ppadmtool.sh. Esse script configura as variáveis adequadas doambiente e inicia o utilitário. Os parâmetros integrados ao script são transmitidosao utilitário de administração para processamento.

Se o ambiente do IBM Cognos Business Intelligence estiver configurado para usaro protocolo SSL para comunicação entre os componentes do IBM Cognos BI, seránecessário concluir etapas de configuração adicionais para poder usar o utilitárioppadmtool.

Faça backups frequentes do armazenamento de conteúdo do IBM Cognos paragarantir que seja possível retornar a um ambiente totalmente funcional casoocorram problemas inesperados.

O utilitário ppadmtoolPara ativar o utilitário ppadmtool, a partir do diretório installation_location\webapps\utilities\ppadmtool, em um sistema operacional Microsoft Windows, dêum clique duplo no arquivo ppadmtool.bat. E em um sistema operacional UNIX,execute ./ppadmtool.sh.

Depois de iniciar o utilitário ppadmtool, é possível emitir os seguintes comandoscom relação aos servidores, cubos e relatórios do IBM Cognos PowerPlay.

HELP

CONNECT <dispatcherURI> USER username PASSWORD password NAMESPACEnamespace_ID

CONNECT <dispatcher URI> -i username -j password -k namespace

ADD type name [PATH path]

CD folder

COPY name name

CRN REPLACE {(CUBENAME)} old_value new_value

DISABLE name

ENABLE name

© Copyright IBM Corp. 2005, 2014 105

Page 114: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

LIST [folder]

MOVE name name

QUIT

REMOVE type [PATH] name

RENAME source destination

RESET name property

RESET BELOW name property

SET name property=value

SHOW name

EXIT

nome de arquivo

Especifica o caminho totalmente qualificado do arquivo mdc, incluindo a extensãodo arquivo.

folder (pasta)

Especifica o nome de um objeto do tipo FOLDER, que representa o caminho dapasta na hierarquia do portal.

nome

Especifica o nome de um objeto (cubo, relatório ou pasta). Quando o objeto foruma pasta, ele pode ser usado para formar uma hierarquia de pastas. Um servidortambém é considerado a pasta-raiz.

Namespace

Especifica a ID do namespace que contém o usuário que está sendo utilizado paraefetuar login.

objectname (nome do objeto)

Especifica o nome lógico do pacote do cubo, relatório ou pasta conforme definidono portal.

opções

Especifica uma opção de comando, como descrito nas Opções.

senha

Especifica uma senha de servidor simples ou a senha para o nome de usuárioespecificado no Access Manager. Não inclui o comando de senha se o nome dousuário não precisar de senha.

106 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 115: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

caminho

Especifica um caminho físico para o arquivo da origem de dados. Usa o formatodo sistema operacional (UNIX ou Windows).

propriedades

Especifica a propriedade de um objeto no formato de hierarquia de objetos (.). Paraobter uma lista de propriedades, use o comando SHOW.

servidor

Especifica o nome ou o endereço IP de um servidor PowerPlay.

tipo

Especifica o tipo de objeto. O tipo pode ser PACKAGE, REPORT ou FOLDER.

nome de usuário

Especifica um nome de usuário a ser usado no logon.

valor

Especifica o valor para uma propriedade.

ConvençõesAo informar caminhos de arquivos ou o nome da variável (quando o objeto foruma pasta), um ponto (.) representará a pasta atual, dois pontos (..) representarão apasta pai e uma barra (/) representará a pasta-raiz, que é o servidor. Por exemplo,o script a seguir desativa todos os objetos no servidor hp_srv.ppadmtool

> connect hp_srv

> disable ./

> exit

Ao informar nomes de arquivos ou caminhos que contenham espaços, insira todo onome do arquivo ou o caminho entre aspas ("). Por exemploSHOW “great outdoors”

COPY ../gnt “/CF systems/great outdoors”

Também é possível redirecionar a entrada de um arquivo e a saída para umarquivo.ppadmtool < ../adm/daily_update.txt > check.log

ComandosCom o utilitário de administração em lote, é possível executar comandos deadministração para o IBM Cognos PowerPlay a partir do prompt de comandos dosistema operacional Microsoft Windows ou do shell de comandos do sistemaoperacional UNIX em vez de usar o IBM Cognos Administration em uma sessãodo navegador.

Capítulo 8. Administração em Lote do PowerPlay 107

Page 116: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

ADDInclui um novo objeto no servidor conectado. PATH indica uma origem de dados.O exemplo a seguir inclui o cubo "Grandes Aventuras" no servidor conectado. Ocomando cria uma origem de dados e um pacote no IBM Cognos BusinessIntelligence:ADD CUBE "Great Outdoors" PATH "F:/cubes/great outdoors.mdc"

Se um tipo não for especificado, o objeto será considerado um cubo.

CONNECTConecta-se a um servidor IBM Cognos PowerPlay. O exemplo a seguir conecta aoservidor nome_do_servidor_c10, com o nome de usuário JuliaX, com base nonamespace Padrão usando a senha neptune:CONNECT http://C10_server_name:9300/p2pd/servlet/dispatchUSER JuliaX PASSWORD neptune NAMESPACE Default

Também é possível usar -i -j e -k em vez de USER, PASSWORD e NAMESPACE. Oexemplo então se transformaria em:CONNECT http://C10_server_name:9300/p2pd/servlet/dispatch-i JuliaX -j neptune -k Default

CDAltera a pasta atual. O prompt da linha de comandos indica a pasta e o caminhoatuais da pasta-raiz. O exemplo a seguir altera a pasta atual de “/globalnetworking/finances” para “/global networking/hub product/marketing”.Visando ao esclarecimento, o prompt está incluído no exemplo:

rede global /finanças> CD “../produtos de hub/marketing” rede global/produtosde hub/marketing>

COPYCria uma cópia de um objeto e suas propriedades substitutas associadas em umnovo objeto. O exemplo a seguir copia o relatório gnt da pasta pai para a pasta“/CF systems”, e atribui um nome ao novo objeto “grandes aventuras”:COPY ../gnt “/CF systems/great outdoors”

CRN REPLACE CUBENAMEAltera o nome do pacote de todos os pacotes de cubo ou relatórios quecorrespondem ao nome de um cubo atual, e cujo gateway corresponde ao gatewaydo servidor atual. O exemplo a seguir altera o nome de todos os objetos chamados"Grandes Aventuras" no gateway atual para "Cubo de amostra":CRN REPLACE CUBENAME "Great Outdoors" "Sample Cube"

DISABLEDesativa as desmarcações da caixa de seleção desativar na página de propriedadesdo pacote. Essa propriedade pode ser acessada no portal. Quando um objetoestiver desativado, os usuários que não tem permissões de gravação para essaentrada não poderão acessá-lo. A entrada não fica mais visível no portal. Se umaentrada estiver desativada e os usuários tiverem acesso de gravação a ela, o íconedesativado será exibido próximo à entrada. O exemplo a seguir torna o objeto"Finanças" indisponível:DISABLE Finance

O exemplo a seguir torna o objeto "Grandes Aventuras" indisponível:DISABLE "Great Outdoors"

108 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 117: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

ENABLEAtiva as desmarcações da caixa de seleção desativar na página de propriedades dopacote:ENABLE "Sales 2009"

EXITFecha o utilitário ppadmtool.

HELPMostra uma lista dos comandos ppadmtool.

LISTLista todos os objetos na pasta especificada. O exemplo a seguir lista todos osobjetos na pasta "/docs/recent reports":LIST "/docs/recent reports"

Se nenhuma pasta for especificada, todos os objetos na pasta atual serão listados.

MOVEMove um objeto e suas propriedades substitutas associadas para um novo objeto.Você deve especificar um local de destino, assim como um nome para o objetomovido. Se o local de destino não existir, será criado. O exemplo a seguir cria umnovo objeto "bls" na pasta "/new/":MOVE gnt "/new/bls"

REMOVERemove um objeto ou a referência ao seu arquivo da origem de dados, sem excluiro arquivo real. Se a operação remover todas as referências, o objeto será totalmenteremovido. O exemplo a seguir remove o cubo "novas_vendas" do servidorconectado.REMOVE CUBE new_sales

O exemplo a seguir remove a referência ao arquivo da origem de dados referenteao objeto "redes gerais".REMOVE PATH "general networks"

Se o objeto for uma pasta, todos os objetos filho também serão removidos. Se umtipo não for especificado, o objeto será considerado um cubo.

RESETReconfigura as propriedades selecionadas em um objeto para as propriedadesherdadas de pastas de níveis superiores. Se não houver pastas de níveis superiores,as propriedades serão configuradas como as propriedades padrão para aqueleobjeto. O exemplo a seguir reconfigura o valor "LA" no objeto "Grandes Aventuras"para o valor padrão referente à pasta ou, se não houver uma pasta padrão, o valorpadrão para o tipo de objeto:RESET "Great Outdoors" LA

RESET BELOWReconfigura as propriedades no conteúdo de uma pasta e suas subpastas, mas nãoas propriedades da própria pasta. O exemplo a seguir reconfigura o valor"Publicado" no conteúdo da pasta-raiz para o valor padrão especificado para apasta ou, se não houver padrão na pasta, o padrão para o tipo de objeto:RESET BELOW / Published

Capítulo 8. Administração em Lote do PowerPlay 109

Page 118: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

SETAtribui valores de propriedade para um objeto. As propriedades fazem distinçãoentre maiúsculas e minúsculas. Você deve informar o nome da propriedadeexatamente como ele é usado. Para exibir as propriedades referentes a um objeto,use a opção SHOW.v O exemplo a seguir configura o número máximo de processos para o cubo

Grandes Aventuras como 5:SET"Great Outdoors".PWQ.Control.MaxProcess=5

v Para configurar uma propriedade para todos os objetos no servidor, insira umabarra (/) em vez do nome de um objeto. O exemplo a seguir configura apropriedade "PWQ.Control.MaxProcess" como "5" na pasta-raiz (ou servidor):SET / .PWQ.Control.MaxProcess=5

v Para configurar uma propriedade referente ao conteúdo em Minhas Pastas paraum usuário específico, use o caminho de procura das propriedades do usuáriopara especificar o local. O exemplo a seguir configura a propriedadeSET CAMID(...some cam id )/folder[@name=’My Folders’] <some property>=<somevalue>

SHOWExibe todas as propriedades para o objeto especificado. O exemplo a seguir exibetodas as propriedades para o objeto "Vendas 2009":SHOW "Sales 2009"

O exemplo a seguir exibe a propriedade .FLD.Control.MinProcess para o objetotestfolder2:SHOW /testfolder2 .FLD.Control.MinProcess

Comandos substituídosOs comandos a seguir foram descontinuados e não estão mais disponíveis naversão ppadmtool do IBM Cognos PowerPlay.

ADD DS type name DS mirror

CRN REPLACE GATEWAY

KILL name

NOTIFY {(CUBE_OBJECT objectname | CUBE_FILEfilename)} EVENT = UPDATE[ON_ERROR IGNORE | FAIL]

PUBLISH name

PUBLISHLINK name

REMOVEDS name DS mirror

REMOVELINK name

110 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 119: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Comandos alteradosAs mudanças a seguir foram feitas na versão do IBM Cognos PowerPlay doppadmtool.v O URI do dispatcher do IBM Cognos Business Intelligence é usado agora para o

nome do servidor. É possível obter as informações do dispatcher a partir doCognos Configuration.

v Se a conexão com o servidor exigir autenticação, você deve fornecer um nomede usuário, senha e ID de namespace para se conectar. A solicitação não seráfeita se essas informações não forem fornecidas. A autenticação não serásolicitada se estiver se conectando por meio do acesso anônimo.

v Se o nome do usuário que estiver sendo usado para conexão não tiver senha,não incluia o parâmetro PASSWORD como parte do comando de conexão. Noppadmtool do IBM Cognos Series 7, nenhuma senha foi especificada usandoaspas sem texto com o parâmetro PASSWORD.

v Não é mais possível emitir comandos adicionais como argumentos durante achamada inicial do programa. Por exemplo, o comando a seguir é inválido.D:\ppadmtool>ppadmtool connect "http://wottppeslab3:9300/p2pd/servlet/dispatch" user dan password dan namespace s7 add cube cubename pathd:\cubes\ppweb.mdcPrimeiro você deve se conectar ao servidor e, em seguida, emitir comandos.

v CRN REPLACE CUBENAME não substitui todos os nomes de cubocorrespondentes no servidor. Quando o comando for executado com base emuma pasta chamada XY, somente os objetos em XY serão alterados.

v Incluir criará uma origem de dados e um pacote Cognos Connection se o objetoque está sendo incluído for um IBM Cognos PowerCube.

Requisitos de Configuração para Usar SSL para o Utilitário PowerPlayServer Batch Administration

Se o IBM Cognos Business Intelligence estiver configurado para usar o protocoloSecure Sockets Layer (SSL) para comunicação entre os componentes do IBMCognos BI, você deve concluir a configuração a seguir para poder usar o utilitárioPowerPlay Server Batch Administration. Essa configuração não será exigida se oSSL estiver ativado somente no servidor web. A configuração envolve três etapas.v Extraia um certificado SSL.v Crie um keystore para o certificado.v Altere os parâmetros no arquivo ppadmintool.bat.

Extrair um Certificado SSLExtrair um certificado SSL para usar o utilitário IBM Cognos PowerPlay ServerBatch Administration.

Procedimento1. Acesse o diretório installation_location\bin.2. Digite o seguinte comando:

ThirdPartyCertificateTool.bat -java:local -E -T -r cacert.cer -k..\configuration\signkeypair\jCAKeystore -p password

Capítulo 8. Administração em Lote do PowerPlay 111

Page 120: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Resultados

O certificado CA, cacert.cer, é exportado para o diretório installation_location\bin.Agora é possível criar um keystore para o certificado.

Criar um Keystore para o CertificadoApós a extração de um certificado SSL, você cria um keystore para o certificadopara poder usar o utilitário IBM Cognos PowerPlay Server Batch Administration.

Procedimento1. Acesse o diretório installation_location\bin\jre\version\bin.2. Digite o seguinte comando:

keytool.exe -import -file installation_location\bin\cacert.cer -keystoreinstallation_location\webapps\utilities\ppadmtool\MyKeyStore -storepasspassword -alias ibmcognos_alias

Resultados

O arquivo de keystore, MyKeyStore, é criado no diretório installation_location\webapps\utilities\ppadmtool. Agora é possível modificar os parâmetros para outilitário de administração em lote.

Modificar os Parâmetros para o Utilitário de Administração emLote

Após a criação de um keystore para o certificado, é possível modificar osparâmetros do utilitário IBM Cognos PowerPlay Server Batch Administration.

Procedimento1. No diretório installation_location\webapps\utilities\ppadmtool, abra o

ppadmtool.bat em um editor de texto.2. Localize a seguinte linha:

%_RUNJAVA% -cp %CP%%J_OPTS% com/spotonsystems/cubeadmin/cli/PpAdmin%*

3. Edite a linha para identificar o keystore e a senha:%_RUNJAVA% -cp %CP% %J_OPTS% -Djavax.net.ssl.trustStore=MeuKeystore -Djavax.net.ssl.trustStorePassword=senha com/spotonsystems/cubeadmin/cli/PpAdmin %*

Resultados

Quando a instalação do IBM Cognos BI estiver configurada para usar o protocoloSSL, use o seguinte formato para o comando CONNECT no utilitário ppadmtool:

CONNECT https://nome_servidor:porta/p2pd/servlet/dispatch

112 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 121: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Apêndice A. Solução de problemas

Use estas informações e soluções de referência para resolução de problemas comoum recurso para ajudá-lo a solucionar problemas específicos que podem serencontrados ao usar o IBM Cognos PowerPlay.

Problemas que podem ser encontrados são organizados nas seguintes áreas. Osarquivos de log também podem conter informações para ajudá-lo a solucionarproblemas.

Problemas ao Migrar do IBM Cognos Series 7 PowerPlay para o IBMCognos PowerPlay

Esta seção descreve os problemas que podem ocorrer ao migrar conteúdo do IBMCognos Series 7 PowerPlay para o IBM Cognos PowerPlay.

Criação de log de migraçãoOs eventos encontrados ao migrar do IBM Cognos Series 7 PowerPlay para o IBMCognos PowerPlay são registrados em dois arquivos, c10_location\logs\cogserver.log e s7_location/migs7/log.txt.

Depois de migrar do IBM Cognos Series 7 PowerPlay para o IBM CognosPowerPlay, revise as mensagens nos arquivos de log para garantir que todos osrelatórios sejam migrados com êxito.

Para saber mais sobre os detalhes de eventos de migração, siga as melhorespráticas abaixo:v Configure o nível de criação de log apropriado antes da migração.v Habilite a criação de log de depuração.v Migre do IBM Cognos Series 7 PowerPlay para o IBM Cognos PowerPlay.v Analise as mensagens do log de migração e tome as atitudes necessárias.

Configuração do nível de criação de log apropriado antes damigraçãoAntes de migrar, recomendamos configurar o Nível de criação de log para Básico.O nível de criação de log determina o nível de informações de migração queaparece no arquivo cogserver.log. Há três níveis de criação de log que sãoutilizados para seu cenário de migração:v Se você desejar controlar apenas operações básicas da migração, use o nível de

criação de log padrão Mínimo do IBM Cognos Business Intelligence. Mínimofornece o mínimo de detalhes e registra apenas as mensagens de inicialização eencerramento do sistema e do serviço e erros de tempo de execução no arquivode log.

v Recomendamos configurar o nível de criação de log para Básico para amigração. Básico registra solicitações e respostas de serviços, e detalhes comoquando os relatórios foram criados, além de detalhes registrados no nívelMínimo.

v Se estiver tendo problemas com a migração, configure o nível de criação de logcomo Completo. Completo registra o nível mais alto de detalhes, incluindotodas as solicitações de todos os componentes com seus valores de parâmetros.

© Copyright IBM Corp. 2005, 2014 113

Page 122: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Depois de executar a migração, é possível enviar o arquivo de log para Suporteao Cliente da IBM com uma descrição dos problemas.

Antes de Iniciar

As mensagens de migração são registradas como MIS.

Você deve ter as permissões requeridas para acessar as funcionalidades do IBMCognos Administration e configurar níveis de criação de log.

Procedimento1. No IBM Cognos Administration, na guia Status, clique em Sistema.2. Clique na seta ao lado de Sistema e clique em Configurar propriedades.3. Clique na guia Configurações.4. Localize Nível de criação de log da auditoria para o serviço de migração na

lista e do menu Valor, selecione Básico para o nível de criação de log.Se estiver enfrentando problemas com a migração, selecione Completo antes demigrar para se certificar de que todos os eventos de migração sejamregistrados.

5. Clique em OK.

Habilite a criação de log de depuraçãoAlém de especificar a quantidade de informações de migração que deseja queapareça no arquivo cogserver.log, é possível habilitar a criação de log de depuraçãopara produzir informações adicionais que ficarão disponíveis no arquivo de loglocal_s7/migs7/log.txt.

Procedimento1. Abra o arquivo local_s7/migs7/migs7service_configuration.xml em um editor

de texto.2. Configura o elemento enable-migs7service-debug-logging como yes.3. Salve o arquivo.

Salve o arquivo migs7service_configuration.xml no formato UTF-8. Se quisersalvar o arquivo na codificação usada pelo código do idioma, como Shift-JIS,altere a codificação especificada na primeira linha do arquivo.<?xml version="1.0" encoding="UTF-8"?>

Revisão de mensagens de log de migração e tomar atitudesnecessáriasRecomendamos revisar os arquivos de log depois da migração para se certificar deque seu conteúdo tenha sido migrado com êxito. Se ocorrerem erros, é possívelinterpretar as mensagens e tomar as atitudes necessárias. O conteúdo migradopode incluir propriedades de relatórios, cubos e NewsBox.

Procedimento1. Abra o arquivo c10_location\logs\cogserver.log em um editor de texto.2. Revise as mensagens de eventos de migração (MIS) com status de Falha. A

maioria das mensagens fornece instruções para solucionar o problema.3. Corrija o problema e execute a migração novamente.

114 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 123: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Conteúdo que não pode ser migradoVocê está migrando conteúdo e recebe mensagens de erro de que um objeto nãoserá migrado.

A seguir estão dois exemplos de mensagens de erro indicando que um relatórionão será migrado:

Essa configuração de relatório é inválida: report_name Esse relatório não será migrado:report_name

ou

Essa referência de cubo é inválida: cube_name Esse relatório não será migrado: report_name

Isso ocorrerá se os relatórios do IBM Cognos Series 7 forem inválidos ou se oscubos nos quais os relatórios são basedos não forem encontrados ou foreminválidos. Se relatórios ou cubos forem inválidos ou não forem localizados, osrelatórios não poderão ser migrados.

Os relatórios e cubos que não são migrados são registrados em um arquivochamado cogserver.log que está localizado no diretório c10_location/logs do IBMCognos Business Intelligence ou no banco de dados de criação de log configuradono ambiente do IBM Cognos BI.

Para solucionar este problema pode-se corrigir o relatório para que ele fique válidoou removê-lo se ele não for mais necessário e tentar a migração novamente.

Conteúdo que não for do PowerPlay não é migrado e esse conteúdo fica registradono arquivo de log.Conceitos relacionados:“O que é migrado e para onde é migrado?” na página 58Dependendo da origem selecionada para migração do conteúdo do IBM CognosMigration Assistant, objetos diferentes serão migrados.

Erros no mapeamento de cuboDepois de selecionar os objetos que deseja migrar, a mensagem de erro a seguirpode ser exibida.

Erro de Solicitação: Capturada uma exceção inesperada: Nenhum mapeamento de cubo foiencontrado para a origem de migração. O conteúdo selecionado está vazio ou contém itensque não são suportados.

Essa mensagem de erro aparece quando se seleciona a migração de objetos comov relatórios que não têm link para um cubov atalhos sem também selecionar os relatórios de destino para os quais os atalhos

apontamv pastas vaziasv NewsBoxes que contêm apenas objetos não suportados (relatórios do

Impromptu, relatórios do Impromptu Web Reports (IWR), objetos do IBMCognos Query, objetos do IBM Cognos Visualizer)

v newsboxes vazios

Apêndice A. Solução de problemas 115

Page 124: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Para resolver esse problema no ambiente do IBM Cognos Series 7, faça asmudanças necessárias no conteúdo que deseja migrar.

O nome da pasta criada para o conteúdo migrado não está noidioma correto

Quando o ambiente do IBM Cognos Series 7 ou do IBM Cognos BusinessIntelligence estiver em um código de idioma diferente do inglês, a pasta criada noIBM Connection para o conteúdo migrado será chamada Conteúdo Migrado.

Assegure-se de que o código de idioma configurado no IBM Cognos Series 7Configuration Manager seja o mesmo que o código do idioma de produto, ocódigo do idioma de conteúdo e o código do idioma de servidor no IBM CognosBI. Os códigos do idioma de produto e de conteúdo são configurações depreferência do usuário no IBM Cognos Connection. O código do idioma deservidor é uma configuração de configuração global que você acessa a partir domenu Ações no IBM Cognos Configuration.

Além disso, crie um arquivo de propriedades de idioma no IBM Cognos BI para ocódigo do idioma no qual o ambiente do Series 7 está configurado.

Os valores de código do idioma no IBM Cognos Series 7 estão no formato decódigo de idioma-país, como en-us. No IBM Cognos BI, o código do idioma deproduto é idioma apenas. Os códigos do idioma de conteúdo e servidor podem sercódigos de região ou de idioma-região ou apenas idioma. Se os códigos do idiomado Series 7 e do IBM Cognos BI tiverem o mesmo valor de idioma, mas um valorde código de país ou região diferente, será necessário criar também um arquivo depropriedades no IBM Cognos BI para o valor de código de país ou regiãodiferente.

A tabela a seguir lista os arquivos de propriedades de idioma exigidos em diversoscenários.

Tabela 41. Arquivos de Propriedades de Idioma Necessários

Código doidioma doSeries 7

Código doidioma deservidorIBMCognos BI

Código doidioma deprodutoIBM CognosBI

Código do idiomade conteúdo doIBM Cognos BI

Necessário o arquivo depropriedades do idioma

de-de de-de Alemão Alemão(Alemanha)

migrationMsg_de-de.properties

de-de de-at Alemão Alemão(Alemanha)

migrationMsg_de-de.properties

migrationMsg_de-at.properties

de-at de-de Alemão Alemão(Alemanha)

migrationMsg_de-at.properties

migrationMsg_de-de.properties

116 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 125: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Tabela 41. Arquivos de Propriedades de Idioma Necessários (continuação)

Código doidioma doSeries 7

Código doidioma deservidorIBMCognos BI

Código doidioma deprodutoIBM CognosBI

Código do idiomade conteúdo doIBM Cognos BI

Necessário o arquivo depropriedades do idioma

de-at de-at Alemão Alemão (Áustria) migrationMsg_de-at.properties

Procedimento1. Crie uma cópia dos arquivos c10_location/webapps/p2pd/WEB-INF/classes/

migrationMsg_<lang>.properties em outro diretório.2. Renomeie a cópia como

migrationMsg_<lang>-<country or region code>.propertiesem que <lang>-<country or region code> é o código do idioma do Series 7.

3. Mova a cópia do diretório especificado na etapa 1.4. Se o valor <country or region code> do código do idioma de conteúdo ou de

servidor IBM Cognos BI for diferente do <country or region code> do código doidioma do Series 7, repita as etapas 1 e 2.

5. Execute novamente a migração.

Não Foi Possível Migrar o Conteúdo Porque o Código doIdioma Não Está Configurado ou Mapeado no IBM CognosConfiguration

Se o código do idioma usado no conteúdo que você está migrando não estiverconfigurado ou mapeado no IBM Cognos Configuration, o processo de migraçãoparará e as seguintes mensagens de erro serão exibidas.CM-REQ-4342 Ocorreu um erro com o cliente.

CM-REQ-4193 A importação da opção de implementação está incorreta.

CM-REQ-4179 O código de idioma locale não é um dos códigos de idioma do conteúdo configurados.

Para contornar o problema, inclua ou mapeie o código do idioma usado peloconteúdo de origem no IBM Cognos Configuration. Por exemplo, se o código doidioma do conteúdo de origem for en-us, no IBM Cognos Configuration, incluaen-us ou mapeie en-us para en.

Se o código do idioma do conteúdo de origem não estiver configurado no IBMCognos Configuration, mas estiver mapeado, o processo de migração substituirá ocódigo do idioma de conteúdo da origem no arquivo de implementação pelocódigo do idioma mapeado. Por exemplo, en-us é substituído por en. Estamudança ocorre somente nas opções de archive e nas propriedades de hierarquiade pasta. O código do idioma nas especificações do relatório é alterado. Umamensagem de alerta é incluída no arquivo de log de migração para indicar amudança.

Apêndice A. Solução de problemas 117

Page 126: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Alocação de Memória do Serviço de Migração do IBM CognosSeries 7

Em determinadas circunstâncias, o serviço de migração do IBM Cognos Series 7pode alocar memória para uma tarefa de migração, mas a memória não seráliberada quando a tarefa for concluída.

Para solucionar esse problema, é possívelv limitar as tarefas de migração individuais para no máximo 5000 objetos.

Se estiver migrando um grande número de relatórios, divida-os em gruposmenores que não tenham mais de 5000 objetos por tarefa de migração.

v monitorar a memória usada pelo serviço de migração do IBM Cognos Series 7No sistema operacional Microsoft Windows, use o Gerenciador de Tarefas paramonitorar a memória usada por migs7service.exe.No HP-UX, configure a variável de ambiente chamada UNIX95 e use ps -o vszpara monitorar a memória. Por exemplo, se estiver usando o shell bash épossível usarUNIX95=ps -eo vsz,ruser,pid,args | grep migs7process

Nos sistemas operacionais AIX ou Solaris, use /usr/bin/ps -o vsz. Por exemplo,/usr/bin/ps -eo vsz,ruser,pid,args | grep migs7process

v reinicie o serviço se a memória ocupada se tornar excessivaNo sistema operacional Windows, vá para o diretório s7_location/migs7 e use oseguinte comando:configure.exe--stop

Para reiniciar o serviço, use o seguinte comando:configure.exe --start

no sistema operacional UNIX, vá para o diretório s7_location/migs7 e use oseguinte comando:./configure --stop

Para reiniciar o serviço, use o seguinte comando:./configure --start

As propriedades de drill through podem precisar ser alteradasdepois da migração

Ao migrar cubos ou relatórios que possuem configurações de drill through, essasconfigurações devem ser preservadas. Entretanto, há várias novas configurações noIBM Cognos PowerPlay que não são preenchidas no conteúdo migrado. Alémdisso, algumas das configurações existentes podem precisar ser alteradas.

Para configurações de drill through para servidores de aplicativos do IBM CognosSeries 7, mudanças são necessárias somente se forem usados nomes de grupos deservidores para fazer referência a servidores. Nesse caso, deve-se alterar essesnomes de grupo de servidor para URLs de gateway.

Para drill through em um pacote do IBM Cognos Business Intelligence, duas novaspropriedades foram apresentadas. Essas propriedades, PowerPlay Studio Package ePowerPlay Studio Package Folder, devem ser configuradas após a migração paraativar essa funcionalidade. Para drill through para um Newsbox do Upfront, uma

118 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 127: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

nova propriedade foi introduzida. Essa propriedade, PowerPlay Web Drill ThroughServer Group, deve ser configurada após a migração para ativar essafuncionalidade.

Erro ao migrar do UpfrontSe o usuário do IBM Cognos Series 7 não for um membro da classe de usuárioraiz, as seguintes mensagens de erro serão exibidas no log.

S7S-err-0646 Exceção capturada: a decodificação do Unicode não é uma solicitaçãosuportada.

S7S_err_Foi localizado um argumento inválido ao executar um comando do IBMCognos Deployment Manager.

Para evitar esse erro, certifique-se de que o nome de usuário inserido seja de ummembro da classe de usuário-raiz.

Não Será Possível Migrar o Conteúdo do Upfront se oPowerPlay Enterprise Server Não Estiver Protegido

Você está migrando o conteúdo do IBM Cognos Series 7 Upfront e recebe um errode namespace. Isso pode ocorrer se o IBM Cognos PowerPlay Enterprise Servernão estiver protegido.

Para corrigir esse problema, proteja o PowerPlay Enterprise Server e tente amigração novamente.

Impossível conectar ao servidor Upfront durante migração seo Upfront estiver protegido para conexão única ou conexãodo SO

O IBM Cognos Migration Assistant exige atualmente que você forneça um nomede usuário e uma senha de conexão básica para um namespace do IBM CognosSeries 7 ao migrar o conteúdo do IBM Cognos Series 7 Upfront ou do PowerPlayEnterprise Server. Se o namespace do IBM Cognos Series 7 estiver configuradopara conexões de S.O. apenas, sua autenticação falhará e não será possível migrarseu conteúdo.

Para resolver esse problema, configure o namespace do IBM Cognos Series 7 paraconexão básica ou para conexões básica e do S.O., e assegure-se de ter umaconexão básica configurada para o nome do usuário que você usará para autenticarno Upfront ou no PowerPlay Enterprise Server.

Newsboxes Pessoais Não Aparecem na Visualização emÁrvore do Upfront no IBM Cognos Migration Assistant

Quando se cria uma tarefa de migração com o Upfront como origem, asNewsboxes pessoais não aparecem na visualização de árvore dos Newsboxes.

Por padrão as Newsboxes pessoais ficam ocultas. Objetos ocultos não aparecem noIBM Cognos Migration Assistant.

As NewsBoxes Pessoais e o conteúdo serão migrados mesmo se não estiveremvisíveis no IBM Cognos Migration Assistant. Em ambientes com conteúdo extenso,isso limita a possibilidade de dividir uma migração em peças gerenciáveis.

Apêndice A. Solução de problemas 119

Page 128: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Para resolver esse problema, você deve alterar as configurações das NewsBoxespessoais.

Procedimento1. Efetue login no Upfront como o usuário que usará o IBM Cognos Migration

Assistant.2. Clique em Personalizar.3. Na guia Geral, selecione Mostrar todas as entradas na árvore, Mostrar

detalhes da entrada e Mostrar entradas ocultas e depois clique em OK.4. Em NewsIndex, clique em Newsboxes pessoais e depois clique em

Propriedades da Newsbox.5. Desmarque a caixa Ocultar esta entrada.

Problemas ao migrar relatórios com nomes de caminhointerno que excedem os 255 caracteres

Ao migrar conteúdo do IBM Cognos Series 7 Upfront, se o número de caracteresusado para o nome da pasta e o nome do relatório exceder 255, a migração falhará.A seguinte mensagem de erro aparece:

S7S-err-0813 Exceção encontrada ao analisar erros e avisos do IBM CognosDeployment Manager a partir do arquivo: UNEXPECTED INTERNAL ERROR: Nodump CDM está faltando a propriedade "PPES.packletLocation".

O IBM Cognos Series 7 PowerPlay Enterprise Server também pode gerar umarquivo principal no diretório S7_install/bin/.

Quando nomes de caminhos excedem os 255 bytes de comprimento, o processo doPowerPlay Enterprise Server pode sobrecarregar o buffer. Verifique,principalmente, o comprimento de seus caminhos no diretório PPSRoot. Porexemplo, instalação_S7/ppserver/PPSRoot/...

É possível que encontre este problema:v no sistema operacional UNIX

O UNIX geralmente permite nomes de caminhos de 1023 ou mais bytes. OWindows limita os nomes de caminhos a 260 ao usar as APIs que o PPES usa.

v Ao usar um idioma de vários bytes, como japonês.Um só caractere pode ocupar dois ou mais bytes. Assim, os nomes de caminhopodem atingir o limite de 255 caracteres com menos caracteres.

Para obter uma solução alternativa para o problema, entre em contato com o IBMCognos Customer Center (www.ibm.com/software/data/cognos/customercenter/)para obter uma atualização de software para endereçar o problema.

Outra forma é evitar o problema selecionando a migração apenas de NewsBoxesque contenham relatórios com nomes de caminhos que tenham menos de 255caracteres de comprimento. Ou renomeie o relatório e a NewsBox para que usemmenos de 255 bytes.

Os detalhes do histórico não aparecem na tarefa de migraçãoApós executar uma tarefa de migração com sucesso, os detalhes do histórico datarefa não aparecem ou estão incompletos. A seguinte mensagem de erro pode serexibida:

120 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 129: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

O histórico de execução não existe. Ele pode ter sido excluído por exceder operíodo de retenção.

Essa situação pode ocorrer devido à configuração incorreta no banco de dados denotificação em um ambiente distribuído do IBM Cognos Business Intelligence. Obanco de dados de notificação deve ser o mesmo que o do banco de dados doContent Manager ou ser um banco de dados separado. Se o banco de dados denotificação é um banco de dados separado, certifique-se de que seu local estáconfigurado em todos os computadores com Content Manager e Application Tier.Para obter informações adicionais sobre como criar e configurar um banco dedados de notificação separado, consulte o Guia de Instalação e Configuração do IBMCognos BI.

Informações de contato do Upfront não migradasVocê migra o conteúdo do IBM Cognos Series 7 Upfront e seleciona a opção paranão migrar informações de contato da classe de usuário. Você migrou o mesmoconteúdo do Upfront uma segunda vez com a opção de migrar informações decontato da classe de usuário, mas as informações não foram migradas.

Para solucionar esse problema, escolha uma das soluções a seguir:v Exclua o conteúdo migrado e refaça a migração, selecionando a opção de migrar

informações de contato.v No IBM Cognos Connection, configure manualmente as informações de contato

para cada relatório migrado.

Apóstrofo no nome da pasta não migradoVocê executa uma migração com o IBM Cognos Connection como a origem demigração e uma pasta que você está migrando possui um apóstrofo no nome. Apósa migração, o apóstrofe não é exibido no nome da pasta.

Para solucionar o problema, renomeie a pasta migrada para incluir a apóstrofe.

Pasta Vazia Chamada "cubos" Criada Após a Migração do IBMCognos Connection

Depois de executar uma migração com o IBM Cognos Connection como a origemde migração, uma pasta vazia chamada "cubos" é criada no local de conteúdomigrado. Os objetos são migrados com êxito e o pacote relacionado às referênciasdo cubo foi migrado para a pasta PowerPlay.

É possível remover a pasta vazia com segurança.

Erro ao Iniciar o Serviço de Migração do Series 7Iniciar o serviço de migração do IBM Cognos Series 7 retorna uma mensagem deerro. Se o serviço de migração for iniciado a partir do Microsoft Windows Services,a mensagem a seguir será exibida.

Os Serviços de Migração do IBM Cognos Series 7 no Computador Local foraminiciados e interrompidos.

Se o serviço de migração for iniciado executando o comando migs7service_config-config, a seguinte mensagem de erro será exibida:

Falha ao carregar o arquivo CSX.

Apêndice A. Solução de problemas 121

Page 130: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Este problema pode ocorrer se o arquivo cer5.csx não existir no diretórioinstalação_S7/bin.

Para solucionar o problema, crie o arquivo cer5.csx aplicando novamente asdefinições de configuração.

Procedimento1. No Configuration Manager, abra a configuração atual.2. Na guia Componentes, selecione o nó raiz.3. No menu Ações, clique em Aplicar seleção.4. Se o arquivo cer5.csx não for criado no diretório bin, reinstale o PowerPlay

Enterprise Server.5. Inicie o serviço de migração do Series 7.

Visualizações customizadas migradas uma segunda vezaparecem como links quebrados

Ao migrar a mesma visualização customizada de um relatório uma segunda vez, olink será quebrado no IBM Cognos Connection.

Para solucionar esse problema, escolha uma das soluções a seguir:v Remova os relatórios migrados na primeira migração e refaça a migração.v Use os comandos copiar e colar para mover os relatórios migrados para uma

nova pasta e refaça a migração.

A mensagem de erro não é clara ao migrar o conteúdo doUpfront de um ambiente distribuído de instalação do Series 7

Ao migrar conteúdo do IBM Cognos Series 7 Upfront de um ambiente IBMCognos Series 7 em que os serviços do PowerPlay Enterprise Server e os serviçosdo Upfront estejam em dois computadores diferentes, a migração falhará se osserviços do PowerPlay Enterprise forem interrompidos. A seguinte mensagem deerro aparece:

MGD-msg-0440 Ocorreu um erro de comunicação com <nome do host> na porta<número da porta>. Verifique se o nome e o número da porta do servidor demigração do Series 7 estão corretos.

A mensagem de erro não indica claramente que o PowerPlay Enterprise Server nãopôde ser contatado.

Não é Possível Migrar Relatórios no UNIX Quando Nomes deCaminhos Contiverem Determinados Caracteres Europeus

Ocorre um erro ao migrar relatórios com nomes de caminhos que contenhamdeterminados caracteres europeus no sistema operacional UNIX. O erro ocorrequando a origem de migração for IBM Cognos Connection e os relatórios forempublicados no IBM Cognos Business Intelligence da seguinte maneira:1. Os relatórios PPX de origem são criados com a codificação Windows-1252.2. Os relatórios são transferidos, usando FTP, para o UNIX executando em um

código do idioma de francês fr_FR.8859-15 ou de alemão de_DE.8859.15.3. Em um dos códigos do idioma na etapa anterior, o serviço do PowerPlay

Enterprise Server é iniciado.

122 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 131: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

4. Os relatórios são inseridos no PowerPlay Enterprise Server e publicados noIBM Cognos BI.

5. O código do idioma é alterado no IBM Cognos Series 7 Configuration Managerdepois que os relatórios foram publicados na etapa anterior e antes da execuçãoda tarefa de migração.

O erro de migração ocorre se o nome do caminho contiver um dos seguintescaracteres:v 0xA4 (símbolo do euro)v 0xA6 (letra latina s maiúscula com acento circunflexo invertido)v 0xA8 (letra latina s minúscula com acento circunflexo invertido)v 0xB4 (letra latina z maiúscula com acento circunflexo invertido)v 0xB8 (letra latina z minúscula com acento circunflexo invertido)v 0xBC (ligatura latina maiúscula oe)v 0xBC (ligatura latina minúscula oe)v 0xBE (letra latina maiúscula y com trema)

Uma mensagem de erro aparece nos detalhes do histórico de execução ou no logde migração:S7S-err-0646 Exception caught: ...... 93 (__privateGetProperty) ppes_bridge.py:

72(__privateEncode) /dap ..../lib/python2.5/encodings/iso8859_15.py: 12 (encode)

Para solucionar o problema, altere o código do idioma no Configuration Managerpara o código do idioma anterior, execute a migração do conteúdo afetado e depoisaltere novamente o código do idioma no Configuration Manager para o novocódigo do idioma.

Rank aplicado a um eixo tendo um subconjunto customizadoe uma ou mais categorias não migrado para o Analysis Studio

A classificação aplicada a um eixo tendo um subconjunto customizado e uma oumais categorias, mesmo se as categorias forem da mesma dimensão, não serámigrada para o IBM Cognos Analysis Studio. Após a migração, as células do rankestarão vazias para o subconjunto.

Para solucionar esse problema, escolha uma das soluções a seguir:v Em vez disso, migre o relatório para o IBM Cognos Report Studio.v No relatório original, deixe somente o subconjunto customizado no eixo e

remova as outras categorias.

Migração de relatórios com uma única medida no eixo X ou Ynão executada no Report Studio

Ao migrar um relatório do IBM Cognos PowerPlay Web ou PowerPlay Studio quepossui uma única medida no eixo x ou y para o IBM Cognos Report Studio, orelatório não será válido nem será executado. A seguinte mensagem de erroaparece:

RSV-VAL-0003 Não é possível localizar o item <nome da medida>_Summary na consulta<nome da consulta>.

No Report Studio, um novo nó <nome da medida>_Summary é criado em tabelacruzada. Um x vermelho será exibido no nó indicando um problema.

Apêndice A. Solução de problemas 123

Page 132: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Para solucionar o problema, exclua o novo nó do relatório.

Pastas na NewsBox pessoal do Upfront não migradasAs pastas e seu conteúdo presentes em uma NewsBox pessoal do IBM CognosSeries 7 Upfront não serão migrados se tiverem sido criados ao recortar e colarpastas da pasta Pública. Quando a tarefa de migração for concluída, nenhum erroserá registrado, indicando que as pastas não foram migradas.

Para solucionar o problema, copie as pastas em vez de recortá-las e colá-las.Depois que as pastas forem copiadas, exclua as pastas originais se não forem maisnecessárias.

A migração de marcadores gera URLs inválidosApós executar o utilitário de migração de marcadores, o URL de cada marcadormigrado não será válido. Especificamente, o gateway em cada URL nãocorresponde ao gateway real do IBM Cognos Business Intelligence. O gatewayusado é o gateway padrão, que normalmente é http://localhost:80/ibmcognos/cgi-bin/cognos.cgi.

Esse problema ocorre em ambientes distribuídos do IBM Cognos BI. Em ambientesdistribuídos, o gateway padrão talvez não corresponda ao gateway real. Aoexecutar uma tarefa de migração, o valor padrão do gateway será usado quando oarquivo de conversão de marcadores PPS7TOC8CFG.xml for gerado. Este é ogateway exibido no arquivo de saída gerado pelo utilitário de migração demarcadores.

Para solucionar o problema, é possível desempenhar uma das soluções. Pode-secorrigir o valor do gateway no arquivo PPS7TOC8CFG.xml antes de migrarmarcadores ou corrigir o valor do gateway para cada marcador no arquivo desaída de migração de marcadores após a migração.

Procedimento1. Para corrigir o valor do gateway no arquivo PPS7TOC8CFG.xml, faça o

seguinte:v Abra o arquivo PPS7TOC8CFG.xml em um editor de texto.v Localize a seção <c8gateway> e atualize o gateway para o valor correto.v Execute novamente o utilitário de migração de marcadores.

2. Para corrigir o valor do gateway no arquivo de saída de migração do marcador,faça o seguinte:v Abra o arquivo de saída gerado pelo utilitário de migração de marcadores.v Para cada marcador no arquivo de saída, atualize o gateway para o valor

correto.

Exibição incorreta da saída em PDF do relatório migradoAo executar um relatório migrado em PDF, o PDF não é exibido corretamente. Otexto aparece como um conjunto de pontos e uma mensagem de erro é exibidainformando que a fonte AndaleWT não está disponível.

A fonte AndaleWT usada em relatórios do IBM Cognos PowerPlay não é umafonte padrão do sistema operacional Microsoft Windows. Para solucionar esseproblema, escolha uma das opções a seguir:v Execute novamente a migração, selecionando a opção de inclusão das fontes .

124 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 133: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

v No IBM Cognos Administration, configure a opção Geração de Arquivos PDFLeves do relatório como Desativada.

Conceitos relacionados:“Configurações de relatórios” na página 50É possível usar as configurações de relatório para customizar o aplicativo IBMCognos PowerPlay.

Configuração de geração de arquivos PDF leves nãomigrados

A configuração de geração de arquivos PDF leves de um relatório não serámigrada quando for herdada da pasta pai em vez de ser configuradaexplicitamente.

Como consequência, a configuração de geração de arquivos PDF leves em umrelatório migrado poderá ser diferente do relatório de origem.

Esse problema ocorre ao usar o IBM Cognos Connection como a origem demigração e selecionar a opção Manter as Configurações de Fontes do PDF daSeries 7 no IBM Cognos Migration Assistant.

O processo de migração não migra configurações que são herdadas ao usar o IBMCognos Connection como a origem de migração. Propriedades como a Geração deArquivos PDF Leves são migradas da pasta raiz do IBM Cognos Series 7PowerPlay Enterprise Server para a pasta de Conteúdo Migrado. Se aspropriedades não forem configuradas explicitamente em objetos-filhos, os filhosherdarão as propriedades do pai, até a pasta Conteúdo migrado.

A tabela a seguir é um exemplo mostrando como a configuração da Geração deArquivos PDF Leves é configurada em um relatório migrado ao usar o IBMCognos Connection como a origem de migração.

Tabela 42. Configurações de Geração de PDF Leve

PowerPlay Enterprise Server(PPES)

Publicado no IBM CognosConnection

Migração para o IBMCognos PowerPlay

Pasta-raiz: a geração dearquivos PDF leves estáhabilitada

Pastas públicas: a geração dearquivos PDF leves estádesabilitada

Pasta Conteúdo migrado: ageração de arquivos PDFleves está habilitada (dapasta-raiz PPES)

Pasta: a geração de arquivosPDF leves está desabilitada

Pasta: a geração de arquivosPDF leves é herdada do pai

Pasta IBM CognosConnection: a geração dearquivos PDF leves éherdada do pai

Relatório: a geração dearquivos PDF leves éherdada do pai

Relatório: a geração dearquivos PDF leves éherdada do pai

Pasta dentro da pasta IBMCognos Connection: ageração de arquivos PDFleves é herdada do pai

Relatório: a geração dearquivos PDF leves éherdada do pai

Apêndice A. Solução de problemas 125

Page 134: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

v No PowerPlay Enterprise Server (PPES), a configuração Geração de arquivosPDF leves é ativada para a pasta raiz e desativada para a pasta. O relatório deorigem herda a configuração da pasta.

v No IBM Cognos Connection, a configuração Geração de arquivos PDF leves édesativada para Pastas Públicas. A pasta publicada herda a configuração dasPastas públicas e o relatório publicado herda a configuração da pasta.

v Para a pasta Conteúdo migrado, a configuração de geração de arquivos PDFleves está habilitada como se tivesse sido obtida da pasta-raiz PPES. A pastaIBM Cognos Connection herda a configuração da pasta Conteúdo Migrado. Apasta migrada herda a configuração da pasta IBM Cognos Connection e orelatório migrado herda a configuração da pasta migrada.

Para solucionar o problema, configure explicitamente a definição de geração dearquivos PDF leves que deseja no relatório de origem, no relatório migrado ou emum dos relatórios migrados. Como alternativa, configure a opção para incluir ouexcluir fontes na tarefa de migração .

Problemas ao Trabalhar no IBM Cognos PowerPlay AdministrationEsta seção descreve problemas que podem ser encontrados ao trabalhar no IBMCognos PowerPlay Administration.

As Solicitações do PowerPlay Não Aparecem no Status doSistema ou nas Listas de Atividades

Algumas solicitações do IBM Cognos PowerPlay não aparecem ao visualizar ostatus do sistema ou as listas de atividades no IBM Cognos Administration.v As solicitações do PowerPlay Studio que se completam em cinco segundos ou

menos não aparecem no status do sistema do serviço do PowerPlayv As solicitações do PowerPlay Client, independentemente do tempo necessário

para processar a solicitação não aparecem no status do sistema, nas atividadesatuais, nas atividades anteriores ou futuras

Algumas Atividades do PowerPlay Não Estão RegistradasSe você visualizar o arquivo de log ou o banco de dados de log e informaçõessobre a atividade do IBM Cognos PowerPlay que você deseja controlar nãoaparecerem, é possível aumentar o nível de criação de log para registrar maisinformações.Tarefas relacionadas:“Ativar Criação de Log para o Serviço PowerPlay” na página 86Você configura níveis de criação de log para especificar os eventos e as mensagenspara registro no serviço PowerPlay no arquivo de log ou no banco de dados delog, como o início ou a interrupção de um serviço.

Erro de conexão quando o nome do arquivo do PowerCubeinclui caracteres chineses simplificados

Quando o IBM Cognos PowerPlay for instalado em um computador IBM AIX,poderá ocorrer o erro a seguir ao se conectar a um PowerCube que tenhacaracteres chineses simplificados no nome do arquivo. O erro pode ocorrer duranteo teste da conexão da origem de dados ou ao abrir um pacote com base noPowerCube.O cubo não foi aberto com sucesso.

PDS-PPE-0084 Nenhuma mensagem de erro está disponível.

126 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 135: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

{0}ppdsweb/source/CExecCrosstab.cpp(1313): CPPWebException: CCL_THROW: CExecCrosstab::Execute

Para evitar esse erro, renomeie o cubo para usar caracteres em inglês e remova oscaracteres nativos do nome do cubo. Outra opção é usar os caracteres UTF-8 parapontos de código de chinês simplificado (GB2312) ao criar a conexão da origem dedados. Esses caracteres serão exibidos incorretamente no Cognos Connection,porém a conexão funcionará de forma correta.

Problemas ao Trabalhar no IBM Cognos PowerPlay StudioEsta seção descreve problemas que os usuários podem encontrar ao trabalhar noIBM Cognos PowerPlay Studio.

Erro Depois de Inserir um Cálculo no PowerPlay StudioApós inserir um cálculo, pode ocorrer um erro de navegador e a ação do cálculopode não finalizar com sucesso. O problema poderá ocorrer no Microsoft InternetExplorer 7 e no Mozilla Firefox.

Não há atualmente nenhuma solução para este problema no Internet Explorer 7 eMozilla Firefox. O problema não ocorre ao utilizar o Internet Explorer 6.

Erro ao abrir links no e-mail de relatórios programadosQuando um usuário programa a execução de um relatório e solicita que a opção deentrega seja por e-mail, apenas o e-mail enviado por último conterá um linkválido. Todos os e-mails anteriores conterão um link para um relatório que já nãoexiste e resultarão em um erro de página em branco ou em um erro de página nãoencontrada.

Erro de página ao editar o título do gráfico em japonêsAo configurar uma fonte em japonês para o título do gráfico, poderá ocorrer umerro. Este erro ocorre se a fonte em japonês selecionada não for uma fonte UTF-8.

Para corrigir este erro, selecione uma fonte japonesa UTF-8.

Sequências longas estão truncadasA quebra de palavras só funciona em idiomas que usam espaços para separarpalavras.

Para forçar uma quebra de palavra em idiomas como o chinês, coreano, japonês etailandês, insira um espaço de um único byte em um local apropriado para simularuma quebra de palavra.

Texto em hebraico exibido em gráficosEm alguns elementos de gráfico, o texto bidirecional hebraico pode ser exibido emuma ordem "lógica", em vez da ordem "visual" esperada. Para obter informaçõesadicionais, visite http://people.w3.org/rishida/scripts/bidi/.

Apêndice A. Solução de problemas 127

Page 136: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Após exportar para PDF, o rótulo correspondente a categoriaOUTRO em um gráfico de setores muda para o rótulo dacategoria

Ao criar um gráfico de setores circulares no IBM Cognos PowerPlay Studio, acategoria OUTRO será gerada e ficará visível na legenda. Após exportar para PDF,o nome da categoria correta substitui o OUTRO na legenda. Este é ocomportamento esperado.

Exibição ilegível ou inacessívelSe você usar o navegador da Web Microsoft Internet Explorer 7, poderá obter umaexibição ilegível com configurações de zoom mais altas. Por exemplo, algunselementos de exibição podem sobrepor-se.

Para corrigir a exibição, reduza as configurações de zoom do Internet Explorer 7.

Delimitador Usado para Exportar para CSV Diferente do IBMCognos Series 7

Por padrão, o IBM Cognos PowerPlay usa um delimitador por tabulação paraexportar para o arquivo CSV. Esse comportamento é consistente com outros studiosdo IBM Cognos.

Para alterar o formato do delimitador, modifique as configurações avançadas doserviço PowerPlay.Conceitos relacionados:“Definindo Configurações Avançadas para o Serviço PowerPlay” na página 33É possível usar configurações avançadas para customizar o ambiente do IBMCognos PowerPlay.

Erro de Firewall do Cognos Application ao Salvar umRelatório do PowerPlay Studio

Se a sua instalação do IBM Cognos Business Intelligence usar o Cognos ContentDatabase, você receberá o seguinte erro ao tentar salvar um relatório do PowerPlayStudio.An error has occurred.

DPR-ERR-2079 Firewall Security Rejection. Your requestwas rejected by the security firewall.

CAF rejection details are available in the log. Pleasecontact your administrator.

Para evitar esse erro, use um banco de dados suportado diferente para oarmazenamento de conteúdo do IBM Cognos BI.

128 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 137: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Apêndice B. Executando Tarefas no IBM Cognos BI UsandoURLs

As URLs fornecem uma maneira rápida e eficiente para iniciar componentes doIBM Cognos Business Intelligence e abrir o conteúdo especificado, como relatórios,métricas, pastas ou páginas.

É possível utilizar URL para:v iniciar componentes do IBM Cognos BIv acessar uma página do IBM Cognos Connection

É possível usar o programa de amostra URL Report incluído no Kit deDesenvolvimento de Software do IBM Cognos para ver exemplos que demonstramcomo executar tarefas básicas clicando em links integrados em uma página deservidor ativa. Para obter informações sobre as amostras instaladas com o SoftwareDevelopment Kit, consulte o IBM Cognos Software Development Kit Developer Guide.No entanto, para tarefas complexas, como planejamento, use o SoftwareDevelopment Kit para criar um aplicativo customizado.

É possível usar várias declarações para identificar a ação solicitada, dependendodo componente do IBM Cognos BI.

Nota: Essas declarações não são as mesmas que as dos métodos do Kit deDesenvolvimento de Software expostos pela API do BI Bus.

Para obter informações adicionais sobre como usar URLs, consulte o Guia deAdministração e Segurança do IBM Cognos BI.

Recomendações para URLsDependendo dos seus objetivos, algumas ou todas as seguintes práticasrecomendadas de programação de URL descritas aqui podem ser aplicar a suasituação.

As práticas recomendadas incluem o seguinte:v Certifique-se de que suas URLs não incluem espaços. Por exemplo, se estiver

usando Javascript para uma declaração de postagem, você deve converterquaisquer espaços no formulário %20. (Se inserir valores usando a técnica deobtenção, o navegador da Web trata essa codificação para você.)

v Use o sinal de igual (=) seguido por um espaço entre aspas simples quandoestiver enviando variáveis de formulário vazio para acomodar os requisitos denotação de todos os servidores da web. Por exemplo, para terminar uma matrizde tipo complexo em uma declaração de postagem, use a seguinte sintaxe:...name='EA' value=' '/>

v Use a sintaxe &backURL= para especificar o local de URL ao qual retornar,quando os usuários clicarem em Retornar na janela de saída.

Dica: Para evitar a ativação de uma nova janela do navegador, é possívelespecificar um nome de destino de "_self" como um atributo da tag âncora <a>.

© Copyright IBM Corp. 2005, 2014 129

Page 138: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Programa CGI e gateways alternativosTodos os comandos URL começam com uma declaração do ponto final dasolicitação: seja cognos.cgi ou um gateway alternativo.

Para o IBM Cognos Business Intelligence, a sintaxe completa éhttp://webservername:portnumber/ibmcognos/cgi-bin/cognos.cgi.

Se você configurou o IBM Cognos BI para usar um gateway diferente do programaCGI padrão, digite a URL que corresponde ao seu gateway. Para obter informaçõessobre como configurar gateways, consulte o IBM Cognos Business IntelligenceInstallation and Configuration Guide.

Os gateways suportados encontram-se relacionados na seguinte tabela:

Tabela 43. Gateways Suportados

Gateway URL

ISAPI http://nomedoservidor/ibmcognos/isapi

Apache Connector (sistema operacionalMicrosoft Windows)

http://nomedoservidor/ibmcognos/cgi-bin/mod_cognos.dll

Apache Connector (Solaris e AIX) http://nomedoservidor/ibmcognos/cgi-bin/mod_cognos.so

Apache Connector (HPUX) http://nomedoservidor/ibmcognos/cgi-bin/mod_cognos.sl

Servlet de gateway http://nomedoservidor:9300/ServletGateway/servlet/Gateway

CGI http://nomedoservidor/ibmcognos

Métodos de URLHá dois métodos para iniciar a maioria dos componentes do IBM Cognos: URLparametrizada e cognosLaunch. Os dois métodos executam a mesma função eusam os mesmos parâmetros. É possível utilizar qualquer um dos métodos paraexecutar as tarefas da interface do usuário.

Método de URL parametrizadoO método de URL parametrizado executa tarefas ou inicia componentes específicosutilizando parâmetros digitados na barra de endereço do navegador da web.

Usando os métodos obter e postar, o parâmetro launch.xts ou cc.xts inicia ocomponente do IBM Cognos BI especificado.

Os métodos exigem que os parâmetros utilizem o seguinte formato:&ArgumentName=ArgumentValue

130 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 139: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

O parâmetro ArgumentName especifica o tipo e o parâmetro ArgumentValue especificao valor dos argumentos chamados. Todos os nomes e valores devem ser sequênciasde caracteres.

Esse método é mais fácil de começar a usar do que o método cognosLaunch, poisnão necessita de preparação antecipada. Entretanto, as entradas codificadas emURL mais longos são restritas por limites de caracteres do navegador.

É possível usar esses comandos para navegar pelo conteúdo do IBM CognosConnection ou visualizar páginas no IBM Cognos Viewer.

Parâmetros obrigatórios de URL parametrizado

Caso utilize o método de URL parametrizado para iniciar um componente, use osseguintes parâmetros com a sintaxe indicada:http://localhost/cgi-bin/cognos.cgi?b_action=xts.run&m=portal/launch.xts

seguido pelos parâmetros do componente específico que deseja utilizar.

Se desejar iniciar o IBM Cognos Viewer usando o método de URL parametrizado,use os seguintes parâmetros com esta sintaxe:http://localhost/cgi-bin/cognos.cgi?b_action=cognosViewer

Se você desejar iniciar o IBM Cognos Connection usando o método de URLparametrizado, use a seguinte URL:http://localhost/cgi-bin/cognos.cgi?b_action=xts.run&m=portal/cc.xts

Os blocos de construção obrigatórios dos comandos de URL parametrizado são osseguintes:v gateway

Esse é o valor do argumento obrigatório que especifica o gateway do IBMCognos BI. O nome do gateway nesse exemplo é http://server/ibmcognos/cgi-bin/cognos.cgi?.A validação do IBM Cognos Application Firewall é aplicada em URLs quecontenham esse parâmetro. Para obter informações adicionais, consulte“Validação de URL”.

v b_action=xts.run

Identifica a ação. Para especificar o IBM Cognos Viewer, useb_action=cognosViewer.

v m=portal/launch.xts&ui.tool=tool_name

Identifica a interface do componente do IBM Cognos BI que exibe o resultado.Para iniciar o IBM Cognos Connection, use o m=portal/cc.xts.

v ui.action

Especifica a ação a ser tomada. Os valores aceitáveis para os componentes doStudio são new eedit. O padrão é new. Os valores aceitáveis para o IBM CognosViewer são run e view. O padrão é view.

Validação de URLA validação do IBM Cognos Application Firewall é forçada em URLs usando asregras a seguir.v URLs totalmente qualificadas ou absolutas:

protocol://host[:port]/path[?query]

Apêndice B. Executando Tarefas no IBM Cognos BI Usando URLs 131

Page 140: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Em que o protocolo é http ou https e o host é validado com relação à lista dedomínios válidos, que é especificada pelo administrador no IBM CognosConfiguration. Para obter informações adicionais, consulte o Guia de Instalação eConfiguração do IBM Cognos Business Intelligence.

v URLs relativas à raiz da Web de instalação do IBM Cognos BI:/<install root>/.*

Em que <install root> é o caminho de arquivo do gateway, obtido no URI doGateway do Cognos Configuration Tool. Por exemplo, /ibmcognos/ps/portal/images/.

v Um dos seguintes URL especialmente permitidos:– about:blank (sem distinção de maiúsculas e minúsculas)– JavaScript:window.close() (sem distinção de maiúsculas e minúsculas, com

ou sem ponto-e-vírgula delimitador)– JavaScript:parent.close() (sem distinção de maiúsculas e minúsculas, com

ou sem ponto-e-vírgula delimitador)– JavaScript:history.back() (sem distinção de maiúsculas e minúsculas, com

ou sem ponto-e-vírgula delimitador)– parent.cancelErrorPage() (sem distinção de maiúsculas e minúsculas, com

ou sem ponto-e-vírula delimitador)– doCancel() (sem distinção de maiúsculas e minúsculas, com ou sem

ponto-e-vírgula delimitador)

Além disso, uma configuração de configuração avançada,RSVP.RENDER.VALIDATEURL, pode ser utilizada para especificar quando essasregras são aplicadas a valores especificados por quaisquer valores de URL contidosna especificação do relatório. O CAF deve ser habilitado para que a configuraçãoRSVP.RENDER.VALIDATEURL funcione.

Iniciando Componentes do IBM Cognos BIUse uma URL para iniciar componentes do IBM Cognos Business Intelligence eabrir o conteúdo especificado.

Os componentes podem ser iniciados em qualquer página da web habilitada.

É possível usar uma URL para iniciar os seguintes componentes do IBMCognos BI:v PowerPlay Studio

Iniciando o PowerPlay StudioÉ possível usar uma URL para ativar um pacote ou relatório no IBM CognosPowerPlay Studio.

Para obter informações adicionais sobre outras opções para trabalhar com URLs,consulte o Guia de Administração e Segurança do IBM Cognos.

Use os seguintes parâmetros para iniciar o PowerPlay Studio com o método URLparametrizada:http://localhost/cgi-bin/cognos.cgi?b_action=powerPlayService

Os parâmetros b.action, TARGET e ui.action são obrigatórios.

132 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 141: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

v O parâmetro b_action direciona as solicitações recebidas para o serviçoapropriado.

v O parâmetro TARGET identifica o nome e o local do objeto de relatório. Oparâmetro TARGET é geralmente o caminho da procura do objeto de relatório queestá sendo usado.

v O parâmetro ui.action especifica a ação a ser tomada. Os valores aceitáveis sãorun e edit.

Os parâmetros FORMAT, FILTER e PROMPT são opcionais.v O parâmetro FORMAT especifica o formato de saída. Os valores aceitáveis são PDF

e HTML.v O parâmetro FILTER especifica o contexto do pacote ou relatório. O parâmetro

exige um valor codificado por URL de Dimension Code1<tab>PPDSIDCode<tab>Dimension Code2<tab>PPDSID Code. É possível usar apenas umPPDSID Code por Dimension Code. Não é possível passar vários valores para amesma dimensão.

v O parâmetro PROMPT especifica se o relatório do cliente com filtragem de linha dedimensão exibe a página de filtragem de linha de dimensão. Esta configuraçãose aplica apenas a relatório publicados no formato PDF com a filtragem de linhade dimensão habilitada.

Exemplos de URL parametrizadoEsta seção fornece um exemplo ao iniciar o IBM Cognos PowerPlay Studio usandoo método de URL parametrizada.v Usando o PowerPlay Studio para abrir um objeto de relatório específico

http://localhost/cgi-bin/cognos.cgi?b_action=powerPlayService&TARGET=/content/folder[@name=’Samples’]/folder[@name=’Cubes’]/package[@name=’Salesand Marketing (cube)’]/folder[@name=’PowerPlay Studio Report Samples’]/powerPlay8Report[@name=’Revenueby Order Method’]

v Abrindo um relatório no PowerPlay Studio usando filtragemhttp://localhost/cgi-bin/cognos.cgi?b_action=powerPlayService&TARGET=/content/folder[@name=’Samples’]/folder[@name=’Cubes’]/package[@name=’Salesand Marketing (cube)’]/folder[@name=’PowerPlay Studio Report Samples’]/powerPlay8Report[@name=’Revenueby Order Method’]&FILTER=Order%20method%09601%09MEASURES%09Returns

Apêndice B. Executando Tarefas no IBM Cognos BI Usando URLs 133

Page 142: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

134 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 143: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Apêndice C. Mapeamento de caracteres Shift-JIS japoneses

Ao migrar relatórios ou cubos cujos nomes contêm caracteres japoneses, podemocorrer problemas, porque não há um padrão da indústria para o mapeamento desequências de bytes de caracteres Shift-JIS para e de Unicode.

O IBM Cognos Series 7 PowerPlay Enterprise Server usa variantes específicas dosistema operacional do esquema de codificação de caractere de multibyte Shift-JISpara armazenar caracteres japoneses. O IBM Cognos Business Intelligencearmazena todos os caracteres internamente em Unicode.

Podem surgir problemas ao migrar do IBM Cognos Series 7 para o IBM Cognos BIporque as conversões do Shift-JIS para Unicode e do Unicode para Shift-JIS sãoexecutadas por software diferente. Se essas conversões não usarem todas o mesmomapeamento de Shift-JIS de e para Unicode, nomes de relatório e cubos poderãonão corresponder, resultando em itens que falham na migração ou em relatóriosmigrados que não podem ser executados.

Mapeamentos de codificação podem ser realizadosv pelo serviço de migração do IBM Cognos Series 7

Por padrão, o serviço de migração do IBM Cognos Series 7 usa bibliotecasintegradas para codificar e decodificar caracteres, mapeando-os entre Shift-JIS eUnicode. Pode ser necessário reconfigurar os mapeamentos.

v pela ferramenta IBM Cognos Series 7 PowerPlay Enterprise ServerAdministration (ppsrvadm)Se você publicar o conteúdo do IBM Cognos Series 7 PowerPlay no IBM CognosBI a partir dessa ferramenta, as referências aos nomes de cubo e relatório doPowerPlay 7 serão convertidas em Unicode usando as bibliotecas de conversãode caracteres fornecidas pela Java™ Virtual Machine (JVM) usada para ativar aferramenta. Ao migrar o conteúdo para o IBM Cognos BI, o serviço de migraçãodo IBM Cognos Series 7 deve estar apto a reconverter os nomes de cubo erelatório em Shift-JIS e novamente em Unicode usando o mesmo conjunto demapeamentos.

v por programas de transferência de arquivos usados para mover arquivos de umservidor para outroSe cubos e relatórios forem transferidos de um servidor para outro e acodificação subjacente do sistema de arquivo for alterada no processo, poderáhaver um impacto do mapeamento de caracteres escolhido pelo programa detransferência de arquivos utilizado. Por exemplo, ao migrar o conteúdo de umservidor IBM Cognos Series 7 no sistema operacional Solaris que usa o códigode idioma japonês JP.PCK, os nomes de arquivos são armazenados no discousando a variante de Shift-JIS do sistema operacional Solaris. Quando essesarquivos são transferidos para um novo servidor que esteja usando um códigodo idioma baseado em Unicode, haverá um impacto do mapeamento decaracteres que o programa de transferência de arquivos usou para atransferência.

v pelas funções de API do sistema operacional usadas para ler e gravar arquivosSe o sistema de arquivos usado pelo servidor IBM Cognos Series 7 usar umconjunto de caracteres diferente do usado no código de idioma em que o IBMCognos Series 7 PowerPlay Enterprise Server está sendo executado, você poderáser afetado pelo mapeamento de caracteres escolhido pelo sistema de arquivos.

© Copyright IBM Corp. 2005, 2014 135

Page 144: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Por exemplo, se o IBM Cognos Series 7 PowerPlay Enterprise Server estiver emexecução no Windows com um sistema de arquivos NTFS no código de idiomajaponês, o PowerPlay está em execução na Página de Códigos 932 do Window,que é a variante de Shift-JIS da Microsoft. Mas os nomes de arquivos sãoarmazenados em Unicode no disco. O mapeamento entre as duas codificações érealizada no momento da execução.

v pelo servidor IBM Cognos BIO servidor do IBM Cognos BI se baseia no JVM usado para executar o IBMCognos BI para executar mapeamentos de caracteres. Mesmo se você estiverusando o mesmo fornecedor de JVM para o IBM Cognos BI e ppsrvadm, os doisservidores podem mapear alguns caracteres Shift-JIS para diferentes pontos decódigo Unicode.

Se qualquer um dos pontos de codificação não empregar os mesmos mapeamentosde caractere, você deve alterar os nomes de cubos e relatórios para remover oscaracteres problemáticos ou reconfigurar os caracteres para fazer com que usem omesmo mapeamento.

Caracteres problemáticos

A tabela abaixo descreve os caracteres Shift-JIS que podem causar problemas.Caracteres marcados com um asterisco (*) são mapeamentos raros e é improvávelque vá encontrá-los.

Tabela 44. Caracteres Shift-JIS que Podem Causar Problemas na Migração

Bytes JIS Bytes Shift-JISPontos de códigoUnicode Descrição

0x5C 0x5C U+005C

u+00A5

Barra invertida

Símbolo do iene

0x7E 0x7E U+007E

U+203E

Til

Sobreposto

0x2131 0x8150 U+203E*

U+FFE3

Sobreposto

Macron com larguratotal

0x213D 0x815C U+2014

U+2015

Travessão

Barra horizontal

0x2140 0x815F U+005C*

U+FF3C

Barra invertida

Barra invertida delargura completa

0x2141 0x8160 U+301C

U+FF5E

Traço ondulado

Til de larguracompleta

136 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 145: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Tabela 44. Caracteres Shift-JIS que Podem Causar Problemas na Migração (continuação)

Bytes JIS Bytes Shift-JISPontos de códigoUnicode Descrição

0x2142 0x8161 U+2016

U+2225

Linha vertical dupla

paralelo a

0x215D 0x817C U+2212

U+FF0D

Sinal de subtração

Sinal de subtração delargura completa

0x216F 0x818F U+00A5*

U+FFE5

Símbolo do iene

Símbolo do iene delargura completa

0x2171 0x8191 U+00A2

U+FFE0

Símbolo de cents

Símbolo de cents delargura completa

0x2172 0x8192 U+00A3

U+FFE1

Símbolo de libra

Símbolo de libra delargura completa

0x224C 0x81CA U+00AC

U+FFE2

Símbolo de não

Símbolo de não delargura completa

Tarefas relacionadas:“Reconfiguração dos caracteres Shift-JIS para mapeamento Unicode”É possível ajustar com precisão o mapeamento de Shift-JIS para Unicode evice-versa, usado pelo serviço de migração do IBM Cognos Series 7, colocando umarquivo de configuração chamado shift-jis.xml no diretório s7_location\migs7.

Reconfiguração dos caracteres Shift-JIS para mapeamento UnicodeÉ possível ajustar com precisão o mapeamento de Shift-JIS para Unicode evice-versa, usado pelo serviço de migração do IBM Cognos Series 7, colocando umarquivo de configuração chamado shift-jis.xml no diretório s7_location\migs7.

Esse arquivo emprega o mesmo formato usado pelo utilitário IBM Cognos BusinessIntelligence Round Trip Safety Configuration.

Para obter informações adicionais sobre o utilitário Round Trip SafetyConfiguration e como ele afeta o comportamento do tempo de execução do IBMCognosBI, consulte o Guia de Administração e Segurança do IBM Cognos BI.

Dica: Pode ser mais fácil gerar um arquivo shift-jis.xml com o utilitário RoundTrip Safety Configuration e, em seguida, ajustar o arquivo shift-jis.xml resultantemanualmente.

Apêndice C. Mapeamento de caracteres Shift-JIS japoneses 137

Page 146: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Antes de Iniciar

Recomendamos primeiro fazer um backup do arquivo shift-jis.xml existente nocaso de desejar voltar à versão original.

Procedimento1. Inicie o utilitário Round Trip Safety Configuration:

v No sistema operacional Microsoft Windows, clique duas vezes emc10_location\bin\rtsconfig.bat.

v No sistema operacional UNIX, execute o comando c10_location/bin/rtsconfig.2. Na guia Conversão, especifique como processar os caracteres Unicode

relacionados em Shift-JIS.3. Na guia Substituição, especifique como alguns caracteres Shift-JIS são

processados em Unicode.4. Salve as mudanças.

O arquivo c10_location\bin\shift-jis.xml é atualizado.5. Copie o arquivo shift-jis.xml para o local s7_location\migs7.6. Se precisar editar manualmente o arquivo, abra-o no local s7_location\migs7

usando um editor de XML ou de texto e faça as mudanças desejadas.7. Crie uma variável de ambiente chamada PYCODECS_MAP_DIR e aponte-a

para a pasta s7_location\migs7.Por exemplo, C:\Arquivos de Programas\Cognos\cer5\migs7.

Nota: No Windows, você deve tornar esta uma variável de ambiente dosistema e não uma variável de usuário para que seja acessível ao serviço demigração do IBM Cognos Series 7.

8. Pare e reinicie o serviço de migração do IBM Cognos Series 7:v No Windows, vá para o diretório s7_location/migs7 e use o seguinte

comando:configure.exe --stop

Para reiniciar o serviço, use o seguinte comando:configure.exe --start

v no sistema operacional UNIX, vá para o diretório s7_location/migs7 e use oseguinte comando:./configure --stop

Para reiniciar o serviço, use o seguinte comando:./configure --start

Resultados

Nota: Se houver uma cópia do arquivo shift-jis.xml no diretório c10_location\bin,ela afetará o comportamento do tempo de execução do IBM Cognos BI ao interagircom usuários finais e com bancos de dados que não fornecem seus própriosmecanismos de conversão. Se não desejar alterar esse comportamento, restaure oarquivo shift-jis.xml localizado na pasta c10_location\bin\ para a versão de backup.Conceitos relacionados:Apêndice C, “Mapeamento de caracteres Shift-JIS japoneses”, na página 135Ao migrar relatórios ou cubos cujos nomes contêm caracteres japoneses, podemocorrer problemas, porque não há um padrão da indústria para o mapeamento desequências de bytes de caracteres Shift-JIS para e de Unicode.

138 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 147: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

“O arquivo shift-jis.xml não parece afetar os mapeamentos usados”Depois de alterar o arquivo shift-jis.xml, os mapeamentos usados não são afetados.

Edição manual do arquivo shift-jis.xmlEdite o arquivo shift-jis.xml manualmente quando precisar de um mapeamentomais flexível do que o fornecido. O utilitário Round Trip Configuration permiteconfigurar mapeamentos somente para caracteres que geralmente apresentamproblemas.

A edição manual do arquivo shift-jis.xml pode impedir que o utilitário Round TripSafety Configuration o analise corretamente. Recomendamos usar o utilitário paragerar o arquivo de mapeamento inicial e copiá-lo para o local s7_location\migs7antes de editá-lo manualmente.

Dica: É possível também criar manualmente o arquivo shift-jis.xml sem usar outilitário Round Trip Safety Configuration.

Antes de editar o arquivo shift-jis.xml, você deve se familiarizar como formato doarquivo. O exemplo a seguir especifica que quando o caractere Unicode U+2116 forencontrado, ele é convertido para o 0x8782 do Shift-JIS.<conversion>

<entry id="1"><unicode>U+2116</unicode><native selected="true">0x8782</native><native>0xFA59</native><references><reference>9333</reference><reference>9334</reference></references></entry>

O exemplo a seguir especifica que quando uma sequência Shift-JIS puder mapearpara U+00A2 ou U+FFE0, ela será mapeada para U+FFE0.<substitution>

<entry id="1"><codepoint value="U+00A2" replaceWith="U+FFE0"/><codepoint value="U+FFE0" replaceWith="U+FFE0"/></entry>

Solução de problemas ao migrar caracteres Shift-JISEsta seção descreve alguns problemas comuns que podem ser encontrados aotentar usar o arquivo shift-jis.xml para migrar caracteres Shift-JIS problemáticos.

O arquivo shift-jis.xml não parece afetar os mapeamentosusados

Depois de alterar o arquivo shift-jis.xml, os mapeamentos usados não são afetados.

Para solucionar esse problema, escolha uma das soluções a seguir:v Verifique se os arquivos s7_location\migs7\rtssubstitution.dat e

s7_location\migs7\rtsconversion.dat foram criados e são mais novos que oarquivo s7_location\migs7\shift-jis.xml. Se não for este o caso, pare e reinicie oserviço de migração do IBM Cognos Series 7.

Apêndice C. Mapeamento de caracteres Shift-JIS japoneses 139

Page 148: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

v Verifique que os arquivos .dat são legíveis pelo ID de usuário com o qual oserviço de migração do IBM Cognos Series 7 está sendo executado. Por exemplo,no Windows, a conta do Sistema Local pode não ter acesso aos arquivos.

v Ative a criação de log de depuração configurando a variável de ambiente dosistema PYCODECS_MAP_DEBUG como 1 e, em seguida, reiniciando o serviçode migração do IBM Cognos Series 7. Isso gera o arquivo de texto%PYCODECS_MAP_DIR%\PyCodec.txt que pode ajudar a diagnosticar oproblema.

Conceitos relacionados:“Uma mensagem de erro multibyte aparece durante a migração”Ao realizar uma migração, a seguinte mensagem de erro aparece:Tarefas relacionadas:“Reconfiguração dos caracteres Shift-JIS para mapeamento Unicode” na página 137É possível ajustar com precisão o mapeamento de Shift-JIS para Unicode evice-versa, usado pelo serviço de migração do IBM Cognos Series 7, colocando umarquivo de configuração chamado shift-jis.xml no diretório s7_location\migs7.

Uma mensagem de erro multibyte aparece durante a migraçãoAo realizar uma migração, a seguinte mensagem de erro aparece:Sequência de códigos multibyte ILEGAL: <Nome da sequência de bytes>

Para solucionar esse problema, escolha uma das soluções a seguir:v Se um arquivo shift-jis.xml foi criado, verifique se há a presença de uma

sequência de bytes no arquivo. Verifique se mapeamentos de ida (substituição) ede volta (conversão) foram definidos. Por exemplo, se você definiu asubstituição U+2015 -> U+2014, deverá definir também a conversão U+2014 ->0x815C.

v Verifique se seus mapeamentos estão carregando conforme esperado ativandoPYCODECS_MAP_DEBUG.

Conceitos relacionados:“O arquivo shift-jis.xml não parece afetar os mapeamentos usados” na página 139Depois de alterar o arquivo shift-jis.xml, os mapeamentos usados não são afetados.

O Serviço de Migração do IBM Cognos Series 7 não PodeAbrir um Arquivo do PowerPlay Contendo CaracteresProblemáticos

Ao realizar uma migração, o serviço de migração relata que não consegue abrir umarquivo .ppx que contém caracteres problemáticos.

Para solucionar esse problema, escolha uma das soluções a seguir:v Verifique se o relatório do IBM Cognos PowerPlay existe no local correto e se ele

pode ser aberto pelo ID do usuário no qual o serviço de migração está sendoexecutado.

v Se seu sistema de arquivos armazena nomes de arquivos em Unicode, pode sernecessário definir um arquivo shift-jis.xml que explicitamente mapeia oscaracteres problemáticos da mesma maneira que o sistema de arquivos. Porexemplo, para o sistema de arquivos NTFS no Windows, é provável que osmapeamentos a seguir sejam necessários.

140 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 149: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Tabela 45. Mapeando Caracteres SHIFT-JIS para Caracteres Unicode

Shift-JIS Unicode

0x815C U+2015

0x8160 U+FF5E

0x8161 U+2225

0x817C U+FF0D

0x818F U+FFE5

0x8191 U+FFE0

0x8192 U+FFE1

0x81CA U+FFE2

Nenhum mapeamento de cubo localizado para um relatórioDurante uma migração nenhum mapeamento de cubo é localizado para umrelatório porque o caminho do cubo contém caracteres problemáticos.

Para solucionar o problema, para cada caractere na tabela de caracteresproblemáticos que esteja no caminho do cubo, tente mapear esse caractere primeiroem uma direção e depois na outra no arquivo shift-jis.xml.

Por exemplo, um relatório .ppx tem a sequência de bytes Shift-JIS 81,61,2e,70,70,78como nome. No Unicode, o nome pode ser interpretado como “{DOUBLEVERTICAL LINE}.ppx” (2016, 002e, 0070, 0070, 0078) ou “{PARALLEL TO}.ppx”(2225, 002e, 0070, 0070, 0078). Se o mapeamento não for substituído para 2016 e2225, não será possível migrar esse relatório. Use uma das seguintes soluções:v Inclua o mapeamento a seguir para forçar o serviço de migração do IBM Cognos

Series 7 a usar 2016.Substituição: 2225 -> 2016Conversão: 2016 -> 81, 61Conversão: 2225 -> 81, 61

v Se o mapeamento não funcionar, use 2225 no lugar.Substituição: 2016 -> 2225Conversão: 2016 -> 81, 61Conversão: 2225 -> 81,61

Nota: Você deve reiniciar o serviço de migração e executar novamente umamigração sempre que modificar o arquivo shift-jis.xml.

Caracteres não migrados corretamente quando se usa umaorigem de migração diferente

Os caracteres que migram corretamente ao usar o IBM Cognos PowerPlayEnterprise Server como a origem de migração não migram corretamente ao usar oIBM Cognos Business Intelligence como a origem de migração ou vice-versa.

Apêndice C. Mapeamento de caracteres Shift-JIS japoneses 141

Page 150: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Para solucionar este problema, defina um arquivo shift-jis.xml separado para cadatipo de origem de migração. Observe que você deve reiniciar o serviço demigração do IBM Cognos Series 7 e executar a migração novamente sempre quealterar o arquivo shift-jis.xml.

Problemas ao Migrar Cubos com Caracteres Não ASCII noUNIX

Se o serviço do IBM Cognos Series 7 PowerPlay Enterprise Server estiver usandoum nome de caminho não ASCII para acessar um PowerCube e o servidor IBMCognos Business Intelligence estiver em execução em um código de idioma queuse um conjunto de caracteres diferente, o servidor IBM Cognos BI não conseguirálocalizar o PowerCube referenciado no disco.

Por exemplo, o serviço PPES está usando um nome japonês codificado em Shift-JISusando o código do idioma ja_JP.PCK no sistema operacional Solaris e o servidorIBM Cognos BI está executando no código do idioma ja_JP.UTF-8. Como resultado,a migração de relatórios que dependem do PowerCube falha com mensagens deerro como as seguintes:

MGD-msg-0424 Não é possível criar a seguinte origem de dados no IBM CognosBI: cubes/Japanese/<caracteres japoneses>

MGD-msg-0422 Exceção MigDeploy: MGD-msg-0432 Parâmetros de origem dedados inválidos. O caminho para o cubo físico não foi especificado.

O procedimento para solucionar o problema depende de você querer usar a mesmaconfiguração ou uma configuração de código de idioma diferente no IBM CognosBI da usada no IBM Cognos Series 7.

Para usar a mesma configuração do código de idioma no IBM Cognos BI da usadano Series 7, configure variáveis de ambiente do idioma para que correspondam àsusadas ao iniciar o Series 7 PPES.

Se desejar usar uma configuração do código de idioma diferente no IBM CognosBI, faça uma cópia do PowerCube na codificação do código de idioma. Observeque provavelmente será necessário usar uma shell customizada ou outro utilitáriopara copiar arquivos, dado que inserir nomes de arquivos usando duascodificações diferentes em um prompt de comandos de shell pode não funcionar.

Procedimento1. Para configurar variáveis de idioma para que correspondam às usadas ao

iniciar o Series 7 PPES, faça o seguinte:v Configure as variáveis de ambiente LANG, LC_ALL e, se aplicável,

LC_CTYPE para que correspondam às usadas ao iniciar o IBM Cognos Series7 PPES.Por exemplo, LANG= ja_JP.UTF-8.

v Inicie instalação_c10/bin/cogconfig.sh.v Reinicie o serviço do IBM Cognos.v Refaça a migração.

2. Para fazer uma cópia do PowerCube na codificação do código de idioma, façao seguinte:

142 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 151: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

v Copie o arquivo .mdc do PowerCube no disco de seu nome, na antigacodificação de código do idioma, para seu novo nome na nova codificação decódigo do idioma.Por exemplo, para mover o arquivo "cubes/Japanese/caracteres japoneses.mdc"de ja_JP.PCK para ja_JP.UTF-8, copie o arquivo de nome".../cubes/Japanese/\x93\xfa\x96{\x8c\xea\x82\xcc\x83L\x83\x85\x83u.mdc"para o novo nome de arquivo".../cubes/Japanese/\xe6\x97\xa5\xe6\x9c\xac\xe8\xaa\x9e\xe3\x81\xae\xe3\x82\xad\xe3\x83\xa5\xe3\x83\x96.mdc"

v Refaça a migração.

Não é possível migrar porque já existe um objeto de relatóriosdo Content Manager com o mesmo nome

Ao executar uma tarefa de migração, o Content Manager relata um erro nosdetalhes do histórico de execução, de que já existe um objeto com o mesmo nome enão é possível prosseguir com a migração. Se fizer uma consulta no banco dedados do Content Manager, não encontrará o objeto.

Esse problema ocorre apenas quando o Content Manager for um banco de dadosdo Microsoft SQL Server e for causado pela existência de um objeto no banco dedados do Content Manager que contém uma variante de um dos caracteres nonome do objeto. Por exemplo, se o objeto que está migrando contém o caractereUnicode U+00A2 (sinal de centavo) e um objeto com o caractere Unicode U+FFE0(sinal de centavo de largura total) existirem no banco de dados.

Para solucionar esse problema, escolha uma das opções a seguir antes de migrar:v No banco de dados do Content Manager, exclua o objeto que impossibilita a

migração.v Recrie o banco de dados do Content Manager usando a sequência de ordenação

Latin1_General_CI_AS_KS_WS em vez de Latin1_General_CI_AS.Ao criar o banco de dados do Content Manager usando uma sequência deordenação que inclui caracteres que fazem distinção de largura (_WS), evita-seconflitos com objetos que contêm variantes de meia largura e de largura total domesmo caractere em seus nomes.

Apêndice C. Mapeamento de caracteres Shift-JIS japoneses 143

Page 152: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

144 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 153: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Avisos

Estas informações foram desenvolvidas para produtos e serviços oferecidos nomundo inteiro.

Esse material pode estar disponível na IBM em outros idiomas. No entanto, podeser necessário possuir sua própria cópia ou versão do produto nesse idioma paraacessá-lo.

É possível que a IBM não ofereça os produtos, serviços ou recursos discutidosnesta publicação em outros países. Consulte um representante IBM local para obterinformações sobre os produtos e serviços disponíveis atualmente em sua área.Qualquer referência a produtos, programas ou serviços IBM não significa queapenas produtos, programas ou serviços IBM possam ser usados. Qualquerproduto, programa ou serviço funcionalmente equivalente, que não infrinjanenhum direito de propriedade intelectual da IBM poderá ser usado emsubstituição a este produto, programa ou serviço. Entretanto, a avaliação everificação da operação de qualquer produto, programa ou serviço não IBM são deresponsabilidade do Cliente. Este documento pode descrever produtos, serviços ourecursos que não estão incluídos no Programa ou autorização de licença que vocêcomprou.

A IBM pode ter patentes ou solicitações de patentes pendentes relativas a assuntostratados nesta publicação. O fornecimento desta publicação não lhe concede direitoalgum sobre tais patentes. Consultas sobre licença devem ser enviadas, por escrito,para:

Gerência de Relações Comerciais e Industriais da IBM BrasilAv. Pasteur, 138-146BotafogoRio de Janeiro, RJCEP 22290-240

Para consultas sobre licença relacionadas a informações de DBCS (Conjunto deCaracteres de Byte Duplo), entre em contato com o Departamento de PropriedadeIntelectual da IBM em seu país ou envie consultas, por escrito, para:

Licenciamento de Propriedade IntelectualLei de Propriedade Legal e IntelectualIBM World Trade Asia Corporation Licensing19-21, Nihonbashi-Hakozakicho, Chuo-kuTokyo 103-8510, Japan

O parágrafo a seguir não se aplica a nenhum país em que tais disposições nãoestejam de acordo com a legislação local: > A INTERNATIONAL BUSINESSMACHINES CORPORATION FORNECE ESTA PUBLICAÇÃO “NO ESTADO EMQUE SE ENCONTRA”, SEM GARANTIA DE NENHUM TIPO, SEJA EXPRESSAOU IMPLÍCITA, INCLUINDO, MAS A ELAS NÃO SE LIMITANDO, ASGARANTIAS IMPLÍCITAS DE NÃO INFRAÇÃO, COMERCIALIZAÇÃO OUADEQUAÇÃO A UM DETERMINADO PROPÓSITO. Alguns países não permitema renúncia de responsabilidade de garantias expressas ou implícitas em certastransações; portanto, essa disposição pode não se aplicar ao Cliente.

© Copyright IBM Corp. 2005, 2014 145

Page 154: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Essas informações podem conter imprecisões técnicas ou erros tipográficos. Sãofeitas mudanças periódicas nas informações aqui contidas; tais mudanças serãoincorporadas em futuras edições desta publicação. A IBM pode, a qualquermomento, aperfeiçoar e/ou alterar os produtos e/ou programas descritos nestapublicação, sem aviso prévio.

Referências nestas informações a Web sites não IBM são fornecidas apenas porconveniência e não representam de forma alguma um endosso a esses Web sites.Os materiais contidos nesses Web sites não fazem parte dos materiais desteproduto IBM e o uso desses Web sites é de inteira responsabilidade do Cliente.

A IBM pode usar ou distribuir as informações fornecidas da forma que julgarapropriada sem incorrer em qualquer obrigação para com o Cliente.

Licenciados deste programa que desejam obter informações sobre este assunto compropósito de permitir: (i) a troca de informações entre programas criadosindependentemente e outros programas (incluindo este) e (ii) o uso mútuo dasinformações trocadas, devem entrar em contato com:

Gerência de Relações Comerciais e Industriais da IBM BrasilAv. Pasteur, 138-146BotafogoRio de Janeiro, RJCEP 22290-240

Tais informações podem estar disponíveis, sujeitas a termos e condiçõesapropriadas, incluindo em alguns casos o pagamento de uma taxa.

O programa licenciado descrito nesta publicação e todo o material licenciadodisponível são fornecidos pela IBM sob os termos do IBM Customer Agreement,do Contrato Internacional de Licença do Programa IBM ou de qualquer outrocontrato equivalente.

Todos os dados de desempenho aqui contidos foram determinados em umambiente controlado. Portanto, os resultados obtidos em outros ambientesoperacionais podem variar significativamente. Algumas medidas podem ter sidotomadas em sistemas em nível de desenvolvimento e não há garantia de que estasmedidas serão iguais em sistemas geralmente disponíveis. Além disso, algumasmedidas podem ter sido estimadas por extrapolação. Os resultados reais podemvariar. Os usuários deste documento devem verificar os dados aplicáveis para seuambiente específico.

As informações relativas a produtos não IBM foram obtidas junto aos fornecedoresdos respectivos produtos, de seus anúncios publicados ou de outras origensdisponíveis publicamente. A IBM não testou estes produtos e não pode confirmar aprecisão de seu desempenho, compatibilidade nem qualquer outra reivindicaçãorelacionada a produtos não IBM. Dúvidas sobre os recursos de produtos não IBMdevem ser encaminhadas diretamente a seus fornecedores.

Todas as declarações relacionadas aos objetivos e intenções futuras da IBM estãosujeitas a mudanças ou retirada sem aviso prévio e representam apenas metas eobjetivos.

Estas informações contêm exemplos de dados e relatórios usados nas operaçõesdiárias de negócios. Para ilustrá-los da forma mais completa possível, os exemplos

146 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 155: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

podem incluir nomes de indivíduos, empresas, marcas e produtos. Todos estesnomes são fictícios e qualquer semelhança com nomes e endereços usados por umaempresa real é mera coincidência.

Se estas informações estiverem sendo visualizadas em formato eletrônico, asfotografias e ilustrações coloridas podem não aparecer.

Dependendo das configurações implementadas, essa Oferta de Software pode usarsessão e cookies persistentes que coletam as informações de cada usuário, como:v nomev nome de usuáriov senha

com os propósitos dev gerenciamento de sessãov autenticaçãov usabilidade do usuário aprimoradav configuração de conexão únicav rastreamento de uso ou propósitos funcionais diferentes de gerenciamento de

sessão, autenticação, usabilidade de usuário aprimorada e configuração deconexão única

Esses cookies não podem ser desativados.

Se as configurações implementadas para essa Oferta de Software fornecem a você,como cliente, a capacidade de coletar informações identificáveis pessoalmente deusuários finais por meio de cookies e outras tecnologias, deve-se buscar seupróprio conselho jurídico sobre quaisquer leis aplicáveis a essa coleta de dados,incluindo quaisquer requisitos para aviso e consentimento.

Para obter mais informações sobre o uso de diversas tecnologias, incluindo cookies,para esses propósitos, consulte a Política de Privacidade da IBM emhttp://www.ibm.com/privacy e a Declaração de Privacidade Online da IBM emhttp://www.ibm.com/privacy/details na seção intitulada "Cookies, Web Beacons eOutras Tecnologias" e "Produtos de Software IBM e Declaração de Privacidade deSoftware como Serviço" em http://www.ibm.com/software/info/product-privacy.

Marcas Registradas

IBM, o logotipo IBM e ibm.com são marcas ou marcas registradas da InternationalBusiness Machines Corp., registradas em várias jurisdições em todo o mundo.Outros nomes de produtos e serviços podem ser marcas registradas da IBM ou deoutras empresas. Uma lista atual das marcas registradas da IBM está disponível naWeb em “ Copyright and trademark information ” no www.ibm.com/legal/copytrade.shtml.

Os termos a seguir são marcas ou marcas registradas de outras empresas:v Microsoft, Windows, Windows NT e o logotipo Windows são marcas registradas

da Microsoft Corporation nos Estados Unidos, e/ou em outros países.v Linux é uma marca registrada de Linus Torvalds nos Estados Unidos e/ou em

outros países.v UNIX é marca registrada do The Open Group nos Estados Unidos e/ou em

outros países.

Avisos 147

Page 156: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

v Java e todas as marcas registradas Java são logos e marcas registradas oucomerciais da Oracle e/ou suas afiliadas.

148 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 157: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

Índice Remissivo

Caracteres Especiais.ppr 15

Aabordagem de migração 56acesso drill-through 23administração 31aliases

nome do servidor do Series 7 65alocação de memória

fugas no serviço de migração do IBM Cognos Series 7 118ambiente distribuído do Series 7

erro de migração quando os serviços PPES sãointerrompidos 122

aplicativosmigração 55

arquivos .bmp 16arquivos .gif 16arquivos .jpg 16arquivos .png 16arquivos .wmf 16Assistente de migração do IBM Cognos 66

NewsBoxes Pessoais são ocultas na visualização emárvore 120

auditoria do banco de dados 85criando o banco de dados 98executando o utilitário PPESAuditFileProcessor 99sequência de conexão 98

auditoria do banco de dados do PowerPlay 85

Bbanco de dados do Content Manager

não é possível migrar devido a conflito de nomes 143bancos de dados

tabelas para mensagens de log 88

CCAF 131caracteres japoneses 135

mapeamento para Unicode 138caracteres shift-JIS

solução de problemas 139caracteres Shift-JIS 135

mapeamento para Unicode 138classificação

não migrada para o Analysis Studio quando aplicada aoeixo com o subconjunto customizado e uma ou maiscategorias 123

códigos do idiomaresolvendo problemas ao migrar 117

conexão únicarequisitos ao migrar do Upfront 119

configuraçãoníveis de criação de log 85

configuraçõescubo 36

configurações (continuação)drill through 36relatório 36

configurações avançadasPowerPlay 33, 34

configurações avançadas do PowerPlay 33, 34conteúdo

o que será migrado 58criação de log

auditoria do banco de dados 85csv

delimitador 128cubos

configurações 36cubos,

Veja PowerCubes

Ddefinições de configuração avançada

RSVP.RENDER.VALIDATEURL 131drill through

configurações 36configurações avançadas 33propriedades podem precisar de mudança após a

migração 118drill through,

Veja acesso drill-throughDrill through.

exemplo de pacotes OLAP para relacionais 27

Eerros no mapeamento de cubo 115

Ffalha ao carregar o arquivo csx

solução de problemas 122formato do relatório

arquivos .ppr 15formatos de exportação

Microsoft Excel 2007 2

Ggeração de arquivos PDF leves

configuração 124não migrada 125

grupos de servidores 31

IIBM Cognos

executando tarefas usando URLs 129iniciando componentes usando URLs 132

IBM Cognos Administration 31IBM Cognos Application Firewall 131IBM Cognos Business Insight 2

© Copyright IBM Corp. 2005, 2014 149

Page 158: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

IBM Cognos Connectionmigrando conteúdo de 58pasta vazia chamada cubos criada após a migração 121

inicialização do IBM Cognos PowerPlay usando umaURL 132

iníciocomponentes do IBM Cognos usando URLs 132

instalações distribuídasconsiderações de administração 31

Internet Explorererro no cálculo do PowerPlay Studio 127

introdução vii

Llista de verificação para migração 62logs

migração 113tabelas de banco de dados para mensagens 88

Mmapeamento

Shift-JIS em Unicode 135marcadores

migração 74URL incorreta em marcadores migrados 124

mensagem de erroRSV-VAL-0003 123

Microsoft Excel 2007formato de exportação 2

migração 55apóstrofo no nome da pasta não migrado 121arquivos de log 113classificações não migradas para o Analysis Studio quando

aplicada ao eixo com o subconjunto customizado e umaou mais categorias 123

conteúdo 58cubos 58erro ao migrar conteúdo do Upfront de um ambiente

distribuído do Series 7 122erro S7S ao migrar uma NewsBox 119informações de contato do Upfront não migradas 121lista de verificação 62marcadores 74migrando cubos com caracteres não ASCII no AIX 142não é possível conectar ao servidor Upfront durante a

migração 119não é possível executar o relatório com uma única medida

no Report Studio 123não é possível migrar relatórios no UNIX quando os nomes

de caminhos contiverem determinados caractereseuropeus 122

o nome da pasta não está no idioma correto 117pasta vazia chamada cubos criada 121pastas na NewsBox pessoal do Upfront não migradas 124PowerCubes 56problemas ao migrar relatórios com nomes longos 120propriedades de drill through podem precisar de mudança

após a migração 118relatórios 58relatórios locais 72usando o IBM Cognos Migration Assistant 66visualizações customizadas migradas uma segunda vez

aparecem como links quebrados 122

modificaçãodelimitador para arquivos csv 128

Mozilla Firefoxerro no cálculo do PowerPlay Studio 127

NNewsBoxes

erro S7S ao migrar 119oculto na visualização em árvore do IBM Cognos

Migration Assistant 120níveis de criação de log

configuração 85, 114nomes dos servidores do Series 7

definindo aliases 65

Ooffline

acesso a dados 15origens de dados

suportado 14

Ppacotes 56PowerCube da amostra

configurando 81PowerCubes

configurando a amostra do PowerPlay 81migração 56

PowerPlay Clientabrindo relatórios remotos 15

PowerPlay Connect 15PowerPlay Enterprise Server

migrando conteúdo de 61requisitos de segurança ao migrar conteúdo do

Upfront 119

Rrelatórios

configurações 36Drill through. 23

relatórios de amostraMargem de Lucro e Receita por País ou Região 27Receita Total por País ou Região 27

Relatórios do PowerPlayobjetos não suportados 61

relatórios locaismigração 72

relatórios remotosabrindo no PowerPlay Client 15

RSVP.RENDER.VALIDATEURL 131

Ssegurança

requisitos para migrar conteúdo do Upfront 119sequência de conexões para banco de dados de auditoria 98serviço de migração do IBM Cognos Series 7

fugas de memória potenciais 118serviço de migração do Series 7

erro ao iniciar 122

150 IBM Cognos PowerPlay Versão 10.2.2: Guia de Migração e Administração

Page 159: IBM Cognos PowerPlay Versão 10.2public.dhe.ibm.com/software/data/cognos/... · reais é mera coincidência. Outros arquivos de amostras podem conter dados ficcionais gerados manualmente

solução de problemasapóstrofo no nome da pasta não migrado 121caracteres japoneses 135configuração de geração de arquivos PDF leves não

migrada 125erro ao iniciar o serviço de migração do Series 7 122erro ao migrar conteúdo do Upfront de um ambiente

distribuído do Series 7 122erros no mapeamento de cubo 115informações de contato do Upfront não migradas 121migrando cubos com caracteres não ASCIII no AIX 142migrando relatórios com nomes longos 120não é possível migrar, pois existe um objeto de relatório do

CM com o mesmo nome 143não é possível migrar porque o código do idioma não está

configurado ou mapeado no IBM CognosConfiguration 117

não é possível migrar relatórios no UNIX quando os nomesde caminhos contiverem determinados caractereseuropeus 122

o nome da pasta de migração não está no idiomacorreto 117

pasta vazia chamada cubos criada após a migração 121problemas ao migrar caracteres Shift-JIS 139saída em PDF de relatório migrado não é exibida

corretamente 124URL incorreta em marcadores migrados 124visualizações customizadas migradas uma segunda vez

aparecem como links quebrados 122suportado

origens de dados 14

Ttabelas

banco de dados para mensagens de log 88tarefa de migração

erros no mapeamento de cubo 115permitindo que usuários 32

tarefasexecutando no IBM Cognos usando URLs 129

tipos de gráficossuportado 16

trabalho offline 15

UUnicode

mapeamento para Shift-JIS 138Upfront

erro S7S ao migrar uma NewsBox 119informações de contato não migradas 121migrando conteúdo de 59não é possível conectar ao servidor durante a

migração 119não será possível migrar conteúdo se o PowerPlay

Enterprise Server não estiver protegido 119pastas na NewsBox pessoal não migradas 124

URLsiniciando componentes do IBM Cognos 132iniciando o IBM Cognos PowerPlay 132práticas recomendadas 129

URLSacessando serviços usando 129executando tarefas no IBM Cognos 129url_xml 129

usuáriospermitindo executar uma tarefa de migração 32

utilitário PPESAuditFileProcessor 99

Vvalidação

URL 131validação de URLs 131visualizações customizadas

aparecem como links quebrados quando migrados umasegunda vez 122

Índice Remissivo 151