Guia do autor do relatóriopublic.dhe.ibm.com/software/data/cognos/...Nota Antes de usar estas informações e o produto suportado por elas, leia as informações em “Avisos” na

IBM OpenPages with WatsonVersão 8.1.0

Guia do autor do relatório

IBM

Nota

Antes de usar estas informações e o produto suportado por elas, leia as informações em “Avisos” napágina 243.

iv IBM OpenPages with Watson Versão 8.1.0 : Guia do autor do relatório

Informações sobre o produto

Este documento se aplica ao IBM OpenPages com o Watson versão 8.1.0 e também pode se aplicar àsliberações subsequentes.

Licensed Materials - Property of IBM Corporation.© Copyright IBM Corporation, 2003, 2019.

Direitos Restritos para Usuários do Governo dos Estados Unidos – Uso, duplicação ou divulgação restritospelo documento GSA ADP Schedule Contract com a IBM Corporation

vi IBM OpenPages with Watson Versão 8.1.0 : Guia do autor do relatório

Índice

Nota..................................................................................................................... iii

Apresentação..................................................................................................... xiiiÍcones da estrutura de relatório............................................................................................................... xivIBM Cognos Analytics V11.1 e informações de suporte.......................................................................... xiv

Capítulo 1. Modelos de Banco de Dados..................................................................1O Modelo de Dados do Aplicativo................................................................................................................1Design da Tabela de Relatório.....................................................................................................................2

Tabelas de Objetos.................................................................................................................................3Visualizações de Objeto......................................................................................................................... 4Tabelas de Enumeração......................................................................................................................... 4A Tabela de Relacionamento................................................................................................................. 5

Capítulo 2. Modelos de Dados de Estrutura.............................................................7O Modelo de Dados Relacionais.................................................................................................................. 7

Terminologia de Modelagem Relacional................................................................................................7Visualização de Pasta de um Modelo de Dados Relacionais.................................................................8

O Modelo de Dados Dimensionais...............................................................................................................8Terminologia de Modelagem Dimensional............................................................................................ 9Visualização de Pasta de um Modelo de Dados Dimensionais............................................................. 9

Capítulo 3. Modelo de objeto................................................................................ 11Terminologia de Modelo de Objeto........................................................................................................... 11Características do Modelo de Objeto........................................................................................................ 11

Capítulo 4. Estrutura de Relatório........................................................................ 15Modelos de estrutura.................................................................................................................................15Pacotes de estrutura..................................................................................................................................16Espaços de Tabelas................................................................................................................................... 16

O Namespace Padrão...........................................................................................................................17Convenções de nomenclatura para namespaces............................................................................... 17

Incluindo códigos de localidade e definindo um código de localidade de ordem de classificação........18As Pastas de Nível Superior do Modelo Relacional.................................................................................. 18

A Pasta Trilha de Auditoria (Modelo Relacional)................................................................................. 18A Pasta Campos Computados (Modelo Relacional)............................................................................ 20A Pasta Enumerações (Modelo Relacional).........................................................................................21A Pasta Objetos GRC (Modelo Relacional).......................................................................................... 23A Pasta Objetos GRC Independentes (Modelo Relacional)................................................................ 27A Pasta Diversos (Modelo Relacional)................................................................................................. 28A Pasta Segurança (Modelo Relacional).............................................................................................. 31

As Pastas de Nível Superior do Modelo Dimensional............................................................................... 32A Pasta Objetos GRC (Modelo Dimensional)....................................................................................... 33A Pasta Objetos Independentes GRC (Modelo Dimensional)............................................................. 35A Pasta de Dimensões de Tipo de Objeto (Modelo Dimensional).......................................................36

Capítulo 5. Otimizando o Desempenho................................................................. 37Filtrando entidades de negócios de nível superior...................................................................................37Filtragem em Períodos de Relatório..........................................................................................................37

vii

Ignorando um Índice................................................................................................................................. 37Desempenho da Direção da Consulta....................................................................................................... 38Incluindo Novos Índices............................................................................................................................38A Configuração de Uso de Informações de Parâmetro............................................................................ 38Ligação Raiz de Níveis de Objeto Recursivo..............................................................................................38

Capítulo 6. Report Design Language..................................................................... 41Configurando Seu Código de Idioma no OpenPages with Watson...........................................................41

Suporte para idioma e código do idioma............................................................................................. 41Configurando seu código de idioma no IBM Cognos Analytics................................................................ 42

Capítulo 7. Trabalhando com Dados Relacionais................................................... 43Convenções de sintaxe.............................................................................................................................. 43Trabalhando com Contêineres de Dados..................................................................................................43

Trabalhando com Listas....................................................................................................................... 43Trabalhando com Crosstabs................................................................................................................ 44Trabalhando com Gráficos................................................................................................................... 45

Trabalhando com Campos Enumerados................................................................................................... 46A Estrutura de Pasta de Campos Enumerados....................................................................................46Utilizando Campos Enumerados em um Relatório..............................................................................47

Trabalhando com Campos de Data........................................................................................................... 48Trabalhando com Campos de Moeda........................................................................................................48

Assuntos de Consulta de Moeda do Sistema...................................................................................... 49Estrutura da Pasta de Campos de Moeda............................................................................................49Configurando o uso dos campos de moeda em um relatório............................................................. 50

Incluindo Prompts..................................................................................................................................... 50Criando uma Página de Prompt........................................................................................................... 50Incluir um Prompt de Período de Relatório.........................................................................................51Incluindo um Prompt de Entidade de Negócios..................................................................................52Incluindo um Prompt de Valor Enumerado de Seleção Única............................................................ 53Incluindo um Prompt de Valor Enumerado Multisseleção................................................................. 55Incluindo um Prompt de Data..............................................................................................................56Incluir um Prompt de Intervalo de Data..............................................................................................57Incluindo um Prompt de Opções Estáticas......................................................................................... 57Incluindo um Prompt em Cascata....................................................................................................... 58Incluindo Prompts para Assuntos de Consulta...................................................................................59

Incluindo Campos Rich Text......................................................................................................................59Incluindo Imagens e Ícones......................................................................................................................61Incluindo Cálculos..................................................................................................................................... 62Classificando Dados...................................................................................................................................62

Utilizando Classificando Simples.........................................................................................................62Utilizando Classificação Avançada...................................................................................................... 62Utilizando Classificando Customizada.................................................................................................63Utilizando Classificação Solicitada...................................................................................................... 64

Filtrando Dados..........................................................................................................................................65Utilizando Mapas de Parâmetro para Filtragem..................................................................................65Filtragem no ID de Período de Relatório............................................................................................. 66Filtragem em uma Enumeração...........................................................................................................66

Agrupando Dados...................................................................................................................................... 66Agrupando Dados em um Relatório de Lista....................................................................................... 67Criando um Cabeçalho do Grupo de Lista........................................................................................... 67Configurando a Extensão de Nível para uma Coluna.......................................................................... 68

Agregando Dados.......................................................................................................................................69Utilizando Formatação Condicional...........................................................................................................71

Utilizando Formatação Condicional para Entradas de Indentação.................................................... 72Destacando Dados Condicionalmente.................................................................................................73

Cores do gráfico de barras.........................................................................................................................74

viii

Exibir Variação de Cor da Barra com Valores Exibidos Automaticamente......................................... 75Exibindo Consistência de Cor da Barra com Modificação de Relatório para Novos Valores............. 76Editando as Cores da Barra..................................................................................................................78

Criando Junções........................................................................................................................................ 78Criando Junções Diretas...................................................................................................................... 78Criando Junções Indiretas................................................................................................................... 80

Criando Relatórios de Drill Through.......................................................................................................... 81Criando o Relatório-Pai........................................................................................................................ 81Incluindo um Relatório Drill Through no Pai....................................................................................... 82

Incluindo Links CrossTrack....................................................................................................................... 83Incluindo links CrossTrack nos relatórios independente e pai...........................................................83Incluindo links CrossTrack em relatórios drill through.......................................................................86

Criando um Relatório Detalhado Mestre...................................................................................................87Criando relacionamentos entre Listas Principais e Integradas.......................................................... 88Formatando Listas Integradas.............................................................................................................89

Incluindo Minigráficos............................................................................................................................... 89

Capítulo 8. Trabalhando com Dados Dimensionais................................................ 93Incluindo Prompts..................................................................................................................................... 93

Incluindo um Prompt Dimensional de Entidade de Negócios de Nível Único....................................93Incluindo um Prompt de Entidade de Negócios de Caminho Completo............................................ 94Configurando um Valor Padrão............................................................................................................ 95Incluindo um valor Todos.................................................................................................................... 96Incluindo um Prompt de Árvore...........................................................................................................97Filtragem no ID de Período de Relatório............................................................................................. 98

Trabalhando com Contêineres de Dados..................................................................................................99Trabalhando com Listas.....................................................................................................................100Trabalhando com Crosstabs.............................................................................................................. 100Trabalhando com Gráficos.................................................................................................................103

Filtrando Dados....................................................................................................................................... 106Utilizando a Dimensão SOXBusEntity_GPC.......................................................................................107Criando um filtro de contexto............................................................................................................ 107

Criando Drill Throughs.............................................................................................................................108Criando um Drill Through Dimensional para Dimensional................................................................108Incluindo um Drill Through Dimensional para Relacional................................................................ 109

Criando Junções para Objetos Secundários........................................................................................... 110Mudando os títulos de nível Todos......................................................................................................... 112

Configurando o texto Todos em um relatório................................................................................... 112Configurando o valor global Todos....................................................................................................114

Utilizando Rótulos de Dados................................................................................................................... 114

Capítulo 9. Trabalhando com Entidades de Negócios.......................................... 115O Assunto de Consulta SOXBUSENTITY_GPC........................................................................................115A Hierarquia de Entidade Definida pelo Usuário.................................................................................... 115Objetos do Componente GPC..................................................................................................................116A Dimensão de Tipo de Objeto GPC........................................................................................................ 116O Modelo de Dados GPC..........................................................................................................................116Filtrando Entidades de Negócios Relacionais.........................................................................................117

Filtrando Utilizando o Caminho Completo........................................................................................ 117Filtrando Profundidade da Hierarquia............................................................................................... 119Filtrando Utilizando Prompts em Cascata.........................................................................................119Referência Rápida para Exibição e Filtragem de Dados................................................................... 122

Filtrando Entidades de Negócios Dimensionais..................................................................................... 123Campos de Contexto de Entidade Dimensional................................................................................124O Modelo Dimensional de Entidade de Negócios............................................................................. 125Prompts Dimensionais....................................................................................................................... 126Usando entidades de negócios para drill down e drill-up................................................................ 126

ix

Capítulo 10. Trabalhando com Objetos Compartilhados...................................... 129Agregando Dados para Objetos Compartilhados................................................................................... 129Criando um Relatório de Agregação Para Objetos Compartilhados...................................................... 130Contando Objetos Compartilhados em Relatórios de Gráfico............................................................... 133Listagem de Objetos Compartilhados em Relatórios de Lista............................................................... 134

Capítulo 11. Trabalhando com Objetos Recursivos..............................................135

Capítulo 12. Internacionalização e localização................................................... 137Tradução de Dados..................................................................................................................................137

Dados Estáticos..................................................................................................................................137Dados de aplicativo............................................................................................................................ 140

Utilizando Mapas de Parâmetro com Filtros de Sequência Enumerada Traduzida...............................147

Capítulo 13. Utilizando Funções de Banco de Dados Predefinidas........................149Transmitindo Parâmetros........................................................................................................................149Determinando um ID de Tipo de Objeto................................................................................................. 149

Utilizando SQL para Obter IDs de Objeto.......................................................................................... 149Utilizando um Relatório para Obter IDs de Objeto........................................................................... 150

Determinando Nomes da Tabela de Banco de Dados............................................................................151Obtendo uma lista de nomes de tabela RT....................................................................................... 152

Determinando Nomes da Coluna da Tabela de Banco de Dados...........................................................152Utilizando Funções Gerais.......................................................................................................................152

Converter Enumerações Multivalor em Nomes................................................................................ 153Converter Enumerações de Valor Único em Nomes......................................................................... 155Contando o Número de Ocorrências de Texto.................................................................................. 156Determinando um Relacionamento de Estrutura Entre Objetos......................................................156Determinando um Relacionamento de Pai Principal Entre Objetos.................................................158Determinando um Relacionamento entre Objetos........................................................................... 160Formatando o Valor de Moeda...........................................................................................................161Obtendo um Nome de Exibição do Agente pelo ID...........................................................................162Obtendo um Nome de Exibição do Agente pelo ID do Agente......................................................... 164Obtendo um Nome de Exibição do Agente pelo ID de Logon...........................................................165Obtendo Texto de Chave Externa...................................................................................................... 167Obtendo os Atributos de um Objeto Pai Principal.............................................................................168Obtendo os Atributos Diretos de um Objeto de Pai Principal...........................................................172Obtendo a Taxa de Câmbio................................................................................................................174Obtendo IDs de Recurso de Caminho de Árvore...............................................................................175Acumulando Enumerações com Diversos Valores em uma Lista.....................................................175

Utilizando Funções Dependentes de Horário......................................................................................... 177Obtendo o Valor do Campo Customizado por ID.............................................................................. 177Obtendo o Valor do Campo Customizado por Nome........................................................................ 179Obtendo a Descrição do Campo do Sistema..................................................................................... 181Obtendo o Caminho Completo do Campo do Sistema......................................................................183Obtendo o Nome do Campo do Sistema........................................................................................... 184Obtendo o ID da Pasta Pai do Campo do Sistema............................................................................ 185

Capítulo 14. Formatando Relatórios para Saída.................................................. 187Configurando o Relatório para Saída PDF...............................................................................................187Incluindo Prompts Sequenciais na Saída em PDF..................................................................................187Formatando o Relatório para Saída PDF.................................................................................................188Formatando para Saída do Microsoft Excel............................................................................................ 188Formatando para Saída CSV....................................................................................................................188

Capítulo 15. Criando Relatórios..........................................................................191

x

Manual de Definições de Configuração do IBM Cognos.........................................................................191Configurando Relatórios..........................................................................................................................191SQL de Relatório Subjacente...................................................................................................................193Utilizando um Modelo de Relatório.........................................................................................................193Organização do Assunto de Consulta..................................................................................................... 194Construções de Assunto de Consulta..................................................................................................... 195Formatando Tabelas ou Listas Vazias.....................................................................................................195

Capítulo 16. Campos Calculados........................................................................ 199Criando um Campo Computado.............................................................................................................. 200Fornecendo Campos Obrigatórios.......................................................................................................... 200Criando um Arquivo de Dados.................................................................................................................201Usando Campos Computado em Diversos Namespaces....................................................................... 202

Capítulo 17. Fragmentos de Relatórios............................................................... 203Criando Fragmentos de Relatórios..........................................................................................................203Utilizando CrossTracks em Fragmentos de Relatórios...........................................................................204

Criando um Link para Abertura na Mesma Janela............................................................................ 204Criando um Link para Abertura em uma Nova Janela.......................................................................204

Fornecendo Campos de Configuração.................................................................................................... 205Obtendo o Caminho de Relatório...................................................................................................... 206Obtendo o Nome do Fragmento........................................................................................................ 206Obtendo Prompts de Objeto.............................................................................................................. 206Obtendo Altura e Largura...................................................................................................................207

Usando imagens em Fragmentos de relatórios ..................................................................................... 207

Capítulo 18. Assuntos de Consulta Customizada.................................................209Revisando seu Design de Relatório.........................................................................................................209Criando um Diagrama de Relacionamento de Entidade.........................................................................209Criando uma Instrução SQL.................................................................................................................... 210Incluindo Funções de Banco de Dados...................................................................................................210Substituindo Variáveis............................................................................................................................. 211Testando uma Instrução SQL..................................................................................................................211Criando o Relatório.................................................................................................................................. 211Incluindo um Objeto SQL........................................................................................................................ 212Incluindo SQL no Objeto SQL.................................................................................................................. 212Colocando Variáveis De Volta na SQL..................................................................................................... 212

Incluindo Prompts..............................................................................................................................212Concluindo Desenvolvimento de Relatório.............................................................................................213Criando uma Entrada no Arquivo CQS.................................................................................................... 213

Incluindo um Assunto de Consulta de Modelos................................................................................214Especificando Relacionamentos........................................................................................................217Criando Cálculos................................................................................................................................ 218Utilizando Mapas de Parâmetro para Criar Expressões no Tempo de Execução.............................219

Gerando novamente a estrutura............................................................................................................. 220Substituindo Referências de Objeto SQL por Referências CQS............................................................. 221

Editando o arquivo de texto de relatório........................................................................................... 221Removendo um objeto SQL............................................................................................................... 221

Apêndice A. Diretrizes de Codificação de SQL..................................................... 223Convenções de nomenclatura.................................................................................................................223Cláusula SELECT...................................................................................................................................... 225Cláusula FROM.........................................................................................................................................226Cláusula WHERE...................................................................................................................................... 226Cláusula ORDER BY................................................................................................................................. 227

Apêndice B. Definições de Namespace............................................................... 229

xi

AUD1........................................................................................................................................................ 230AUD2........................................................................................................................................................ 231DEFAULT.................................................................................................................................................. 232ITG1......................................................................................................................................................... 232ITG2......................................................................................................................................................... 233MAND1..................................................................................................................................................... 234MAND2..................................................................................................................................................... 235ORM1....................................................................................................................................................... 236ORM2....................................................................................................................................................... 236ORM3....................................................................................................................................................... 237POL1.........................................................................................................................................................237RA1...........................................................................................................................................................237RA2...........................................................................................................................................................238REGAPP1..................................................................................................................................................239

Apêndice C. Limitações e Soluções Alternativas................................................. 241Limitação de Comprimento de Equação................................................................................................. 241Problemas de Exibição de Localização................................................................................................... 241Erro ao agrupar campos de sequência grandes..................................................................................... 241RQP-DEF-0162 Erro de cardinalidade ilegal ao executar um relatório................................................. 242

Avisos............................................................................................................... 243

Índice Remissivo............................................................................................... 247

xii

Apresentação

É possível usar o IBM® OpenPages with Watson para desenvolver relatórios.

O CommandCenter deve ser instalado e configurado com o OpenPages with Watson.

Público

O Guia do autor do relatório do IBM OpenPages with Watson é destinado a autores de relatório quedesejam usar ferramentas de relatório no OpenPages with Watson para desenvolver relatórios. Elesrequerem conhecimento do IBM Cognos Analytics. Eles devem participar do treinamento do autor dorelatório do IBM OpenPages e devem ter experiência com o uso do IBM Cognos Analytics - Reporting.

Escopo

O Guia do autor do relatório do IBM OpenPages with Watson não se destina a ser uma substituição dadocumentação do IBM Cognos Analytics, mas um suplemento específico para sua implementação noOpenPages with Watson.

Leia as informações importantes a seguir sobre a documentação do IBM OpenPages with Watson

A IBM mantém um conjunto de documentações que atende às implementações do IBM OpenPages withWatson no local e na nuvem. A documentação do IBM OpenPages with Watson descreve alguns recursose funções que podem não estar disponíveis na nuvem. Por exemplo, IBM OpenPages with Watson onCloud não inclui integração com o IBM Business Process Manager e certas funções administrativas.

Se você tiver qualquer pergunta sobre a funcionalidade disponível na versão do produto que está sendousada, entre em contato com o suporte do IBM OpenPages por meio da Comunidade de suporte IBM.

Localização de informaçõesPara localizar a documentação do produto na web, incluindo toda a documentação traduzida, acesse oIBM Knowledge Center (http://www.ibm.com/support/knowledgecenter).

Recursos de acessibilidade

Os recursos de acessibilidade ajudam usuários com alguma deficiência, como mobilidade reduzida ouvisão limitada, a utilizar produtos de tecnologia da informações. A documentação do OpenPages withWatson tem recursos de acessibilidade. Documentos PDF são complementares e, dessa forma, nãoincluem recursos de acessibilidade.

Declarações prospectivas

Esta documentação descreve a funcionalidade atual do produto. Referências a itens que não estãodisponíveis atualmente podem estar incluídas. Nenhuma implicação sobre qualquer disponibilidadefutura deve ser inferida. Tais referências não representam um compromisso, uma promessa ou umaobrigação legal de entrega de qualquer material, código ou funcionalidade. O desenvolvimento, aliberação e a sincronização de recursos ou funcionalidade ficam ao arbítrio exclusivo da IBM.

Informações sobre ferramenta de banco de dados

O OpenPages with Watson suporta o banco de dados IBM Db2 e o banco de dados Oracle. Utilizequalquer ferramenta SQL para consultar esses bancos de dados. Por exemplo, é possível usar oCommand Line Processor Plus (CLPPlus) ou o Optim Development Studio para executar consultas SQL nobanco de dados IBM Db2.

https://www.ibm.com/mysupport

http://www.ibm.com/support/knowledgecenter

Ícones da estrutura de relatórioNo IBM OpenPages with Watson, os ícones de estrutura de relatório fornecem uma estrutura dereferência na interface com o usuário.

A tabela a seguir lista os ícones que são utilizados no modelo de estrutura de relatório.

Tabela 1. Ícones da estrutura de relatório

Convenções Definição

Representa um namespace raiz ou qualquer outro namespace em um projeto.

Representa um assunto de consulta.

Representa um item de consulta ou um atributo em um modelo dimensional.

Representa uma dimensão

Representa uma hierarquia.

Representa um nível em uma hierarquia.

Representa uma medida.

Representa uma pasta.

Representa um cálculo.

Representa um filtro.

IBM Cognos Analytics V11.1 e informações de suporteO IBM Cognos Analytics integra relatório, modelagem, análise, painéis, histórias e gerenciamento deeventos para que você possa entender os dados de sua organização e tomar decisões efetivas denegócios.

É possível acessar o IBM Cognos Analytics por meio de Relatório > Cognos Analytics em OpenPages. OIBM Cognos Analytics é o ponto de início para executar relatórios, procurar conteúdo, visualizar as listasMeu conteúdo, Conteúdo da equipe e Recente, abrir painéis, abrir histórias e outros itens, fazer uploadde arquivos, configurar suas preferências e a página inicial.

Dependendo do trabalho que fizer, você usará diferentes áreas da interface do Cognos. Autores edesenvolvedores de relatório profissional, por exemplo, usam o IBM Cognos Analytics - Reporting paracriar e editar uma ampla variedade de relatórios sofisticados e gerenciados. Eles também podem criarpainéis e histórias para visualizar, monitorar e comunicar insights e análise de dados. Os administradorespodem, por exemplo, acessar o Console de administração para gerenciar usuários, monitorar o sistema econfigurar origens de dados. Dependendo de seu sistema, também será possível ter acesso aosaplicativos complementares do IBM Cognos Analytics.

Para obter mais informações sobre o IBM Cognos Analytics, veja a documentação do produto no IBMKnowledge Center (http://www.ibm.com/support/knowledgecenter/SSEP7J/welcome).

xiv IBM OpenPages with Watson Versão 8.1.0 : Guia do autor do relatório

http://www.ibm.com/support/knowledgecenter/SSEP7J/welcome

http://www.ibm.com/support/knowledgecenter/SSEP7J/welcome

Capítulo 1. Modelos de Banco de DadosOs tópicos do modelo de banco de dados concedem ao autor do relatório as informações de plano defundo que são necessárias para entender o processo de criação de relatórios usando o IBM CognosAnalytics - Reporting. Isso inclui informações sobre a estrutura do modelo de dados de aplicativos dosoftware IBM OpenPages with Watson e as tabelas de banco de dados de relatório correspondentes.

O Modelo de Dados do AplicativoO modelo de dados do aplicativo do IBM OpenPages with Watson é projetado utilizando técnicasorientadas a objetos para propósitos de manutenção, custo e extensibilidade.

O modelo de objeto OpenPages with Watson é altamente configurável porque consiste em tipos deobjeto, propriedades desses objetos e os relacionamentos permitidos entre esses tipos de objetos.

O núcleo do design do banco de dados consiste nas seguintes tabelas:RESOURCE

Contém uma instância de cada objeto criado no sistema.RESRELATIONSHIPS

Contém todos os relacionamentos entre objetos no sistema.ASSETTYPES

Contém definições do tipo de conteúdo permitido (tipos de objeto) no sistema.ASSETTYPESBUNDLEDEFS

Contém os relacionamentos entre Tipos de ativos e BundleDefs.BUNDLEDEFS

Contém grupos de campos anexados a um objeto.PROPERTYDEFS

Contém os campos anexados a uma instância de um objeto.PROPERTYVALS

Contém os valores de campo anexados a uma instância de um objeto.

Figura 1. Diagrama ER do Banco de Dados Principal

Com estas tabelas genéricas definidas, qualquer tipo de objeto pode ser criado no banco de dados doOpenPages with Watson. Isso permite que os nossos clientes estendam os objetos do sistema existentesou incluam novos objetos com suas próprias definições.

Há muitas outras tabelas utilizadas no suporte dessas tabelas, mas essas compreendem as tabelasbásicas necessárias para criar objetos no OpenPages with Watson.

As vantagens deste design do banco de dados podem ser vistas em que um pequeno conjunto de classesJava™ pode criar e acessar qualquer objeto no banco de dados. A desvantagem desse design é quenenhuma ferramenta de relatório comercial pode ser usada para gerar relatórios a partir desse designpelas seguintes razões:

• O relacionamento entre a tabela RESOURCE e a tabela RESRELATIONSHIP é recursivo.• Para criar um relatório em um objeto, muitas tabelas precisam ser juntadas. Eventualmente, isso

excede os limites de uma ferramenta de relatório.• Para relatar a partir dessas tabelas que frequentemente requerem o conhecimento do designer do

banco de dados sobre como elas foram construídas.

Nota: Não se deve gravar relatórios no banco de dados principal porque isso afetará o desempenho dosistema.

Design da Tabela de RelatórioPara facilitar o relatório a partir do banco de dados de dados do aplicativo, um conjunto de visualizaçõessecundário é criado, combinando as várias tabelas individuais do design de dados do aplicativo em umformato mais adequado para geração de relatórios.

O Tabela 2 na página 2 lista a convenção de nomenclatura para essas tabelas e visualizações.

Em que <OBJECT_TYPE> é o nome do tipo de objeto e <ENUMERATION> é o nome de um campo desequência enumerada com diversos valores.

Tabela 2. Convenção de Nomenclatura de Tabela de Relatório

Convenção de Nomenclatura Descrição

RV_<OBJECT_TYPE>

(RV_ com um único sublinhado)

Uma visualização de Objeto

Por exemplo, RV_ENTITY

RT_<OBJECT_TYPE>_<ENUMERATION>

(RT_ com um sublinhado único)

Uma tabela de enumeração com diversos valores

Por exemplo, RT_RISKASSESSMENT_DOMAIN

RT__<OBJECT_TYPE>_<OBJECT TYPE>

(RT__ com um sublinhado duplo)

Uma tabela de relacionamentos entre 2 tipos de objeto

Por exemplo, RT__ENTITY_PROCESS

Importante:

• O Oracle possui uma limitação de 30 caracteres para um nome de tabela. Alguns nomes de tabela serãotruncados.

• As visualizações RV são diferentes das tabelas RT porque essas visualizações possuem segurança dedados integrada, ao passo que as tabelas RT não têm.

A maioria dos objetos que são definidos no IBM OpenPages with Watson possui uma visualizaçãoRV_<OBJECT_TYPE> e uma tabela RT_<OBJECT_TYPE> no banco de dados. No entanto, as tabelas dejunção não possuem visualizações porque elas não precisam de segurança. Ao utilizar a SQL direta, épreferível utilizar as visualizações RV devido ao código de segurança de dados já presente.

As tabelas de relacionamento representam os relacionamentos pai-filho que são definidos durante ainstalação do seu sistema.

2 IBM OpenPages with Watson Versão 8.1.0 : Guia do autor do relatório

As tabelas de enumeração armazenam o relacionamento dos objetos com as sequências enumeradas noformato relacional adequado.

Estas tabelas são geradas automaticamente com base nas configurações no menu Administração noOpenPages with Watson. Mais informações sobre este tópico podem ser localizadas no Guia doadministrador do IBM OpenPages with Watson.

Tabelas de ObjetosAs tabelas de objetos podem incluir muitos campos do sistema.

Este tópico lista todos os campos do sistema que serão incluídos em todas as tabelas de objetos. Todosos outros campos são específicos do cliente e correspondem à configuração particular de seu sistema enão são mostrados aqui.

Tabela 3. Campos do Sistema de Tabela do Objeto

Nome da Coluna Descrição Tipo Nativo

CHECKED_IN_BY ID do usuário que fez a últimamodificação neste objeto.

NÚMERO

CREATION_DATE Data de criação do objeto. DATA

CREATOR ID do criador do objeto. NÚMERO

DESCRIPTION Descrição do objeto. VARCHAR2(2048)

DETAIL_PAGE_URL A URL da página do sistema paraeste objeto.

VARCHAR2(2083)

FULL_PATH O caminho completo do objeto. VARCHAR2(1024)

IS_LOCKED Status do bloqueio do objeto. Y ouN.

NÚMERO

LATEST_VERSION Versão do objeto mais recente. NÚMERO

MAJOR_NUMBER Número da versão principal. NÚMERO

MINOR_NUMBER Número da versão secundária. NÚMERO

MODIFICATION_DATE Data da última modificação doobjeto.

DATA

NAME00 Nome do objeto. VARCHAR2(256)

PARENT_FOLDER Pasta pai do objeto. ID do recurso. NÚMERO

REPORTING_PERIOD_ID O ID do rótulo de período derelatório especificado pelo usuário.

NÚMERO

RESOURCE_ID ID do recurso exclusivo do objeto. NÚMERO

VERSION_COMMENTS Comentários da versão. VARCHAR2(2048)

Tabela 4 na página 3 lista os índices que estão localizados em todas as tabelas de objetos:

Tabela 4. Índices de Tabela do Objeto

Índice Nomes da Coluna

1 PARENT_FOLDER, REPORTING_PERIOD_ID

2 FULL_PATH, REPORTING_PERIOD_ID

Capítulo 1. Modelos de Banco de Dados 3

Tabela 4. Índices de Tabela do Objeto (continuação)


N Campos de <ENUMERATION> (um índice para cada campo)

N Campos de Moeda (um índice para a moeda base e um índice para moeda local)

Sistema ENTITY_ID, REPORTING_PERIOD_ID

Visualizações de ObjetoHá uma visualização correspondente para cada objeto definido no sistema. O que difere as visualizaçõesdas tabelas de objetos é o fato de elas possuírem a segurança de dados integrada em sua definição.

A Tabela 5 na página 4 lista os campos adicionais incluídos com cada visualização:

Tabela 5. Campos Adicionais Incluídas com a Visualização


OP_OBJECT_TYPE_ID O tipo de objeto na visualização. NÚMERO

OP_RECURSIVE_NATIVE_LEVEL Em um objeto hierárquico, o nível dahierarquia.

NÚMERO

OP_FLAG_READ_ACCESS Uma sinalização Y ou N que indica se ousuário tem o privilégio para visualizar osdados.

VARCHAR2(4)

Tabelas de EnumeraçãoEsta classe de tabela contém listas de variáveis enumeradas que se aplicam a um tipo de objetoespecífico no qual valores enumerados multisseleção são armazenados como registros separados.

Todas as tabelas de enumeração contêm os mesmos campos, listados em Tabela 6 na página 4.

Tabela 6. Campos de Tabela Enumerados

Nome da Coluna Descrição TipoNativo

<PARENT>_ID O ID exclusivo do objeto pai. NÚMERO

REPORTING_PERIOD_ID O ID do rótulo de período derelatório especificado pelousuário.

NÚMERO

<ENUMERATION> O ID da sequênciaenumerada.

NÚMERO

Tabela 7 na página 4 lista os índices que são localizados em todas as tabelas de enumeração:

Tabela 7. Índices da Tabela de Ennumeração


1 RESOURCE_ID, REPORTING_PERIOD_ID

2 <ENUMERATION>

Sistema RESOURCE_ID, REPORTING_PERIOD_ID, <ENUMERATION>


A Tabela de RelacionamentoAs tabelas de relacionamento representam os relacionamentos de muitos para muitos entre objetos doIBM OpenPages with Watson.

Todas as tabelas de relacionamento consistem nos mesmos campos, listados em Tabela 8 na página5.

Tabela 8. Campos de Tabela de Relacionamento


PARENT_ID O ID exclusivo do objeto pai. NÚMERO

REPORTING_PERIOD_ID O ID do rótulo de período de relatório especificadopelo usuário.

NÚMERO

CHILD_ID O ID exclusivo do objeto-filho. NÚMERO

HIER_INSTANCE_ID Esse valor é sempre configurado como 1. NÚMERO

IS_PRIMARY Indica se o objeto pai é o pai principal do objeto-filho. Os valores são Y ou N.

VARCHAR2(1)

DISTANCE A distância entre os objetos pai e filho. Se adistância entre os objetos pai e filho for 1, osobjetos estão vinculados diretamente.

NÚMERO

Tabela 9 na página 5 lista os índices que são localizados em todas as tabelas de relacionamento:

Tabela 9. Índices de Tabela de Relacionamento


1 PARENT_ID, REPORTING_PERIOD_ID

2 CHILD_ID, REPORTING_PERIOD_ID

Sistema PARENT_ID, CHILD_ID, REPORTING_PERIOD_ID, HIER_INSTANCE_ID

Capítulo 1. Modelos de Banco de Dados 5


Capítulo 2. Modelos de Dados de EstruturaO modelo de dados de estrutura possui duas ramificações: um namespace relacional e um namespacedimensional.

O namespace dimensional foi introduzido especificamente para fornecer aos usuários do IBM OpenPageswith Watson acesso ao IBM Cognos Analysis Studio e aos recursos OLAP que estão disponíveis.

O Modelo de Dados RelacionaisO modelo de dados relacionais que o IBM OpenPages with Watson fornece é projetado para permitir queo usuário relate sobre objetos com base em seus relacionamentos definidos no sistema.

Os dados são armazenados em um conjunto normalizado de tabelas que fornece armazenamentoeficiente. O objetivo é evitar redundância de dados e fornecer um alto nível de desempenho. Aorganização deste tipo de dados normalmente possui um analista de negócios ou um modelador dedados qualificado para entendê-lo e não deve ser visto por um usuário final.

Este tipo de modelo é geralmente utilizado em relatórios lista em que dados combinados (numéricos,data, sequência) são necessários para transmitir informações aos usuários. Agregação pode serexecutada neste tipo de relatório, mas não é um elemento chave do relatório.

A lista a seguir descreve as características principais do modelo de dados relacional:

• Modelado como um diagrama de Relacionamento de Entidade.• Dados altamente normalizados• Geralmente divididos por objetos relacionados a outros objetos.• Todos os atributos de um objeto incluindo textuais, bem como numéricos, pertencem ao objeto.

Figura 2. Diagrama de Relacionamento de Entidade

O diagrama anterior representa o diagrama de relacionamento de entidade típico de quatro dos principaisobjetos no OpenPages with Watson.

Terminologia de Modelagem RelacionalÉ útil conhecer a terminologia de modelagem relacional.

Tabela 10. Terminologia de Modelagem Relacional

Ícone Name Descrição

AssuntodeConsulta

Uma consulta SQL que foi projetada para expor um certo conjunto de dados aousuário para fins de relatório.

Item deConsulta

Um campo do banco de dados.

Visualização de Pasta de um Modelo de Dados RelacionaisUm modelo de dados relacional contém uma estrutura de pasta específica.

O Figura 3 na página 8 mostra o assunto de consulta SOXRisk e alguns de seus itens de consulta.

Figura 3. Visualização da Pasta Relacional

Haverá um assunto de consulta para cada tipo de objeto definido em seu sistema. Cada um dessesobjetos se relacionarão entre si pelas junções externas à esquerda com base nos relacionamentos pai-filho definidos no sistema. Consulte o Guia do administrador do IBM OpenPages with Watson para obtermais informações sobre a configuração do sistema.

O Modelo de Dados DimensionaisUm modelo de dados dimensionais foi designado para atender às necessidades de usuários finais,fornecendo uma estrutura de dados que é projetada em terminologia de negócios. Os dados sãoagrupados ao redor de fatos, que são campos numéricos que podem ser agregados e analisados edimensões que são filtros de negócios e campos de agrupamento. Esses dados são muito bemadequados para relatórios de crosstab e gráficos.

Este tipo de modelo é frequentemente referido como multidimensional, OLAP ou hipercubos. Asferramentas fornecidas pelo IBM OpenPages with Watson permitem definir os fatos e as dimensõesnecessários para atender às suas necessidades de relatório.

A lista a seguir descreve as características principais do modelo de dados dimensionais:

• Os dados são modelados como dimensões e fatos.• As dimensões podem ser consideradas Filtros ou expressões Group By.• Os fatos são dados numéricos.• Os dados são modelados como um esquema em estrela ou em floco de neve.


Figura 4. Modelo de Dados Dimensionais

A figura anterior detalha uma Dimensão de medida SOXRisk que contém os fatos principais para o objetoRisco. Junto dela estão as Dimensões Regulares de Tipo de Risco, a Data de Modificação, a Categoria deRisco e o Domínio. Neste design, os dados na Dimensão da Medida podem ser filtrados por qualquer umadas dimensões.

Terminologia de Modelagem DimensionalÉ útil conhecer a terminologia de modelagem dimensional.

Tabela 11. Terminologia de Modelagem Dimensional

Ícone Name Descrição

DimensãoRegular

Um agrupamento de dados descritivos sobre um aspecto de uma empresa,como categorias de risco, datas de ocorrência ou domínio. Esses são os valoresde sequência típicos. Todas as dimensões regulares incluirão uma hierarquiacomo parte de sua definição.

Hierarquia Uma série de relacionamentos pai-filho, em que um membro-pai geralmenterepresenta a consolidação dos membros-filhos. As hierarquias podem incluirníveis únicos em que os pais não possuem filhos.

Nível Um membro de uma hierarquia que representa um requisito de negócios para aconsolidação de dados.

Atributo Um item de consulta que é um membro de dados de um nível que pode serincluído em um relatório.

Dimensão daMedida

Uma coleção de medidas.

Medidas Qualquer item de consulta numérico que pode ser submetido a agregação eanálise matemáticas.

Visualização de Pasta de um Modelo de Dados DimensionaisUm modelo de dados dimensionais contém uma estrutura de pasta específica.

Capítulo 2. Modelos de Dados de Estrutura 9

Figura 5. Estrutura do Modelo Dimensional

Ao criar um modelo dimensional, os recursos a seguir agora estão disponíveis para o relatório.

Drill down e upRealizar drill down ou up é uma técnica analítica específica em que o usuário navega entre níveis dedados que vão do mais resumido (up) até o mais detalhado (down).

DistribuiçãoUma rolagem envolve calcular todos os relacionamentos de dados para uma ou mais dimensões.

SetorUma fatia é um subconjunto dos dados correspondentes a um valor único para um ou mais membrosdas dimensões.


Capítulo 3. Modelo de objetoO modelo de objeto referenciado nesse documento é o modelo padrão (pronto para utilização) que éinstalado para todas as soluções em uma primeira instalação.

Somente os objetos no modelo de objeto padrão que são comuns a todas as soluções são incluídos ediscutidos nesse documento para simplicidade.

Importante: Todos os exemplos nesse documento são exibidos no Report Design Language (RDL).

Terminologia de Modelo de ObjetoÉ útil conhecer os termos básicos necessários para entender o modelo de objeto do IBM OpenPages withWatson.

Tabela 12. Terminologia de Modelo de Objeto

Terminal Descrição

Diversos Pais Um objeto-filho que é associado a mais de um pai.

Relacionamento Pai-Filho

Quando um objeto se associa a outro objeto, os dois objetos são consideradosum objeto pai e um objeto-filho. O relacionamento que é formado é umrelacionamento pai-filho.

Associação Principal Um pai pode ter diversos objetos-filhos e todos eles podem ser primários. Umfilho pode ter diversos objetos pai e apenas um deles poderá ser o primário.Associações primárias são utilizadas para determinar o caminho que o sistemadeve seguir ao executar um número de operações que requerem passagem nahierarquia de objeto.

Objeto Primário Um objeto principal do OpenPages with Watson.

RelacionamentoRecursivo

Um relacionamento no qual um objeto-filho é o mesmo tipo de objeto que o pai.

Objeto Secundário Um objeto que pode ser associado a diversos tipos de objetos na lombadacomum.

Características do Modelo de ObjetoO modelo de objeto padrão (pronto para utilização) consiste em determinadas características.

A lista a seguir descreve as principais características de modelos de objetos:

• Os tipos de objeto de entidade de negócio e subprocesso são recursivos.• Os tipos de objeto Problema, Assinatura, Arquivo e Link podem ser associados a qualquer tipo de objeto

primário.• Os tipos de objeto podem conter um tipo de dados de sequência enumerada com valor único ou com

diversos valores.

Nota: Dependendo da sua configuração, o modelo de objeto que você vê pode ser diferente.

A Tabela 13 na página 12 lista os tipos de objetos primários que são compartilhados entre todas assoluções. A lista é seguida por Figura 6 na página 12 mostrando o modelo de objeto e o relacionamentoentre os objetos primários. Todos os objetos possuem um relacionamento pai-filho direto.

Tabela 13. Tipos de Objeto Primário

Tipo de Objeto Rótulo

SOXBusEntity (recursivo) Entidade de Negócios

SOXProcess Processo

SOXSubprocess (recursivo) Subprocesso

SOXRisk Risco

SOXControl Controle

SOXTest ~Refazer\tCtrl+Y

SOXTestResult Resultado do Teste

RiskAssessment Avaliação de Risco

Figura 6. Relacionamentos do Objeto Primário

A Tabela 14 na página 13 lista os tipos de objetos secundários que são compartilhados entre todas assoluções. A lista é seguida por Figura 7 na página 13 mostrando os objetos secundários sem links paraos objetos primários porque as junções são formadas na ferramenta de relatório.


Tabela 14. Tipo de Objeto Secundário

Tipo de Objeto Rótulo

SOXIssue Issue

SOXTask Item de Ação

SOXSignature Assinatura

SOXExternalDocument Efetuar o Link

ProjectActionItem Item de Ação

SOXDocument Arquivo

Etapa Etapa

Figura 7. Objetos Secundários

Este modelo representa o relacionamento básico de objetos dentro do IBM OpenPages with Watson. Paraos relacionamentos exatos para seu próprio sistema, obtenha o diagrama de modelo de objeto que foicriado durante o processo de instalação do sistema ou examine os relacionamentos de objetos no menuAdministrador > Tipos de objeto.

Capítulo 3. Modelo de objeto 13


Capítulo 4. Estrutura de RelatórioA estrutura de relatório consiste em modelos de estrutura do Cognos que são configurados e gerados noOpenPages. Eles suportam os dados relacionais e dimensionais usados para criar relatórios no IBMCognos Analytics.

Ao gerar a estrutura de relatório, pacotes para modelos de estrutura selecionados são publicados noservidor Cognos. Usando os assuntos de consulta e os itens de consulta nesses namespaces, os autoresde relatório podem criar relatórios de dentro do IBM OpenPages with Watson.

Para obter informações sobre como configurar a estrutura de relatório, veja o Guia do administrador doIBM OpenPages with Watson.

Modelos de estruturaModelos de estrutura são baseados no modelo de objeto do OpenPages e definem subconjuntos deobjetos e relacionamentos necessários para seus requisitos de relatório.

Os modelos de estrutura incluem os componentes a seguir:

• Metadados• Rótulos• Fatos e dimensões (apenas modelos padrão)• Assuntos de consulta customizada

A estrutura de relatório contém um modelo de estrutura predefinido chamadoOPENPAGES_FRAMEWORK_V6, que é usado para os relatórios predefinidos que são fornecidos com oOpenPages. Além do modelo de estrutura OPENPAGES_FRAMEWORK_V6, é possível criar seus própriosmodelos de estrutura. A capacidade de usar vários modelos de estrutura permite destinar um modelo deestrutura para soluções, funções de usuário ou perfis do objeto específicos.

Há dois tipos de modelos de estrutura que podem ser criados:

• Padrão• Básico

Ambos os tipos suportam filtragem de perfil e permitem definir o nome do pacote.

Modelos de estrutura padrão

Os modelos de estrutura padrão são destinados a autores de relatórios avançados com conhecimentoextensivo de IBM Cognos Analytics. Use esse tipo de modelo para relatórios que requerem afuncionalidade mais complexa que o Cognos oferece. O modelo de estruturaOPENPAGES_FRAMEWORK_V6 é um modelo padrão.

Os modelos de estrutura padrão têm as características a seguir:

• Suportam fatos e dimensões.• Aninham subnamespaces de relacionamento e dimensionais.• Usam a hierarquia de namespace a seguir:

– [rótulo do pacote] > [namespace] > [namespace]_REL– [rótulo do pacote] > [namespace] > [namespace]_DIM

.• Usam criação de pastas extensiva para assuntos de consulta e itens de dados.• Contêm assuntos de consulta para objetos auxiliares como Enumerações e Relacionamentos.

• Usam representações de campo complexo, por exemplo, moedas têm múltiplos itens de dados paraquantia local e base.

• Representam objetos recursivos como múltiplos assuntos de consulta usando níveis de objetorecursivo.

• Fornecem objetos de conformidade secundários, como Arquivos ou Problemas, como objetosIndependentes. Os relacionamentos com eles devem ser construídos em relatórios.

Modelos de estrutura básica

Os modelos básicos são destinados a usuários finais que não possuem amplo conhecimento do IBMCognos Analytics. Use esse tipo de modelo para relatórios mais simples que você deseja permitir queseus usuários finais criem conforme necessário.

Os modelos de estrutura básica têm as características a seguir:

• Não suportam fatos e dimensões. O subnamespace [namespace]_DIM não foi criado.• Usam a hierarquia de namespace a seguir:

– [rótulo de pacote] > [namespace]

Os assuntos de consulta são criados no namespace raiz. O subnamespace [namespace]_REL não foicriado.

• Não criam assuntos de consultas auxiliares para Enumerações, relacionamentos e assim por diante.• Geram objetos recursivos, por exemplo, Entidade de Negócios, Submandato e Subprocesso, como

assuntos de consulta única.• Geram Níveis de objeto recursivo apenas para objetos de Entidade de Negócios.• Removem itens de dados de nível do sistema, por exemplo, IS_PRIMARY, LATEST_VERSION e assim

por diante.• Usam representações de campo simplificadas, por exemplo, itens de dados únicos para Moedas e

Enumerações como Quantia local e Valor localizado, respectivamente.

Pacotes de estruturaAo gerar a estrutura de relatório, pacotes para modelos de estrutura selecionados são publicados noservidor Cognos.

O modelo gerado para o modelo de estrutura OPENPAGES_FRAMEWORK_V6 está publicado no pacoteOPENPAGES_REPORTS_V6.

Os modelos gerados para modelos de estrutura que você cria são publicados sob o nome do pacote domodelo de estrutura.

Espaços de TabelasUm namespace identifica exclusivamente uma coleção de assuntos de consulta, seus relacionamentos eoutros objetos (como cálculos) que podem ser utilizados para criação de relatórios.

O gerador de estrutura usa a definição de um namespace (que é definido na interface com o usuário IBMOpenPages with Watson) para criar um namespace correspondente no modelo de estrutura.

Os namespaces no modelo de estrutura OPENPAGES_FRAMEWORK_V6 são usados pelos relatóriospredefinidos que são fornecidos com o OpenPages. Se você fizer mudanças nos namespaces, isso poderáafetar a funcionalidade dos relatórios e poderá fazer com que eles não sejam executados. É possívelincluir seus próprios namespaces no modelo de estrutura OPENPAGES_FRAMEWORK_V6 para identificarexclusivamente uma coleção de assuntos de consulta e outros objetos (como cálculos) para satisfazersuas necessidades de relatório.


Se você define seus próprios modelos de estrutura padrão e básicos, deve-se definir namespaces paraeles.

Quando você gera o Reporting Framework V6, os pacotes para modelos de estrutura padrão selecionadossão publicados no servidor Cognos com subnamespaces de relacionamento e dimensionais:

• [namespace]_REL — este namespace relacional permite que autores de relatório relatem sobreobjetos com base em seus relacionamentos definidos. Este tipo de modelo é frequentemente utilizadoem relatórios de lista que usam dados combinados (numéricos, dados e sequências).

• [namespace]_DIM — esse namespace dimensional é organizado em fatos e dimensões e concede aosautores de relatório acesso aos recursos de processamento analítico on-line (OLAP), que estãodisponíveis no Cognos.

Quando você gera o Reporting Framework V6, os pacotes para modelos de estrutura básica selecionadossão publicados no servidor Cognos. Os assuntos de consulta são criados no namespace raiz. Ossubnamespaces não foram criados.

Para obter informações sobre como criar ou modificar os namespaces, consulte o Guia do administradordo IBM OpenPages with Watson.

O Namespace PadrãoO namespace DEFAULT no modelo de estrutura OPENPAGES_FRAMEWORK_V6 contém os assuntos deconsulta, os cálculos e os itens de consulta prontos para usar e não devem ser mudados. Ele contém amaioria dos objetos e associações presentes na hierarquia de objeto padrão definida do IBM OpenPageswith Watson. O namespace padrão foi projetado para atender às necessidades de relatório mais comuns.

No namespace padrão estão dois outros namespaces: DEFAULT_REL e DEFAULT_DIM. Eles representamo modelo de dados relacionais e o modelo de dados dimensionais.

Conforme mostrado no Figura 8 na página 17, o modelo de estrutura OpenPages with Watson geradocontém um namespace padrão que inclui os dois subnamespaces.

Figura 8. Namespaces de Modelo de Estrutura Gerado

Além do namespace DEFAULT, outros namespaces são fornecidos predefinidos dependendo dassoluções instaladas em seu sistema. Para obter detalhes, consulte Apêndice B, “Definições deNamespace”, na página 229.

Convenções de nomenclatura para namespacesQuando for preciso criar um nome para um namespace, você deve seguir algumas convenções denomenclatura.

• Todos os assuntos de consulta que representam um objeto definido no IBM OpenPages with Watsonpossuem o mesmo nome que o objeto.

• Todos os itens de consulta para um objeto são prefixados com um identificador exclusivo para esseobjeto. A lista de identificadores pode ser encontrada em Guia do administrador do IBM OpenPageswith Watson.

• Todos os cálculos que estiverem associados a um objeto possuem um nome que inicia com o nome doobjeto.

• Se dimensões de tipo de objeto tiverem sido definidas, o nome do assunto de consulta começará comnomes de nível definidos na dimensão.

Capítulo 4. Estrutura de Relatório 17

Incluindo códigos de localidade e definindo um código de localidade deordem de classificação

É possível incluir códigos de localidade no IBM OpenPages with Watson Reporting Framework V6 paraque eles possam ser aplicados aos relatórios e ao relatório localizado. Também é possível controlar oidioma no qual os assuntos de consulta e itens de dados são classificados.

Para obter informações, veja o Guia do administrador do IBM OpenPages with Watson.

As Pastas de Nível Superior do Modelo RelacionalPastas são utilizadas amplamente para organizar assuntos de consulta para que os autores do relatóriopossam localizar itens de modo fácil e intuitivo.

Essas informações aplicam-se somente para modelos de estrutura padrão, não para modelos deestrutura básica.

O Figura 9 na página 18 mostra o layout de pasta de nível superior para o subnamespace de dadosrelacionais DEFAULT_REL.

Figura 9. Layout da Pasta do Modelo Relacional

As pastas de nível superior podem conter outras pastas, assuntos de consulta e itens de consulta,conforme listado na Tabela 15 na página 18.

Tabela 15. Pasta de nível superior

Esta pasta de nível superior... Contém Assuntos de Consulta para...

AUDIT_TRAIL Tabelas de auditoria do sistema

COMPUTED_FIELDS Os campos computados que foram criados no aplicativo

ENUMERATIONS Assuntos de consulta de enumeração de prompt

GRC_OBJECTS Objetos de conformidade primários

GRC_OBJECTS_STANDALONE Objetos de conformidade secundários

DIVERSOS Informações não relacionadas a nenhuma outra pasta

SECURITY Segurança do Sistema

A Pasta Trilha de Auditoria (Modelo Relacional)O Figura 10 na página 19 mostra a pasta Trilha de Auditoria com todos os seus assuntos de consulta.


Figura 10. Pasta de Auditoria

A Tabela 16 na página 19 lista os assuntos de consulta nessa pasta.

Tabela 16. Assuntos de Consulta da Pasta de Auditoria

Assunto de Consulta Descrição

Actor_Audit_Trail Contém registros relacionados a tentativas de login de umusuário.

Alteração de Auditoria Retorna uma lista de propriedades que foram mudadas paraqualquer objeto associado a uma entidade no sistema.

Os prompts a seguir são definidos para esse assunto deconsulta:

• Data de Início• Data de Conclusão• ID de Entidade• Configurar ID (sempre configurado = 1)

Audita_MetaData Contém informações de trilha de auditoria relacionadas àsconfigurações de registro.

Audita_Security Contém informações de trilha de auditoria relacionadas àcriação de segurança do usuário.

Audita_Security_Obj_RoleTpl Retorna informações de auditoria para Listas de controle deacesso (ACLs) de modelos de função, designações de modeloda função permissões do aplicativo de modelo da função eobjetos de modelo da função.

Audita_Security_Obj_Actor Retorna informações de auditoria para agentes e ACLs deagentes.

Audit_Trail_Types Contém os nomes e as descrições de todos os tipos de itens detrilha de auditoria que podem ser registrados.


Tabela 16. Assuntos de Consulta da Pasta de Auditoria (continuação)


Classifier_Audit_Trail Contém informações de auditoria para sugestões feitas por umNatural Language Classifier.

Bloqueios Contém dados de bloqueio de recurso.

Locks_Audit_Trail Contém a trilha de auditoria de todos os bloqueios que foramaplicados no sistema.

Recursos modificados por entidade Retorna uma lista de recursos associados a uma entidadeespecífica que foram modificados.


• Data de Início• Data de Conclusão• ID da Entidade-pai• Configurar ID (sempre configurado = 1)

Auditoria de Objeto por Recurso Retorna uma lista de todas as definições de propriedade nosistema e se foram marcadas para exclusão.

Property_Audit_Trail Contém todos os registros para qualquer propriedade mudadano sistema.

RR_Audit_Trail Contém dados da trilha de auditoria para a tabelarelacionamento. Qualquer modificação nos relacionamentos égravada nessa tabela.

Trilha de Auditoria Unificada Retorna uma lista de todas as propriedades de objetos nosistema que foram mudadas.

Log unificado por recurso Retorna uma lista de todas as propriedades de objetos queforam mudadas para o ID do recurso especificado.


• Data de Início• Data de Conclusão• ID do recurso• Configurar ID (sempre configurado = 1)

Permissões do Usuário Retorna uma lista de todos os usuários no sistema e seusdireitos efetivos.

A Pasta Campos Computados (Modelo Relacional)O Figura 11 na página 21 mostra um exemplo de uma pasta do campo computado e de suas subpastas.Essa pasta é criada apenas se você tiver um campo computado definido em seu namespace.


Figura 11. Pasta Campos Computados

A Tabela 17 na página 21 descreve as pastas na pasta Campos computados.

Tabela 17. Pasta de Enumeração

Pasta Descrição

<Object Name> (COMPUTED_FIELDS) Uma subpasta será criada para cada objeto nonamespace que possui um campo computado.

<Computed Field Name> Cada campo computado que foi criado será listadoaqui.

A Pasta Enumerações (Modelo Relacional)O Figura 12 na página 21 mostra um exemplo da pasta Enumerações e suas subpastas. Esta pastacontém os assuntos de consulta que podem ser utilizados apenas para criar prompts em relatórios.Haverá uma pasta para cada tipo de objeto. Os objetos mostrados serão diferentes para cada instalaçãodo usuário.

Figura 12. Pasta Enumerações

A Tabela 18 na página 21 descreve as pastas na pasta Enumerações.

Tabela 18. Pasta de Enumeração

Pasta Descrição

<Object Name> (ENUMERATIONS) Contêm os assuntos de consulta correspondentes acada sequência enumerada definida para um objeto.Elas devem ser utilizadas somente para criarprompts em relatórios.


Sequências Enumeradas (Modelo Relacional)

O Figura 13 na página 22 mostra um exemplo de pastas ENUMERATIONS abertas:

Figura 13. Pasta ENUMERATIONS

Cada assunto de consulta representa uma sequência enumerada que foi definida para esse objeto. Essassequências enumeradas podem ser únicas ou possuir diversos valores.

O Figura 14 na página 22 mostra um exemplo de um assunto de consulta aberto:

Figura 14. Itens de Consulta de Sequência Enumerada

A tabela a seguir lista os itens de consulta localizados em uma sequência enumerada:

Tabela 19. Sequência Enumerada com Diversos Valores


ENUMVALID ID do valor da sequência enumerada.

ENUMTYPEID ID do tipo de variável retornada. Todos os registrosem uma sequência enumerada retornarão o mesmovalor.

VALUE Valor retornado para cada registro.

NOME Nome deste registro na sequência enumeradaretornada em RDL.

DISPLAY_ORDER Valor numérico que indica a ordem na qual o valor éexibido para o usuário.

FLAG_IS_HIDDEN O valor True ou false que indica se o valor é exibidopara o usuário.

I18N_LOCALE_ID Código de idioma do valor retornado.

RI_DOMAN Nome localizado desse registro na sequênciaenumerada.


Esses assuntos de consulta podem ser usados apenas para criar prompts. Você utilizaria o ENUMVALIDcomo o valor retornado e o RI_DOMAIN como o valor de exibição, porque ele está localizado. Outrosparâmetros podem ser usados para filtragem.

A Pasta Objetos GRC (Modelo Relacional)O Figura 15 na página 23 mostra um exemplo da pasta Objetos GRC com todas as suas subpastas. Osobjetos mostrados serão diferentes para cada instalação do usuário.

Figura 15. Pasta Objetos GRC

O Tabela 20 na página 23 lista as pastas na pasta GRC.

Tabela 20. Pastas Objetos GRC

Pasta Descrição

<Recursive Object>_FOLDER Contém todos os objetos de consulta relacionadosaos objetos recursivos usados nesse namespace.

<Object Name> Contêm os itens de dados relacionados aos objetosespecificados nesse namespace.

A Pasta SOXBusEntity (Modelo Relacional)

O Figura 16 na página 24 mostra um exemplo de uma pasta de objeto SOXBusEntity com todos os seusitens.


Figura 16. Pasta do Objeto da Entidade de Negócios SOX

O Tabela 21 na página 24 lista os itens na pasta SOXBusEntity.

Tabela 21. Pasta do Objeto de Entidade

Pasta/Assunto da consulta Descrição

<Hierarchy> Uma pasta será criada para cada nível de objetorecursivo criado no IBM OpenPages with Watson.

<Level>_FOLDER Uma pasta será criada para conter todos osassuntos de consulta relacionados a um úniconível do objeto recursivo.

ID_FIELDS Para cada nível de objeto recursivo, essa pastacontém os itens de consulta de campo de ID.

CURRENCY_FIELDS Para cada nível de objeto recursivo, essa pastacontém os itens de consulta de campo de moeda.

ENUMERATION_FIELDS Para cada nível de objeto recursivo, essa pastacontém as sequências enumeradas específicas doobjeto.

HIERARCHY_CONTEXT Para cada nível de objeto recursivo, essa pastacontém itens de dados que permitem que o autordo relatório filtre esse nível do objeto.

<Query Items> Para cada nível do objeto recursivo, todos essessão os demais itens de consulta para o nível.

SOXBUSENTITY_GPC Este é um assunto de consulta único que contémtodos os itens de consulta GPC.

Os Assuntos de Consulta GPC (Modelo Relacional)

A Figura 17 na página 25 mostra a estrutura de pasta Avô-Pai-Filho sob a pasta Entidade.


Figura 17. Itens da Pasta GPC

O Tabela 22 na página 25 lista os itens na pasta GPC.

Tabela 22. Itens de GPC


SOXBUSENTITY_GPC Assunto de consulta que contém todos os campospara cada um dos níveis de entidade padrão.

ID_FIELDS Todos os campos de ID que estão associados a estenível de entidade.

CURRENCY_FIELDS Todos os campos de moeda associados a este nívelde entidade.

ENUMERATION_FIELDS Todos os campos de sequência enumeradaassociados a este nível de entidade.

JOIN_FIELDS Para o objeto GPC, essa pasta contém itens de dadosque permitem que o autor do relatório filtre os níveisdesse objeto.

<Query Items> Todos os itens de consulta que podem ser usadosem um relatório para o nível de entidade.

O assunto de consulta SOXBUSENTITY_GPC contém três níveis de hierarquia para itens de consulta: avô,pai e filho. A tabela a seguir descreve quando utilizar cada nível em um relatório.

Utilize este nível... Se desejar fazer isto...

avô filtrar ou definir o escopo

pai agrupar, agregar ou prompt

child filtrar ou definir o escopo.

A Pasta de Objeto (Modelo Relacional)

O Figura 18 na página 26 mostra um exemplo de uma pasta de um objeto com todos os seus itens.


Figura 18. Pasta de Objeto

O Tabela 23 na página 26 lista os itens em uma pasta de objeto.

Tabela 23. Pasta de Objeto


ID_FIELDS Contém os campos de ID que estão associados aeste objeto.

PARENT_CONTEXT Contém os relacionamentos entre os objetos e todosos pais possíveis. Os itens nessa pasta são usadospara criar junções no IBM Cognos Analytics -Reporting.

ENUMERATION_FIELDS Contém assuntos de consulta para as variáveisenumeradas associadas a este objeto.

<Query Items> Todos os itens de consulta restantes que podem serusados em um relatório.

Itens de Consulta de Campos de Enumeração (Modelo Relacional)

A tabela a seguir lista os itens de consulta localizados em uma sequência enumerada de valor único:

Tabela 24. Sequência Enumerada de Valor Único


<Item de consulta>_SYSTEM_NAME Nome do sistema para o campo.

<Item de consulta> Nome localizado para o campo.

<Item de consulta>_ID ID do campo.

Ao exibir um valor de sequência enumerada em um relatório, o <Item de consulta> deverá sempre serusado porque ele está localizado. Ao filtrar em um valor de sequência enumerada, use o campo <Item deconsulta>_ID porque ele está indexado.

A tabela a seguir lista os itens de consulta localizados em uma sequência enumerada com diversosvalores:


Tabela 25. Sequência Enumerada com Diversos Valores


<Item de consulta>_SYSTEM_NAME Retorna um registro para cada valor na sequênciaenumerada. Ele será retornado como um nome desistema.

<Item de consulta> Retorna um registro para cada valor na sequênciaenumerada. Ele será retornado como um nomelocalizado.

<Item de consulta>_ID Lista separada por barra vertical ( | ) dos IDs dosvalores de enumeração.

<Item de consulta>_SYSTEM_LIST Lista separada por vírgula dos valores de sequênciado sistema das enumerações.

<Item de consulta>_LIST Lista separada por vírgula dos valores de sequêncialocalizados das enumerações.

Para obter uma lista separada por vírgula dos valores convertidos da sequência, o autor do relatórioprecisa selecionar o campo <Item de consulta>_LIST e usar isso no relatório. Esse é o melhor campo aser utilizado para exibir o valor de uma sequência enumerada com diversos valores.

A Pasta Objetos GRC Independentes (Modelo Relacional)O Figura 19 na página 27 mostra a pasta Objetos Independentes com todos os seus itens.

Figura 19. Pasta Objetos Independentes

Tabela 26 na página 27 é uma explicação dos itens na pasta Objetos Independentes.

Tabela 26. Pasta Objetos Independentes


<Secondary Object Name> Assuntos de consulta que contêm todos os objetossecundários definidos para uso em seu sistema.

Importante: Por padrão, o SOXTask (Item de Ação) é uma junção externa esquerda ao objeto SOXIssueporque SOXTask pode ser unido somente ao objeto SOXIssue no modelo.

As Pastas de Objeto Secundário (Modelo Relacional)

O Figura 20 na página 28 mostra um exemplo de uma pasta de objeto secundário com todos os seusitens.


Figura 20. Pasta de Objeto Secundário

O Tabela 27 na página 28 lista os itens em uma pasta de objeto secundário.

Tabela 27. Pasta de Objeto Secundário


ID_FIELDS Campos de ID que estão associados a este objeto.

PARENT_CONTEXT Contém os relacionamentos entre os objetos e todosos pais possíveis. Os itens nessa pasta são usadospara criar junções no IBM Cognos Analytics -Reporting.

ENUMERATION_FIELDS Contém assuntos de consulta para as variáveisenumeradas associadas a este objeto.

<Query Items> Itens de consulta restantes que podem ser usados emum relatório.

A Pasta Diversos (Modelo Relacional)O Figura 21 na página 28 mostra a pasta Diversos com todas as suas subpastas.

Figura 21. Pasta Diversos

A Tabela 28 na página 29 lista os itens na pasta Diversos.


Tabela 28. Pasta Diversos


CURRENCIES Contém os assuntos de consulta relacionados àsmoedas do sistema.

REPORTING_PERIODS Contém os assuntos de consulta relacionados aperíodos de relatório do sistema.

ALL_DOCUMENTATION Retorna uma lista de todos os objetos no sistema e acontagem/tipo de documentação que é anexado a cadaobjeto.


• ID de Entidade• Configurar ID (sempre configurado = 1)

CHECKED_OUT_OBJECTS Usado para localizar todos os objetos que foramretirados.

O prompt a seguir é definido para esse assunto deconsulta:

• Sequência de Ordenação

A ordem de classificação é um prompt opcional queaceita um dos seguintes valores:

[NAME] = 3 [FULL_PATH] = 4 [CONTENT_TYPE] = 5 [DESCRIPTION]= 8 [CHECKED_OUT_BY] = 9[CHECKED_OUT_DATE] = 10[PARENT_NAME] = 11 [PARENT_FULL_PATH] = 12 [PARENT_CONTENT_TYPE] = 13

Nota: Se nenhum valor de classificação forselecionado, o valor será padronizado como 3 (o itemde consulta NAME).

I18N_INT_OP_CALENDAR Contém a definição de todas as datas no sistemaconvertidas em outros valores de data. Ao criar umrelacionamento com um campo de data, é possívelfiltrar o campo pelas partes de data neste assunto deconsulta.

LOCALIZED_CONTENT_TYPES Retorna a lista de todos os tipos de objetos definidosno sistema.

LOCALIZED_PROPERTY_DEFINITIONS Retorna a definição de todas as propriedades definidasno sistema.


Tabela 28. Pasta Diversos (continuação)


NON_ASSOCIATED_OBJECTS Retorna todos os objetos órfãos em seu sistema.


• Sequência de Ordenação• Configurar ID (sempre configurado = 1)

A ordem de classificação é um prompt opcional queaceita um dos seguintes valores:

[NAME]= 2[FULL_PATH] = 3[CONTENT_TYPE] = 4[DESCRIPTION] = 7[CREATOR] = 8[CREATION_DATE] = 9

Dica: Se nenhum valor de classificação for selecionado,o valor será padronizado como 2 (o item de consultaNAME).

USERS_AND_PROFILES Contém o relacionamento de usuários com seu perfilde login.

ADVANCED Contém assuntos de consulta avançados que foramcriados para criar relatórios complexos.

A Pasta Moedas (Modelo Relacional)

O Figura 22 na página 30 mostra a pasta Moedas com todos os seus assuntos de consulta.

Figura 22. Pasta Moedas

O Tabela 29 na página 30 lista os itens na pasta Moedas.

Tabela 29. Pasta Moedas


BASE_CURRENCY Retorna a definição do código de moeda base em seusistema.

EXCHANGE_RATES Retorna uma lista de todas as moedas definidas esuas taxas de câmbio.

A Pasta de Período de Relatório (Modelo Relacional)

O Figura 23 na página 30 mostra a pasta Períodos de Relatório com todos os seus assuntos de consulta.

Figura 23. Pasta de Período de Relatório

O Tabela 30 na página 31 lista os itens na pasta Períodos de Relatório.


Tabela 30. Assuntos de Consulta da Pasta de Período de Relatório


LABELS Retorna a lista de todos os períodos de relatóriodefinidos no sistema.

A Pasta Avançado (Modelo Relacional)

O Figura 24 na página 31 mostra a pasta Avançado com todas as suas subpastas.

Figura 24. Pasta Avançado

Tabela 31 na página 31 lista os itens na pasta Avançado.

Tabela 31. Pasta Avançado


GPC COMPONENT OBJECTS Contém o assunto de consulta GPC dividido emníveis.

RV_ENTITY_GPC Expõe a visualização do objeto GPC para o autor dorelatório. Ele possui segurança de dados IBMOpenPages with Watson integrada.

<Object> (PARENTS) Contém tabelas de pontes entre objetos quepodem ser usadas para criar junções avançadasem um relatório.

A Pasta Segurança (Modelo Relacional)O Figura 25 na página 32 mostra a pasta Segurança com todos os seus assuntos de consulta.


Figura 25. Pasta Segurança

O Tabela 32 na página 32 lista os itens na pasta Segurança.

Tabela 32. Assuntos de Consulta de Pasta de Segurança


ACTORINFO Retorna a definição de todos os usuários no sistema.

BUSINESS ENTITY GROUPS Retorna a lista de entidades no sistema e seucaminho completo.

EFFECTIVE ACTOR MANAGEMENT RIGHTSUNDER AN ENTITY GROUP

Retorna uma lista de grupos de entidades e osdireitos efetivos definidos para esse grupo.

O prompt a seguir é definido para esse assunto deconsulta:

• ID de Grupo de Entidade

ROLES ASSIGNED TO BUSINESS UNITS Retorna uma lista de todas as funções designadas auma entidade.

ROLES ASSIGNED TO USERS AND GROUPS ONBUSINESS UNITS

Retorna uma lista de todas as funções designadas ausuários e grupos em uma entidade.

ROLE_TEMPLATES Retorna uma lista de todos os modelos de função.

USER_GROUP_INFO Retorna uma lista de todos os usuários e gruposdefinidos no sistema.

As Pastas de Nível Superior do Modelo DimensionalA estrutura de pasta no namespace do modelo dimensional é diferente daquela do namespace de modelorelacional.


O Figura 26 na página 32 mostra o layout da pasta de nível superior do modelo dimensional.

Figura 26. Layout da Pasta do Modelo Dimensional


O Tabela 33 na página 33 lista os itens na pasta de modelo dimensional.

Tabela 33. Nome e descrição da pasta de nível superior

Esta pasta de nível superior... Contém Assuntos de Consulta para...

GRC_OBJECTS As dimensões e os fatos para os objetos primários.

GRC_OBJECTS_STANDALONE As dimensões e os fatos para os objetos secundários.

OBJECT_TYPE_DIMENSIONS As definições de todas as dimensões de tipo deobjeto definido pelo usuário.

A Pasta Objetos GRC (Modelo Dimensional)O Figura 27 na página 33 mostra a pasta Objetos GRC com todas as suas subpastas.

Figura 27. Pasta Objetos de Conformidade

O Tabela 34 na página 33 lista as pastas na pasta GRC.

Tabela 34. Pastas Objetos GRC

Pasta Descrição

SOXBUSENTITY_FOLDER Contém todas as dimensões e os fatos relacionadosao objeto de entidade de negócios.

<Object>_FOLDER Contém todas as dimensões e os fatos relacionadosaos objetos especificados nesse namespace.

A Pasta SOXBusEntity (Modelo Dimensional)

A pasta SOXBusEntity contém pastas para os níveis de objeto recursivo customizado. As pastas refletemos nomes e os níveis designados utilizando o recurso de objeto recursivo de Entidade de Negócios no IBMOpenPages with Watson.

Esta pasta será diferente para cada cliente, dependendo de como cada nível de objeto recursivo deentidade foi definido.

O Figura 28 na página 34 mostra um exemplo de uma pasta SOXBusEntity com todos os seus itens.


Figura 28. Pasta SOXBusEntity

O Tabela 35 na página 34 lista as pastas na pasta SOXBusEntity.

Tabela 35. Pasta de Entidade

Pasta Descrição

SOXBUSENTITY_FOLDER Contém dimensões de tipo de objeto criadas pelousuário.

GFS ORG STRUCTURE Contém o nome da dimensão de tipo de objetocriada no OpenPages with Watson.

<Recursive Object Level> Para cada nível da dimensão tipo de objeto, essapasta contém a definição de um único nível.

<Recursive Object Level>(ENUMERATION_DIMENSIONS)

Contém as dimensões de enumeração definidaspara este nível no objeto recursivo.

<Recursive Object Level>_FACTS Os fatos definidos para este nível no objetorecursivo.

<Recursive Object Level> Contém os demais atributos definidos para estenível do objeto recursivo.

A Pasta de Objeto Primário (Modelo Dimensional)

A pasta de objetos primários será diferente para cada cliente, dependendo dos objetos que tiverem sidodefinidos para seu sistema por meio do IBM OpenPages with Watson. Consulte o Guia do administradordo IBM OpenPages with Watson para obter mais informações sobre como configurar fatos e dimensõespara cada objeto.

O Figura 29 na página 34 mostra um exemplo de uma pasta de objeto primário.

Figura 29. Pasta de Objeto Primário

Tabela 36 na página 35 é uma explicação das pastas em uma pasta de objetos primários.


Tabela 36. Pastas de Objeto

Pasta Descrição

<Object Name> (DATE_DIMENSIONS) Contém todas as dimensões de data para cadaobjeto.

<Object Name>_FACTS Os fatos definidos para o objeto.

<Object Name> Uma dimensão definida para cada objeto que contémtodos os campos restantes. Esses campos sãogeralmente utilizados ao criar um relatório de listacom base em dimensão.

A Pasta Objetos Independentes GRC (Modelo Dimensional)A pasta Objeto Independente GRC será diferente para cada cliente, dependendo de quais objetossecundários estiverem definidos.

O Figura 30 na página 35 mostra um exemplo da pasta Objetos Independentes GRC com todas as suassubpastas.

Figura 30. Pasta Objetos Independentes GRC

Tabela 37 na página 35 é uma explicação das pastas na pasta Objetos Independentes GRC.

Tabela 37. Pastas Objetos GRC Independentes

Pasta Descrição

<Object Name>_FOLDER Contém todas as medidas e dimensões para cadaobjeto.

As Pastas de Objetos (Modelo Dimensional)

Esta pasta será diferente para cada cliente, dependendo dos objetos que tiverem sido definidos para seusistema por meio do IBM OpenPages with Watson. Consulte o Guia do administrador do IBM OpenPageswith Watson para obter informações adicionais sobre como definir fatos e dimensões para um objeto.

O Figura 31 na página 35 mostra um exemplo de uma pasta de objeto:

Figura 31. Pasta de Objeto

Tabela 38 na página 36 é uma explicação das pastas de uma pasta de objeto.


Tabela 38. Pastas de Objeto

Pasta Descrição

<Object Name> (DATE_DIMENSIONS) Contém todas as dimensões de datarelacionadas ao objeto.

<Object Name> (ENUMERATION_DIMENSIONS) Contém todas as dimensões de enumeraçãorelacionadas ao objeto.

<Object Name>_Facts Os fatos definidos para este objeto.

<Object Name> Uma dimensão definida para cada objeto quecontém todos os campos restantes. Essescampos são geralmente utilizados ao criar umrelatório de lista com base em dimensão.

A Pasta de Dimensões de Tipo de Objeto (Modelo Dimensional)A pasta Dimensão de Tipo de Objeto será diferente para cada cliente dependendo das dimensões de tipode objeto que foram definidas para seu sistema através do IBM OpenPages with Watson. Consulte o Guiado administrador do IBM OpenPages with Watson para obter mais informações sobre como criar estasdimensões.

O Figura 32 na página 36 mostra um exemplo da pasta Dimensões de Tipo de Objeto.

Figura 32. Pasta de Dimensões de Tipo de Objeto

Tabela 39 na página 36 é uma explicação das pastas na pasta Dimensão de Tipo de Objeto.

Tabela 39. Pastas de Dimensões de Tipo de Objeto

Pasta Descrição

SOXBUSENTITY_GPC Dimensão de tipo de objeto padrão que cria umadimensão GPC. Este objeto é usado somente parafiltragem. Ele não pode ser usado para afuncionalidade drill up ou drill down.

GFS ORG HIERARCHY Dimensão do tipo de objeto customizado que foiinserida por meio do OpenPages with Watson paracriar uma hierarquia para entidades de negócios.


Capítulo 5. Otimizando o DesempenhoEste capítulo lista as técnicas que os autores de relatório podem utilizar para melhorar o desempenho dorelatório.

Filtrando entidades de negócios de nível superiorPara melhorar o desempenho de um relatório, todos os relatórios devem ter um prompt que filtra parauma entidade de negócios específica ou um filtro que define o escopo do relatório pela entidade ouentidades de negócios de nível superior. Se os relatórios forem executados sem um escopo definido parauma única entidade, a consulta executará diversas procuras através da hierarquia. Isto diminuienormemente o tempo de resposta e pode apresentar resultados indesejáveis para a página de consultaou relatório do prompt de entidade.

O prompt pode assumir qualquer um dos seguintes formatos:

• Um prompt único exibindo o caminho completo das entidades válidas a partir das quais o usuário podeselecionar.

• Uma série de prompts em cascata que permite que o usuário trabalhe até a entidade exata cujorelatório deseja gerar.

• Um prompt de árvore que permite filtragem em um relatório dimensional.

Se um prompt não for necessário porque o relatório sempre será executado a partir da mesma entidade,então um filtro fixo poderá ser colocado no assunto de consulta que sempre seleciona a entidade exata.

Nota: Não utilize IDs de Recurso como filtros fixos porque eles serão diferentes em cada instalação.

Filtragem em Períodos de RelatórioTodos os relatórios devem incluir um filtro no período de relatório. Um período de relatório é uma capturainstantânea de todos os dados em seu banco de dados como uma função de horário. Isso cria umconjunto de dados muito grande cada vez que esta operação for executada.

O filtro pode ser criado utilizando um valor do prompt a partir de uma página de prompt ou ao criar umfiltro de período de relatório que seleciona apenas (por exemplo) o período de relatório atual:

[DEFAULT_REL].[SOXBUSENTITY_GPC].[GEN_REPORTING_PERIOD_ID] = -1

O valor -1 significa o período de relatório atual.

Ignorando um ÍndiceNas tabelas de banco de dados, os índices são definidos em todos os IDs de valor de sequênciaenumerada. Se você usar IDs de valor de sequência enumerada como filtros, talvez queira ignorar oíndice específico no campo para melhor desempenho geral.

Ao criar um filtro de valor de sequência enumerada, o que ocorre é que ao invés de escolher um índice dosistema para unir duas tabelas de objetos (que incluem o filtro de sequência), o Oracle escolherá índicesmenos eficientes devido ao filtro de sequência enumerada. Ao ignorar o índice na sequência enumerada,o Oracle cria uma consulta mais rápida.

Por exemplo, modifique o filtro no valor de sequência enumerada Efetivo, conforme mostrado noexemplo a seguir:

[DEFAULT_REL].[SOXCONTROL].[CN_OPERATING_EFFECTIVENESS_ID] + 0 = #$SOXCONTROL_OPERATING_EFFECTIVENES_DEFINITION_MAP{"Effective"}#

Ao incluir um 0 (zero) no lado esquerdo da expressão de filtro, Oracle o tratará como uma expressão, e oíndice anexado a esse campo será ignorado.

Geralmente é difícil notar alguma melhora de desempenho como resultado desta mudança. A melhora dedesempenho se torna mais evidente quando um número grande de linhas é retornado ao gerar para umarquivo PDF/Excel ou quando o valor de retorno de linha é configurado para um número grande para ocontêiner de dados ao invés de configurar para o valor padrão de 20 linhas.

Nota: Esta técnica de aprimoramento de desempenho é aplicável apenas para filtros que contenham IDsde sequência enumerada.

Desempenho da Direção da ConsultaAo explorar todas as possibilidades de cálculo, há uma grande diferença no que você pode e deve fazer

Ao gravar um relatório, é possível consultar a árvore de relacionamento (ou seja, calcular valores combase em ancestrais), e esta atividade é altamente recomendável. A geração automática de estrutura éconfigurada de modo a criar junções que levam a um melhor desempenho ao consultar a árvore derelacionamentos para baixo. Uma consulta da árvore para cima prejudica o desempenho do campocomputado, além de sobrecarregar enormemente o banco de dados e causar uma lentidão no aplicativointeiro.

Incluindo Novos ÍndicesSe você considerar que um padrão em seus relatórios envolve unir dois campos que não estiveremindexados, vale investigar se a inclusão do índice melhorará o desempenho do relatório.

Nesse caso, é possível incluir o índice permanentemente por meio do IBM OpenPages with Watson.Consulte o Guia do administrador do IBM OpenPages with Watson para incluir índices em tabelas.

A Configuração de Uso de Informações de ParâmetroÉ possível configurar a propriedade Usar para informações de parâmetro em todos os assuntos daconsulta.

Esta configuração determina quais consultas têm prioridade ao determinar informações de parâmetro.Assim, para solicitar consultas, esse valor deve ser configurado para Sim. Para todas as outras consultas,esse parâmetro deve ser configurado para Não. Essa configuração melhora somente o desempenho dapágina de prompt.

Ligação Raiz de Níveis de Objeto RecursivoAo usar o modelo dimensional, geralmente deve-se criar Níveis de objeto recursivo para suportar umahierarquia de entidade de negócios.

A Entidade inicial é configurada como uma barra (/) que é a raiz da hierarquia da entidade de negócios emseu IBM OpenPages with Watson. Ao fazer esta seleção, essa dimensão reunirá todas as entidades denegócios em seu sistema no seu relatório. Talvez isso seja o que você está procurando, mas normalmenteno nível superior de suas definições de entidade de negócios estão suas pessoas jurídicas, biblioteca deauditoria, biblioteca geral, entidades de negócios, etc., que não são necessariamente aquilo que desejaver em um único relatório.


Para fazer com que a dimensão definida tenha um melhor desempenho, selecione uma Entidade inicialque corresponda ao que você deseja exibir. Por exemplo, selecione Global Financial Services.

Você observará as seguintes mudanças:

• A Entidade Inicial é agora /Global Financial Services. Desde que os relatórios estejam normalmente nasua hierarquia de relatório da entidade de negócios, esse é o melhor local para iniciar.

• Isso melhorará o desempenho ao deixar de fora todas as outras entidades de negócios de nível superiorque não precisavam realmente ser relatadas nesta dimensão específica.

Capítulo 5. Otimizando o Desempenho 39


Capítulo 6. Report Design LanguageReport Design Language (RDL) é a linguagem de segundo plano em que todos os seus relatórios sãoarmazenados. O resultado é que um relatório pode ser completamente definido em XML, e seu conteúdode origem pode ser visualizado em qualquer editor XML.

A partir do IBM OpenPages 6.0, não é mais necessário projetar seus relatórios em RDL. No entanto, aindaé recomendado que autores de relatório usem RDL para projetar seus relatórios devido a limitações donão uso de RDL.

A seguinte lista de limitações pode ser aplicável se você não desenvolver seu relatório no RDL:

• Se alterar um rótulo de campo no IBM OpenPages with Watson, ele será exibido corretamente como umnovo objeto que pode ser inserido, mas, se ele já tiver sido utilizado em seu relatório, essa referêncianão será atualizada para o novo nome. Isso causará uma confusão.

• O drill up e o drill down dimensionais não funcionam mais.• Os arquivos CQS ainda estarão em RDL.• O editor de expressão ainda será exibido apenas em RDL.• Os campos no modelo de estrutura são classificados pelo seu nome em RDL.• Será mais difícil suportar um relatório que possuir uma combinação de idioma nativo e campos de RDL.

O RDL para OpenPages usa inglês (Canadá) (en_CA).

Configurando Seu Código de Idioma no OpenPages with WatsonTodos os usuários precisam ter um código do idioma padrão no IBM OpenPages with Watson. O código deidioma determina em qual idioma o aplicativo é exibido junto de qual idioma é visto quando um relatório éexecutado.

Para obter mais informações sobre como configurar seu código do idioma, consulte o Guia doadministrador do IBM OpenPages with Watson.

Suporte para idioma e código do idiomaSe você estiver usando o IBM OpenPages with Watson em um idioma diferente do inglês, essasinformações ajudarão a entender as configurações de idioma e de código do idioma.

Preferência de idioma do navegador da web

A preferência de idioma do navegador da web é a configuração de idioma que você optar por especificarno qual as páginas da web podem ser exibidas. A preferência de idioma do navegador da web afetaapenas a página de login do OpenPages with Watson. A preferência de idioma do navegador da web nãoafeta a formatação de número e data no OpenPages with Watson.

Se a preferência de idioma do navegador da web for configurada para um idioma diferente de um dosseguintes idiomas, lembre-se de que a página de login do OpenPages with Watson aparece em inglês:

• Alemão• Espanhol• Francês• FAR• Japanese• Português• Chinesa• English

Configuração do código de idioma

A lista Código do idioma contém uma lista de idiomas do produto. Esta configuração de idioma controla oidioma do produto, exceto para a página de login.

A formatação de dados e os idiomas de relatório estão disponíveis nas seguintes culturas na lista Códigodo idioma:

Tabela 40. Idiomas na lista Código do idioma e as culturas que eles representam

Idioma na lista Código de idioma Cultura

Francês Francês (França)

Alemão Alemão (Alemanha)

FAR Italiano (Itália)

Japanese Japonês (Japão)

Português Português (Brasil)

Espanhol Espanhol (Espanha)

Chinês simplificado Chinês (China)

Chinês Tradicional Chinês (Taiwan)

Inglês do Reino Unido Inglês (Reino Unido)

Inglês dos EUA Inglês (EUA)

Considerações para idiomas específicos

Quando o OpenPages with Watson é configurado para utilizar Inglês dos Estados Unidos, as datas sãoformatadas como mm/dd/aa. Por exemplo, 3 de janeiro de 2013 é formatado como 1/3/13, em vez de03/01/2013 no inglês do Reino Unido.

Quando o produto é configurado para utilizar Espanhol (Espanha), os números são formatados como123.456,78, em que o ponto é um separador de milhares e a vírgula é utilizada como um separadordecimal. Por exemplo, o número doze mil e quinhentos é formatado como 12.500 em Espanhol (Espanha)ao invés de 12,500 em Espanhol (México).

Em várias culturas, a convenção é colocar o símbolo monetário após o número. No OpenPages withWatson, os símbolos monetários são sempre exibidos antes do número.

A formatação de data também pode ser não convencional.

Configurando seu código de idioma no IBM Cognos AnalyticsAo configurar seu código de idioma no IBM Cognos Analytics, você ainda mantém sua capacidade deexecutar o aplicativo IBM OpenPages with Watson no código de idioma especificado no aplicativo juntoao recurso incluído para projetar relatórios em RDL.

Procedimento

1. Efetue login no IBM Cognos Analytics.2. Clique no ícone de usuário e selecione Minhas preferências.3. Selecione a guia Geral.4. Configure o Idioma do Conteúdo para Inglês (Canadá).


Capítulo 7. Trabalhando com Dados RelacionaisEsse capítulo explica como usar a estrutura de relatório quando trabalhar com dados relacionais.

• Estas informações se aplicam a ambos os modelos de estrutura padrão e básico, mas as explicações eos exemplos são para modelos de estrutura padrão.

• Para obter uma lista de problemas conhecidos e quaisquer soluções alternativas disponíveis, consulteApêndice C, “Limitações e Soluções Alternativas”, na página 241

• Para obter uma lista de dicas e truques de desempenho, consulte Capítulo 5, “Otimizando oDesempenho”, na página 37

Convenções de sintaxe

Sintaxe de Expressão de Campo

Os exemplos neste capítulo utilizam a seguinte sintaxe para expressões de filtro ou de campo:

[NAMESPACE].[QUERY SUBJECT].[QUERY ITEM] = value

Por exemplo,

[DEFAULT_REL].[SOXCONTROL].[CN_OPERATING_EFFECTIVENES] = 'Effective'

[DEFAULT_REL] é um namespace na hierarquia de objeto padrão predefinida. Se estiver utilizando umnamespace diferente, substitua o nome desse namespace para o namespace padrão.

Sintaxe de Navegação de Pasta

Os exemplos neste capítulo usam a sintaxe a seguir para mostrar a navegação para um item de consultasob o namespace DEFAULT:

FOLDER|[QUERY SUBJECT]|[QUERY ITEM]

Por exemplo,

REPORTING_PERIODS|[LABELS]|[NAME]

Trabalhando com Contêineres de DadosAs seções a seguir descrevem como criar e formatar relatórios de lista, de crosstab e de gráfico.

Para obter mais informações sobre como modificar listas, crosstabs e gráficos, veja o IBM CognosAnalytics - Guia do usuário do relatório.

Trabalhando com ListasUm objeto de lista é utilizado para criar um relatório que mostrará dados em linhas e colunas. Ao criar umobjeto de lista pela primeira vez, ele aparece vazio.

A linha do cabeçalho é destacada em azul, enquanto os dados da coluna são representados em branco.Quando um item de dados é colocado em uma lista, o cabeçalho e os dados da coluna são preenchidos.

A lista em si é dividida nas seguintes áreas:Células individuais

Controla o formato.

Corpo da Coluna da Listacontrola a formatação da área de dados de uma coluna individual.

Coluna da Listacontrola a formatação de uma coluna individual.

Estilo de Corpo das Colunas da Listacontrola a formatação da área de dados de todas as colunas.

Estilo de Título das Colunas da Listacontrola a formatação dos cabeçalhos de todas as colunas.

Colunas da Listacontrola a formatação das colunas de lista.

Listcontrola a formatação da lista inteira.

Cada um dos itens anteriores possui um conjunto de propriedades que podem ser configuradas paraafetar como os dados aparecem para o usuário. Cada item possui um conjunto de propriedades um poucodiferente.

Selecionando Colunas de DadosÉ possível selecionar colunas de dados para o relatório de lista.

Procedimento

1. Na área de janela Objetos que Podem Ser Inseridos na guia Origem, arraste e solte os seguintesitens de dados na lista:

• DEFAULT|[DEFAULT_REL]|GRC_OBJECTS|[SOXCONTROL]|[CN_NAME00]• DEFAULT|[DEFAULT_REL]|GRC_OBJECTS|[SOXCONTROL]|[CN_DESCRIPTION]

2. Execute o relatório.

Ao soltar itens em uma lista, uma consulta é formada usando os itens de dados selecionados.

Resultados

Se você não gostar da ordem das colunas, será possível selecionar uma coluna e movê-la com o mousepara outro lugar na lista.

Trabalhando com CrosstabsCrosstabs são um tipo de contêiner de dados que opera em dados agregados. Os campos de linha e decoluna na crosstab são normalmente campos de sequência ou enumerações, ao passo que a interseçãoda crosstab deve sempre ser uma parte de dados resumida, geralmente um valor numérico.

É possível ver três áreas no objeto de tabulação cruzada:

ColunasOs itens de dados colocados aqui gerarão cabeçalhos da coluna. Diversos itens de dados podem sersoltos aqui para criar cabeçalhos de coluna aninhados.

LinhasOs itens de dados colocados aqui gerarão as linhas de dados na tabulação cruzada. Diversos itens dedados podem ser colocados aqui para gerar linhas aninhadas.

MedidasSomente um único item de dados que pode ser colocado aqui será agregado às linhas e colunasselecionadas.

Selecionando Itens de DadosÉ possível selecionar quais itens de dados deseja incluir como linhas e colunas no relatório de tabulaçãocruzada e como deseja que sejam formatados.


Procedimento

1. Utilizando o Explorador de Consultas, selecione Query1.2. Na área de janela Objetos que Podem Ser Inseridos, arraste e solte os seguintes itens de dados na

área de janela de itens de dados da crosstab:

• DEFAULT | [ DEFAULT_REL ] | GRC_OBJECTS | [ SOXCONTROL ] | ID_FIELDS |[CN_CONTROL_ID]

• DEFAULT|[DEFAULT_REL]|GRC_OBJECTS|[SOXCONTROL]| ENUMERATION_FIELDS|OPERATING_EFFECTIVENES (ENUMERATION)| [CN_OPERATING_EFFECTIVENES]

• DEFAULT|[DEFAULT_REL]|GRC_OBJECTS|SOXBUSENTITY_FOLDER| [SOXBUSENTITY_GPC]|[SOXBUSENTITY_GPC]|[CEN_NAME00]

3. Arraste e solte o [CN_OPERATING_EFFECTIVENES] na área de colunas na guia Itens de Dados daárea de janela Objetos que Podem Ser Inseridos.

4. Arraste e solte o [CEN_NAME00] na área de linhas na guia Itens de Dados da área de janela Objetosque Podem Ser Inseridos.

5. Arraste e solte o [CN_CONTROL_ID] na área de medidas na guia Itens de Dados da área de janelaObjetos que Podem Ser Inseridos.

6. Selecione a área das medidas e conclua as etapas a seguir na área de janela de Propriedades.a) Em Item de Dados, configure a Função Agregada para Contagem Distinta.b) Configure a Função de Agregado de Sintetização para Automática.


Dica: Para classificar as linhas em ordem crescente, clique na coluna de linhas e, em seguida, cliqueno ícone Classificar . Para incluir resumos nas linhas e colunas, clique no ícone Adição eselecione Total.

Trabalhando com GráficosGráficos são utilizados para exibir dados em um formato visual. Há uma variedade de formatos degráficos construídos no CommandCenter com os quais o autor do relatório deve familiarizar-se para exibirmelhor os dados para os usuários finais.

Um gráfico consiste nos seguintes componentes:

Medida PadrãoIsso é normalmente o componente do eixo y do gráfico. Ele é um valor numérico.

SérieUm grupo ou agrupamentos para o eixo y.

CategoriesIsso é normalmente o componente do eixo x do gráfico.

Criando um gráficoÉ possível criar um gráfico com dados relacionais.

Procedimento

1. Para criar um novo relatório gráfico, conclua as etapas a seguir.a) Selecione o agrupamento de gráfico Pizza, Rosca.b) Selecione o tipo de gráfico Pizza.c) Clique em OK.

2. Arraste e solte os itens de consulta a seguir nas várias seções do gráfico:

Capítulo 7. Trabalhando com Dados Relacionais 45

• Categories (pies)

DEFAULT|[DEFAULT_REL]|GRC_OBJECTS|SOXBUSENTITY_FOLDER| [SOXBUSENTITY_GPC]|[SOXBUSENTITY_GPC]|[CEN_NAME00]

• Default Measures

DEFAULT|[DEFAULT_REL]|GRC_OBJECTS|[SOXCONTROL]|ID_FIELDS| [CN_CONTROL_ID]

• Series (pie slices)

DEFAULT|[DEFAULT_REL]|GRC_OBJECTS|[SOXCONTROL]|ENUMERATION_FIELDS| OPERATING_EFFECTIVENES (ENUMERATION)|[CN_OPERATING_EFFECTIVENES]

3. No Explorador de Consultas, selecione a consulta.4. Na área de janela Propriedades em Diversos, configure o nome da consulta para chartMain.5. Na área de janela Itens de dados, selecione [CN_CONTROL_ID] e conclua as etapas a seguir.

a) Na área de janela Propriedades em Item de Dados, altere o valor da propriedade FunçãoAgregada para Contagem Distinta.

b) Na área de janela Propriedades em Item de Dados, altere o valor da propriedade Função deAgregado de Sintetização para Automática.

6. No Explorador de Página, crie uma Página de Prompt e crie um prompt Entidade de Negócios,conforme mostrado em “Incluindo um Prompt de Entidade de Negócios” na página 52.

7. Retorne à página principal do relatório.8. Dê um clique duplo no título e configure o valor para Eficácia operacional.9. Execute o relatório.

Trabalhando com Campos EnumeradosAs seções a seguir descrevem como incluir campos enumerados nos relatórios.

• “A Estrutura de Pasta de Campos Enumerados” na página 46• “Utilizando Campos Enumerados em um Relatório” na página 47

A Estrutura de Pasta de Campos EnumeradosCada objeto possui uma pasta contendo todos os campos enumerados definidos para esse objeto. OFigura 33 na página 47 mostra o assunto de consulta SOXControl com sua subpasta de camposenumerados. Esta pasta contém os valores específicos do objeto dos campos enumerados.

Conforme foi mencionado anteriormente, há uma segunda pasta de campos enumerados na estrutura.Esta pasta contém a definição da enumeração a ser utilizada para os prompts. Consulte o Capítulo 4,“Estrutura de Relatório”, na página 15 para obter mais informações sobre a outra pasta.

No Figura 33 na página 47, nós estamos escolhendo a pasta que contém os valores de enumeraçãoespecíficos do objeto.


Figura 33. Campos Enumerados do SOXControl

Há dois tipos de campos enumerados: valor único e com diversos valores.

O campo com valor único possui os seguintes itens de consulta:

<Query Item>_SYSTEM_NAMEEsse é o nome do sistema para o campo.

<Query Item>Esse é o nome localizado para o campo.

<Query Item>_IDEsse é o ID do campo.

Ao exibir o valor em um relatório, <Query Item> deverá sempre ser utilizado. Ao filtrar esse valor, utilize ocampo <Query Item>_ID porque ele está indexado.

Os campos com diversos valores possuem os seguintes itens de consulta:

<Query Item>_SYSTEM_NAMEIsso o retorna um registro para cada valor na sequência enumerada. Ele é retornado como um nomedo sistema.

<Query Item>Isso o retorna um registro para cada valor na sequência enumerada. Ele é retornado como um nomelocalizado.

<Query Item>_IDEssa é uma lista separada por barra vertical ( | ) dos IDs de valores de enumeração.

<Query Item>_SYSTEM_LISTEsta é uma lista separada por vírgula dos valores de sequência do sistema das enumerações.

<Query Item>_LISTEste é lista separada por vírgula dos valores de sequência localizados das enumerações.

Para obter uma lista separada por vírgula dos valores convertidos da sequência, o autor do relatórioprecisa selecionar o campo <Query Item>_LIST e usar isso no relatório. Esse é o melhor campo a serutilizado para exibir o valor de uma sequência enumerada com diversos valores.

Utilizando Campos Enumerados em um RelatórioÉ possível usar um campo enumerado em um relatório.


Procedimento

1. Clique na guia Origem na área de janela Objetos que Podem Ser Inseridos e selecione o item deconsulta que deseja utilizar no relatório.

2. Arraste e solte o item de consulta no relatório.

Trabalhando com Campos de DataOs campos de data são listados como itens de consulta anexados ao objeto.

No Figura 34 na página 48 é possível ver o [PR_CREATION_DATE] listado como um item de consulta.

Figura 34. Assunto de Consulta SOXProcess

Procedimento

1. Clique na guia Origem na área de janela Objetos que podem ser inseridos e selecione o item deconsulta que deseja usar no relatório.

2. Arraste e solte o item de consulta no relatório.3. Selecione o item de consulta que acabou de soltar no relatório.4. Na área de janela Propriedades em Dados, selecione Formato de Dados.5. Para formatar o campo de data, conclua as etapas a seguir.

a) Selecione Data para o Tipo de formato.b) Selecione Curta para o Estilo de Data.c) Selecione a barra (/) para o Separador de Data.d) Selecione Mês, Dia, Ano para a Ordem de Data.e) Selecione Mostrar Século (para mostrar um ano de 4 dígitos) para Exibir Anos.f) Selecione Dois Dígitos para Exibir Meses.g) Selecione Dois Dígitos para Exibir Dias.

6. Clique em OK.

Resultados

Além da formatação manual de datas, existem formatos integrados que estão localizados de acordo como código de idioma do usuário. Se você não criar um formato para um campo de data, esses formatosentrarão em vigor. Para ver os campos de data predefinidos, consulte “Traduzindo Campos de DataUsando Formatos de Data Predefinida” na página 144.

Trabalhando com Campos de MoedaÉ possível incluir campos de moeda em relatórios.

As seções a seguir descrevem como incluir campos de moeda nos relatórios.


• “Assuntos de Consulta de Moeda do Sistema” na página 49• “Estrutura da Pasta de Campos de Moeda” na página 49• “Configurando o uso dos campos de moeda em um relatório” na página 50

Assuntos de Consulta de Moeda do SistemaOs objetos de consulta de moeda do sistema estão localizados na pasta MISCELLANEOUS|CURRENCIESem um namespace e são categorizados em quaisquer taxas de câmbio ou moeda base, conformemostrado em Figura 35 na página 49.

Figura 35. Pasta de Moeda do Sistema

O assunto de consulta de taxas de câmbio inclui um registro para cada taxa de câmbio que forconfigurada no sistema. O assunto de consulta de moeda base retorna apenas um registro único com asinformações da moeda base.

A lista a seguir fornece alguns exemplos de como é possível usar objetos de moeda.

• Exibir a moeda base (código ISO) em um relatório.• Obter a taxa de câmbio mais recente para um determinado código de moeda (como uma alternativa,

você poderia usar a função do banco de dados GET_EX_RATE_ISO). Para obter detalhes, consulte“Obtendo a Taxa de Câmbio” na página 174.

• Exibir um símbolo da moeda ao invés de um código de moeda em um relatório.

Estrutura da Pasta de Campos de MoedaAlém de assuntos de consulta, cada objeto possui uma pasta contendo todos os campos de moedadefinidos para esse objeto. O Figura 36 na página 49 mostra o assunto de consulta SOXRisk com suasubpasta de campos de moeda.

Figura 36. Campos de Moeda da Conta SOX

Cada campo de moeda será localizado em sua própria pasta com cinco valores:

<Query Item>_BAO valor da moeda base do campo.

<Query Item>_BAO valor da moeda base do campo.


<Query Item>_ERA taxa de câmbio.

<Query Item>_LAO valor de moeda localizado do campo.

<Query Item>_LCO código de moeda local.

Dependendo do requisito, você seleciona o campo apropriado para o seu relatório.

Configurando o uso dos campos de moeda em um relatórioÉ possível utilizar um campo de moeda em um relatório. Configure o aplicativo para permitir o uso decampos de moeda.

Procedimento

1. Clique na guia Origem na área de janela Objetos que podem ser inseridos. Selecione o item deconsulta a ser usado no relatório.

2. Arraste e solte o item de consulta no relatório.3. Selecione o item de consulta que acabou de soltar no relatório.4. Na área de janela Propriedades em Dados, selecione Formato de Dados.5. Para formatar o campo de moeda, conclua as etapas a seguir.

a) Selecione Moeda como o Tipo de Formato.b) Selecione um formato de moeda predefinido como $(USD) ou configure o formato do item de

consulta.

6. Clique em OK.

Resultados

Além da formatação manual de moedas, os formatos construídos são incluídos e localizados com base nocódigo do idioma do usuário. Se você não criar um formato para um campo de moeda, formatos padrãoserão utilizados. Para obter informações sobre os formatos de moeda predefinidos, consulte “TraduzindoCampos de Moeda Usando Formatos Customizados” na página 146.

Incluindo PromptsA página de prompt inclui interatividade para usuários e age como um mecanismo de escopo de relatóriopara filtrar e limitar os dados recuperados.

Criando uma Página de PromptÉ possível criar uma página de prompt em seu relatório.

Procedimento

1. Crie uma página de prompt utilizando o ícone Página de Prompt de Construção na barra deferramentas.

2. No título, conclua as etapas a seguir.a) Dê um clique duplo em Dar um clique para editar o texto e insira o título do relatório.b) Na Área de Janela de Propriedade na categoria Diversos, configure a propriedade Classes para

vazia.c) Remova o título sublinhado clicando no ícone Sublinhado.

3. No rodapé, conclua as seguintes etapas.


a) Remova quaisquer botões que considerar desnecessários, selecionando o botão e clicando noícone Excluir.

b) Clique no rodapé e, em seguida, no ícone Centro para centralizar os botões na página.c) Clique nos botões restantes e configure a propriedade Cor do plano de fundo para Prata na área

de janela Propriedades.

4. Clique na guia Caixa de ferramentas na área de janela Objetos que podem ser inseridos.5. Arraste um objeto Tabela para o corpo da página de prompt. Selecione duas colunas e quantas linhas

precisar. Inclua uma linha em branco após cada prompt.6. Quando você tiver uma linha em branco entre os controles, configure a altura da célula padrão para 15

pt, e conclua as etapas a seguir.a) Selecione a célula na tabela cuja altura deseja configurar.b) Na área de janela Propriedades, em Posicionamento, selecione Tamanho e Estouro.c) Na caixa de diálogo, configure a Altura para 15 pt.d) Clique em OK.

Incluir um Prompt de Período de RelatórioÉ possível incluir um prompt de período de relatório em seu relatório.

Procedimento

1. Se você ainda não tiver uma página de prompt em seu relatório, siga as instruções em “Criando umaPágina de Prompt” na página 50.

2. Para criar seu prompt de Período de relatório, conclua as seguintes etapas.a) Arraste um Item de texto para a primeira coluna da tabela. Insira o texto para o prompt no item de

texto Período de relatório.b) Selecione a célula de tabela com o item de texto e configure o local para estar à direita

horizontalmente e verticalmente para cima.c) Coloque o texto em negrito usando o ícone Negrito.d) Arraste um objeto Prompt de valores para a segunda coluna de sua página de prompt.

O Assistente de prompt é aberto.

3. Na tela Escolher parâmetro do Assistente de Prompt, conclua as seguintes etapas.a) Selecione a opção Criar um novo parâmetro.b) Na caixa, digite um nome para o parâmetro. Por exemplo, Período de Relatório.c) Clique em Avançar.

4. Na tela Criar filtro, conclua as seguintes etapas.a) Selecione a opção Criar um filtro parametrizado.b) Na caixa Item modelo, clique no botão Navegar e navegue para o item de consulta LABELID,

conforme mostrado no exemplo a seguir:

[DEFAULT_REL]|MISCELLANEOUS|REPORTING PERIODS|[LABELS]|[LABELID]

c) Os valores a seguir são exibidos na caixa:

[DEFAULT_REL].[LABELS].[LABELID]

d) Na caixa Operador, use o sinal de igual (=) que é o padrão.e) Limpe a caixa para a opção Tornar esse filtro opcional.f) Se tiver diversas consultas em seu relatório, na caixa Aplicar filtro, selecione a consulta na qual o

filtro deverá ser aplicado.


g) Clique em Avançar.

5. Na tela Preencher controle, conclua as etapas a seguir.a) Selecione a opção Criar nova consulta.b) Na caixa Nome, digite um nome para a consulta, por exemplo, Prompt de período derelatório.

c) Na caixa Valores para exibir, clique no botão Navegar e navegue para o item de consulta NAME,conforme mostrado no exemplo a seguir:

[DEFAULT_REL]|MISCELLANEOUS|REPORTING_PERIODS|[LABELS]|[NAME]

Os valores a seguir são exibidos na caixa:

[DEFAULT_REL].[LABELS].[NAME]

d) Clique em Concluir.

Transmitindo o Parâmetro de Período de Relatório do OpenPages with WatsonO seletor Período de relatório no IBM OpenPages with Watson do usuário pode ser usado para configuraro período de relatório em um relatório. Quando o relatório é instalado no aplicativo, uma configuraçãoadicional é executada para transmitir os valores do período de relatório para o relatório.

Por exemplo, se um usuário no aplicativo OpenPages with Watson selecionar o período atual antes declicar em um relatório, essa configuração do período de relatório será transferida para o relatório nomomento em que o relatório for ativado.

Quando um relatório é ativado a partir do aplicativo, os parâmetros de período de relatório a seguir sãoenviados:

ReportingPeriodIdContém o valor do identificador para o Período de relatório selecionado.

ReportingPeriodNameContém o valor do nome para o Período de relatório selecionado.

Para filtrar relatórios, é necessário usar o parâmetro ReportingPeriodId em expressões de filtro. Seestes parâmetros forem utilizados no relatório, então não será necessário criar uma página de promptpara selecionar um Período de Relatório.

É possível tirar vantagem da configuração do período de relatório do usuário criando um filtro com aseguinte sintaxe exata inserida na Definição de expressão:

[DEFAULT_REL].[SOXBUSENTITY_GPC].[GEN_REPORTING_PERIOD_ID] = ?ReportingPeriodId?

Em seguida, o período de relatório do aplicativo é usado para filtrar o relatório. Lembre-se de que essefiltro precisará ser incluído em cada consulta no relatório.

Incluindo um Prompt de Entidade de NegóciosÉ possível incluir um prompt Entidade de negócios em seu relatório.

Procedimento


2. Para criar seu prompt Entidade de negócios, conclua as seguintes etapas.a) Arraste um Item de texto para a primeira coluna da tabela. Insira o texto para o prompt no item de

texto.


b) Selecione a célula de tabela e configure o local para estar à direita horizontalmente e verticalmentepara cima.

c) Coloque o texto em negrito usando o ícone negrito.d) Arraste um objeto Prompt de valores para a segunda coluna de sua página de prompt.

O Assistente de Prompt é aberto.

3. Na tela Escolher parâmetro do Assistente de Prompt, conclua as seguintes etapas.a) Selecione a opção Criar um novo parâmetro.b) Na caixa, digite um nome para o parâmetro. Por exemplo, Entidade de Negócios:.c) Clique em Avançar.

4. Na tela Criar filtro, conclua as seguintes etapas.a) Selecione a opção Criar um filtro parametrizado.b) Na caixa Item de modelo, clique no botão Navegar e navegue até o item de consulta a seguir:

[DEFAULT_REL]|GRC_OBJECTS|SOXBUSENTITY_FOLDER| [SOXBUSENTITY_GPC]|ID_FIELDS|[PEN_ENTITY_ID]

c) Na caixa Operador, use o sinal de igual (=) (padrão).d) Limpe a caixa para a opção Tornar esse filtro opcional.e) Se tiver diversas consultas em seu relatório, na caixa Aplicar filtro, selecione a consulta na qual o

filtro deverá ser aplicado.f) Clique em Avançar.

5. Na tela Preencher controle, conclua as seguintes etapas.a) Selecione a opção Criar nova consulta.b) Na caixa Nome, digite um nome para a consulta. Por exemplo, Consulta do Prompt de Entidade

de Negócios.c) Na caixa Valores para exibir, clique no botão Navegar e navegue até o item de consulta a seguir:

[DEFAULT_REL]|GRC_OBJECTS|SOXBUSENTITY_FOLDER| [SOXBUSENTITY_GPC]|[PEN_FULL_PATH]

d) Os valores a seguir são exibidos na caixa:

[DEFAULT_REL].[SOXBUSENTITY_GPC].[PEN_FULL_PATH]

e) Clique em Concluir.

6. Agora selecione o prompt recém-criado e, na categoria Geral na área de janela Propriedades, altere apropriedade de Selecionar IU para Caixa de Listagem.

Incluindo um Prompt de Valor Enumerado de Seleção ÚnicaSe o relatório precisar ser filtrado interativamente em um valor de sequência enumerada, será possívelutilizar um Prompt de Valor para executar esta ação. Siga este procedimento para incluir um prompt devalor enumerado no seu relatório.

Procedimento


2. Para criar seu prompt de Valor Enumerado, conclua as etapas a seguir.a) Arraste um Item de texto para a primeira coluna da tabela. Insira o texto para o prompt no item de

texto.



c) Coloque o texto em negrito usando o ícone Negrito.d) Arraste um objeto Prompt de Valor para a segunda coluna de sua página de prompt.


3. Na tela Escolher parâmetro do Assistente de Prompt, conclua as etapas a seguir.a) Selecione a opção Criar um novo parâmetro.b) Na caixa, digite um nome para o parâmetro, por exemplo, Eficácia operacional:.c) Clique em Avançar.

4. Na tela Criar filtro, conclua as etapas a seguir.a) Selecione a opção Criar um filtro parametrizado.b) Na caixa Item de modelo, clique no botão Navegar e navegue até o item de consulta a seguir:

[DEFAULT_REL]|ENUMERATIONS|SOXCONTROL(ENUMERATIONS)| [CN_OPERATING_EFFECTIVENESS]|[ENUMVALID]



5. Na tela Preencher controle, conclua as etapas a seguir.a) Selecione a opção Criar nova consulta.b) Na caixa Nome, digite um nome para a consulta, por exemplo, Eficácia Operacional PromptConsulta.

c) Na caixa Valores para exibir, clique no botão Navegar e navegue até o item de consulta a seguir:

[DEFAULT_REL]|ENUMERATIONS|SOXCONTROL(ENUMERATIONS)| [CN_OPERATING_EFFECTIVENES]|[CN_OPERATING_EFFECTIVENES]

d) Os valores a seguir são exibidos na caixa:

[DEFAULT_REL].[CN_OPERATING_EFFECTIVENES].[CN_OPERATING_EFFECTIVENES]

e) Clique em Concluir.

6. Selecione o prompt recém-criado e na categoria Geral na área de janela Propriedades, altere apropriedade Selecionar IU para Caixa de Listagem.

7. Se houver um número limitado de itens no prompt, será possível configurar a altura do prompt paraum valor que mostre apenas os prompts e nenhum espaço em branco. Conclua as seguintes etapas.a) Selecione o prompt na tabela cuja altura deseja configurar.b) Na área de janela Propriedades, em Posicionamento, selecione Tamanho e Estouro.c) Na caixa de diálogo, configure a altura para 14 pt vezes o número de linhas no prompt.d) Clique em OK.

8. O filtro produzido na consulta selecionada do relatório aparecerá como o exemplo a seguir:

[DEFAULT_REL].[CN_OPERATING_EFFECTIVENESS].[ENUMVALID] = ?Operating Effectiveness?


a) O problema com a criação do Oracle para causas anterior é que é filtro preferir o índice associado àsequência enumerada sobre um índice do sistema de melhor desempenho para unir as tabelasrelacionadas aos objetos antes e após este objeto. Para resolver esse problema, modifique o filtrocorrespondente a este prompt ao incluir + 0 (mais zero) no lado esquerdo da expressão de filtropara desativar o uso de índices neste campo.

[DEFAULT_REL].[CN_OPERATING_EFFECTIVENESS].[ENUMVALID] + 0 = ?Operating Effectiveness?


Resultados

Para obter detalhes e mais explicações, consulte a seção sobre Capítulo 5, “Otimizando o Desempenho”,na página 37.

Incluindo um Prompt de Valor Enumerado MultisseleçãoÉ possível incluir um prompt de valor enumerado de multisseleção para seu relatório.

Procedimento

1. Na página de prompt, selecione o prompt de valores recém-criado.2. Na Área de Janela de Propriedade na categoria Geral, configure o valor da propriedade

Multisseleção para Sim.3. No Explorador de Consultas, selecione a consulta na qual o filtro está localizado.4. Selecione o filtro que está relacionado a esse prompt. Altere o operador de um sinal de igual (=) para

in. Parênteses não são necessários.5. Clique em OK.6. Execute o relatório.

Resultados

Agora é possível selecionar dois valores no prompt, além de ter os links Selecionar tudo e Desmarcartudo para os usuários acessarem.

Incluindo um Valor Todos Estáticos para um Prompt de Valor Enumerado MultisseleçãoHá casos em que o cliente ocultou Selecionar todos ou Desmarcar todos os links, mas ainda deseja queseus usuários tenham a capacidade de Selecionar Todos como uma opção estática. É possível incluir umaopção estática Selecionar todos em seu relatório.

Procedimento

1. Na página de prompt, selecione o prompt de valores recém-criado.2. Na Área de Janela de Propriedade na categoria Dados, clique na propriedade Opções Estáticas e

conclua as etapas a seguir.

a) Clique no ícone Incluir.b) No diálogo Editar, configure o valor Usar para -1 e o valor Exibir para Todos.c) Clique em OK.d) Clique em OK.

3. Para configurar o valor Todos para que seja o padrão quando a página de prompt aparecer, conclua asetapas a seguir.a) Na área de janela Propriedades na categoria Geral, clique em Seleções Padrão.

b) Clique no ícone Incluir.


c) Insira -1 para o valor.d) Clique em OK duas vezes.

4. Na área de janela Propriedades, em Posicionamento, selecione Tamanho e Estouro e na caixa dediálogo, configure a altura para 56 pt.

5. No filtro para o prompt multisseleção, deve-se agora incluir ?Eficácia Operacional? = -1 nofiltro.


Resultados

Isso corrige o próprio prompt, mas também se deve corrigir o filtro. Para justificar o valor estático deTodos os recém-incluído, altere o filtro conforme mostrado no exemplo a seguir:

[DEFAULT_REL].[SOXCONTROL].[CN_OPERATING_EFFECTIVENESS_ID] in ?Operating Effectiveness? or ?Operating Effectiveness? = -1

Isso ignora o filtro com relação ao banco de dados e anula o uso do filtro para que todos os valores sejamaceitos.

Incluindo um Prompt de DataÉ possível incluir um prompt de data em seu relatório.

Procedimento


2. Para criar seu prompt Data, conclua as seguintes etapas.a) Arraste um Item de texto para a primeira coluna da tabela. Insira o texto para o prompt no item de

texto.b) Selecione a célula de tabela e configure o local para estar à direita horizontalmente e verticalmente

para cima.c) Coloque o texto em negrito usando o ícone Negrito.d) Arraste um objeto Prompt de data para a segunda coluna de sua página de prompt.

O Assistente de Prompt é aberto3. Na tela Escolher parâmetro do Assistente de Prompt, conclua as seguintes etapas.

a) Selecione a opção Criar um novo parâmetro.b) Na caixa, digite um nome para o parâmetro, por exemplo, Data de início:.c) Clique em Avançar.

4. Na tela Criar filtro, conclua as seguintes etapas.a) Selecione a opção Criar um filtro parametrizado.b) Na caixa Item de modelo, clique no botão Navegar e navegue até o item de consulta a seguir:

DEFAULT_REL|GRC_OBJECTS|[SOXCONTROL]|[CN_CREATION_DATE]



5. Selecione o prompt recém-criado e, na categoria Geral, na área de janela Propriedades, mude o valorde Selecionar IU para Caixa de edição.



Incluir um Prompt de Intervalo de DataO processo de criação de um prompt de intervalo de data requer incluir dois objetos de Prompt de Datana página de prompt (um para uma data de início e o outro para uma data de enterramento) do seurelatório e modificar um filtro para a data de encerramento.

Sobre Esta Tarefa

Por exemplo, se o usuário selecionar uma data de início de 1 de julho de 2006 e uma data deencerramento de 7 de julho de 2006 em um prompt de intervalo de data, efetivamente o filtro seráaplicado entre 1 de julho de 2006 à 0h e 7 de julho de 2006 à 0h. Para recuperar os registrosindependentemente do tempo da data de encerramento, é necessário modificar o filtro.

No exemplo a seguir, um filtro foi criado para o item de consulta [CREATED_ON] no assunto de consulta[ACTOR_AUDIT_TRAIL].

Procedimento

1. Crie um prompt de data para a data de início conforme descrito em “Incluindo um Prompt de Data” napágina 56. Utilize o nome do parâmetro de Data de Início. No Assistente de prompt, altere o operadorpara >=.

2. Da mesma forma, crie um prompt de data para a data de encerramento conforme descrito em“Incluindo um Prompt de Data” na página 56. Utilize o nome do parâmetro de Data de Encerramento.No Assistente de prompt, mude o operador para <=.

3. Na área de janela Filtros de detalhes da consulta, edite o lado direito da expressão de filtro do itemde consulta, incluindo a função _add_days(?End Date?,1) depois do operador <=. Isso asseguraque o intervalo de datas inclua a data de encerramento inteira.

Resultados

Por exemplo, [OPENPAGES_REL].[ACTOR_AUDIT_TRAIL].[CREATED_ON] <= _add_days(?EndDate?,1). A função _add_days inclui mais um dia na data de encerramento.

Incluindo um Prompt de Opções EstáticasEm alguns casos, um prompt não pode ser preenchido com valores baseados em um item de consulta.Se, por exemplo, um relatório contiver duas colunas, Status de Problema e Data do Problema, e vocêdesejar que o relatório classifique por coluna de Status do Problema ou por coluna Data do Problema,dependendo da seleção do usuário, então será necessário criar um prompt de valor que será usado comoopções estáticas (como um título da coluna).

Procedimento


2. Para criar seu prompt Estático, conclua as seguintes etapas.a) Arraste um Item de texto para a primeira coluna da tabela. Insira o texto para o prompt no item de

texto.b) Selecione a célula de tabela e configure o local para estar à direita horizontalmente e verticalmente

para cima.c) Coloque o texto em negrito usando o ícone Negrito.d) Arraste um objeto Prompt de Valores para a segunda coluna de sua página de prompt.

O Assistente de Prompt é aberto.3. Na tela Escolher parâmetro do Assistente de Prompt, conclua as etapas a seguir.

a) Selecione a opção Criar um novo parâmetro.


b) Na caixa, digite um nome para o parâmetro, por exemplo, Ordem de Classificação.c) Clique em Concluir.

4. Para incluir os valores estáticos no prompt, conclua as etapas a seguir.a) Selecione o objeto de prompt recém-criado.b) Na caixa Propriedades em Dados, clique no botão Opções Estáticas para abrir a caixa Opções

Estáticas.5. Na caixa Opções Estáticas, conclua as etapas a seguir.

a) Clique no botão Incluir para abrir a caixa Editar.b) No campo Utilizar, insira o valor a ser utilizado no filtro. Por exemplo, 1.c) No campo Exibir, insira o valor a ser exibido no prompt. Por exemplo, Status do Problema.d) Para incluir mais valores, repita as etapas a-c.

Resultados

É possível utilizar o parâmetro recém-criado, por exemplo, ordem de Classificação, para filtrar seusrelatórios. Para obter informações sobre classificação de dados, consulte “Classificando Dados” napágina 62.

Incluindo um Prompt em CascataOs prompts em cascata são prompts que são preenchidos dinamicamente com base na escolha feita noprompt anterior. Por exemplo, se escolher um Período de Relatório em um prompt, o segundo promptpoderá ser preenchido com as Entidades de Negócios que existirem nesse Período de Relatório.

Siga este procedimento para incluir um prompt em cascata em um prompt de Entidade para um períodode relatório selecionado.

Procedimento


2. Se você ainda não tiver criado um prompt de período de relatório, siga as instruções em “Incluir umPrompt de Período de Relatório” na página 51.

3. Se você ainda não tiver criado um prompt de entidade de negócios, siga as instruções em “Incluindoum Prompt de Entidade de Negócios” na página 52.

4. Selecione o prompt Período de Relatório.5. Na área de janela Propriedades do prompt Período de relatório em Geral, conclua as seguintes

etapas.a) Configure a propriedade Envio Automático para Sim.b) Se a propriedade Seleções Padrão contiver um valor padrão, remova-o.

6. Selecione o prompt Entidade de Negócios.7. Na área de janela Propriedades do prompt Entidade de negócios, configure a propriedade Origem

em cascata para o parâmetro Período de relatório do prompt Período de relatório. Isso ativará oprompt em cascata no Prompt de Entidade.

8. Na consulta Prompt de entidade de negócios, conclua as seguintes etapas.a) Assegure-se de que haja um item de consulta de período de relatório.b) Crie um filtro utilizando o item de consulta de período de relatório e o prompt ?Período de

Relatório?.

Resultados

O prompt de entidade de negócios não é preenchido porque ele está aguardando o valor ser inserido noprompt de período de relatório. Como você configura o valor de Envio Automático para Sim, assim que o


usuário selecionar um valor no prompt de Período de Relatório, a consulta do prompt de entidade denegócios será executada com o filtro de período de relatório.

Incluindo Prompts para Assuntos de ConsultaDentro do modelo de estrutura do IBM OpenPages with Watson, alguns assuntos de consulta contêmmacros de prompt.

Quando esse assunto de consulta é utilizado em um relatório, é necessário fornecer valores para essesprompts (para obter macros e valores de prompt, consulte Capítulo 4, “Estrutura de Relatório”, na página15). Por exemplo, o assunto de consulta [MODIFIED RESOURCES BY ENTITY] (localizado na pastaDEFAULT|[DEFAULT_REL]| AUDIT_TRAIL) contém macros de prompt. Ao utilizar esse assunto de consultaem um relatório, uma página de prompt é gerada.

A página de prompt gerada não é simples. Para ajudar o usuário do relatório, é possível criar sua própriapágina de prompt de relatório utilizando os nomes das macros de prompt existentes. Por exemplo, épossível criar um prompt de valores para a Entidade de Negócios utilizando o ID de entidade pai como oparâmetro de prompt de saída. Ao executar agora o relatório, primeiro é exibida a página de prompt dorelatório e, em seguida, a página de prompt gerada automaticamente com os parâmetros restantes.

É possível eliminar a página de prompt gerada automaticamente ao criar prompts para todas as macrosde prompt na consulta.

Os métodos para criar esses prompts são idênticos àqueles já descritos neste capítulo. A única diferençaé que no assistente de prompt na tela Escolher Parâmetro você seleciona a opção Usar parâmetroexistente e seleciona o prompt apropriado na lista.

Incluindo Campos Rich TextSe o texto não for HTML ou rich text, ele será exibido como texto simples no relatório. Os campos de textono IBM OpenPages with Watson podem ser configurados para exibir rich text. Uma formatação especialdeve ocorrer nos relatórios para exibir esses campos corretamente.

Procedimento

1. Abra um relatório de lista.2. Na área de janela Objetos que Podem Ser Inseridos, arraste e solte os seguintes itens de dados na

lista:

• DEFAULT|[DEFAULT_REL]|GRC_OBJECTS|SOXBUSENTITY_FOLDER| [SOXBUSENTITY_GPC]|[CEN_NAME00]

• DEFAULT|[DEFAULT_REL]|GRC_OBJECTS|[SOXPROCESS]|[PR_NAME00]• DEFAULT|[DEFAULT_REL]|GRC_OBJECTS|[SOXPROCESS]|[PR_DESCRIPTION]• DEFAULT|[DEFAULT_REL]|GRC_OBJECTS|[SOXPROCESS]|[PR_ADDITIONAL_DESCRIPTION] (This is defined as a Rich Text field)

3. Clique na guia Caixa de ferramentas na área de janela Objetos que podem ser inseridos e, emseguida, arraste e solte um Item HTML na lista.

4. Para selecionar o item HTML na lista, conclua as etapas a seguir.a) Na área de janela Propriedades em Origem HTML, configure a propriedade Tipo de Origem para

Valor do Item de Dados.b) Configure a propriedade Valor do Item de Dados para [PR_ADDITIONAL_DESCRIPTION].

5. Recorte [PR_ADDITIONAL_DESCRIPTION] da lista.6. Para selecionar o cabeçalho da coluna Item de HTML, conclua as etapas a seguir.

a) Na área de janela Propriedades em Origem de Texto, configure a propriedade Tipo de Origempara Rótulo do Item de Dados.

b) Configure a propriedade Rótulo do Item de Dados para [PR_ADDITIONAL_DESCRIPTION].


c) Execute o relatório.

Isto é formatado corretamente ao exibir o relatório em HTML, mas quando renderizar o relatório noformato PDF ou Excel, o rich text exibirá como um campo em branco. Para corrigir isso, conclua asseguintes etapas.

7. No Explorador de Consultas, abra a consulta de lista.8. Para incluir um novo Item de Dados na consulta, conclua as etapas a seguir.

a) Arraste um Item de Dados na área de janela de itens de dados.b) Insira o código a seguir na área de janela Definição de Expressão:

trim(regexp_replace([DEFAULT_REL].[SOXPROCESS].[PR_ADDITIONAL_DESCRIPTION],'<[^>]+>'))

c) Valide a expressão e, em seguida, clique em OK.9. Na área de janela Propriedades do item de dados que você acabou de incluir, conclua as etapas a

seguir.a) No grupo Dados, configure a propriedade Nome para Descrição Adicional.b) No grupo Dados, configure a propriedade Função Agregada para Nenhuma.c) No grupo Dados, configure a propriedade Função de Agregado de Sintetização para Nenhuma.

10. Acesse a página principal do relatório.11. Arraste e solte Descrição Adicional na lista.12. Na área de janela Propriedades do título da coluna de lista de Descrição Adicional, conclua as

seguintes etapas.a) Em Origem de texto, configure a propriedade Tipo de origem para Rótulo do item de dados.b) Configure o Rótulo do Item de Dados para PR_ADDITIONAL_DESCRIPTION.

13. Para criar uma variável condicional, conclua as etapas a seguir.a) No Explorador de Condição, clique em Variáveis.b) Arraste e solte uma Variável de sequência na área de janela Variáveis.c) Na área de janela Definição de expressão, insira ReportOutput () e clique em OK.

d) Utilizando o ícone Incluir, insira HTML como uma variável.e) Na área de janela Propriedades em Diversos, na propriedade Nome, insira Saída de Relatório.

14. Retorne para a página principal do relatório e conclua as seguintes etapas.a) Selecione a coluna com o item HTML.b) Utilizando o seletor anterior, selecione Coluna de Lista.c) Na área de janela Propriedades em Condicional, configure a propriedade Variável de Estilo para

Saída de Relatório.d) No Explorador de Condição, selecione Outro na variável Saída de Relatório.e) Na área de janela Propriedades em Caixa, configure a propriedade Tipo de Caixa para Nenhum.f) No Explorador de Condição, clique em (nenhuma variável).

15. Complete as seguintes etapas.a) Selecione a coluna com a <Descrição Adicional> no corpo da lista.b) Utilizando o seletor anterior, selecione Coluna de Lista.c) Na área de janela Propriedades em Condicional, configure a propriedade Variável de Estilo para

Saída de Relatório.d) No Explorador de Condição, selecione HTML na variável Saída de Relatório.e) Na área de janela Propriedades em Caixa, configure a propriedade Tipo de Caixa para Nenhum.f) No Explorador de Condição, clique em (nenhuma variável).



Resultados

O relatório terá a mesma aparência que tinha antes quando executado em formato HTML. No entanto, aoexecutar o relatório agora como um PDF, o rich text aparecerá como texto simples no relatório.

A formatação condicional que criamos mostra a coluna formatada em HTML ou a outra coluna DescriçãoAdicional quando HTML não é o formato de saída.

Neste exemplo, utilizamos um objeto HTML para exibir o rich text. Há um objeto Rich Text na caixa deferramentas, mas ele suporta apenas uma quantia extremamente limitada de propriedades de rich text, oque não recomendamos utilizá-lo.

Incluindo Imagens e ÍconesÉ possível melhorar a aparência dos seus relatórios ao incluir ícones ou um logotipo da empresa neles.

Antes de IniciarFale com seu administrador do sistema sobre como identificar o caminho do diretório de imagem corretopara sua instalação específica. Os caminhos são diferentes para os sistemas operacionais AIX, Linux eMicrosoft Windows.

A melhor prática é armazenar arquivos de imagem no diretório a seguir no servidor IBM Cognos:

• C:\<Cognos_Home>\webcontent\bi\images\<icon file name>

Use um caminho relativo:

../bi/images/<icon file name>

Os arquivos de imagem para relatórios de versões anteriores podem estar localizados nos diretórios aseguir:

• C:\<Cognos_Home>\webcontent\skins\branding\<icon file name>• C:\<Cognos_Home>\webcontent\bi\skins\branding\<icon file name>

Procedimento

1. Crie um novo relatório de lista.

2. Clique na guia Caixa de ferramentas e, então, arraste um objeto de Imagem para a primeiracoluna do relatório da lista.

3. Na barra de ferramentas, clique no ícone Bloquear para desbloquear o modelo (o ícone muda paradesbloqueado).

4. Selecione a guia Imagem.5. Na área de janela Propriedades do objeto Imagem, conclua as etapas a seguir.

a) Na categoria Origem de URL, clique na propriedade URL.b) No campo URL da imagem, insira o caminho de arquivo a seguir ../bi/images/<icon filename> para incluir um ícone no relatório. Deve-se utilizar um caminho relativo conforme mostradoneste exemplo ou o relatório não será portátil entre os sistemas. Deve-se também utilizar acapitalização correta para o nome do ícone ou eles não aparecerão corretamente em um sistemaAIX ou Linux.

c) Clique em OK.6. Na Barra de ferramentas, clique no ícone Bloquear novamente para bloquear o modelo (o ícone

muda para bloqueado).7. Execute o relatório.


Resultados

As imagens podem ser utilizadas como um link CrossTrack da mesma maneira que o objeto de hiperlinkfoi utilizado. As imagens também podem ser soltas em um hyperlink para o usuário poder clicar naimagem ou no hyperlink e obter o mesmo comportamento.

Incluindo CálculosHá dois métodos para criar cálculos na estrutura.

• É possível criar campos computados por meio do IBM OpenPages with Watson (“Criando um CampoComputado” na página 200).

• É possível criar um cálculo no arquivo de assunto de consulta customizada (“Criando Cálculos” napágina 218).

Quando os cálculos forem criados e a estrutura for gerada novamente, eles se tornam disponíveis para oautor do relatório nas pastas dos campos computados em cada namespace.

Os cálculos podem ser soltos em qualquer relatório exatamente como qualquer outro item de consulta.Eles podem ser agregados utilizando o método descrito em “Agregando Dados” na página 69.

Classificando DadosÉ possível organizar os dados em uma coluna de relatório ao especificar uma ordem de classificação. Osdados podem ser organizados em ordem crescente ou decrescente com base nos valores em qualquercoluna.

Utilizando Classificando SimplesÉ possível classificar uma coluna usando a função de classificação integrada.

Procedimento

1. Abrir um relatório.2. Clique na coluna que deseja ordenar.

3. Clique no ícone Classificação na barra de ferramentas e, em seguida, clique em Classificar emordem crescente ou Classificar em ordem decrescente.


Utilizando Classificação AvançadaA função de classificação avançada é utilizada para aplicar classificações em diversas colunas em umrelatório. Ela permite que o autor do relatório especifique a ordem da coluna e a direção de classificaçãopela qual deseja que o relatório seja classificado.

Procedimento

1. Abrir um relatório.

2. Clique no ícone Classificação na barra de ferramentas e, então, clique em Classificaçãoavançada.

3. No diálogo Classificação Avançada, determine as colunas pelas quais deseja classificar e arraste esolte-as na pasta Lista de Classificação Detalhada.

4. É possível alterar a ordem com as setas para cima e para baixo ou alterar a direção da classificação.


Resultados

Se houver grupos criados nessa lista, eles serão exibidos na pasta de grupos. A classificação dos gruposocorre antes da classificação detalhada da lista. O diálogo de classificação avançada permite criar umtipo que não seja baseado na ordem em que as colunas aparecerão no relatório.

Utilizando Classificando CustomizadaPode haver situações em que a classificação de dados em ordem crescente ou decrescente não atendeaos seus requisitos.

Sobre Esta Tarefa

Por exemplo, considere um relatório que mostra os nomes de controle e sua eficácia operacional. Ocampo Eficácia Operacional pode ter um destes valores: Efetivo, Ineficaz ou Nãodeterminado.

Se desejar mostrar os valores de controle para o campo Eficácia Operacional nesta ordem:Ineficaz, Não Determinado e Efetivo, não será possível atingir esse resultado ao classificar acoluna Eficácia Operacional em ordem crescente ou decrescente. Se a coluna for classificada emordem crescente, então os valores no relatório serão exibidos como Efetivo, Ineficaz e NãoDeterminado. Se a coluna for classificada em ordem decrescente, os valores serão exibidos como NãoDeterminado, Ineficaz e Efetivo.

Para atingir uma ordem de classificação customizada, é necessário criar um novo item de dados noAssunto de Consulta subjacente e, em seguida, classificar esse item de dados.

O exemplo a seguir demonstra como criar uma ordem de classificação customizada para o objeto decontrole do campo Eficácia Operacional em um novo relatório de lista.

Procedimento

1. Crie um novo relatório de lista com os seguintes itens de consulta:

• DEFAULT|[DEFAULT_REL]|GRC_OBJECTS|[SOXCONTROL]|[CN_NAME00]

• DEFAULT|[DEFAULT_REL]|GRC_OBJECTS|[SOXCONTROL]| ENUMERATION_FIELDS| OPERATING_EFFECTIVENES (ENUMERATION)|[CN_OPERATING_EFFECTIVENES]

• DEFAULT|[DEFAULT_REL]|GRC_OBJECTS|[SOXCONTROL]| ENUMERATION_FIELDS| OPERATING_EFFECTIVENES (ENUMERATION)| [CN_OPERATING_EFFECTIVENES_ID]

2. Execute o relatório e observe a ordem dos controles.3. Utilizando o Explorador de Consultas, selecione a consulta para a qual deseja customizar a

classificação.

4. Clique na guia Caixa de ferramentas na área de janela Objetos que podem ser inseridos e, então,arraste e solte um objeto Item de dados na caixa Itens de dados da consulta.

5. Na área de janela Definição de Expressão, insira a seguinte expressão:

Case ([CN_OPERATING_EFFECTIVENES_ID] + 0)when #$SOXCONTROL_OPERATING_EFFECTIVENES_DEFINITION_MAP {"Ineffective"}# then 1when #$SOXCONTROL_OPERATING_EFFECTIVENES_DEFINITION_MAP {"Not Determined"}# then 2 when #$SOXCONTROL_OPERATING_EFFECTIVENES_DEFINITION_MAP {"Effective"}# then 3 else 4end

6. Clique no ícone Validar para validar a expressão e, então, clique em OK.7. Na área de janela Propriedades do item de dados, conclua as etapas a seguir.

a) Em Dados, configure a propriedade Nome ao digitar um nome para o item de dados. Por exemplo,Ordem de Classificação.


b) Em Dados, configure a propriedade Função Agregada para Nenhuma.c) Em Dados, configure a propriedade Função de Agregado de Sintetização para Nenhuma.

8. Seguindo as instruções em “Utilizando Classificação Avançada” na página 62, inclua o item de dadosOrdem de Classificação na Lista de Classificação Detalhada.


Utilizando Classificação SolicitadaÉ possível classificar um relatório na coluna selecionada pelo usuário a partir da página de prompt dorelatório.

Procedimento

1. Crie um novo relatório de lista com os seguintes itens de consulta:


• DEFAULT|[DEFAULT_REL]|GRC_OBJECTS|[SOXCONTROL]| ENUMERATION_FIELDS| OPERATING_EFFECTIVENESS (ENUMERATION)|[CN_OPERATING_EFFECTIVENES]

• DEFAULT|[DEFAULT_REL]|GRC_OBJECTS|[SOXCONTROL]| ENUMERATION_FIELDS| OPERATING_EFFECTIVENESS (ENUMERATION)|[CN_DESIGN_EFFECTIVENES]

2. Crie uma página de prompt.3. Inclua um Prompt de Valores com opções estáticas na página de prompt. Para obter detalhes sobre

como incluir um prompt de valores com opções estáticas, consulte “Incluindo um Prompt de OpçõesEstáticas” na página 57. Nomeie o prompt como Ordem de Classificação.

4. Na caixa Propriedades do Prompt de Valores, inclua os seguintes valores na caixa Opções Estáticas:No campo Uso, digite isto...

No campo Exibir digite isto...1

Eficácia Operacional2

Eficácia do Design5. Utilizando o Explorador de Consultas, selecione a consulta que deseja editar.6. No Modelo Tabular, conclua as etapas a seguir.

a) Clique na guia Caixa de ferramentas e arraste um objeto de Item de dados para a área dejanela Itens de dados.

b) Na área de janela Definição de expressão, insira as seguintes expressões:

case ?Sort Order?

when 1 then [CN_OPERATING_EFFECTIVENES]

when 2 then [CN_DESIGN_EFFECTIVENESS]

end

em que:

Sort Order é o nome do parâmetro criado na etapa 3 deste exemplo.

Os valores 1 e 2 na expressão anterior são os valores de Uso que foram criados na Etapa 4. Se osvalores forem diferentes dos mostrados aqui, será necessário alterar a expressão.

7. Na área de janela Propriedades do item de dados, conclua as etapas a seguir.a) Altere o nome do item de dados para Ordem de Classificação.b) Altere a propriedade Função Agregada para Nenhuma.


c) Altere a propriedade Função de Agregado de Sintetização para Nenhuma.

8. Seguindo as instruções em “Utilizando Classificação Avançada” na página 62, inclua o item de dadosOrdem de Classificação na Lista de Classificação Detalhada.

9. Execute o relatório. Dependendo da seleção do usuário no prompt, o relatório será classificado.

Filtrando DadosÉ possível usar um filtro de relatório para focar um relatório e minimizar o tempo de processamento aoexcluir dados indesejados.

Utilizando Mapas de Parâmetro para FiltragemPara exibir, por exemplo, em um relatório apenas os objetos de controle que possuírem um valor deeficácia operacional de Efetivo, será possível aplicar um filtro no campo de sequência enumeradaEficácia Operacional.

O tipo de dados do campo Eficácia Operacional é um tipo de dados enumerados (enumeração).Como o aplicativo IBM OpenPages with Watson é totalmente internacionalizado, os valores enumeradossão convertidos para o código do idioma do usuário que efetuou login no aplicativo.

Se você fosse usar o valor de sequência Efetivo em uma expressão de filtro, como:

[CN_OPERATING_EFFECTIVENES] = 'Effective'

O valor enumerado funciona somente para o código do idioma inglês dos EUA, e não para outros códigosdo idioma. Por exemplo, se um usuário cujo código do idioma for japonês efetuar login, os valoresenumerados serão convertidos para japonês e, portanto, a definição de filtro anterior não funcionará.

Para que este filtro funcione com qualquer código de idioma, deve-se utilizar o ID do valor de sequênciaenumerada na expressão de filtro ao invés do próprio valor de sequência enumerada.

O assunto de consulta para o objeto correspondente possui dois itens de consulta, um contendo asinformações de ID para o valor de sequência enumerada e outro contendo o valor de sequênciaenumerada real.

Por exemplo, no modelo de estrutura gerado, o assunto de consulta SOXCONTROL contém dois campos:[CN_OPERATING_EFFECTIVENES_ID] e [CN_OPERATING_EFFECTIVENES].

Para filtrar o valor de sequência enumerada Efetivo para que ele funcione em todos os códigos doidioma, a expressão anterior terá de ser modificada para utilizar o ID do valor de sequência enumerada,conforme mostrado no exemplo a seguir:

[CN_OPERATING_EFFECTIVENES_ID] = 45

em que 45 é o ID do valor de sequência enumerada Efetivo para o campo do objeto EficáciaOperacional neste conjunto de dados específico. No entanto, o ID da sequência enumerada podealterar de uma implementação para outra. Na prática, o ID deve ser obtido por meio de uma página deprompt ou de um mapa de parâmetros.

Os mapas de parâmetro são criados para todos os campos enumerados de valor único ou com diversosvalores.

É possível utilizar mapas de parâmetro na expressão de filtro ao invés de localizar os IDs dos valores desequência enumerada. Por exemplo:

[CN_OPERATING_EFFECTIVENES_ID] + 0 = #$SOXCONTROL_OPERATING_EFFECTIVENES_DEFINITION_MAP{"Effective"}#

Quando o relatório é executado, a definição de mapa de parâmetro é substituída pelo ID real do valorEfetiva.


A convenção de nomenclatura para os mapas de parâmetro é mostrada no exemplo a seguir:

#$<Object Name>_<Field Name>_DEFINITION_MAP{"Value"}#

Em que <Object Name> é o nome do objeto e <Field Name> é o nome do campo enumerado.

Filtragem no ID de Período de RelatórioTodo relatório deve ser filtrado pelo ID do período de relatório (utilizando um prompt ou um filtro), amenos que o usuário deseje relatar em todos os períodos de relatório.

É possível, por exemplo, solicitar ao usuário explicitamente um período de relatório específico e filtrarpela seleção. Ou é possível filtrar pelo valor do ID de Período de Relatório -1 se o relatório estiverdisponível somente para o período de relatório atual.

Dica: Ao combinar a filtragem no ID de Período de Relatório com a filtragem na entidade, deve-se utilizaro GEN_REPORTING_PERIOD_ID como o item de filtragem para o ID de Período de Relatório.

Filtragem em uma EnumeraçãoHá dois tipos de variáveis enumeradas, valor único e com diversos valores. Para filtrar usandoenumerações, o operador do filtro deve ser alterado para acomodar o tipo de prompt que está sendoutilizado.

Tabela 41. Filtrar Operadores

Tipo deEnumeração

Tipo de Prompt Operador deFiltro

Comentários

Valor único Seleção única =

Valor único Diversas seleções em

Com diversosvalores

Seleção única contém Retorna qualquer registro que contiver ovalor no prompt.

Com diversosvalores

Diversas seleções *in Retorna todos os registros quecontiverem qualquer um dos valoresselecionados no prompt.

Para filtrar uma sequência enumerada com diversos valores em relação a um prompt multisseleção,deve-se utilizar a seguinte sintaxe para o filtro:

[DEFAULT_REL].[RI_DOMAIN].[RI_DOMAIN] in ?Domain?

Esse filtro está usando o item de dados <object_field name> da definição da cadeia enumerada dedomínio (como um exemplo) a ser comparada com relação ao prompt. Este campo retorna registrosindividuais para cada um dos domínios que o usuário pode ter selecionado no aplicativo a seremcomparados com o valor de prompt que também pode ser multisseleções.

Além disso, deve-se se certificar de que a propriedade Autoagrupamento e Resumo no assunto deconsulta que contém esse filtro esteja configurada para Sim.

Agrupando DadosÉ possível remover os valores duplicados em um relatório ao agrupar itens de consulta. Por exemplo, seum relatório contiver diversos controles para um risco e para uma entidade de negócios específica, serápossível agrupar as colunas de risco e de entidade de negócios para que apenas uma instância do risco eda entidade de negócios seja exibida na lista de cada controle.


Agrupando Dados em um Relatório de ListaÉ possível agrupar dados em um novo relatório de lista. O relatório de amostra utiliza itens de entidade denegócios, de risco e de consulta de controle e, em seguida, agrupa as colunas de entidade de negócios ede risco para remover dados duplicados.

Nota: Grupo por ID do recurso ao invés de Nome porque os IDs de Recursos são exclusivos em todo osistema, mas os nomes não são.

Procedimento

1. Crie um novo relatório de lista com os seguintes itens de consulta a partir do namespace relacionalcolocado na área de janela Itens de Dados da consulta:

• DEFAULT|[DEFAULT_REL]|GRC_OBJECTS|SOXBUSENTITY_FOLDER| [SOXBUSENTITY_GPC]|ID_FIELDS|[CEN_ENTITY_ID]


• DEFAULT|[DEFAULT_REL]|GRC_OBJECTS|[SOXRISK]| ID_FIELDS|[RI_RISK_ID]

• DEFAULT|[DEFAULT_REL]|GRC_OBJECTS|[SOXRISK]|[RI_NAME00]

• DEFAULT|[DEFAULT_REL]|GRC_OBJECTS|[SOXCONTROL]| ID_FIELDS| [CN_CONTROL_ID]


2. Agrupe os dados para as seguintes colunas:a) Selecione a coluna [CEN_ENTITY_ID].b) Clique no ícone Grupo . O ícone do grupo será exibido na coluna recém-selecionada.c) Selecione as colunas [RI_RISK_ID] e [CN_CONTROL_ID] e repita a Etapa b.

3. Recorte os seguintes itens de consulta da lista para ocultar o identificador do objeto para que nãoapareça na página do relatório:

[CEN_ENTITY_ID][RI_RISK_ID][CN_CONTROL_ID]

Importante: Ao recortar uma coluna a partir de um relatório, ela não será mostrada no relatório, masainda estará presente na consulta subjacente. Ao excluir uma coluna de um relatório, ela será excluídado relatório e da consulta subjacente se nenhum outro objeto no relatório referenciar esse item deconsulta.

4. Selecione a coluna [CEN_NAME00] e na Área de janela de propriedades, em Dados, selecioneAbrangência do grupo e configure-a como [CEN_ENTITY_ID].

5. Selecione a coluna [RI_NAME00] e na Área de janela de propriedades, em Dados, selecioneAbrangência do grupo e configure-a como [RI_RISK_ID].

6. Selecione a coluna [CN_NAME00] e na Área de janela de propriedades, em Dados, selecioneAbrangência do grupo e configure-a como [CN_CONTROL_ID].

7. Selecione a coluna [CN_DESCRIPTION] e na Área de janela de propriedades, em Dados, selecioneAbrangência do grupo e configure-a como [CN_CONTROL_ID].


Criando um Cabeçalho do Grupo de ListaÉ possível usar o nome de um objeto (como o nome de uma entidade) como um cabeçalho do grupo emum novo relatório da lista.


Sobre Esta Tarefa

O relatório de amostra utiliza itens de entidade de negócios, de risco e de consulta de controle. Emseguida, ele agrupa a entidade de negócios e as colunas de risco para remover dados duplicados, e exibeo nome da entidade a partir do assunto de consulta [CEN_NAME00] como um cabeçalho no relatório deamostra.

Procedimento

1. Siga as Etapas 1 a 3 conforme descrito em “Agrupando Dados em um Relatório de Lista” na página 67para criar um relatório de lista com agrupamentos.

2. Clique em Estrutura > Cabeçalhos e rodapés > Cabeçalhos de lista e rodapés para abrir a caixaCabeçalhos de lista e rodapés e conclua as etapas a seguir.a) Selecione CEN_NAME00(header).b) Clique em OK.

3. Na página do relatório, recorte o item de consulta [CEN_NAME00] na lista para ocultar a exibição doidentificador do objeto como uma coluna de lista no relatório.


Configurando a Extensão de Nível para uma ColunaQuando as colunas são agrupadas, é possível escolher a frequência com que os valores de coluna serãoexibidos usando a extensão de nível. Diferentemente do agrupamento, a extensão de nível não altera aconsulta subjacente.

Procedimento

1. Crie um novo relatório de lista com os seguintes itens de consulta a partir do namespace relacional:

• DEFAULT|[DEFAULT_REL]|GRC_OBJECTS|[SOXRISK]|ID_FIELDS|[RI_RISK_ID]

• DEFAULT|[DEFAULT_REL]|GRC_OBJECTS|[SOXRISK]|[RI_NAME00]

• DEFAULT|[DEFAULT_REL]|GRC_OBJECTS|[SOXRISK]| ENUMERATION_FIELDS| INHERENT_IMPACT (ENUMERATION)| [RI_INHERENT_IMPACT]

• DEFAULT|[DEFAULT_REL]|GRC_OBJECTS|[SOXRISK]| ENUMERATION_FIELDS| INHERENT_LIKELIHOOD(ENUMERATION)| [RI_INHERENT_LIKELIHOOD]

• DEFAULT|[DEFAULT_REL]|GRC_OBJECTS|[SOXCONTROL]|ID_FIELDS| [CN_CONTROL_ID]


• DEFAULT|[DEFAULT_REL]|GRC_OBJECTS|[SOXCONTROL]|ENUMERATION_FIELDS| OPERATING_EFFECTIVENES (ENUMERATION)|[CN_OPERATING_EFFECTIVENES]

2. Para editar a página do relatório, conclua as etapas a seguir.a) Recorte os seguintes itens de consulta da lista para ocultar o identificador do objeto para que não

apareça na página do relatório:

[RI_RISK_ID][CN_CONTROL_ID]

b) Agrupe os dados na coluna [RI_NAME00].3. Execute o relatório.

O [RI_NAME00] não é repetido para todos os seus controles. No entanto, [RI_INHERENT_IMPACT]e [RI_INHERENT_LIKELIHOOD], que são as propriedades do objeto de risco, são repetidos paracada objeto de controle associado no relatório gerado.


Para que os campos de risco adicionais não se repitam, conclua as etapas a seguir.4. Para que o nível estenda os itens de consulta [RI_INHERENT_IMPACT] e[RI_INHERENT_LIKELIHOOD] quando [RI_NAME00] for mudado, conclua as etapas a seguir.a) Selecione a coluna [RI_INHERENT_IMPACT] no relatório.b) Na caixa Propriedades em Dados da coluna selecionada, clique no botão Abrangência do grupo e

selecione a coluna [RI_NAME00].c) Repita as etapas a e b para a coluna [RI_INHERENT_LIKELIHOOD].

Resultados

Os campos de risco adicional agora estendem o campo de nome de risco.

Agregando DadosAgregações são utilizadas para agrupar e resumir dados numéricos. As técnicas descritas aqui sãoutilizadas não só para produzir os resultados desejados, mas também fazer com que uma SQL eficienteseja gerada pelo CommandCenter.

Sobre Esta Tarefa

Siga este procedimento para contar o número de controles Efetivo, Ineficaz e Não determinadoque estiverem presentes diretamente em uma entidade e, em seguida, a porcentagem total de controlesIneficaz para essa entidade.

Procedimento

1. Crie um novo relatório de lista.2. Para criar uma consulta-filha, conclua as etapas a seguir.

a) No Explorador de Consultas, abra a consulta.b) Na área de janela Propriedades em Diversos, configure o nome para listMain.c) Retorne ao Explorador de Consultas e selecione a pasta de nível superior Consultas.

d) Clique na guia Caixa de ferramentas .e) Arraste um objeto Consulta ao lado da consulta listMain.f) Selecione o novo objeto de consulta.g) Na área de janela Propriedades em Diversos, configure o Nome para listMain1.

3. Para incluir outro objeto de consulta-filha para o objeto de consulta criado na etapa anterior, concluaas etapas a seguir.a) Arraste um objeto de Consulta para o lado da consulta listMain1.b) Selecione o novo objeto de consulta.c) Na área de janela Propriedades em Diversos, configure o Nome para listMain2.

4. Para incluir itens de consulta na consulta listMain2 que você criou na etapa anterior, conclua asseguintes etapas.a) Selecione a consulta listMain2 para abri-la.

b) Clique na guia Origem na área de janela Objetos que podem ser inseridos.c) Arraste os itens de consulta a seguir para a caixa Itens de Dados:





• DEFAULT|[DEFAULT_REL]|GRC_OBJECTS|[SOXCONTROL]|ENUMERATION_FIELDS| OPERATING_EFFECTIVENESS (ENUMERATION)| [CN_OPERATING_EFFECTIVENES_ID]

5. Para incluir um item de dados no objeto de consulta, conclua as etapas a seguir.

a) Clique na guia Caixa de ferramentas .b) Arraste um objeto Item de Dados para a caixa Itens de Dados da consulta.c) Na área de janela Definição de Expressão do item de dados, insira a seguinte expressão:

if([CN_OPERATING_EFFECTIVENES_ID] + 0 = #$SOXCONTROL_OPERATING_EFFECTIVENES_DEFINITION_MAP{"Effective"}#) then(1) else (0)

d) Clique no ícone Validar para validar a expressão e, então, clique em OK.6. Na área de janela Propriedades do item de dados, conclua as etapas a seguir.

a) Altere a propriedade Nome do item de dados para Efetiva.b) Altere a propriedade Função Agregada para Nenhuma.

7. Repita as Etapas 5 e 6 para criar mais dois itens de dados: um para Ineficaz e outro para NãoDeterminado. Assegure-se de alterar o valor da chave do mapa do parâmetro apropriadamentepara cada novo item de dados.

8. No menu Executar, clique em Visualizar Dados Tabulares para visualizar os dados de listMain2.O relatório é executado apenas no nível do objeto listMain2. As colunas Efetivo, ineficaz e Nãodeterminado são preenchidas com 1s e 0s, dependendo da efetividade operacional do controle.

9. Para agregar os dados no objeto listMain1 ao contar o número total de controles com base em suaeficácia operacional de cada entidade, conclua as etapas a seguir.a) No Explorador de Consultas, clique na consulta listMain1.b) Clique na guia Origem e arraste e solte os itens de consulta [CEN_ENTITY_ID] e[CEN_NAME00] na caixa Itens de dados de listMain2.

c) Altere a propriedade Função Agregada de cada item de dados para Nenhuma.

d) Clique na guia Caixa de ferramentas e, então, arraste um objeto de Item de dados para acaixa Itens de dados do modelo tabular.

e) Na área de janela Definição de Expressão, insira a seguinte expressão:

total([listMain2].[Effective] for [listMain2].[CEN_ENTITY_ID])

10. Na área de janela Propriedades do item de dados recém-criado, conclua as etapas a seguir.a) Altere a propriedade Nome do item de dados para Contagem Efetiva.b) Altere a propriedade Função Agregada para Nenhuma.

11. Repita as Etapas 9 e 10 para criar mais dois itens de dados para contagem de controles: um paraIneficaz e outro para Não Determinado.

12. Para calcular a porcentagem de controles ineficazes, conclua as etapas a seguir.

a) Clique na guia Caixa de ferramentas .b) Arraste um Item de Dados para a caixa Itens de Dados.

13. Na área de janela Propriedades do item de dados recém-criado, conclua as etapas a seguir.a) Altere a propriedade Nome para Porcentagem Ineficaz.b) Altere a propriedade Função Agregada para Nenhuma.c) Altere a propriedade Função de Agregado de Sintetização para Nenhuma.


d) Na área de janela Definição de Expressão, crie a seguinte expressão:

[Ineffective Count] / ([Effective Count] +[Ineffective Count] + [Not Determined Count]))

14. No menu Executar, clique em Visualizar Dados Tabulares para visualizar os dados de nível tabulardo objeto listMain1.

15. Para preencher a consulta listMain, conclua as etapas a seguir.a) No Explorador de Consultas, selecione na consulta listMain.

b) Na guia Origem , arraste os itens de consulta a seguir para a área de janela Itens de Dados daconsulta:

• [CEN_NAME00]• [CEN_ENTITY_ID]• [Effective Count]• [Ineffective Count]• [Not Determined Count]• [Percent Ineffective]

16. Na área de janela Propriedades de cada um dos itens de dados anteriores, altere a propriedadeFunção Agregada para Nenhuma.

17. Para preencher a página do relatório com itens de consulta, conclua as etapas a seguir.a) No Explorador de Página, selecione a página do relatório para abri-la.

b) Na área de janela Objetos que podem ser inseridos, selecione a guia Itens de consulta e,então, arraste e solte os itens de consulta a seguir na lista de objetos do listMain:

• [CEN_NAME00]• [CEN_ENTITY_ID]• [Effective Count]• [Ineffective Count]• [Undetermined Count]• [Percent Ineffective]

c) Selecione a coluna [Percent Ineffective] no objeto de lista.d) Dê um clique duplo na caixa Formato de Dados na área de janela Propriedade.e) Configure o Tipo de Formato para Porcentagem.f) Configure a propriedade Símbolo de Porcentagem para o símbolo de porcentagem (%).g) Clique em Ok.


Resultados

O relatório parece ter linhas duplicadas para várias entidades de negócios. Com base no campo[CEN_ENTITY_ID], elas são, na realidade, entidades conectadas a diferentes nós folha da hierarquia deentidade de negócios.

Uma melhor forma para exibir o nome da linha é utilizar a variável full_path ao invés do nome do filho. Avariável full_path exibe o caminho inteiro da entidade de negócios até o nó folha com todos os nósintermediários.

Utilizando Formatação CondicionalAs seções a seguir descrevem como usar a formatação condicional.


Utilizando Formatação Condicional para Entradas de IndentaçãoSiga este procedimento para indentar nomes de entidade dependendo de seu nível.

Procedimento

1. Crie um novo relatório de lista.2. No Explorador de Consultas, abra a consulta.3. Na área de janela Propriedades em Diversos, configure o nome para listMain.4. Inclua os seguintes itens de consulta:



• DEFAULT|[DEFAULT_REL]|GRC_OBJECTS|SOXBUSENTITY_FOLDER| [SOXBUSENTITY_GPC]|[CEN_FULL_PATH]

5. Recorte os seguintes itens de consulta do relatório:

• [CEN_ENTITY_ID]• [CEN_FULL_PATH]

6. Para configurar a ordem de classificação no item de dados [CEN_FULL_PATH], conclua as etapas aseguir.a) Selecione qualquer item no objeto de lista.

b) Clique no ícone Classificar na barra de ferramentas e, em seguida, clique em ClassificaçãoAvançada.

c) No diálogo Agrupamento e classificação, arraste e solte [CEN_FULL_PATH] na pasta Lista declassificação de detalhes.

d) Clique em Ok.

7. Selecione a consulta listMain a partir do Explorador de Consultas.

8. Clique na guia Caixa de ferramentas e arraste um Item de dados para o Itens de dados.

Nota: Se você tem um banco de dados IBM Db2, deve-se substituir a função INSTR do Oracle naexpressão de amostra a seguir pela função DB2 correspondente.

Na área de janela Definição de Expressão, insira a seguinte expressão:

case INSTR([CEN_FULL_PATH], '/', 1, 2) when 0 then 1 else (case INSTR([CEN_FULL_PATH], '/', 1, 3) when 0 then 2 else (case INSTR([CEN_FULL_PATH], '/', 1, 4) when 0 then 3 else (case INSTR([CEN_FULL_PATH], '/', 1, 5) when 0 then 4 else (case INSTR([CEN_FULL_PATH], '/', 1, 6) when 0 then 5 else (case INSTR([CEN_FULL_PATH], '/', 1, 7) when 0 then 6 else (case INSTR([CEN_FULL_PATH], '/', 1, 8) when 0 then 7 end) end) end)


end) end) end)End

9. Na área de janela Propriedades, configure a propriedade Nome do novo item de dados para Nível.10. Para tornar o item de dados Nível uma propriedade da lista, conclua as etapas a seguir.

a) Selecione o objeto Lista na página principal do relatório.b) Na área de janela Propriedades em Dados, dê um clique duplo em Propriedades.c) Selecione [Level].d) Clique em OK

11. Abra o Explorador de condição e clique em Variáveis.12. No diálogo Variáveis, conclua as etapas a seguir.

a) Arraste e solte um objeto Variável de sequência na área de janela Variáveis.b) Arraste o item de consulta Nível para a área de janela Definição de Expressão.c) Clique em OK.

13. Na área de janela Propriedades em Diversos, configure a propriedade Nome para IndentarVariável.

14. Na Área de janela Valores, conclua as etapas a seguir.

a) Clique no ícone Incluir e insira 1 na caixa de diálogo.b) Repita a etapa a para todos os níveis de 2 a 7.

15. Selecione a página principal do relatório no Explorador de Página.16. Na página do relatório, selecione [CEN_NAME00] e na caixa Propriedades, conclua as etapas a

seguir.a) Clique na propriedade Variável de Estilo e selecione a variável Indentar Variável.b) Clique em OK.

17. Para aumentar a indentação para diferentes níveis de entidades, conclua as etapas a seguir.a) Selecione a coluna [CEN_NAME00].b) Passe o ponteiro do mouse sobre a barra Explorador Condicionalc) Selecione o valor da variável 2 que está presente na variável Indentar Variável. A barra do

explorador ficará verde indicando que você está configurando o valor de uma variável.d) Na área de janela Propriedades em Caixa, clique na propriedade Preenchimento e insira um

valor de 50 px para a célula de preenchimento à esquerda e clique em OK.e) Repita as Etapas c-d e selecione diferentes valores de Indentar Variável e insira os valores de

aumento para o preenchimento à esquerda.f) No Explorador de Condição, clique em (Nenhuma variável).


Destacando Dados CondicionalmenteÉ possível destacar condicionalmente algumas linhas de dados quando esses dados atenderemdeterminados critérios.

Sobre Esta Tarefa

O exemplo a seguir é baseado no relatório que foi criado no “Agregando Dados” na página 69. Esteexemplo mostra como destacar condicionalmente a coluna [Percent Ineffective].

Neste exemplo, a cor do plano de fundo de uma célula altera com base na porcentagem de um controleineficaz. Se a porcentagem dos controles ineficazes for maior que 50%, a cor do plano de fundo da célula


será vermelha, se a porcentagem estiver entre 20% e 50%, a cor do plano de fundo da célula seráamarela, e se a porcentagem for menor que 20%, a cor do plano de fundo da célula será verde.

Procedimento

1. Abra o relatório criado no “Agregando Dados” na página 69.2. Abra o Explorador de condição e clique em Variáveis.3. No diálogo Variáveis, conclua as etapas a seguir.

a) Arraste e solte um objeto Variável de Sequência na área de janela Variáveis.b) Na área de janela Definição de Expressão, insira a seguinte expressão:

if([Percent Ineffective] >= 0.5)then (3)else if ( [Percent Ineffective] < 0.5 and [Percent Ineffective] > 0.2)then (2)else if ( [Percent Ineffective] <= 0.2)then (1)else (0)

c) Clique em OK.

4. Na área de janela Propriedades em Diversos, configure a propriedade Nome para Destacar Variável.

5. Na área de janela Valores, clique no ícone Incluir e insira 3 na caixa de diálogo. Repita para 2, 1 e0.

6. Selecione a página principal do relatório no Explorador de Página.7. Na página do relatório, selecione [Percent Ineffective] e na caixa Propriedades, conclua as

etapas a seguir.a) Clique na propriedade Variável de Estilo e selecione a variável Destacar Variável.b) Clique em OK.

8. Para definir as cores para os valores diferentes, conclua as etapas a seguir.a) Selecione a coluna [Percent Ineffective].b) Passe o ponteiro do mouse sobre a barra Explorador Condicionalc) Selecione o valor da variável 1 que está presente na variável Indentar Variável. A barra do explorer

ficará verde, indicando que você está configurando o valor de uma variável.d) Na área de janela Propriedades em Cor e Plano de Fundo, configure a propriedade Cor do Plano

de Fundo para Verde.e) Repita as etapas c-d para cada valor da variável 2 e 3 e, em seguida, configure a propriedade Cor

do Plano de Fundo para Amarelo e Vermelho, respectivamente.f) No Explorador de Condição, clique em (Nenhuma variável).


Resultados

No relatório, os valores que forem menores que 20% são destacados em verde, e os valores que foremmaiores que 20% e menores que 50% são destacados em amarelo.

Cores do gráfico de barrasAo representar dados em gráficos de barras, os autores do relatório devem controlar a consistência dascores de modo que cores específicas signifiquem a mesma coisa em um determinado relatório toda vezque os usuários executarem esse relatório.

Essa seção contrasta duas técnicas que podem ser utilizadas para criar relatórios de gráfico de barras.Para ilustrar os resultados das cores do gráfico de barras de cada método, o campo Eficácia operacional


do objeto de controle é usado com todos ou alguns de seus valores correspondentes (Efetivo, Ineficaz,Não determinado) nos exemplos a seguir.

Método 1

Este método exibe automaticamente valores que são incluídos no campo Eficácia operacional noesquema (os valores não são mapeados). No entanto, as cores desses valores nos relatórios são exibidasde forma inconsistente.

Por exemplo, há duas entidades de negócios: BE1 e BE2. A lista a seguir mostra o campo Eficáciaoperacional para essas entidades de negócios.

BE1Efetivo, Ineficaz, Não determinado

BE2Ineficaz, Não determinado

Quando um usuário executa o relatório para cada entidade de negócios, as cores da barra resultantes dosvalores são inconsistentes:

BE1Efetivo = preto, Ineficaz = rosa, Não determinado = púrpura

BE2Ineficaz = preto, Não determinado = rosa

Para obter informações adicionais, consulte “Exibir Variação de Cor da Barra com Valores ExibidosAutomaticamente” na página 75.

Método 2

Este método usa uma técnica de mapeamento de parâmetro e requer que o relatório de gráfico de barrasseja modificado quando novos valores forem incluídos, por exemplo, para o campo Eficácia operacionalno esquema. No entanto, as cores são exibidas de modo consistente nos relatórios para os valores quesão mapeados.

Usando as mesmas duas entidades de negócios com os mesmos valores em Eficácia operacional comono exemplo no Método 1, os resultados usando o Método 2 são diferentes.

Quando um usuário executa o relatório para cada entidade de negócios, as cores da barra resultantes dosvalores são consistentes:

BE1Efetivo = preto, Ineficaz = rosa, Não determinado = púrpura

BE2Ineficaz = rosa, Não determinado = púrpura

Para obter informações adicionais, consulte “Exibindo Consistência de Cor da Barra com Modificação deRelatório para Novos Valores” na página 76.

Exibir Variação de Cor da Barra com Valores Exibidos AutomaticamenteAo exibir valores de forma automática, é possível exibir variações de cor da barra.

Procedimento

1. Para criar um novo relatório de gráfico, conclua as etapas a seguir.a) Selecione o agrupamento de Gráfico de Coluna.b) Selecione o tipo de gráfico Coluna.c) Clique em OK.



• Categorias (eixo-x)

DEFAULT|[DEFAULT_REL]|GRC_OBJECTS|SOXBUSENTITY_FOLDER| [SOXBUSENTITY_GPC]|[CEN_NAME00]

• Measures (y-axis)

DEFAULT|[DEFAULT_REL]|GRC_OBJECTS|[SOXCONTROL]|ID_FIELDS| [CN_CONTROL_ID]

• Série

DEFAULT|[DEFAULT_REL]|GRC_OBJECTS|[SOXCONTROL]|ENUMERATION_FIELDS| OPERATING_EFFECTIVENES (ENUMERATION)|[CN_OPERATING_EFFECTIVENES]

3. No Explorador de Consultas, selecione a consulta e na área de janela Propriedades em Diversos,configure o nome para chartMain.

4. Na área de janela Itens de dados, selecione [CN_CONTROL_ID] e conclua as etapas a seguir.a) Na área de janela Propriedades em Item de Dados, altere o valor da propriedade Função

Agregada para Contagem Distinta.b) Na área de janela Propriedades em Item de Dados, altere o valor da propriedade Função de

Agregado de Sintetização para Automática.


6. Dê um clique duplo no título e configure o valor para Eficácia Operacional.7. Abra Títulos do Eixo e conclua as seguintes etapas.

a) Selecione o título do eixo x na área de janela Propriedades.b) Em Geral, configure a propriedade Título Padrão para Nenhum.c) Dê um clique duplo no título do eixo e configure o valor para Entidade de Negócios.d) Repita as etapas a-c para o eixo y e configure o valor para Contagem de Controle.

8. Selecione (Título da Legenda Padrão) e conclua as seguintes etapas.a) Na área de janela Propriedades em Geral, configure a propriedade Título Padrão para Nenhum.b) Dê um clique duplo no título da legenda e configure o valor para Eficácia Operacional de Controle.


Exibindo Consistência de Cor da Barra com Modificação de Relatório para Novos ValoresQuando um relatório é modificado com novos valores, é possível exibir a cor da barra de formaconsistente.

Procedimento

1. Crie um novo relatório de gráfico e conclua as seguintes etapas.a) Selecione o agrupamento de Gráfico de Coluna.b) Selecione o tipo de gráfico Coluna.

2. Para criar uma consulta-filha, conclua as etapas a seguir.a) No Explorador de Consultas, selecione consultas.b) Selecione Query1 e, na área de janela Propriedades em Diversos, configure o nome para

listMain.

c) Clique na guia Caixa de Ferramentas.d) Arraste um objeto Consulta para a consulta graphMain.e) Selecione o novo objeto de consulta.


f) Na área de janela Propriedades em Diversos, configure o Nome para graphMain1.

3. Para incluir itens de consulta na consulta graphMain1 que você criou na etapa anterior, conclua asseguintes etapas.a) Selecione a consulta graphMain1 para abri-la.

b) Clique na guia Origem na área de janela Objetos que Podem Ser Inseridosc) Arraste os itens de consulta a seguir para a caixa Itens de Dados:


• DEFAULT|[DEFAULT_REL]|GRC_OBJECTS|SOXBUSENTITY_FOLDER| [SOXBUSENTITY_GPC]|ID_FIELDS| [CEN_ENTITY_ID]


• DEFAULT|[DEFAULT_REL]|GRC_OBJECTS|[SOXCONTROL]|ENUMERATION_FIELDS| OPERATING_EFFECTIVENES (ENUMERATION)| [CN_OPERATING_EFFECTIVENES_ID]

4. Conclua as seguintes etapas.

a) Clique na guia Caixa de Ferramentas.b) Arraste um objeto Item de Dados para a caixa Itens de Dados da consulta.c) Na área de janela Definição de Expressão do item de dados, insira a seguinte expressão:

if([CN_OPERATING_EFFECTIVENES_ID] = #$SOXCONTROL_OPERATING_EFFECTIVENES_DEFINITION_MAP{"Effective"}#) then(1) else (0)

d) Valide a expressão e, em seguida, clique em OK.

5. Na área de janela Propriedades do item de dados, conclua as etapas a seguir.a) Altere a propriedade Nome do item de dados para Efetiva.b) Altere a propriedade Função Agregada para Nenhuma.

6. Repita as Etapas 5 e 6 para criar mais dois itens de dados: um para Ineficaz e outro para NãoDeterminado. Assegure-se de alterar o valor da chave do mapa do parâmetro apropriadamentepara cada novo item de dados.

7. No menu Executar, clique em Visualizar Dados Tabulares para visualizar os dados de graphMain1.O relatório é executado somente no nível do objeto graphMain1. Observe que as colunas Efetivo,Ineficaz e Não determinado são preenchidas com 1s e 0s, dependendo de eficácia operacional docontrole.

8. Para agregar os dados no objeto graphMain1 ao contar o número total de controles com base em suaeficácia operacional de cada entidade, conclua as etapas a seguir.a) No Explorador de Consultas, clique na consulta graphMain.b) Arraste e solte os itens de consulta [CEN_ENTITY_ID] e [CEN_NAME00] na caixa Itens de

dados de graphMain.c) Altere a propriedade Função Agregada de cada item de dados para Nenhuma.d) Arraste e solte os itens de consulta [Effective] e [Ineffective] e [Not Determined] na

caixa Itens de dados de graphMain.e) Altere a propriedade Função Agregada de cada item de dados para Total.





[CEN_NAME00]

• Measures (y-axis)

[Effective][Ineffective][Not Determined]

11. Dê um clique duplo no título e configure o valor para Eficácia Operacional.12. Abra Títulos do Eixo e conclua as seguintes etapas.

a) Selecione o título do eixo x.b) Na área de janela Propriedades, em Geral, configure a propriedade Título Padrão para Nenhum.c) Dê um clique duplo no título do eixo e configure o valor para Entidade de Negócios.d) Repita as etapas a-c para o eixo y e configure o valor para Contagem de Controle.

13. Selecione (Título da Legenda Padrão) e conclua as seguintes etapas.a) Na área de janela Propriedades em Geral, configure a propriedade Título Padrão para Nenhum.b) Dê um clique duplo no título da legenda e configure o valor para Eficácia Operacional de

Controle.


Editando as Cores da BarraSiga este procedimento para configurar as cores que o gráfico utilizará.

Procedimento

1. Selecione o objeto Gráfico de Combinação no relatório.2. Na área de janela Propriedades na categoria Cor e Plano de Fundo, clique na propriedade Paleta.3. Usando as setas Para cima e Para baixo, mova as barras Verde, Amarela e Vermelha para o início da

paleta.4. Clique em OK.5. Execute o Relatório.

Criando JunçõesA seção descreve como criar os dois tipos de junções que são comuns ao criar relatórios: junções diretasem que obtemos apenas objetos secundários que estão diretamente relacionados ao objeto principal, ejunções indiretas em que vemos todos os objetos secundários que podem acumular no objeto principal.

Criando Junções DiretasPara criar uma junção direta, deve-se criar um relatório de entidades para as emissões.

Procedimento

1. Crie um novo relatório de lista.2. No Explorador de Consultas, selecione consultas.3. Arraste e solte dois objetos de Consulta adicionais na área de janela à direita.4. Nomeie as consultas listMain, Entidade e Problema.5. Selecione a consulta Problema.6. Arraste os itens de consulta a seguir para a caixa Itens de Dados:


• DEFAULT|[DEFAULT_REL]|GRC_OBJECTS_STANDALONE|[SOXISSUE]| [IS_NAME00]

• DEFAULT|[DEFAULT_REL]|GRC_OBJECTS_STANDALONE|[SOXISSUE]| [IS_DESCRIPTION]

• DEFAULT|[DEFAULT_REL]|GRC_OBJECTS_STANDALONE|[SOXISSUE]| PARENT_CONTEXT|SOXBUSENTITY_CHILD|[CEN_ENTITY_ID]

• DEFAULT|[DEFAULT_REL]|GRC_OBJECTS_STANDALONE|[SOXISSUE]| PARENT_CONTEXT|SOXBUSENTITY_CHILD|[CEN_REPORTING_PERIOD_ID]

7. Selecione a consulta Entidade no Explorador de Consultas.8. Arraste os itens de consulta a seguir para a caixa Itens de Dados:

• DEFAULT|[DEFAULT_REL]|GRC_OBJECTS|SOXBUSENTITY_FOLDER| [SOXBUSENTITY_GPC]|[GEN_NAME00]

• DEFAULT|[DEFAULT_REL]|GRC_OBJECTS|SOXBUSENTITY_FOLDER| [SOXBUSENTITY_GPC]|[GEN_FULL_PATH]


• DEFAULT|[DEFAULT_REL]|GRC_OBJECTS|SOXBUSENTITY_FOLDER| [SOXBUSENTITY_GPC]|ID_FIELDS|[CEN_REPORTING_PERIOD_ID]

9. No Explorador de Consultas, selecione consultas.10. Arraste e solte uma Junção ao lado da consulta listMain e, em seguida, preencha a junção com as

consultas Entidade e Problema.11. Clique duas vezes na junção e conclua as seguintes etapas.

a) Clique em Novo Link.b) Selecione [CEN_REPORTING_PERIOD_ID] em ambas as colunas.c) Clique em Novo Link.d) Selecione [CEN_ENTITY_ID] em ambas as colunas.e) Clique em OK.

12. Selecione a consulta listMain.13. Arraste e solte os itens de consulta a seguir na área de janela Objetos que podem ser Inseridos:

• GEN_FULL_PATH• IS_NAME00• IS_DESCRIPTION

14. Configure as propriedades Função agregada e a Função de Agregado de Sintetização paraNenhuma para todos os três itens de dados.

15. Acesse a página principal do relatório e posicione os três itens de dados na lista.16. Execute o relatório.

Resultados

É possível ver os seguintes itens no relatório:

• Somente problemas que estão diretamente ligados a entidades são mostrados.• Na realidade há apenas dois problemas aqui, ISS-012-01 unido à entidade Serviços de Agência em

EMEA e ISS-012-03 unido à entidade Serviços de Agência em Asia Pac.


• Como estamos mostrando o caminho completo do avô, podemos ver todas as entidades que seacumulam na entidade de nível superior do Global Financial Services. Isso dá a impressão de que osproblemas estão conectados em três locais, mas não estão.

• Se exibirmos o caminho completo do filho ao invés do caminho completo do avô, veremos somente osdois problemas ligados diretamente às suas entidades.

Criando Junções IndiretasJunções indiretas são utilizadas para obter todos os objetos secundários que estiverem relacionadosdireta e indiretamente ao tipo de objeto primário.

No “Criando Junções Diretas” na página 78 era possível obter apenas problemas ligados diretamente aentidades. Nesta tarefa, obteremos todos os problemas ligados diretamente a entidades e qualquer outroobjeto que possuir problemas ligados a entidades.

Procedimento

1. Crie um novo relatório de lista.2. No Explorador de Consultas, selecione consultas.3. Arraste e solte para obter objetos de Consulta adicional na área de janela à direita.4. Nomeie as consultas listMain, Entidade e Problema.5. Selecione a consulta Problema.6. Arraste os itens de consulta a seguir para a caixa Itens de Dados:

• DEFAULT|[DEFAULT_REL]|GRC_OBJECTS_STANDALONE|[SOXISSUE]| [IS_NAME00]

• DEFAULT|[DEFAULT_REL]|GRC_OBJECTS_STANDALONE|[SOXISSUE]|

• DEFAULT|[DEFAULT_REL]|GRC_OBJECTS_STANDALONE|[SOXISSUE]| ID_FIELDS|[IS_ISSUE_ID]

• DEFAULT|[DEFAULT_REL]|GRC_OBJECTS_STANDALONE|[SOXISSUE]| ID_FIELDS|[IS_REPORTING_PERIOD_ID]

7. Selecione a consulta Entidade no Explorador de Consultas.8. Arraste os itens de consulta a seguir para a caixa Itens de Dados:

• DEFAULT|[DEFAULT_REL]|GRC_OBJECTS|SOXBUSENTITY_FOLDER| [SOXBUSENTITY_GPC]|[GEN_NAME00]

• DEFAULT|[DEFAULT_REL]|GRC_OBJECTS|SOXBUSENTITY_FOLDER| [SOXBUSENTITY_GPC]|[GEN_FULL_PATH]


9. No Explorador de Consultas, selecione consultas.10. Arraste e solte uma Junção ao lado da consulta listMain e, em seguida, preencha a junção com as

consultas Entidade e Problema.11. Clique duas vezes na junção e conclua as seguintes etapas.

a) Clique em Converter em Expressão.b) Insira o código a seguir na Definição de expressão.

"OP_RPS_AUX.IS_REL_PARENT_CHILD"([Entity].[CEN_ENTITY_ID],[Issue].[IS_ISSUE_ID], [Entity].[CEN_REPORTING_PERIOD_ID]) = 'Y' and[Entity].[CEN_REPORTING_PERIOD_ID] = [Issue].[IS_REPORTING_PERIOD_ID]


c) Clique em OK.

12. Selecione a consulta listMain.13. Arraste e solte os itens de consulta a seguir na área de janela Objetos que podem ser Inseridos:

• GEN_FULL_PATH• IS_NAME00• IS_DESCRIPTION

14. Configure as propriedades Função agregada e a Função de agregado de sintetização paraNenhuma para todos os três itens de dados.

15. Acesse a página principal do relatório e posicione os três itens de dados na lista.16. Execute o relatório.

Resultados

Há muito mais problemas ligados à entidade Global Financial Services de nível superior, uma vez quequalquer problema que puder ser relacionado por meio de qualquer objeto ligado a uma entidade serámostrado devido ao modo com que alteramos a junção.

Dica: Se criar uma junção indireta, os dados retornados serão do modelo de objeto definido no aplicativoe não serão limitados pelos objetos no namespace.

Criando Relatórios de Drill ThroughSiga este procedimento para criar relatórios de drill through.

É possível anexar diferentes sub-relatórios a vários lugares diferentes em um relatório, como na legendaou em uma barra de um gráfico. Também é possível anexar múltiplos relatórios de drill through aomesmo item de dados e fornecer ao usuário uma opção de qual deles selecionar.

Importante: Relatórios relacionais podem realizar drill through apenas para outro relatório relacional.

Criando o Relatório-PaiSiga este procedimento para criar um relatório-pai.

Procedimento

1. Crie um novo relatório de crosstab.2. Inclua um prompt de entidade de negócios conforme descrito em “Incluindo um Prompt de Entidade

de Negócios” na página 52. Utilize GEN_ENTITY_ID como o campo para a origem dos dados. Suaconsulta de crosstab deve ter o seguinte filtro após criar o prompt:

[DEFAULT_REL].[SOXBUSENTITY_GPC].[GEN_ENTITY_ID] = ?Entity ID?

3. Utilizando o Explorador de Consultas, selecione a consulta para a crosstab.4. Na área de janela Objetos que Podem Ser Inseridos, arraste e solte os seguintes itens de dados na

área de janela Itens de Dados da crosstab:

• DEFAULT|[DEFAULT_REL]|GRC_OBJECTS|SOXBUSENTITY_FOLDER| [SOXBUSENTITY_GPC]| [PEN_NAME00]

• DEFAULT|[DEFAULT_REL]|GRC_OBJECTS|SOXBUSENTITY_FOLDER| [SOXBUSENTITY_GPC]| ID_FIELDS|[PEN_ENTITY_ID]


• DEFAULT|[DEFAULT_REL]|GRC_OBJECTS|[SOXCONTROL]|ENUMERATION_FIELDS| OPERATING_EFFECTIVENES (ENUMERATION)|[CN_OPERATING_EFFECTIVENES]


• DEFAULT|[DEFAULT_REL]|GRC_OBJECTS|[SOXCONTROL]|ENUMERATION_FIELDS| OPERATING_EFFECTIVENES (ENUMERATION)| [CN_OPERATING_EFFECTIVENES_ID]

5. Selecione CN_CONTROL_ID e, na área de janela Propriedades, conclua as etapas a seguir.a) Na categoria Item de Dados, configure a propriedade Função Agregada para Contagem Distinta.b) Na categoria Item de Dados, configure a Função de Agregado de Sintetização para Automática.

6. Retorne à página principal do relatório.7. Para preencher a tabulação cruzada, conclua as etapas a seguir.

a) Arraste e solte o campo [CN_OPERATING_EFFECTIVENES] na área de colunas na guia Itens deDados da área de janela Objetos que Podem Ser Inseridos.

b) Arraste e solte o campo [PEN_NAME00] na área de linhas na guia Itens de Dados da área de janelaObjetos que Podem Ser Inseridos.

c) Arraste e solte o campo [CN_CONTROL_ID] na área de medidas da guia Itens de Dados

8. Para formatar o relatório, conclua as etapas a seguir.a) Centralize os títulos das colunas.b) Centralize a interseção da crosstab.c) Configure a classificação das colunas em ordem crescente.d) Configure a classificação das linhas em ordem crescente.


O que Fazer Depois“Incluindo um Relatório Drill Through no Pai” na página 82

Incluindo um Relatório Drill Through no PaiSiga este procedimento para incluir um relatório drill through em um relatório para que o usuário possaobter informações mais detalhadas sobre os controles por trás dos números na tabela cruzada.

Procedimento

1. Selecione a página principal de um relatório.2. Desbloqueie a crosstab.3. Selecione o cabeçalho da coluna CN_OPERATING_EFFECTIVENES e conclua as seguintes etapas.

a) Na área de janela Propriedades, na categoria Dados, selecione Propriedades.b) Selecione CN_OPERATING_EFFECTIVENES_ID para que ele possa ser usado como um parâmetro

de passagem para o sub-relatório.c) Clique em OK.

4. Selecione o cabeçalho da linha PEN_NAME00 e conclua as seguintes etapas.a) Na área de janela Propriedades, na categoria Dados, selecione Propriedades.b) Selecione PEN_ENTITY_ID para que ele possa ser usado como um parâmetro de passagem para

o sub-relatório.c) Clique em OK.

5. Selecione a medida na crosstab.6. Na área de janela Propriedades, em Dados, selecione Definições de Drill Through.

7. Para incluir uma nova definição de drill through, clique no ícone Incluir.8. Para configurar o nome do drill through para Detalhe de controle, clique no ícone Renomear.9. Selecione o relatório Drill Through Filho.

10. Selecione para abrir o relatório em uma nova janela.


11. Clique no ícone Editar para editar os parâmetros transmitidos para o sub-relatório, e conclua asseguintes etapas.a) Para ID da Entidade, configure o método para Transmitir Valor do Item de Dados e o Valor para

PEN_ENTITY_IDb) Para ID de Eficácia Operacional, configure o método para Transmitir Valor do Item de Dados e

o Valor para CN_OPERATING_EFFECTIVENES_ID.c) Clique em OK.


Resultados

As medidas nas crosstabs agora aparecem em azul e sublinhadas indicando que um drill through estáanexado a essa célula. Ao clicar na interseção de Ásia Pac e Não determinado, um relatório de drillthrough é exibido.

O relatório de drill through mostra três registros com a eficácia operacional de Não determinadoproveniente da entidade de negócios Ásia Pac.

O que Fazer DepoisÉ possível incluir links CrossTrack em relatórios pai e drill through (opcional). Para obter informações,veja “Incluindo Links CrossTrack” na página 83.

Incluindo Links CrossTrackUm link CrossTrack é um hiperlink em um relatório que, quando clicado, leva para uma página dedetalhes no IBM OpenPages with Watson. É possível criar links CrossTrack em um relatório de um objetode controle para sua página de detalhes.

Incluindo links CrossTrack nos relatórios independente e paiSiga este procedimento para incluir um link CrossTrack em um relatório independente ou pai.

Procedimento

1. Crie um novo relatório de lista.2. No Explorador de Consultas, abra a consulta.3. Na área de janela Propriedades em Diversos, configure o nome para listMain.4. No Explorador de Página, selecione a página principal do relatório e conclua as etapas a seguir.

a) Clique na guia Origem no Objetos que podem ser inseridos.b) Arraste os itens de consulta a seguir na caixa de objeto Lista:


• DEFAULT|[DEFAULT_REL]|GRC_OBJECTS|[SOXCONTROL]|[CN_DESCRIPTION]

• DEFAULT|[DEFAULT_REL]|GRC_OBJECTS|[SOXCONTROL]|ENUMERATION_FIELDS| CLASSIFICATION (ENUMERATION)|[CN_CLASSIFICATION]

• DEFAULT|[DEFAULT_REL]|GRC_OBJECTS|[SOXCONTROL]|ENUMERATION_FIELDS| DESIGN_EFFECTIVENESS (ENUMERATION)|[CN_DESIGN_EFFECTIVENESS]

• DEFAULT|[DEFAULT_REL]|GRC_OBJECTS|[SOXCONTROL]|[CN_DETAIL_PAGE_URL]

5. Selecione a coluna [CN_DETAIL_PAGE_URL] no relatório e recorte-a (não a exclua).6. Para alterar os títulos das colunas de lista, conclua as seguintes etapas.


a) Selecione cada título da coluna de lista.b) Na área de janela Propriedades em Origem de Texto, configure a propriedade Tipo de Origem

para Texto.c) Dê um clique duplo na propriedade Texto e digite o valor de título apropriado. Configure os

cabeçalhos para os seguintes valores:

• [CN_NAME00] para Nome do controle.• [CN_DESCRIPTION] para Descrição.• [CN_CLASSIFICATION] para Classificação.• [CN_DESIGN_EFFECTIVENESS] para Eficácia de design.

7. Inclua o seguinte JavaScript no relatório:

Arraste um Item de HTML para o início do relatório.

Dê um clique duplo no Item de HTML e insira o código a seguir:

<script language="javascript">

function _fixUpLinkTarget() { var crossTrackLinks = document.querySelectorAll('a[href^="javascript:crosstrack("]'); for (var i = 0; i < crossTrackLinks.length; i++) { crossTrackLinks[i].target = ""; }}_fixUpLinkTarget();

var _crosstrackTargetWindow;function _discoverCrosstrackTargetWindow(){ if(!_crosstrackTargetWindow || typeof(_crosstrackTargetWindow)=='undefined') { var win; if(!window.opener || typeof(window.opener)=='undefined') { win = window.parent; } else if(!window.opener.opener || typeof(window.opener.opener)=='undefined') { if(!window.opener.parent || typeof(window.opener.parent)=='undefined') { win = window.opener; } else { win = window.opener.parent; } } else { win = window.opener.opener; } _crosstrackTargetWindow = win; }}_discoverCrosstrackTargetWindow();function _crosstrack(url, targetWin){ if(!targetWin || typeof(targetWin)=='undefined') { if(!window.opener || typeof(window.opener)=='undefined') { targetWin = window.parent; } else if(!window.opener.opener || typeof(window.opener.opener)=='undefined') { if(!window.opener.parent || typeof(window.opener.parent)=='undefined') { targetWin = window.opener; } else { targetWin = window.opener.parent; }


} else { targetWin = window.opener.opener; } } try { targetWin.location.href=url; targetWin.focus(); } catch(err) { window.open(url); }}function crosstrack(url){ _crosstrack(url, _crosstrackTargetWindow);}</script>

8. Clique na guia Caixa de ferramentas e, então, arraste um objeto de Hyperlink para a primeiracoluna do relatório de lista.

9. Na barra de ferramentas, clique no ícone Bloquear para desbloquear o modelo (o ícone mudapara desbloqueado).

10. Para tornar o item de dados de hiperlink uma propriedade da lista, conclua as etapas a seguir.a) Selecione o objeto Lista na página principal do relatório.b) Na área de janela Propriedades na categoria Dados, clique em Propriedades.c) Selecione [CN_DETAIL_PAGE_URL].d) Clique em OK.

11. Para configurar o objeto Hiperlink, conclua as etapas a seguir.a) Clique no texto de Hiperlink nas células da coluna de objeto de Hiperlink.b) Na área de janela Propriedades na categoria Origem do texto, configure a propriedade Tipo de

origem como Valor do item de dados e a propriedade Valor do item de dados como[CN_NAME00].

c) Na área de janela Propriedades na categoria Origem de URL, configure a propriedade Tipo deOrigem para Expressão de Relatório.

d) Clique na propriedade Expressão de Relatório e insira o seguinte código JavaScript na área dejanela Definição de Expressão:

if (ReportOutput()="HTML")then("javascript:crosstrack('"+ [listMain].[CN_DETAIL_PAGE_URL] + "');")else ([listMain].[CN_DETAIL_PAGE_URL])

Nota: Os itens em itálico são os valores que precisam ser substituídos ao implementar isso emseu sistema.

e) Selecione o texto do cabeçalho da coluna no objeto Hiperlink.f) Na área de janela Propriedades na categoria Origem de Texto, configure a propriedade Texto

para Nome do Controle.12. Na Barra de Ferramentas, clique no botão Cadeado novamente para bloquear o modelo (o ícone

muda para bloqueado).13. Selecione a coluna [CN_NAME00] original (não a coluna de hiperlink) na página do relatório e, em

seguida, recorte-a.14. Execute o relatório.

Nota: Para testar o link CrossTrack, o relatório deverá ser publicado e executado a partir doOpenPages with Watson.


ResultadosQuando um usuário clica no link CrossTrack de um relatório independente ou pai, a página de detalhespara esse objeto é aberta na janela do aplicativo da qual o relatório foi ativado.

Incluindo links CrossTrack em relatórios drill throughSiga este procedimento para incluir um link CrossTrack em um relatório drill through.

Procedimento

1. Crie um novo relatório de lista.2. Na área de janela Objetos inseríveis, arraste os itens de dados a seguir para a lista (o que é carregado

no sistema é diferente do que você vê aqui):

• DEFAULT|[DEFAULT_REL]|GRC_OBJECTS|SOXBUSENTITY_FOLDER| [SOXBUSENTITY_GPC]|[PEN_NAME00]



• DEFAULT|[DEFAULT_REL][DEFAULT_REL]|GRC_OBJECTS|[SOXCONTROL] ENUMERATION_FIELDS|OPERATING_EFFECTIVENES(ENUMERATION)| [CN_OPERATING_EFFECTIVENES]

• DEFAULT|[DEFAULT_REL]|GRC_OBJECTS|[SOXCONTROL] ENUMERATION_FIELDS| OPERATING_EFFECTIVENES (ENUMERATION)| [CN_OPERATING_EFFECTIVENES_ID]

3. Recorte o campo CN_OPERATING_EFFECTIVENES_ID na lista.4. Inclua o seguinte JavaScript no relatório:

Arraste um Item de HTML para o início do relatório.

Dê um clique duplo no Item de HTML e insira o código a seguir:

<script language="javascript">

function _fixUpLinkTarget() { var crossTrackLinks = document.querySelectorAll('a[href^="javascript:crosstrack("]'); for (var i = 0; i < crossTrackLinks.length; i++) { crossTrackLinks[i].target = ""; }}_fixUpLinkTarget();

var _crosstrackTargetWindow;function _discoverCrosstrackTargetWindow(){ if(!_crosstrackTargetWindow || typeof(_crosstrackTargetWindow)=='undefined') { var win; if(!window.opener || typeof(window.opener)=='undefined') { win = window.parent; } else if(!window.opener.opener || typeof(window.opener.opener)=='undefined') { if(!window.opener.parent || typeof(window.opener.parent)=='undefined') { win = window.opener; } else { win = window.opener.parent; } } else { win = window.opener.opener; } _crosstrackTargetWindow = win;


}}_discoverCrosstrackTargetWindow();function _crosstrack(url, targetWin){ if(!targetWin || typeof(targetWin)=='undefined') { if(!window.opener || typeof(window.opener)=='undefined') { targetWin = window.parent; } else if(!window.opener.opener || typeof(window.opener.opener)=='undefined') { if(!window.opener.parent || typeof(window.opener.parent)=='undefined') { targetWin = window.opener; } else { targetWin = window.opener.parent; } } else { targetWin = window.opener.opener; } } try { targetWin.location.href=url; targetWin.focus(); } catch(err) { window.open(url); }}function crosstrack(url){ _crosstrack(url, _crosstrackTargetWindow);}</script>

5. Acesse o Explorador de Consultas e inclua os seguintes filtros na consulta:

• [DEFAULT_REL].[SOXBUSENTITY_GPC].[GEN_ENTITY_ID] = ?Entity ID?• [CN_OPERATING_EFFECTIVENES_ID] = ?Operating Effectiveness ID?• [DEFAULT_REL].[SOXBUSENTITY_GPC].[GEN_REPORTING_PERIOD_ID] = -1

6. Valide o relatório.7. Salve o relatório com o nome Drill Through Filho.

ResultadosQuando um usuário clica no link CrossTrack no relatório, a página de detalhes para esse objeto é aberta.O navegador determina o comportamento da janela:

• No Microsoft Internet Explorer, a página de detalhes é aberta na janela de aplicativo da qual o relatóriofoi ativado.

• No Chrome, a página de detalhes é aberta em uma nova janela ou guia do aplicativo.

Criando um Relatório Detalhado MestreUm relatório detalhado mestre geralmente contém uma segunda lista integrada na lista de relatóriosprincipais. Isso cria uma situação em que você tem uma consulta externa para a lista de relatóriosprincipais e uma subconsulta para a lista integrada. Isso significa, em termos de desempenho, que outraconsulta será executada para cada registro retirado do banco de dados. Esta construção deverá serutilizada somente se ela for a sua única opção devido à estrutura dos dados.

Procedimento

1. Crie um novo relatório de lista.


2. Inclua um prompt de entidade de negócios conforme descrito em “Incluindo um Prompt de Entidadede Negócios” na página 52. Use GEN_ENTITY_ID como o campo para a origem dos dados. Suaconsulta de crosstab deve ter o seguinte filtro após criar o prompt:


3. Na área de janela Objetos que podem ser inseridos, arraste e solte os seguintes itens de dados nalista (lembre-se de que o que for carregado em seu sistema pode ser diferente do que é visto aqui):




• DEFAULT|[DEFAULT_REL]|GRC_OBJECTS|[SOXCONTROL] ENUMERATION_FIELDS| OPERATING_EFFECTIVENES (ENUMERATION)|[CN_OPERATING_EFFECTIVENES]

4. Recorte o campo CN_CONTROL_ID da lista.5. Acesse o Explorador de Consultas e inclua os seguintes filtros na consulta:

[DEFAULT_REL].[SOXBUSENTITY_GPC].[GEN_REPORTING_PERIOD_ID] = -1

6. Valide o relatório.7. Acesse a página principal do relatório e conclua as etapas a seguir.

a) Classifique CN_NAME00 em ordem crescente.

b) Na área de janela Objetos que podem ser inseridos na guia Caixa, selecione uma Lista e solte-a na última coluna da lista existente. A lista deve ser bloqueada.

8. Na nova lista, arraste e solte os seguintes itens de dados:


• DEFAULT|[DEFAULT_REL]|GRC_OBJECTS|[SOXCONTROL]|ENUMERATION_FIELDS| FINANCIAL_STATEMENT_AS(ENUMERATION)|[CN_FINANCIAL_STATEMENT_AS]


O que Fazer Depois“Criando relacionamentos entre Listas Principais e Integradas” na página 88

Criando relacionamentos entre Listas Principais e IntegradasO relatório está obviamente incorreto porque os valores CN_CONTROL_ID não correspondem. Issoacontece porque você não criou o relacionamento entre a lista principal e a lista integrada.

Procedimento

1. Selecione um item na lista integrada.2. No menu Dados na barra de ferramentas principal, selecione Relacionamentos de Detalhes Mestres.3. Crie uma junção entre CN_CONTROL_ID no listMain e o CN_CONTROL_ID no childList.4. Clique em OK.5. Execute o relatório.

Resultados

Agora há menos linhas na lista integrada, e os valores de ID de controle correspondem ao registroprincipal.


O que Fazer Depois“Formatando Listas Integradas” na página 89

Formatando Listas IntegradasÉ possível fazer algumas atividades de limpeza para tornar a lista integrada menos evidente.

Procedimento

1. Selecione os campos CN_CONTROL_ID em ambas as listas e recorte-os. Eles precisam estar naconsulta, mas não precisam ser exibidos.

2. Selecione o cabeçalho da lista integrada e conclua as etapas a seguir.a) Utilizando o seletor antecessor, selecione lista.b) Na área de janela Propriedades em Geral, configure a propriedade Títulos da Coluna para

Ocultar.

3. Selecione a célula na lista principal na qual a lista está integrada. Na área de janela Propriedades emCaixa, configure a propriedade Preenchimento e configure todos os valores para zero.


Incluindo MinigráficosUm minigráfico é uma versão em miniatura de um gráfico que pode ser inserida em uma tabulaçãocruzada ou em uma lista. Esses minigráficos operam da mesma maneira que as funções do relatóriodetalhado mestre em que o minigráfico é uma visualização detalhada dos dados mestres.

Procedimento

1. Crie um novo relatório de lista.2. Inclua um prompt de entidade de negócios conforme descrito em “Incluindo um Prompt de Entidade

de Negócios” na página 52. Utilize GEN_ENTITY_ID como o campo para a origem dos dados. Suaconsulta de crosstab deve ter o seguinte filtro após criar o prompt:


3. Na área de janela Objetos que podem ser inseridos, arraste e solte os seguintes itens de dados nalista (lembre-se de que o que for carregado em seu sistema será diferente do que é visto aqui):

• DEFAULT|[DEFAULT_REL]|GRC_OBJECTS|SOXBUSENTITY_FOLDER| [SOXBUSENTITY_GPC]|[PEN_NAME00]

• DEFAULT|[DEFAULT_REL]|GRC_OBJECTS|SOXBUSENTITY_FOLDER| [SOXBUSENTITY_GPC]|ID_FIELDS| [PEN_ENTITY_ID]

• DEFAULT|[DEFAULT_REL]|GRC_OBJECTS|[SOXCONTROL] ENUMERATION_FIELDS|OPERATING_EFFECTIVENES(ENUMERATION)| [CN_OPERATING_EFFECTIVENES]

4. Recorte o campo PEN_ENTITY_ID e o campo CN_OPERATING_EFFECTIVENES da lista.5. Acesse o Explorador de Consultas e inclua os seguintes filtros na consulta:

• [DEFAULT_REL].[SOXBUSENTITY_GPC].[GEN_REPORTING_PERIOD_ID] = -1• [CN_OPERATING_EFFECTIVENES] is not null

6. No Explorador de Consultas, renomeie a consulta utilizada pela lista para listMain.7. Valide o relatório.8. Acesse a página principal do relatório e conclua as etapas a seguir.

a) Classifique PEN_NAME00 em ordem crescente.b) Configure o rótulo para PEN_NAME00 para Entidade de Negócios.


c) Na guia Caixa de ferramentas da área de janela Objetos que podem ser inseridos , selecioneum Gráfico e solte-o na última coluna da lista existente. A lista deve ser bloqueada.

d) Selecione Minigráfico e um gráfico de barras Coluna.

9. No novo gráfico, arraste e solte os seguintes itens de dados:

• DEFAULT|[DEFAULT_REL]|GRC_OBJECTS|[SOXCONTROL]|ID_FIELDS| [CN_CONTROL_ID]• DEFAULT|[DEFAULT_REL]|GRC_OBJECTS|[SOXCONTROL] ENUMERATION_FIELDS|OPERATING_EFFECTIVENES(ENUMERATION)| [CN_OPERATING_EFFECTIVENES]

10. No Explorador de Consultas, renomeie a consulta utilizada pela lista para microChart.11. Acesse o Explorador de Consultas e inclua os seguintes filtros na consulta:

• [DEFAULT_REL].[SOXBUSENTITY_GPC].[GEN_REPORTING_PERIOD_ID] = -1• [CN_OPERATING_EFFECTIVENES] is not null

12. Na área de janela Objetos que Podem Ser Inseridos, arraste e solte o seguinte item de dados:

DEFAULT|[DEFAULT_REL]|GRC_OBJECTS|SOXBUSENTITY_FOLDER| [SOXBUSENTITY_GPC]|ID_FIELDS|[PEN_ENTITY_ID]

13. Selecione o item de dados CN_CONTROL_ID e, na área de janela Propriedades, conclua as etapas aseguir.a) Na categoria Item de Dados, configure a propriedade Função Agregada para Contagem Distinta.b) Na categoria Item de Dados, configure a Função de Agregado de Sintetização para Automática.

14. Na página principal do relatório, renomeie a coluna de gráfico para Eficácia Operacional.15. A partir do menu Dados na barra de ferramentas principal, selecione Relacionamentos de Detalhes

Mestres e conclua as seguintes etapas.a) Crie uma junção entre PEN_ENTITY_ID no listMain e o PEN_ENTITY_ID no minigráfico.b) Clique em OK.

16. Selecione o plano de fundo do minigráfico e conclua as etapas a seguir.a) Na área de janela Propriedades na categoria Posicionamento, configure a propriedade Tamanho

e Estouro para uma altura de 100 px.b) Configure a largura para 150 px.

17. Selecione o eixo y do minigráfico e, na área de janela Propriedades na categoria Geral, configure apropriedade Rótulos do Eixo para Mostrar.

18. No Explorador de Condição, selecione variáveis e conclua as seguintes etapas.a) Inclua uma nova variável de sequência.b) No editor de expressão, inclua [microChart].[CN_OPERATING_EFFECTIVENES]c) Clique em OK.d) Inclua três valores: Efetivo, Ineficaze Não Determinado.e) Na área de janela Propriedades em Diversos, configure a propriedade Nome para Eficácia

Operacional

19. Na página principal do relatório, selecione o minigráfico e na área de janela Propriedades em Cor eplano de fundo, selecione a Paleta condicional e conclua as etapas a seguir.a) Para a Variável, selecione Eficácia Operacional.b) Para Efetivo, configure a cor para verde limão.c) Para Ineficaz, configure a cor para vermelho.d) Para Não Determinado, configure a cor para azul.e) Clique em OK.

20. Selecione a Barra de séries. Na área de janela Propriedades em Rótulos do Gráfico, configure apropriedade Valores para Mostrar.



Resultados

Agora existe uma comparação da Eficácia Operacional do controle entre as diferentes entidades denegócios para comparar como elas estão controlando seu processo.



Capítulo 8. Trabalhando com Dados DimensionaisEste capítulo introduz os conceitos de criação de relatórios dimensionais.


A estrutura do modelo dimensional é explicada em Capítulo 4, “Estrutura de Relatório”, na página 15.

Incluindo PromptsA página de prompt inclui interatividade para usuários e age como um mecanismo de escopo de relatóriopara filtrar e limitar os dados recuperados.

É possível incluir um prompt de entidade de negócios de caminho completo.

Incluindo um Prompt Dimensional de Entidade de Negócios de Nível ÚnicoUm prompt de Entidade de Negócios de nível único incluído em seu relatório é útil para criar prompts emcascata.

Figura 37. Estrutura da Entidade de Negócios Dimensional

Procedimento

1. Se você ainda não tiver uma página de prompt no seu relatório, siga as instruções em “Criando umaPágina de Prompt” na página 50

2. Para criar seu prompt de Entidade de Negócios, conclua as seguintes etapas.a) Arraste um Item de texto para a primeira coluna da tabela. Insira o texto para o prompt no item

de texto.b) Selecione a célula de tabela e configure o local para estar à direita horizontalmente e

verticalmente para cima.c) Coloque o texto em negrito usando o ícone Negrito.

3. Arraste um objeto Prompt de Valores para a segunda coluna de sua página de prompt.O Assistente de Prompt é aberto.

4. Na tela Escolher parâmetro do Assistente de Prompt, conclua as etapas a seguir.a) Selecione a opção Criar um novo parâmetro.b) Na caixa, digite um nome para o parâmetro, por exemplo, Entidade de Negócios.c) Clique em Avançar.

5. Na tela Criar filtro, conclua as etapas a seguir.

a) Selecione a opção Criar um filtro parametrizado.b) Na caixa Item de modelo, clique no botão Navegar e navegue até o item de consulta a seguir

(lembre-se que sua dimensão Entidade de Negócios será nomeada de forma diferente):

DEFAULT|[DEFAULT_DIM]|OBJECT_TYPE_DIMENSIONS| [GFS ORG HIERARCHY]| [GFS

ORG HIERARCHY]| [CORPORATE]c) Na caixa Operador, use o sinal de igual (=) (padrão).d) Limpe a caixa para a opção Tornar esse filtro opcional.e) Clique em Avançar.

6. Se tiver diversas consultas em seu relatório, na caixa Aplicar filtro, selecione a consulta na qual ofiltro deverá ser aplicado.

7. Na tela Preencher controle, conclua as etapas a seguir.a) Selecione a opção Criar nova consulta.b) Na caixa Nome, digite um nome para a consulta, por exemplo, Prompt de Entidade deNegócios.


DEFAULT|[DEFAULT_DIM]|OBJECT_TYPE_DIMENSIONS| [GFS ORG HIERARCHY]| [GFS

ORG HIERARCHY]| [CORPORATE]d) Os valores a seguir serão exibidos na caixa:

[DEFAULT_DIM].[GFS ORG HIERARCHY].[GFS ORG HIERARCHY]. [CORPORATE]

8. Clique em Concluir.9. Selecione o prompt recém-criado e na categoria Geral na área de janela Propriedades, altere o valor

de Selecionar IU para Caixa de Listagem.10. Usando o Explorador de Consultas, conclua as etapas a seguir.

a) Selecione o filtro recém-criado na consulta principal.b) Na área de janela Propriedades, em Geral, configure a propriedade Aplicativo para Após

Autoagregação.


Resultados

Há algumas diferenças entre este prompt de Entidade de Negócios e um prompt relacional:

• Para criar o prompt, você teve que escolher um nível da dimensão tipo de objeto da Entidade deNegócios. Isso significa que o prompt mostrará os dados somente nesse nível.

• O prompt criado é um prompt dimensional. Ele pode ser usado somente para filtrar dados dimensionaisem seu relatório.

• O valor a ser utilizado e o valor para exibir são os mesmos.• O filtro aparece na área de janela Filtros de Detalhe da consulta.

Incluindo um Prompt de Entidade de Negócios de Caminho CompletoÉ possível incluir um prompt de Entidade de Negócios de caminho completo para seu relatório.

Procedimento


2. Para criar seu prompt de Entidade de Negócios, conclua as seguintes etapas.


a) Arraste um Item de texto para a primeira coluna da tabela. Insira o texto para o prompt no item detexto.


c) Coloque o texto em negrito usando o ícone Negrito.d) Arraste um objeto Prompt de Valores para a página de prompt.


a) Selecione a opção Criar um novo parâmetro.b) Na caixa, digite um nome para o parâmetro, por exemplo, Entidade de Negócios.c) Clique em Avançar.

4. Na tela Criar filtro, conclua as etapas a seguir.a) Selecione a opção Criar um filtro parametrizado.b) Na caixa Item de pacote, clique no botão Navegar e navegue até o item de consulta a seguir:

DEFAULT|DEFAULT_DIM|OBJECT_TYPE_DIMENSIONS| [SOXBUSENTITY_GPC]|

[SOXBUSENTITY_GPC]| [SOXBUSENTITY_GRANDPARENT]|[GEN_ENTITY_ID]c) Na caixa Operador, use o sinal de igual (=) (padrão).d) Limpe a caixa para a opção Tornar esse filtro opcional.e) Se tiver diversas consultas em seu relatório, na caixa Aplicar filtro, selecione a consulta na qual o





[SOXBUSENTITY_GPC]| [SOXBUSENTITY_GRANDPARENT]|[GEN_FULL_PATH]d) Os valores a seguir serão exibidos na caixa:

[DEFAULT_DIM].[SOXBUSENTITY_GPC].[SOXBUSENTITY_GPC].[SOXBUSENTITY_GRANDPARENT].[GEN_FULL_PATH]

e) Clique em Concluir.6. Selecione o prompt recém-criado e na categoria Geral na área de janela Propriedades, altere o valor

de Selecionar IU para Caixa de Listagem.

Resultados

• A dimensão tipo de objeto SOXBUSENTITY_GPC pode ser utilizada apenas para fins de filtragem. Elenão pode ser utilizado para drill up ou drill down.

• Deve-se ajustar o filtro criado por este prompt para corresponder os objetos em seu relatório.

Configurando um Valor PadrãoTalvez seja desejado que o prompt exiba um valor padrão quando a página de prompt for exibida para ousuário.

Capítulo 8. Trabalhando com Dados Dimensionais 95

Procedimento

1. Selecione o prompt Entidade de Negócios criado na seção anterior “Incluindo um PromptDimensional de Entidade de Negócios de Nível Único” na página 93.

2. Na área de janela Objetos que podem ser inseridos, selecione o membro que você deseja configurarcomo o padrão. Neste exemplo, estamos selecionando o Global Financial Services.

3. Clique com o botão direito do mouse no membro e selecione Propriedades.4. No diálogo Propriedades, copie o valor no Nome Exclusivo de Membro.5. Clique em Concluir.6. Na área de janela Propriedades para o prompt de Entidade de Negócios, em Geral, selecione

Seleções Padrão.

7. Clique no ícone Incluir .8. Cole o valor recém-copiado no diálogo Incluir.9. Clique em Ok.

10. Clique em Ok.11. Execute o relatório.

Resultados

O Global Financial Services agora é destacado como o valor padrão no prompt ao executar o relatório.

Nota: O valor padrão utilizado é específico do ambiente.

Incluindo um valor TodosÉ possível desejar permitir ao usuário uma opção Todos em vez de selecionar todos os itensindividualmente.

Procedimento

1. Selecione o prompt Entidade de Negócios criado na seção anterior.


2. Na área de janela Objetos que Podem ser Inseridos, selecione o membro OU1(All) nos membros dahierarquia OU1.

3. Clique com o botão direito do mouse no membro e selecione Propriedades.4. No diálogo Propriedades, copie o valor no Nome Exclusivo de Membro.5. Clique em Concluir.6. Na área de janela Propriedades para o prompt de Entidade de Negócios, em Dados, selecione

Opções Estáticas.

7. Clique no ícone Incluir .8. Cole o valor recém-copiado para o valor Utilizar no diálogo Incluir. Inclua Todos para o valor de

exibição.9. Clique em Ok.

10. Clique em Ok.11. Na área de janela Propriedades para o prompt de Entidade de Negócios, em Geral, selecione

Seleções Padrão.12. Exclua quaisquer opções anteriores.

13. Clique no ícone Incluir .14. Cole o valor recém-copiado no diálogo Incluir.15. Execute o relatório.

Resultados

O prompt agora possui um valor Todos, e é selecionado como o padrão.

Incluindo um Prompt de ÁrvorePrompts de árvore podem ser utilizados somente com o modelo de dados dimensionais. Um usuário podeutilizar um prompt de árvore para fazer uma seleção a partir de uma visualização hierárquica dos dados.

Procedimento


2. Para criar seu prompt de Árvore, conclua as seguintes etapas.a) Arraste um Item de texto para a primeira coluna da tabela. Insira o texto para o prompt no item

de texto.b) Selecione a célula de tabela e configure o local para estar à direita horizontalmente e

verticalmente para cima.c) Coloque o texto em negrito usando o ícone Negrito.d) Arraste um objeto Prompt de Árvore para a página de prompt.


3. Na tela Escolher parâmetro do Assistente de Prompt, conclua as etapas a seguir.a) Selecione a opção Criar um novo parâmetro.b) Na caixa, digite um nome para o parâmetro, por exemplo, Entidade de Negócios.c) Clique em Avançar.

4. Na tela Criar filtro, conclua as etapas a seguir.a) Selecione a opção Criar um filtro parametrizado.b) Na caixa Item de Pacote, clique no botão Procurar e navegue para a seguinte hierarquia (as

dimensões de tipo de objeto serão diferentes em seu sistema):

DEFAULT_DIM|OBJECT_TYPE_DIMENSIONS|[Business Entity]





c) Clique em Concluir.

6. Selecione o prompt recém-criado e na categoria Geral na área de janela Propriedades, altere o valorde Pré-Preencher para Sim.

7. Como o prompt de árvore pode retornar uma grande quantia de itens de dados, é necessárioconfigurar a altura do prompt para um valor que seja razoável. Complete as seguintes etapas.a) Selecione o prompt na tabela para a qual você deseja configurar a altura.b) Na área de janela Propriedades, em Posicionamento, selecione Tamanho e Estouro.c) Na caixa de diálogo, configure a altura para 1,5 pol..

8. Clique em OK.9. Usando o Explorador de Consultas, conclua as etapas a seguir.

a) Selecione o filtro recém-criado na consulta principal.b) Na área de janela Propriedades, em Geral, configure a propriedade Aplicativo para Após

Autoagregação.


Resultados

O prompt de árvore permite percorrer para baixo uma hierarquia de dados e selecionar o membro exatoque deseja como um filtro.

Nota:

• É necessário ajustar o filtro criado por este prompt para corresponder os objetos em seu relatório.• Em algumas instâncias, será necessário criar um novo conjunto de membro ao criar um item de dados

como o exemplo a seguir:

[DEFAULT_DIM].[OU1].[OU1]->?Business Entity?

Filtragem no ID de Período de RelatórioTodo relatório deve ser filtrado pelo ID do período de relatório (utilizando um prompt ou um filtro), amenos que o usuário deseje relatar em todos os períodos de relatório.

É possível, por exemplo, solicitar ao usuário explicitamente um período de relatório específico e filtrarpelo ID de Período de Relatório selecionado. Ou é possível filtrar pelo valor do ID de período de relatório-1 se o relatório estiver disponível somente para o período de relatório atual.

Ao combinar a filtragem no ID de Período de Relatório com a filtragem na entidade, deve-se utilizar oGEN_REPORTING_PERIOD_ID como o item de filtragem para o ID de Período de Relatório.

Para criar um filtro no período de relatório em um relatório dimensional, a Dimensão de Tipo de ObjetoSOXBusEntity_GPC será usada.


Procedimento

1. Na área de janela Objetos que Podem Ser Inseridos, arraste e solte o seguinte item de dados nosfiltros de detalhes:


[SOXBUSENTITY_GPC]| [SOXBUSENTITY_GRANDPARENT] |GEN_REPORTING_PERIOD_ID]

2. Edite o filtro e configure o valor para -1, o período de relatório atual, conforme mostrado no exemplo a

seguir:

[DEFAULT_DIM].[SOXBUSENTITY_GPC].[SOXBUSENTITY_GPC]. [SOXBUSENTITY_GRANDPARENT].[GEN_REPORTING_PERIOD_ID] = -1

3. Se for necessário configurar o filtro para um valor de prompt, inclua o valor de prompt definido naexpressão, conforme mostrado no exemplo a seguir:

[DEFAULT_DIM].[SOXBUSENTITY_GPC].[SOXBUSENTITY_GPC]. [SOXBUSENTITY_GRANDPARENT].[GEN_REPORTING_PERIOD_ID] = ?Reporting Period?

Resultados

Há um segundo método para filtragem no ID do período de relatório. Todas as dimensões de tipo deobjeto possuem atributos associados a cada nível da hierarquia, conforme mostrado em Figura 38 napágina 99.

Figura 38. Atributos da Dimensão de Tipo de Objeto

Qualquer um desses atributos pode ser utilizado na seguinte expressão:

roleValue('REPORTING_PERIOD_ID',[DEFAULT_DIM].[GFS ORG HIERARCHY].[GFS ORG HIERARCHY])

Isso retorna o atributo indicado na expressão de qualquer nível da hierarquia. Não inclua o nível dahierarquia no nome do atributo. Também não há necessidade de se preocupar com o contexto dahierarquia.

Trabalhando com Contêineres de DadosAs seções a seguir descrevem como utilizar contêineres de dados com dados dimensionais.


Trabalhando com ListasUm objeto de lista é usado para criar um relatório que mostra dados em linhas e colunas. Ao usar umobjeto de lista pela primeira vez, ele aparece vazio.

Esta seção explica como criar uma lista dimensional. Para obter informações adicionais sobre aspropriedades de uma lista, consulte “Trabalhando com Listas” na página 43.

Selecionando Colunas de DadosÉ possível selecionar quais colunas de dados você deseja incluir no relatório e como deseja que elassejam formatadas.

Procedimento

1. Na área de janela Objetos que Podem Ser Inseridos, arraste e solte os seguintes itens de dados nalista (que é carregado em seu sistema pode ser diferente do que é visto aqui):

• DEFAULT|DEFAULT_DIM|OBJECT_TYPE_DIMENSIONS| [GFS ORG HIERARCHY]| [GFS

ORG HIERARCHY]| [CORPORATE]

• DEFAULT|DEFAULT_DIM|GRC_OBJECTS|SOXRISK_FOLDER| [SOXRISK]| [SOXRISK]| [SOXRISK]

• DEFAULT|DEFAULT_DIM|GRC_OBJECTS|SOXRISK_FOLDER| [SOXRISK]| [SOXRISK]| [SOXRISK]|[RI_DESCRIPTION]

• DEFAULT|DEFAULT_DIM|GRC_OBJECTS|SOXRISK_FOLDER| [SOXRISK]| [SOXRISK]| [SOXRISK]|[RI_FULL_PATH]

2. No Explorador de Consultas, inclua o seguinte filtro:

DEFAULT|DEFAULT_DIM|OBJECT_TYPE_DIMENSIONS| [GFS ORG HIERARCHY]| [GFS

ORGHIERARCHY]| [CORPORATE]| [CORPORATE_REPORTING_PERIOD_ID]3. Para ativar o comportamento de drill-up e drill-down, conclua as etapas a seguir.

a) A partir do menu de nível superior, clique em Dados > Comportamento de Drill.b) No diálogo, clique na caixa de seleção Permitir drill up e drill down.

4. Clique em OK.5. Para configurar o agrupamento e a ampliação exatamente como qualquer relatório de lista, conclua as

etapas a seguir.a) Agrupe a dimensão da entidade de negócios e a dimensão do risco.b) Estenda a descrição de risco e o caminho completo do risco.

Resultados

Você também observará que nas colunas OU1 e SOXRISK os dados são sublinhados. Isso indica que épossível fazer drill up ou drill down nesses dados. Em um relatório de lista, o recurso de drill up e drill-down age como um filtro sequencial. Isso permite focar nos dados que deseja ver mais rapidamente.

Para fazer pesquisa detalhada, selecione o item de dados sublinhado. O relatório realiza drill down nopróximo nível da hierarquia.

Trabalhando com CrosstabsCrosstabs são um tipo de contêiner de dados que opera em dados agregados. Os campos de linha e decoluna na crosstab serão dimensões, ao passo que a interseção da crosstab sempre deverá ser um fato.

É possível ver três áreas em um objeto de tabulação cruzada:


ColunasOs itens de dados colocados aqui gerarão cabeçalhos da coluna. Diversos itens de dados podem sersoltos aqui para criar cabeçalhos de coluna aninhados.

LinhasOs itens de dados colocados aqui gerarão as linhas de dados na tabulação cruzada. Diversos itens dedados podem ser colocados aqui para gerar linhas aninhadas.

MedidasOs vários itens de dados que podem ser colocados aqui serão agregados às linhas e colunasselecionadas.

Selecionando Linhas e Colunas de DadosÉ possível selecionar quais itens de dados deseja incluir como linhas e colunas no relatório e como desejaque sejam formatados.

Procedimento

1. Acesse a área de janela Explorador de Consultas.2. Na área de janela Objetos que podem ser inseridos, arraste e solte os seguintes itens de dados na

área de janela Itens de Dados da tabulação cruzada:

• DEFAULT|DEFAULT_DIM|OBJECT_TYPE_DIMENSIONS| [Business Entity]| [Business

Entity]| [OU1]

• DEFAULT|DEFAULT_DIM|GRC_OBJECTS| SOXCONTROL_FOLDER|SOXCONTROL

(ENUMERATION_DIMENSIONS)| [CN_OPERATING_EFFECTIVENES]|

[CN_OPERATING_EFFECTIVENES]| [CN_OPERATING_EFFECTIVENES]

• DEFAULT|DEFAULT_DIM|GRC_OBJECTS| SOXCONTROL_FOLDER| [SOXCONTROL_FACTS]|

[SOXCONTROL (COUNT)]

Trabalhando com DadosÉ possível preencher uma tabulação cruzada.

Procedimento

1. Utilizando o Explorador de Página, mova para a Página 1.2. Arraste e solte o campo [CN_OPERATING_EFFECTIVENES] na área de colunas na guia Itens de Dados

da área de janela Objetos que Podem Ser Inseridos.3. Arraste e solte o campo [OU1] na área de linhas na guia Itens de Dados da área de janela Objetos que

Podem Ser Inseridos.4. Arraste e solte o campo [SOXCONTROL] na área de medidas na guia Itens de Dados da área de janela

Objetos que Podem Ser Inseridos.5. Ative drill-up e drill down na tela Comportamento de Dados|Drill.6. Execute o relatório.

Resultados

Você observará que os cabeçalhos de coluna e de linha do relatório de crosstab estão sublinhados. Issoindica que é possível realizar drill up e drill down deles. Os cabeçalhos de coluna agirão como filtros,porque a dimensão de eficácia operacional é apenas um único nível.


Ao clicar em Global Financial Services, o Global Financial Services é exibido novamente porque podehaver controles diretamente conectados ao nível do Global Financial Service da hierarquia de Entidade deNegócios. Ao realizar drill down, o próximo nível deve incluir até o nível anterior e é por isso que o GlobalFinancial Services é empurrado para baixo para o próximo nível.

Classificando os DadosÉ possível classificar o Global Financial Services para o início da tabulação cruzada porque ele éempurrado para baixo do nível anterior.

Procedimento

1. Na área de janela Objetos que podem ser inseridos, conclua as etapas a seguir.a) Arraste e solte os seguintes itens de dados na área de janela de itens de dados da consulta:

DEFAULT|DEFAULT_DIM|OBJECT_TYPE_DIMENSIONS| [Business Entity]| [Business

Entity]| [OU1]|IS_ROW_PUSHED_DOWNb) Altere o nome do item de dados para OU1_IS_ROW_PUSHED_DOWN.c) Arraste e solte os seguintes itens de dados na área de janela de itens de dados da consulta:


Entity]| [OU2]|IS_ROW_PUSHED_DOWNd) Altere o nome do item de dados para OU2_IS_ROW_PUSHED_DOWN.e) Arraste e solte os seguintes itens de dados na área de janela de itens de dados da consulta:


Entity]| [OU3]|IS_ROW_PUSHED_DOWNf) Altere o nome do item de dados para OU3_IS_ROW_PUSHED_DOWN.

2. Na página principal do relatório, conclua as seguintes etapas.a) Selecione o item de dados OU1.b) Na área de janela Propriedades, em Dados, selecione Classificação.c) Arraste e solte os itens de dados do OU3_IS_PUSHED_DOWN para Classificar Lista e selecione

classificação decrescente para cada item.d) Clique em OK.e) Execute o relatório novamente.

3. Selecione a seção Medidas da crosstab.

4. Clique no ícone Adição e selecione Total para incluir sumarizações nas linhas e colunas.

Resultados

Para obter mais informações sobre a configuração das propriedades de crosstab, consulte “Trabalhandocom Crosstabs” na página 44.

Nota:

• Não é possível inserir dois níveis da mesma hierarquia em uma tabulação cruzada porque o recursodrill-up e drill-down será desativado.

• É possível inserir diversas medidas em uma crosstab ao arrastar as duas medidas para o canto dacrosstab. Ao fazer isso, diversas medidas serão criadas nas células de fato.


Trabalhando com GráficosGráficos são utilizados para exibir dados em um formato visual. Há uma variedade de formatos degráficos construídos no IBM Cognos com os quais o autor do relatório deve familiarizar-se para exibirmelhor os dados para os usuários finais. Construir um gráfico com componentes dimensionais permiteque o usuário final seja capaz de realizar drill up e drill down dos dados para melhor focar a saída dográfico.

Um gráfico consiste nos seguintes componentes:

Medida PadrãoIsso é normalmente o componente do eixo y do gráfico. Ela será um valor numérico.

SérieUm grupo ou agrupamentos para o eixo y.

CategoriesIsso é normalmente o componente do eixo x do gráfico.

Criando um gráficoÉ possível criar um gráfico.

Procedimento

1. Crie um novo relatório Gráfico e conclua as seguintes etapas.a) Selecione o agrupamento de Gráfico de Coluna.b) Selecione o gráfico Coluna com Efeito Visual em 3D.c) Clique em OK.



DEFAULT|DEFAULT_DIM|GRC_OBJECTS|SOXRISK_FOLDER|SOXRISK (ENUMERATION

DIMENSIONS) | [RI_RISK_SUBCATEGORY_DEPENDENT_PICKLIST]|

[RI_RISK_SUBCATEGORY_DEPENDENT_PICKLIST]| [RI_RISK_CATEGORY]• Medida Padrão (eixo y)

DEFAULT|DEFAULT_DIM|GRC_OBJECTS|SOXRISK_FOLDER| [SOXRISK_FACTS]|[SOXRISK (COUNT)]• Série

DEFAULT|DEFAULT_DIM|GRC_OBJECTS|SOXRISK_FOLDER| SOXRISK (ENUMERATION

DIMENSIONS)| [RI_RESIDUAL_RISK_RATING]| [RI_RESIDUAL_RISK_RATING]| [RI_RESIDUAL_RISK_RATING]

3. Ative drill-up e drill down na tela Comportamento de Dados|Drill.4. Execute o relatório.

O que Fazer DepoisTrabalhe com esse gráfico posteriormente pelo “Incluindo títulos em um gráfico” na página 103.

Incluindo títulos em um gráficoÉ possível configurar alguns dos títulos no relatório.

Procedimento

1. Abra Títulos do Eixo e conclua as etapas a seguir.a) Selecione o título do eixo x.b) Na área de janela Propriedades, em Geral, configure a propriedade Título Padrão como Não.


c) Dê um clique duplo no título do eixo e configure o valor para Categoria de Risco.d) Selecione o título do eixo y.e) Na área de janela Propriedades, em Geral, configure a propriedade Título Padrão como Não.f) Dê um clique duplo no título do eixo e configure o valor para Contagem de Risco.

2. Selecione o (Título da Legenda Padrão) e conclua as seguintes etapas.a) Na área de janela Propriedades em Geral, configure a propriedade Título Padrão para Nenhum.b) Dê um clique duplo no título da legenda e configure o valor para Classificação de Risco Residual.


O que Fazer DepoisTrabalhe com esse gráfico posteriormente pelo “Preservando a Cor da Barra” na página 104.

Preservando a Cor da BarraÉ possível preservar a cor da barra em um gráfico.

Sobre Esta Tarefa

Agora vamos examinar os recursos de drill-up e drill down. Primeiro, clique em Fraude Externa. Como aCategoria de Risco é uma dimensão de diversos níveis, o gráfico agora mostra os dados de subcategoriaem Fraude Externa. Se selecionarmos Não Determinado a partir da legenda, o gráfico é agora filtradoainda mais para a subcategoria e para a classificação de risco residual única. Você também deve terobservado que a cor das barras não foi preservada conforme realizamos drill down.

Procedimento

1. No Explorador de Consultas, conclua as etapas a seguir.a) Arraste um Item de Dados para a área de janela Itens de Dados.b) No Item de Dados, insira a seguinte fórmula:

caption([RI_RESIDUAL_RISK_RATING])

c) Na área de janela Propriedades, configure o Nome para Classificação de Risco Residualde Legenda.

d) Configure a Função Agregada e a Função de Agregado de Sintetização para Nenhuma.2. No Explorador Condicional, conclua as etapas a seguir.

a) Arraste e solte uma Variável de Sequência na área de janela Variável.b) Arraste e solte o item de dados a seguir na área de janela Definição de Expressão:

[graphMain].[Caption Residual Risk Rating]

c) Clique em Ok.d) Na área de janela Propriedades, altere o Nome para Cor da Barra.e) Na área de janela Valores, inclua Alto, Médio, Baixo e Não Determinado.

3. Na página principal do relatório, conclua as seguintes etapas.a) Selecione o gráfico.b) Na área de janela Propriedades, em Cor e Plano de Fundo, selecione Paleta Condicional.c) Selecione Cor da Barra para o valor Variável.d) Selecione o Valor Alto, clique em Cor e configure a cor para vermelho.e) Selecione o Valor Médio, clique em Cor e configure a cor para amarelo.f) Selecione o Valor Baixo, clique em Core configure a cor para verde.


g) Selecione o Valor Não Determinado, clique em Cor e configure a cor para azul.h) Clique em OK para finalizar.

4. Para incluir a nova variável nas propriedades do gráfico, conclua as etapas a seguir.a) Na página principal do relatório, clique em RI_RESIDUAL_RISK_RATING.b) Utilizando o seletor Anterior, selecione Membro do Nó de Gráfico.c) Na área de janela Propriedades, em Dados, selecione Propriedades.d) Selecione a Classificação de Risco Residual de Legenda.

5. Selecione o novo contêiner de crosstab e execute o relatório.

O que Fazer DepoisTrabalhe com esse gráfico posteriormente pelo “Preservando Cores da Legenda” na página 105.

Preservando Cores da LegendaAs cores das barras no gráfico foram preservadas conforme realizamos drill down, mas a legenda nãocorresponde mais às cores da barra. Isso ocorre porque usamos uma paleta condicional para forçar ascores da barra para valores específicos, e a legenda não seleciona esses valores. É possível criar suaprópria legenda.

Procedimento

1. Clique na guia Caixa de ferramentas na área de janela Objetos que podem ser inseridos.2. Arraste um objeto Tabela para o corpo da página de relatório. Selecione 2 colunas por 1 linha.3. Arraste o gráfico existente para a primeira coluna da tabela.4. Arraste uma Tabulação cruzada para a segunda coluna da tabela.5. Na área de janela Propriedades, em Dados, configure a propriedade Consulta para a mesma do

gráfico existente.6. Para preencher a tabulação cruzada, conclua as etapas a seguir.

a) Na área de janela Objetos que Podem Ser Inseridos, arraste e solte[RI_RESIDUAL_RISK_RATING] nas linhas da crosstab.

b) Na área de janela Objetos que Podem Ser Inseridos, arraste e solte[RI_RESIDUAL_RISK_RATING] nas colunas da crosstab.

c) Na área de janela Objetos que Podem Ser Inseridos, arraste e solte [SOXRISK (COUNT)] nasmedidas da crosstab.

7. Para configurar as colunas e medidas, conclua as etapas a seguir.a) Na área de janela Propriedades, em Caixa, configure o Tipo de Caixa para Nenhuma para as

colunas e as medidas.b) Remova as bordas das células restantes da crosstab.c) Configure a Cor do Plano de Fundo para Branco para as células restantes da crosstab.

8. Selecione o texto no canto da tabulação cruzada e conclua as seguintes etapas.a) Na área de janela Propriedades, em Origem de Texto, configure o Tipo de Origem para Texto.b) Configure a propriedade Texto para Classificação de Risco Residual.c) Configure o Alinhamento Horizontal para Esquerdo.d) Configure o Alinhamento Vertical para Inferior.

9. Para incluir a nova variável nas propriedades da tabulação cruzada de legenda, conclua as etapas aseguir.a) Na página principal do relatório, clique em RI_RESIDUAL_RISK_RATING.b) Utilizando o seletor Anterior, selecione Membro do Nó de Crosstab.c) Na área de janela Propriedades, em Dados, selecione Propriedades.


d) Selecione a Classificação de Risco Residual de Legenda.10. Na página principal do relatório, clique em RI_RESIDUAL_RISK_RATING e conclua as seguintes

etapas.a) Na área de janela Propriedades, em Caixa, selecione Preenchimento.b) Configure o preenchimento à esquerda para 5 px.c) Clique em Ok.

11. Para criar as caixas de cores para a legenda, conclua as etapas a seguir.a) Desbloqueie o modelo de relatório.b) Arraste e solte um Item de texto antes do Item de texto [RI_RESIDUAL_RISK_RATING] na

tabulação cruzada da legenda.c) Insira 0 como o texto.d) Configure o tamanho da fonte para 2 pt.e) Na área de janela Propriedades, em Posicionamento, configure o Tamanho e Estouro para 10 px

por 10 px.f) Na área de janela Propriedades, em Condicional, configure a Variável de Estilo para Cor da

Barra.g) No Explorador Condicional, selecione Alto na variável Cor da Barra.h) Configure a Cor de Plano de Fundo, a Cor do Primeiro Plano e a Cor da Borda para Vermelho.i) Repita as etapas anteriores para médio (Amarelo), baixo (Verde) e Não Determinado como

opções. O modelo de relatório deve permanecer desbloqueado.12. Na célula da tabela que contém a tabulação cruzada da legenda, conclua as seguintes etapas.

a) Configure o alinhamento horizontal para a esquerda.b) Configure o alinhamento vertical para cima.

13. Na célula de tabela que contém a tabulação cruzada original, conclua as seguintes etapas.a) Defina o alinhamento horizontal para a direita.b) Configure o alinhamento vertical para cima.

14. Na tabela que contém as duas legendas, na área de janela Propriedades, em Posicionamento,configure a propriedade Tamanho e Estouro para em branco.

15. No gráfico principal, selecione a legenda e na área de janela Propriedades, em Caixa, configure oTipo de Caixa para Nenhum.


Resultados

Veja que a legenda customizada agora possui as mesmas cores que o gráfico. Pelo fato de ser umacrosstab, os itens na legenda são sublinhados indicando que é possível realizar drill up e drill down neles.Como a legenda e o gráfico compartilham a mesma consulta subjacente, o gráfico se comportará deacordo com o modo com que será feito drill up/drill down na legenda.

Dica: A criação da legenda customizada é uma solução alternativa que nos permite escolher as cores napaleta condicional.

Filtrando DadosPara filtrar dados em um relatório dimensional, é possível utilizar campos somente do modelodimensional. Como autor do relatório, você tem acesso aos modelos relacionais e dimensionais, mas ainclusão de campos do modelo relacional em um relatório dimensional gerará uma SQL imprevisível e nãoé recomendado.


Utilizando a Dimensão SOXBusEntity_GPCPara facilitar a criação de relatórios dimensionais, uma dimensão chamada de dimensãoSOXBUSENTITY_GPC foi incluída por padrão na pasta OBJECT_TYPE_DIMENSIONS.

Figura 39. Dimensão SOXBUSENTITY_GPC

Este objeto pode somente ser utilizado para filtragem. Ele não pode ser utilizado para realizar drill up oudrill down.

Os campos na dimensão são idênticos àqueles no modelo relacional e permitem criar filtros de períodode relatório, filtros de entidade de negócios, filtros de distância e filtros de caminho completo em umrelatório dimensional.

Criando um filtro de contextoUm filtro de contexto é utilizado para limitar o relatório dimensional para o contexto de um membroespecífico de uma hierarquia.

Procedimento

1. Abra um relatório dimensional existente.2. Selecione a consulta que você deseja filtrar a partir do Explorador de Consultas.3. Expanda a visualização de modelo de objeto na área de janela Objetos que Podem Ser Inseridos para

mostrar os membros da dimensão na qual deseja filtrar.4. Arraste e solte o membro que você deseja filtrar na área de filtro de contexto.

Resultados

Agora existe um filtro fixo neste relatório que limita a saída inicial da dimensão da OU1 para o GlobalFinancial Services. Como este relatório é dimensional, ainda é possível fazer drill up e drill down no GlobalFinancial Services.


Criando Drill ThroughsNo CommandCenter há muitos mais itens de dados que podem ser utilizados para realizar drill throughs.Isso permite anexar diferentes sub-relatórios a muitos objetos diferentes em um relatório como alegenda.

Ao criar um relatório dimensional, é possível realizar drill through para um outro relatório dimensional ourelacional. As técnicas para isso são muito diferentes.

Criando um Drill Through Dimensional para DimensionalÉ possível pode criar um relatório de lista relacional simples para criar um drill through dimensional paradimensional.

Procedimento

1. Crie um novo relatório de lista.2. Na área de janela Objetos que podem ser inseridos, arraste e solte os seguintes itens de dados na

lista (lembre-se de que o que for carregado em seu sistema será diferente do que é visto aqui):

• DEFAULT|DEFAULT_DIM|OBJECT_TYPE_DIMENSIONS| [Business Entity]| [Business

Entity]| [Business Entity]

• DEFAULT|DEFAULT_DIM|GRC_OBJECTS|SOXCONTROL_FOLDER| [SOXCONTROL]|

[SOXCONTROL]| [SOXCONTROL]

• DEFAULT|DEFAULT_DIM|GRC_OBJECTS|SOXCONTROL_FOLDER| [SOXCONTROL]|

[SOXCONTROL]| [SOXCONTROL]|[CN_DESCRIPTION]• DEFAULT|DEFAULT_DIM|GRC_OBJECTS| SOXCONTROL_FOLDER|SOXCONTROL

(ENUMERATION_DIMENSIONS)| [CN_OPERATING_EFFECTIVENES]|

[CN_OPERATING_EFFECTIVENES]| [CN_OPERATING_EFFECTIVENES]3. Recorte o [CN_OPERATING_EFFECTIVENES] do relatório de lista. Isto está sendo removido porque

ter sequências enumeradas em um relatório da lista dimensional não é suportado.4. Acesse o Explorador de Consultas e inclua os seguintes filtros na consulta:

• [DEFAULT_DIM].[BUSINESS ENTITY].[BUSINESS ENTITY] = ?Business Entity?• [DEFAULT_DIM].[CN_OPERATING_EFFECTIVENES]. [CN_OPERATING_EFFECTIVENES].[CN_OPERATING_EFFECTIVENES] = ?Operating Effectiveness?

• [DEFAULT_DIM].[SOXBUSENTITY_GPC].[SOXBUSENTITY_GPC].[SOXBUSENTITY_GRANDPARENT].[GEN_REPORTING_PERIOD_ID] = -1

5. Nos primeiros dois filtros, na área de janela Propriedades, em Geral, configure a propriedadeAplicativo para Após Agregação automática.

6. Ative drill-up e drill down na tela Comportamento de Dados|Drill.7. Salve o relatório como Sub-Relatório Dimensional.8. Usando o relatório de lista que criou o “Trabalhando com Crosstabs” na página 100, faça uma cópia e

conclua as seguintes etapas.a) Selecione a página principal do relatório.b) Desbloqueie a crosstab.c) Selecione a medida na crosstab.


d) Na área de janela Propriedades, em Dados, selecione Definições de Drill Through.

e) Para incluir uma nova definição de drill through, clique no ícone Incluir.f) Use o ícone Renomear para configurar o nome do drill through para Sub-relatóriodimensional.

g) Selecione o relatório Sub-Relatório Dimensional.h) Selecione para abrir o relatório em uma nova janela.i) Edite os parâmetros de relatório e selecione OU1 para o parâmetro Entidade de Negócios e

CN_OPERATING_EFFECTIVENES para o parâmetro Eficácia Operacional. Configure o valorPropriedade para Transmitir para Nome Exclusivo do Membro para ambos os parâmetros.


Resultados

As medidas nas crosstabs agora aparecem em azul e sublinhadas indicando que um drill through estáanexado a essa célula.

Incluindo um Drill Through Dimensional para RelacionalÉ possível criar um relatório de lista relacional simples para criar um drill through dimensional pararelacional

Procedimento

1. Crie um novo relatório de lista.2. Na área de janela Objetos que podem ser inseridos, arraste e solte os seguintes itens de dados na

lista (lembre-se de que o que foi carregado em seu sistema será diferente do que você vê aqui):

• DEFAULT|DEFAULT_REL|GRC_OBJECTS| [SOXBUSENTITY_FOLDER| [SOXBUSENTITY_GPC]|[CEN_NAME00]

• DEFAULT|DEFAULT_REL|GRC_OBJECTS| [SOXCONTOL]|[CN_NAME00]

• DEFAULT|DEFAULT_REL|GRC_OBJECTS| [SOXCONTOL]|[CN_DESCRIPTION]

• DEFAULT|DEFAULT_REL|GRC_OBJECTS| [SOXCONTOL]|ENUMERATION_FIELDS|

OPERATING_EFFECTIVENES (ENUMERATION)|[CN_OPERATING_EFFECTIVENES]

3. Acesse o Explorador de Consultas e inclua os seguintes filtros na consulta:

• [DEFAULT_REL].[SOXBUSENTITY_GPC].[GEN_ENTITY_ID] = ?Business Entity?• [DEFAULT_REL].[SOXCONTROL].[CN_OPERATING_EFFECTIVENES_ID] = ?OperatingEffectiveness?

• [DEFAULT_REL].[SOXBUSENTITY_GPC].[GEN_REPORTING_PERIOD_ID] = -14. Salve o relatório como Sub-Relatório Relacional.5. Usando o relatório de lista criado “Trabalhando com Listas” na página 100, faça uma cópia e conclua

as seguintes etapas.a) Arraste e solte um Item de dados na área de janela Itens de dados.b) Inclua a expressão a seguir:

roleValue('_businessKey',[DEFAULT_DIM].[BUSINESS ENTITY]. [BUSINESS ENTITY])

c) Na área de janela Propriedades, em Item de Dados, configure o Nome para o ID da Entidade deNegócios.


d) Configure a Função Agregada e a Função de Agregado de Sintetização para nenhuma.e) Arraste e solte um Item de dados na área de janela Itens de dados.f) Inclua a expressão a seguir:

roleValue('_businessKey',[CN_OPERATING_EFFECTIVENES])

g) Na área de janela Propriedades, em Item de dados, configure o Nome para ID de eficáciaoperacional.

h) Configure a Função Agregada e a Função de Agregado de Sintetização para nenhuma.6. Na página principal do relatório, conclua as seguintes etapas.

a) Selecione a medida na crosstab.b) Na área de janela Propriedades, em Dados, selecione Definições de Drill Through.

c) Para incluir uma nova definição de drill through, clique no ícone Incluir.d) Use o ícone Renomear para configurar o nome do drill through para Sub-relatóriorelacional.

e) Selecione o relatório Sub-relatório relacional.f) Selecione para abrir o relatório em uma nova janela.g) Edite os parâmetros de relatório e selecione o ID de Entidade de Negócios para o parâmetro

Entidade de Negócios e o ID de Eficácia Operacional para o parâmetro Eficácia Operacional.7. Inclua as duas variáveis nas propriedades da lista e conclua as seguintes etapas.

a) Na página principal do relatório, selecione a lista.b) Na área de janela Propriedades, em Dados, selecione Propriedades.c) Verifique o ID da Entidade de Negócios e o ID de Eficácia Operacional.


Resultados

As medidas nas crosstabs agora aparecem em azul e sublinhadas indicando que um drill through estáanexado a essa célula.

Criando Junções para Objetos SecundáriosNa estrutura, não há nenhuma junção padrão para objetos secundários. No modelo relacional, é possívelcriar uma junção utilizando o objeto de junção no Explorador de Consultas. No modelo dimensional, não épossível fazer isso.

Para resolver esse problema no modelo dimensional, é possível criar uma junção para um objetosecundário ao criar definições específicas no IBM OpenPages with Watson.

Como um exemplo, crie uma junção entre Entidades de Negócios e Problemas no modelo dimensional.

Procedimento

1. Para criar um Conjunto de nível de objeto recursivo no objeto SOXBusEntity, conclua as etapas aseguir.a) No menu principal, clique em Administração > Tipos de Objeto.b) Selecione SOXBusEntity na lista.c) Role para Níveis de objeto recursivo e clique em Editar.d) Salve o objeto.

2. Para criar uma Dimensão de tipo de objeto, conclua as etapas a seguir.a) No menu principal, clique em Administração > Estrutura de Relatório > Configuração.


b) Em Dimensões de Tipo de Objeto, clique em Incluir.c) Em Nome, Insira Entidade-Problema.d) Selecione um Tipo de Objeto de Início de OU1 e clique em Ir.e) Clique em Escolher Tipo de Objeto ao lado de OU3 e selecione Problema.f) Clique em Salvar.

3. Gere novamente a estrutura.4. Crie um novo relatório de crosstab.5. A partir de Dimensões de Tipo de Objeto, inclua o nível OU1 da Dimensão de Tipo de Objeto

Entidade de Negócios existente nas linhas da crosstab.

6. Na pasta GRC_OBJECTS SOXBUSENTITY, inclua o OU3 – SOXISSUE_STATUS na célula da colunada crosstab. Esta nova enumeração é o resultado da junção criada na estrutura devido à definição daDimensão de Tipo de Objeto de Entidade-Problema.

7. Na pasta GRC_OBJECTS SOXBUSENTITY, inclua o fato OU3 – SOXISSUE (COUNT) na célula demedida da crosstab. Este novo fato é o resultado da junção criada na estrutura devido à definição daDimensão de Tipo de Objeto de Entidade-Problema.


8. No Explorador de Consultas, inclua o seguinte filtro de período de relatório:

[DEFAULT_DIM].[BUSINESS ENTITY].[BUSINESS ENTITY].[OU1]. [OU1_REPORTING_PERIOD_ID] = -1

9. Ative drill-up e drill down na tela Comportamento de Dados|Drill.10. Execute o relatório.

Resultados

Para obter mais informações sobre como criar Níveis de Objeto Recursivo e Dimensões de Tipo de Objeto,consulte o Guia do administrador do IBM OpenPages with Watson.

Mudando os títulos de nível TodosNos relatórios dimensionais criados, cada dimensão possui um nível anterior ao nível superior dahierarquia que é referido como o nível Todos. Não é possível remover este nível, pois ele é geradoautomaticamente pela estrutura.

O problema com esse nível é que a sequência de texto que é gerada para este nível baseia-se no nome dadimensão. Dessa forma, por exemplo, em um objeto de Evento de Perda, se tiver optado por fazer comque uma lista de seleção dependente seja gerada como uma dimensão hierárquica, o nome seriaLE_RISK_SUBCATEGORY_DEPENDENT_PICKLIST (Todos) (em RDL) ou Loss Event Risk Sub-CategoryDependent Picklist (Todos) em inglês. Outros nomes, como RI_RISK_CATEGORY (Todos), setransformaria em Risk Risk Category (Todos) em inglês. Nenhum desses é desejável em um relatório.Vamos agora descrever dois métodos para resolver este problema.

Configurando o texto Todos em um relatórioNo nível de relatório, é possível criar fórmulas para corrigir este problema. Por exemplo, no Relatório deTendência de Evento de Perda, o texto Todos da data de ocorrência é Data de Início da Ocorrência doEvento de Perda (Todos) e o texto Todos da Categoria de Risco é Subcategoria de Risco de Evento dePerda (Todos).

Procedimento

1. No Explorador de Consultas, conclua as etapas a seguir.a) Arraste e solte um Item de Dados para a área de janela Itens de Dados.b) Inclua a expressão a seguir:


if (roleValue('_businessKey',[ORM1_DIM]. [LE_RISK_SUBCATEGORY_DEPENDENT_PICKLIST]. [LE_RISK_SUBCATEGORY_DEPENDENT_PICKLIST]) is missing ) then (1) else (2)

c) Na área de janela Propriedades, em Item de Dados, configure a propriedade Nome para Títuloda Categoria de Risco.

d) Configure a Função Agregada e a Função de Agregado de Sintetização para Nenhuma.

2. No Explorador Condicional, conclua as etapas a seguir.a) Crie uma variável de sequência com a seguinte expressão:

[graphMain].[Risk Category Title]

b) Inclua um valor chamado 1.

3. Na página principal do relatório, conclua as seguintes etapas.a) Selecione LE_RISK_CATEGORY em Séries.b) Na área de janela Propriedades, em Condicional, configure a Variável de Origem de Texto para

Título da Categoria de Risco.

4. Selecione LE_RISK_CATEGORY em Séries.5. No Explorador Condicional, conclua as etapas a seguir.

a) Selecione o valor 1 na variável Título da Categoria de Risco.b) Selecione LE_RISK_CATEGORY em Séries.c) Na área de janela Propriedades, em Origem de Texto, configure o valor de Texto para Todos.

6. Para incluir a nova variável nas propriedades das séries de gráfico, conclua as etapas a seguir.a) Na página principal do relatório, clique em LE_RISK_CATEGORY.b) Utilizando o seletor Anterior, selecione Membro do Nó de Gráfico.c) Na área de janela Propriedades, em Dados, selecione Propriedades.d) Verifique o Título da Categoria de Risco.

7. Execute o relatório. A categoria de risco agora mostra o texto Todos ao invés do texto padrão.Podemos fazer o mesmo para o valor de drill up da data de ocorrência.

8. No Explorador de Consultas, conclua as etapas a seguir.a) Arraste e solte um Item de Dados para a área de janela Itens de Dados.b) Inclua a expressão a seguir:

if (roleValue('_businessKey',[ORM1_DIM].[LE_OCCURRENCE_DATE Y-Q-M]. [LE_OCCURRENCE_DATE Y-Q-M]) is missing) then (1) else (2)

c) Na área de janela Propriedades, em Item de Dados, configure a propriedade Nome para Títuloda Data de Ocorrência.

d) Configure a Função Agregada e a Função de Agregado de Sintetização para Nenhuma.

9. No Explorador Condicional, conclua as etapas a seguir.a) Crie uma variável de sequência com a seguinte expressão:

[graphMain].[Occurrence Date Title]

b) Inclua um valor chamado 1.

10. Na página principal do relatório, conclua as seguintes etapas.a) Selecione YEAR_KEY em Categorias.


b) Na área de janela Propriedades, em Condicional, configure a Variável de Origem de Texto paraTítulo da Data de Ocorrência.

11. Selecione YEAR_KEY em Categorias.12. No Explorador Condicional, conclua as etapas a seguir.

a) Selecione o valor 1 partir da variável Título da Data de Ocorrência.b) Na área de janela Propriedades, em Origem de Texto, configure o valor de Texto para Todas as

Datas de Ocorrência.

13. Para incluir a nova variável nas propriedades das séries de gráfico, conclua as etapas a seguir.a) Na página principal do relatório, clique em YEAR_KEY.b) Utilizando o seletor Anterior, selecione Membro do Nó de Gráfico.c) Na área de janela Propriedades, em Dados, selecione Propriedades.d) Verifique o Título da Data de Ocorrência.


Resultados

A data de ocorrência agora mostra o texto Todas as Datas de Ocorrência ao invés do texto padrão.

Configurando o valor global TodosConfigurando o valor Todos em uma base relatório por relatório consome muito tempo. Também há aopção de configurar o valor de Todos para o conjunto inteiro de dimensões em sua estrutura. A limitaçãoneste método é que ele força cada valor a ser o mesmo valor.

Procedimento

1. No menu principal, clique em Administração > Aplicativo texto.2. Na pasta Estrutura de Relatório, acesse a configuração com.fw.template.dimension.all.3. Altere o valor de {0} (Todos) para Todos para cada idioma que estiver usando.4. Gere novamente a estrutura.

Utilizando Rótulos de DadosEm alguns dos exemplos anteriores, é possível notar que os títulos foram corrigidos como um item detexto. Isso pode causar problemas conforme se realiza drill up ou drill down porque perde-se o contextode onde se encontra na hierarquia.

Procedimento

1. Selecione o Item de texto Categoria de Risco que serve como o nome da Legenda e conclua asseguintes etapas.a) Na área de janela Propriedades em Origem de Texto, configure o Tipo de Origem para Rótulo do

Item de Dados.b) Configure a propriedade Rótulo do Item de Dados para LE_RISK_CATEGORY.


Resultados

Agora é possível ver que o título de legenda foi substituído pelo rótulo da categoria pai da qual foirealizado drill down.


Capítulo 9. Trabalhando com Entidades de NegóciosUma entidade de negócios é um objeto hierárquico. As entidades de negócios podem ter pais e filhos quesão as próprias entidades de negócios. Qualquer nível da estrutura de entidade de negócios pode teroutros objetos vinculados a ele, como processos e avaliações de risco.


É possível executar as seguintes tarefas com entidades de negócios:

• Definir o escopo e filtrar dados do relatório• Determinar como as instâncias de dados são contadas• Determinar como os números serão exibidos, como números individuais ou acumulados para uma

entidade de negócios selecionada• Ativar drill down e drill up no relatório

Há duas visualizações de entidades de negócios: GPC (avô-pai-filho) existente na estrutura por padrão eum modelo hierárquico definido pelo usuário.

O modelo definido pelo usuário pode ser criado no IBM OpenPages with Watson. Para obter informaçõesadicionais sobre como configurar esses níveis de objeto recursivo e dimensões de tipo de objeto para omodelo dimensional de uma entidade de negócios, consulte o Guia do administrador do IBM OpenPageswith Watson

O Assunto de Consulta SOXBUSENTITY_GPCO assunto de consulta SOXBUSENTITY_GPC é o objeto de entidade mais básico. Ele é semelhante aoobjeto do componente GPC, exceto que todos os valores fazem parte do mesmo assunto de consulta.

O assunto de consulta possui três níveis abstratos de entidades de negócios que podem ser usados emseu relatório:

• Entidade Avô (GEN)• Entidade Pai (PEN)• Entidade-Filha (CEN)

Nesse modelo, apenas a entidade-filha possui outros objetos associados a ela.

Esse é o assunto de consulta principal que será usado quando trabalhar com entidades de negócios nomodelo relacional.

A Hierarquia de Entidade Definida pelo UsuárioNo modelo definido pelo usuário, o usuário define os níveis de objeto recursivos e os nomes dos níveis. Aofazer isso, quando a estrutura for gerada novamente, você terá objetos em seu modelo com os nomesselecionados na IU.

Por exemplo, se a sua hierarquia consistir em regiões, países, estados e cidades, você verá quatro pastasem sua estrutura com estes nomes, assuntos de consulta e os relacionamentos apropriados entre eles.

Nota: Deve-se configurar o sistema para incluir a profundidade inteira de sua hierarquia, ou o modelo deestrutura criado não funcionará corretamente.

Além de definir os nomes dos níveis de sua hierarquia de entidade de negócios, é possível definir umadimensão de tipo de objeto que cria um objeto hierárquico na estrutura dimensional. Isso permite usar

modelos dimensionais em listas, crosstabs e gráficos. Somente usando modelos dimensionais é possívelusar os recursos drill up e drill down.

Quando uma hierarquia definida pelo usuário é criada, um assunto de consulta é criado para cada nível nahierarquia. A seguir estão as vantagens e desvantagens dessa estrutura de objeto:

• Cada nível da hierarquia é pré-filtrado e retornará apenas as entidades nesse nível.• Esses objetos são ideais para criar prompts de nível de entidade em cascata.• Eles podem ser utilizados como campos individuais em um relatório de lista sem precisar criar filtros

complexos.• Os cabeçalhos de campo refletem os nomes selecionados ao definir a hierarquia.

Esses são os objetos primários que serão utilizados quando trabalhar com entidades de negócios nomodelo dimensional.

Objetos do Componente GPCOs Objetos do Componente GPC são incluídos por padrão em seu modelo.

Esse objeto pode ser localizado apenas na pasta Miscellaneous > Advanced > GPC ComponentObjects. Três assuntos de consulta criados são equivalentes a um avô, pai e filho. Ao usar objetos decomponente, esteja ciente dos seguintes comportamentos:

• Se utilizar os assuntos de consulta independente, cada entidade aparecerá nos níveis de avô, pai e filho.• Se usar todos os três níveis do GPC em um relatório, deve-se incluir filtros para obter os valores

corretos em cada nível.• É possível utilizar o nível de avô para criar um prompt que contenha entidades de todos os níveis da

hierarquia.• Relatórios gravados com os objetos GPC são portáteis entre ambientes diferentes.

É recomendável gravar os relatórios com o assunto de consulta SOXBUSENTITY_GPC ao invés dessemodelo.

A Dimensão de Tipo de Objeto GPCNo modelo dimensional, é criada uma dimensão padrão chamada SOXBUSENTITY_GPC.

Esta dimensão é hierárquica com três níveis: avô, pai e filho. Cada nível na hierarquia possui somente osatributos do sistema de um objeto de entidade definido. Esta dimensão é utilizada apenas para filtragemem um relatório dimensional e não pode ser utilizada como uma dimensão em si, o que explica por queapenas os atributos do sistema são definidos.

O Modelo de Dados GPCHá três níveis de entidades no modelo de objeto GPC: avô, pai e filho. Isso forma uma abstração de seusdados. Mesmo se você tiver mais de três níveis em sua hierarquia de entidade, este modelo poderá serutilizado.

É possível visualizar os três seguintes níveis:

• Avôs não possuem pais, mas podem ter filhos.• Pais podem ter pais, podem ter filhos e podem ser filhos.• Filhos podem ter pais.

As colunas de numéricas no relatório representam a distância entre as entidades na hierarquia daentidade. Uma entidade é sempre um pai dela mesmo e um pai é sempre um filho dele mesmo. Isso podeser visto quando a distância é igual a zero.


Tabela 42. Uso típico no nível da entidade

Utilize este nível... Para...

avô (GEN_) Filtragem e definição de escopo

pai (PEN_) Agrupamento e agregação de dados, e prompt

filho (CEN_) Filtragem e definição de escopo

Filtrando Entidades de Negócios RelacionaisÉ possível filtrar entidades de negócios relacionais em seus relatórios.

Os tópicos a seguir descrevem como configurar a filtragem em relatórios.

• “Filtrando Utilizando o Caminho Completo” na página 117• “Filtrando Profundidade da Hierarquia” na página 119• “Filtrando Utilizando Prompts em Cascata” na página 119• “Referência Rápida para Exibição e Filtragem de Dados” na página 122

Filtrando Utilizando o Caminho CompletoA variável de caminho completo que existe em todos os objetos de entidade de negócios é comumenteutilizada para permitir que o usuário filtre o contexto do relatório.

As instruções para criar esse tipo de prompt podem ser localizadas em “Incluindo um Prompt deEntidade de Negócios” na página 52. Após o prompt ser criado, será possível ajustar o filtro que oassistente de prompt cria para obter os resultados desejados.

Neste primeiro exemplo, iremos exibir o nome do pai e o caminho completo.

A função desse filtro é permitir que somente o usuário veja a entidade exata que foi escolhida no prompt.O segundo filtro indica que você deseja ver apenas as entidades que possuírem distância de zero naentidade selecionada, conforme mostrado em Figura 40 na página 117. Este filtro pode retornar apenas aentidade que foi escolhida.

Figura 40. Filtragem de Entidade de Negócios – G2P = 0

Se eu eliminar o segundo filtro, eu obtenho o seguinte, conforme mostrado em Figura 41 na página 117:

Figura 41. Filtragem de Entidade de Negócios – Nenhuma Filtragem de G2P

Isso mostra a entidade selecionada no prompt e os filhos diretos sob essa entidade.

Se eu alterar o filtro G2P para 1 (mostram pais que são uma junção fora do avô), eu obtenho o seguinte,conforme mostrado em Figura 42 na página 118:

Capítulo 9. Trabalhando com Entidades de Negócios 117

Figura 42. Filtragem de Entidade de Negócios – G2P = 1

Isso mostra apenas os filhos da entidade selecionada.

Agora, se eu alterar a variável de exibição para a entidade filha e remover o filtro de distância, eu obtenhoo seguinte quando executar o relatório, conforme mostrado em Figura 43 na página 118:

Figura 43. Filtragem de Entidade de Negócios – Todos os Níveis

O que você vê agora (apenas uma parte dos dados é mostrada) é a entidade selecionada e todas asentidades sob o que foi selecionado. Isso é útil quando você desejar criar uma acumulação de todas asinformações sob uma entidade selecionada.

O que estes exemplos mostram é a flexibilidade que existe quando filtrar o objeto de entidade denegócios para obter dados em uma entidade específica, em filhos de entidades ou quando tudo estiveracumulado em uma entidade de negócios.

Campos de Contexto de Entidade RelacionalÉ possível usar campos de contexto de entidade relacional para filtrar entidades no modelo relacional.

A Tabela 43 na página 119 explica os campos de contexto usados para filtrar entidades no modelorelacional.


Tabela 43. Campos de Contexto de Entidade Relacional

Nome do Campo Descrição

G2P_DISTANCE O número de níveis entre um avô e um pai. O valor é 0 ou1.

G2P_IS_PRIMARY Indica se o objeto avô é o pai principal do objeto pai. Osvalores são Y e N.

P2C_DISTANCE O número de níveis entre um pai e um filho. Os valorespodem ser N a 0.

P2C_IS_PRIMARY Indica se o objeto pai é pai principal do objeto-filho. Osvalores são Y e N.

Filtrando Profundidade da HierarquiaÉ possível criar um prompt com base na profundidade de uma entidade na hierarquia.

Nota: Se você tiver um banco de dados IBM Db2, deverá substituir a função INSTR do Oracle naexpressão de amostra a seguir pela função DB2 correspondente.

Por exemplo, suponha que você tenha uma hierarquia de entidade de negócios distribuídauniformemente e deseja que o usuário selecione somente a partir do terceiro nível da hierarquia. Épossível colocar o seguinte filtro em seu prompt para que eles possam ver somente o terceiro nível dahierarquia:

instr([PEN_FULL_PATH],'/',1,3) > 0 and

instr([PEN_FULL_PATH],'/',1,4) = 0

Este filtro utiliza o número de barras na variável de caminho completa para determinar a profundidadeabsoluta de uma entidade na hierarquia.

Todos os itens possuem três barras que são o que o filtro foi projetado para exibir.

Filtrando Utilizando Prompts em CascataPrompts em cascata são utilizados quando o usuário deseja ver apenas os valores de prompt com baseem uma seleção de um prompt anterior.

Sobre Esta Tarefa

Este exemplo demonstra como usar os objetos na pasta GPC para criar uma série de prompts em cascata.

Procedimento

1. Crie um novo relatório de lista.2. Siga as instruções em “Criando uma Página de Prompt” na página 50.3. Para criar um prompt de nível global, conclua as etapas a seguir.

a) Arraste um Item de texto para a primeira coluna da tabela. Insira o texto para o prompt no itemde texto.

b) Selecione a célula de tabela e configure o local para estar à direita horizontalmente everticalmente para cima.

c) Coloque o texto em negrito usando o ícone Negrito.d) Arraste um objeto Prompt de Valor para a segunda coluna de sua página de prompt.


a) Selecione a opção Criar um novo parâmetro.


b) Na caixa, digite um nome para o parâmetro, por exemplo, Entidade Global.c) Clique em Avançar.

5. Na tela Criar filtro, conclua as etapas a seguir.a) Selecione a opção Criar um filtro parametrizado.b) Na caixa Item de pacote, clique no botão Navegar e navegue até o item de consulta a seguir

(como os nomes desses itens de consulta são definidos pelo usuário, eles podem ser diferentesno seu sistema):

DEFAULT_REL|GRC_OBJECTS|SOXBUSENTITY_FOLDER|REGIONAL HIERARCHY|1_GLOBAL_FOLDER|ID_FIELDS|[GLOBAL]|ID_FIELDS|[GLOBAL_ENTITY_ID]



6. Na tela Preencher controle, conclua as etapas a seguir.a) Selecione a opção Criar nova consulta.b) Na caixa Nome, digite um nome para a consulta, por exemplo, Entidade Global de Prompt.c) Na caixa Valores para exibir, clique no botão Navegar e navegue até o item de consulta a seguir:

DEFAULT_REL|GRC_OBJECTS|SOXBUSENTITY_FOLDER|REGIONAL HIERARCHY|1_GLOBAL_FOLDER|[GLOBAL]|[GLOBAL_NAME00]

d) Os valores a seguir serão exibidos na caixa:

[DEFAULT_REL].[GLOBAL].[GLOBAL_NAME00]

e) Clique em Concluir.7. Selecione o prompt recém-criado e na categoria Geral na área de janela Propriedades, altere o valor

de Selecionar IU para Caixa de Listagem.8. Na área de janela Propriedades em Dados, configure a propriedade Classificação para ser o nome

da entidade de negócios.9. Se houver um número limitado de itens no prompt, será possível configurar a altura do prompt para

um valor que mostre apenas os prompts e nenhum espaço em branco. Conclua as seguintes etapas.a) Selecione o prompt na tabela cuja altura deseja configurar.b) Na área de janela Propriedades, em Posicionamento, selecione Tamanho e Estouro.c) Na caixa de diálogo, configure a altura para 14 pt vezes o número de linhas no prompt.

10. Para incluir um botão de reprompt na página de prompt, conclua as etapas a seguir.a) Arraste um Botão de Prompt para a célula de tabela sob o prompt de valor recém-criado.b) Na área de janela Propriedades em Geral, configure a propriedade Tipo para Novo Prompt.c) Arraste um Item de texto para o botão de prompt e insira o seguinte texto: AtualizarEntidade Regional.

d) Na área de janela Propriedades em Cor e Plano de Fundo, configure a propriedade Cor do Planode Fundo para Prata.

e) Selecione a célula de tabela na qual o botão foi colocado.f) Na área de janela Propriedades em Posicionamento, configure a propriedade Tamanho e

Estouro para 40 px.11. No Explorador de consultas, selecione o assunto da consulta Prompt de entidade global e conclua

as etapas a seguir.

a) Clique na guia Caixa de ferramentas na área de janela Objetos que podem ser inseridos.


b) Arraste e solte um objeto de Filtro na área de janela de Filtro da consulta.c) Na área de janela Definição de Expressão, insira a seguinte expressão:

[DEFAULT_REL].[GLOBAL].[IS_ROW_PUSHED_DOWN]='N'

O item de dados pode ser encontrado na seguinte pasta:

DEFAULT_REL|GRC_OBJECTS|SOXBUSENTITY_FOLDER|REGIONAL HIERARCHY|1_GLOBAL_FOLDER|[GLOBAL]|HIERARCHY_CONTEXT|[IS_ROW_PUSHED_DOWN]

d) Clique em OK.12. Para criar um prompt de nível regional, conclua as etapas a seguir.

a) Arraste um Item de texto para a primeira coluna da tabela. Insira o texto para o prompt no itemde texto.

b) Selecione a célula de tabela e configure o local para estar à direita horizontalmente everticalmente para cima.

c) Coloque o texto em negrito usando o ícone Negrito.d) Arraste um objeto Prompt de Valores para a página de prompt.

O Assistente de Prompt é aberto13. Na tela Escolher parâmetro do Assistente de Prompt, conclua as etapas a seguir.

a) Selecione a opção Criar um novo parâmetro.b) Na caixa, digite um nome para o parâmetro, por exemplo, Entidade de Região.c) Clique em Avançar.

14. Na tela Criar filtro, conclua as etapas a seguir.a) Selecione a opção Criar um filtro parametrizado.b) Na caixa Item de pacote, clique no botão Navegar e navegue até o item de consulta a seguir

(como os nomes desses itens de consulta são definidos pelo usuário, eles podem ser diferentesno seu sistema):

DEFAULT_REL|GRC_OBJECTS|SOXBUSENTITY_FOLDER|REGIONAL HIERARCHY|2_REGIONS_FOLDER|[REGIONS]|ID_FIELDS|[REGIONS_ENTITY_ID]



15. Na tela Preencher controle, conclua as etapas a seguir.a) Selecione a opção Criar nova consulta.b) Na caixa Nome, digite um nome para a consulta, por exemplo, Prompt de Entidade deRegião.


DEFAULT_REL|GRC_OBJECTS|SOXBUSENTITY_FOLDER|REGIONAL HIERARCHY|2_REGIONS_FOLDER|[REGIONS]|[REGIONS_NAME00]

d) Os valores a seguir serão exibidos na caixa:

[DEFAULT_REL].[REGIONS].[REGIONS_NAME00]

e) Na lista Origem em Cascata, selecione Entidade Global.f) Clique em Concluir.

16. Selecione o prompt recém-criado e na categoria Geral na área de janela Propriedades, altere o valorde Selecionar IU para Caixa de Listagem.


17. Na área de janela Propriedades em Dados, configure a propriedade Classificação para ser o nomeda entidade de negócios.

18. Se houver um número limitado de itens no prompt, será possível configurar a altura do prompt paraum valor que mostre apenas os prompts e nenhum espaço em branco. Conclua as seguintes etapas.a) Selecione o prompt na tabela cuja altura deseja configurar.b) Na área de janela Propriedades, em Posicionamento, selecione Tamanho e Estouro.c) Na caixa de diálogo, configure a altura para 14 pt vezes o número de linhas no prompt.

19. No Explorador de consultas, selecione o assunto da consulta Prompt de entidade global e concluaas etapas a seguir.

a) Clique na guia Caixa de ferramentas na área de janela Objetos que podem ser inseridos .b) Arraste e solte um objeto de Filtro na área de janela de Filtro da consulta.c) Na área de janela Definição de Expressão, insira o seguinte:

[DEFAULT_REL].[REGIONAL].[IS_ROW_PUSHED_DOWN]='N'

O item de dados pode ser encontrado na seguinte pasta:

DEFAULT_REL|GRC_OBJECTS|SOXBUSENTITY_FOLDER|REGIONAL HIERARCHY|2_REGIONS_FOLDER|[GLOBAL]|HIERARCHY_CONTEXT|[IS_ROW_PUSHED_DOWN]

d) Clique em OK.20. Para incluir um botão de reprompt na página de prompt, conclua as etapas a seguir.

a) Arraste um Botão de Prompt para a célula de tabela sob o prompt de valor recém-criado.b) Na área de janela Propriedades em Geral, configure a propriedade Tipo para Novo Prompt.c) Arraste um Item de texto para o botão de prompt e insira o seguinte texto: AtualizarEntidade Regional.

d) Na área de janela Propriedades em Cor e Plano de Fundo, configure a propriedade Cor do Planode Fundo para Prata.

e) Selecione a célula de tabela na qual o botão foi colocado.f) Na área de janela Propriedades em Posicionamento, configure a propriedade Tamanho e

Estouro para 40 px.21. Repita as etapas 11-17 e crie o prompt do Departamento. Não é necessário incluir um botão de novo

prompt após este prompt.

Resultados

Quando o relatório for renderizado pela primeira vez, somente o prompt global é preenchido.

Ao selecionar um valor na lista e clicar em Atualizar Entidade Regional, a caixa de listagem de entidadede região será preenchida apenas com as entidades que forem filhas diretas da entidade GlobalFinancial Services.

Mais uma vez, ao selecionar América do Norte e clicar em Atualizar Entidade de Departamento, a caixade listagem Entidade de Departamento é preenchida com as entidades que forem filhas diretas daentidade América do Norte.

Referência Rápida para Exibição e Filtragem de DadosÉ possível usar informações de referência rápida ao criar prompts.

O Tabela 44 na página 123 contém informações de referência que podem ser utilizadas ao criar prompts.

Para utilizar estas informações de referência rápida, selecione uma das opções de exibição de dados dorelatório e, em seguida, implemente cada uma das configurações nessa linha.

Para cada opção de exibição de dados, selecione os valores de entidade a seguir no campo Prompt deValor:


• Para Item de pacote, selecione GEN_ENTITY_ID• Para Operador, selecione o sinal de igual (=)• Para Valor a ser usado, selecione PEN_ENTITY_ID• Para Valor a ser exibido, selecione PEN_FULL_PATH

Tabela 44. Referência Rápida de Entidades

Opções de exibição de dados do relatório Valor do item deconsulta (páginaRelatório)

Item de consulta e valor em uma expressão de filtro (assunto deconsulta de Relatório)

Somente a entidade selecionada

Este relatório pode suportar um prompt delista de multisseleção. Use in para ooperador Prompt de valores.

GEN_NAME00 G2P_DISTANCE=0

A entidade selecionada e o próximo nível PEN_NAME00 Não aplicável

A entidade selecionada e todos os níveis soba entidade

CEN_NAME00 Não aplicável

O próximo nível sob a entidade selecionada PEN_NAME00 G2P_DISTANCE=1

Selecionar a entidade de nível inferior no prompt resulta em umrelatório nulo.

Todos os níveis sob a entidade selecionada CEN_NAME00 G2P_DISTANCE=1

Selecionar a entidade de nível inferior no prompt resulta em umrelatório nulo.

Uma rolagem somente na entidadeselecionada

Utilize esta opção somente com um relatóriocrosstab.

GEN_NAME00 Não aplicável

Filtrando Entidades de Negócios DimensionaisÉ possível filtrar entidades de negócios dimensionais no modelo dimensional.

Os tópicos a seguir descrevem a metodologia para filtrar as entidades ao utilizar o modelo dimensional doIBM OpenPages with Watson.

• “Campos de Contexto de Entidade Dimensional” na página 124• “O Modelo Dimensional de Entidade de Negócios” na página 125• “Prompts Dimensionais” na página 126• “Usando entidades de negócios para drill down e drill-up” na página 126

Para filtrar entidades no modelo dimensional, um conjunto diferente de valores de filtro foi criado. Essesvalores de filtro permitem entender o relacionamento do item do membro para onde você se encontra nahierarquia.

O conceito-chave que precisa ser entendido é o de rebaixar. O modelo dimensional é projetado para quecada vez que um drill down é feito para outro nível, os dados exibidos se acumulem a partir do nívelanterior.

Um item de dados que foi rebaixado corresponde aos dados localizados no nível anterior na hierarquia.Por exemplo, se olharmos os dados na crosstab mostrada no Figura 44 na página 124, vemos que há 21problemas abertos na entidade de negócios na América do Norte e 13 problemas encerrados.


Figura 44. Dados de Problema de Entidade

Ao realizar drill down em América do Norte para refinar ainda mais nossas informações, vemos osseguintes dados, conforme mostrado na Figura 45 na página 124.

Figura 45. Dados de Problema de Entidade Mostrando Empurrar para Baixo

Os itens rebaixados são emissões anexadas à entidade de negócios América do Norte diretamente ou pormeio de outro objeto. Se eles não forem mostrados na crosstab, os dados nos quais foram feitos drilldown não serão acumulados com o que estava no nível anterior, e os seus usuários ficarão curiosos comessa discrepância.

Campos de Contexto de Entidade DimensionalÉ possível usar campos de contexto de entidade dimensional para filtrar entidades de negóciosdimensionais no modelo dimensional.

A Tabela 45 na página 124 explica os campos de contexto que são usados para filtrar entidades nomodelo dimensional.

Tabela 45. Campos de Contexto de Entidade

Nome do Campo Descrição

OP_RECURSIVE_NATIVE_LEVEL Este é um valor numérico que representa o nível nativo doobjeto na árvore de entidade de negócios.

HIERARCHY_LEVEL Isso indica o nível da hierarquia que você consultou.

IS_ROW_PUSHED_DOWN Isso indica se essa linha foi enviada por push para esse nível.Os valores são Y ou N.

ROW_HIERARCHY_LEVEL Este é um valor numérico que representa o nível do objetoconforme definido na hierarquia de entidade de negócios.

ROOT_NATIVE_LEVEL Esse é o nível nativo da raiz da hierarquia.

ROOT_FULL_PATH É o caminho completo para a raiz dessa hierarquia.

Todos os campos de contexto de entidade podem ser acessados no IBM Cognos Analytics - Reportingcom a sintaxe a seguir:

roleValue(<Field Name>, <Entity Hierarchy>)


Em que <Field Name> é uma sequência entre aspas da tabela anterior e <Entity Hierarchy> é o nomecompleto da hierarquia de entidade. O exemplo a seguir mostra a sintaxe correta para esta função:

roleValue('IS_ROW_PUSHED_DOWN',[DEFAULT_DIM].[ENTITY].[ENTITY])

O Modelo Dimensional de Entidade de NegóciosÉ possível usar uma hierarquia de entidade de negócios de amostra para saber mais sobre o modelo deentidade de negócios dimensional.

Para explicar melhor o modelo de entidade de negócios dimensional, vamos olhar uma hierarquia deentidade de negócios de amostra, conforme mostrada em Figura 46 na página 125:

Figura 46. Hierarquia da Entidade de Negócios

Agora, se olharmos o valor dos campos de contexto como uma função do nível de entidade, veremos osseguintes resultados, conforme mostrado em Figura 47 na página 125:

Figura 47. Nível Global

Isso mostra que, quando usamos o assunto de consulta global, da hierarquia de entidade de negócios, asseguintes variáveis de contexto são retornadas:

• O [NATIVE_LEVEL] das entidades na hierarquia é 1 porque criamos nossa hierarquia a partir deste nível.• O [HIERARCHY_LEVEL] é configurado como 1 porque todos os objetos retornados estão no nível global

da hierarquia.• Os valores [IS_ROW_PUSHED_DOWN] são configurados como N porque nesse nível, não pode haver

nenhuma entidade rebaixada no nível superior da hierarquia.• O [ROW_HIERARCHY_LEVEL] é igual ao [NATIVE_LEVEL] porque criamos nossa hierarquia de entidade

a partir do nível superior.

Quando consultamos o nível da região da hierarquia, vemos os seguintes resultados, conforme mostradonaFigura 48 na página 125:

Figura 48. Nível da Região


Isso mostra que, quando usamos o assunto de consulta da região, da hierarquia de entidade de negócios,as seguintes variáveis de contexto são retornadas:

• O [NATIVE_LEVEL] das entidades é 1 e 2 devido à entidade Global Financial Services que foi rebaixadapara esse nível.

• O [HIERARCHY_LEVEL] é configurado como 2 porque todos os objetos retornados estão no nível deregião da hierarquia.

• O campo [IS_ROW_PUSHED_DOWN] mostra que a entidade de nível superior Global Financial Servicesfoi rebaixada para esse nível.

• O [ROW_HIERARCHY_LEVEL] é igual ao [NATIVE_LEVEL] porque criamos nossa hierarquia de entidadea partir do nível superior.

Quando consultamos o nível de estado da hierarquia, vemos os seguintes resultados, conforme mostradona Figura 49 na página 126:

Figura 49. Nível de Estado

Isto mostra que, quando usamos o assunto de consulta de estado da hierarquia de entidade de negócios,as seguintes variáveis de contexto são retornadas.

• O [NATIVE_LEVEL] das entidades é 2 ou 3 devido às entidades que foram rebaixadas para esse nível.• O [HIERARCHY_LEVEL] é configurado como 3 porque todos os objetos retornados estão no nível de

estado da hierarquia.• O campo [IS_ROW_PUSHED_DOWN] mostra que as entidades anteriores a esse nível foram rebaixadas

para esse nível.• O [ROW_HIERARCHY_LEVEL] é igual ao [NATIVE_LEVEL] porque criamos nossa hierarquia de entidade

a partir do nível superior.

Prompts DimensionaisEles são descritos em “Incluindo Prompts” na página 93.

Usando entidades de negócios para drill down e drill-upAntes de poder criar um relatório com drill up e drill down, deve-se definir níveis de objeto recursivo edefinir uma dimensão de tipo de objeto usando os níveis de objeto recursivo.

Essas instruções podem ser localizadas no Guia do administrador do IBM OpenPages with Watson.


Drill down e drill up podem ser usados apenas com o modelo dimensional do IBM OpenPages withWatson. Para demonstrar isso, é possível criar um gráfico simples, usando uma hierarquia de entidade e oobjeto de controle.

Procedimento

1. Crie um relatório de gráfico e conclua as seguintes etapas.a) Selecione o agrupamento de gráfico de Coluna.b) Selecione o tipo de gráfico Coluna.c) Clique em OK.

2. Arraste e solte os itens de consulta a seguir nas várias seções de gráfico (os nomes dos campospodem ser diferentes em seu sistema):


DEFAULT|DEFAULT_DIM|OBJECT_TYPE_DIMENSIONS| ENTITY|

ENTITY| Global• Medidas Padrão (eixo y)

DEFAULT|DEFAULT_DIM|GRC_OBJECTS|SOXCONTROL_FOLDER| SOXCONTROL_FACTS|SOXCONTROL (COUNT_DISTINCT)

• Série

DEFAULT|DEFAULT_DIM|GRC_OBJECTS|SOXCONTROL_FOLDER|

CN_OPERATING_EFFECTIVENESS| CN_OPERATING_EFFECTIVENES3. No Explorador de Consultas, selecione a consulta e conclua as seguintes etapas.

a) Na área de janela Propriedades em Diversos, configure o nome para chartMain.b) Arraste e solte um objeto Filtro na área de janela de filtro.c) Na área de janela Expressão de Relatório, insira o código a seguir:

[DEFAULT_DIM].[ENTITY].[ENTITY].[GLOBAL]. [IS_ROW_PUSHED_DOWN] = 'N'

d) Clique em OK.e) Repita as etapas b-d para os níveis restantes da hierarquia de entidade de negócios.

4. No Explorador de Página, selecione a página principal do relatório.5. Dê um clique duplo no título e configure o valor para Eficácia Operacional de Controle.6. Abra Títulos do Eixo e conclua as etapas a seguir.


7. Selecione (Título da Legenda Padrão) e conclua as seguintes etapas.a) Na área de janela Propriedades em Geral, configure a propriedade Título Padrão para Nenhum.b) Dê um clique duplo no título de legenda e configure o valor para Efetividade operacional.

8. Clique em Dados > Comportamento de Drill e conclua as seguintes etapas.a) Marque a caixa de seleção Permitir drill-up e drill-down.b) Clique em OK.



Resultados

Ao clicar em Global Financial Services no relatório, o relatório realiza drill down para essa entidade.

O resultado mostra dados associados aos filhos do Global Financial Services.


Capítulo 10. Trabalhando com ObjetosCompartilhados

Objetos compartilhados são objetos que podem ser um filho de diversos tipos de objetos pais. Porexemplo, diversos objetos de risco pais podem referenciar um objeto de controle compartilhado único ouum objeto de controle pode ter diversos pais.

Agregando Dados para Objetos CompartilhadosSe um objeto-filho compartilhado possuir diversos pais do mesmo tipo de objeto, o objeto compartilhadopoderá ser contado diversas vezes resultando em uma contagem imprecisa.

Por exemplo, suponha que ocorra uma perda de $ 1.000,00 e a perda foi compartilhada entre doiseventos de perda diferentes para o mesmo risco identificado. A Figura 50 na página 129 mostra asassociações que existem entre os objetos Risco, Evento de perda e Impacto de perda:

Figura 50. Associações do Objeto Pai-Filho de Evento de Perda

Se tentar agregar valores para Impacto de Perda no nível de Risco usando a seguinte função:

O valor de retorno será 2000,00 (em vez de 1000,00) porque o Impacto de perda-1 será contado duasvezes:

Risco-1 > Evento de perda-1 > Impacto de perda-1

Risco-1 > Evento de perda-2 > Impacto de perda-1

Para obter uma contagem distinta de objetos compartilhados, utilize a seguinte fórmula:

[average(Loss Impacts for Risk)] * [count (distinct Loss Impacts for Risk)]

O valor de retorno será 1.000,00 porque a o Loss Impact-1 será contado apenas uma vez.

Como alternativa, podemos expressar a fórmula matemática conforme mostrado no exemplo a seguir:

average * distinct_count = total/count * distinct_count = total * distinct_count/count

Portanto, se a nossa intenção é totalizar os Impactos de Perda para um Risco conforme mostrado noexemplo anterior, totalizaríamos o Impacto repetido, multiplicando por 1/2 para fatorar a repetição.

Criando um Relatório de Agregação Para Objetos CompartilhadosEsse procedimento cria um relatório de amostra que conta o número de controles exclusivo Ineficaz eEfetivo em uma entidade de negócios.

Sobre Esta Tarefa

O Figura 51 na página 130 mostra a associação entre os objetos Entidade, Processo, Risco e Controleneste cenário. Como os objetos Controle filhos podem ter diversos objetos Risco pais, é importante que ovalor de um controle seja contado apenas uma vez no relatório.

Figura 51. Associações Pai e Filho de Controle

Procedimento

1. Crie um novo relatório de lista.2. Crie uma consulta-filha:

a) No Explorador de Consultas, abra a consulta.b) Na área de janela Propriedades em Diversos, configure o nome para listMain.c) Retorne ao Explorador de Consultas e selecione a pasta de nível superior Consultas.

d) Clique na guia Caixa de ferramentas .e) Arraste um objeto Consulta ao lado da consulta listMain.f) Selecione o novo objeto de consulta.g) Na área de janela Propriedades em Diversos, configure o Nome para listMain1.

3. Para incluir outro objeto de consulta-filha para o objeto de consulta criado na etapa anterior, concluaas seguintes etapas.a) Arraste um objeto Consulta para a consulta listMain1.b) Selecione o novo objeto de consulta.c) Na área de janela Propriedades em Diversos, configure o Nome para listMain2.

4. Para incluir itens de consulta na consulta listMain2 criada na etapa anterior, conclua as seguintesetapas.a) Selecione a consulta listMain2 para abri-la.

b) Clique na guia Origem na área de janela Objetos que Podem Ser Inseridosc) Arraste os itens de consulta a seguir para a caixa Itens de Dados:


• DEFAULT|DEFAULT_REL|GRC_OBJECTS|SOXBUSENTITY_FOLDER|[SOXBUSENTITY_GPC]| [SOXBUSENTITY_GPC]|[PEN_NAME00]

• DEFAULT|DEFAULT_REL|GRC_OBJECTS|SOXBUSENTITY_FOLDER|[SOXBUSENTITY_GPC]| [SOXBUSENTITY_GPC]|ID_FIELDS|[PEN_ENTITY_ID]

• DEFAULT|DEFAULT_REL|GRC_OBJECTS|SOXBUSENTITY_FOLDER|[SOXBUSENTITY_GPC]| [SOXBUSENTITY_GPC]|ID_FIELDS|[GEN_REPORTING_PERIOD_ID]

• DEFAULT|DEFAULT_REL|GRC_OBJECTS|SOXCONTROL_FOLDER|[SOXCONTROL]|ID_FIELDS| [CN_CONTROL_ID]

• DEFAULT|DEFAULT_REL|GRC_OBJECTS|SOXCONTROL_FOLDER|[SOXCONTROL] |ENUMERATION_FIELDS| OPERATING_EFFECTIVENES (ENUMERATION)|[CN_OPERATING_EFFECTIVENES_ID]

5. Inclua filtros no relatório:a) Selecione o item de dados [GEN_REPORTING_PERIOD_ID] recém-incluído e arraste-o para a

área de janela Filtros de detalhes.b) Na área de janela Definição de Expressão, defina a expressão de filtro:

[GEN_REPORTING_PERIOD_ID] = -1

c) Clique em OK.d) Selecione o item de dados [CN_CONTROL_ID] recém-incluído e arraste-o para a área de janela

Filtros de detalhes.e) Na área de janela Definição de Expressão, defina a expressão de filtro:

[CN_CONTROL_ID] is not null

f) Clique no ícone Validar para validar a expressão e, em seguida, clique em OK.6. Para incluir um item de dados no objeto de consulta, conclua as etapas a seguir.

a) Clique na guia Caixa de ferramentas .b) Arraste um objeto Item de Dados para a caixa Itens de Dados da consulta.c) Na área de janela Definição de Expressão do item de dados, insira a seguinte expressão:

IF([CN_OPERATING_EFFECTIVENES_ID] = #$SOXCONTROL_OPERATING_EFFECTIVENES_DEFINITION_MAP {"Ineffective"}#)THEN ([CN_CONTROL_ID])ELSE (NULL)

d) Clique no ícone Validar para validar a expressão e, em seguida, clique em OK.7. Na área de janela Propriedades do item de dados, conclua as etapas a seguir.

a) Altere a propriedade Nome do item de dados para Controle Ineficaz.b) Altere a propriedade Função Agregada para Nenhuma.

8. Para visualizar os dados tabulares, clique em Executar > Visualizar Dados Tabulares.9. Abra o assunto de consulta listMain1 no Explorador de Consultas. Para contar o número de

controles distintos para cada entidade, conclua as etapas a seguir.

a) Clique na guia Origem e arraste e solte o item de consulta [PEN_NAME00] na área de janelaItens de dados.

b) Na área de janela Propriedades em Item de Dados, configure a Função Agregada paraNenhuma.

c) Clique na guia Caixa de ferramentas e arraste um objeto de Item de dados para a área dejanela Itens de dados.

d) Na caixa Definição de Expressão, insira a seguinte expressão para contar o número total decontroles distintos:

Capítulo 10. Trabalhando com Objetos Compartilhados 131

count(distinct [listMain2].[CN_CONTROL_ID] for [listMain2].[PEN_NAME00])

e) Clique no ícone Validar para validar a expressão e, em seguida, clique em OK.10. Na área de janela Propriedades do item de dados, conclua as etapas a seguir.

a) Em Item de Dados, configure a propriedade Nome para Contagem de Controles.b) Configure a propriedade Função Agregada para Nenhuma.c) Configure a propriedade Função de Agregado de Sintetização para Nenhuma.

11. Para contar o número de controles ineficazes para cada entidade, conclua as etapas a seguir.

a) Clique na guia Caixa de ferramentas e arraste um objeto de Item de dados para a área dejanela Itens de dados.

b) Na caixa Definição de Expressão, insira a seguinte expressão para contar o número total decontroles distintos:

count(distinct [listMain2].[Ineffective Control] for [listMain2].[PEN_NAME00])

c) Clique no ícone Validar para validar a expressão e, em seguida, clique em OK.12. Na área de janela Propriedades do item de dados, conclua as etapas a seguir.

a) Em Item de Dados, configure a propriedade Nome para Contagem de ControlesIneficientes.

b) Configure a propriedade Função Agregada para Nenhuma.c) Configure a propriedade Função de Agregado de Sintetização para Nenhuma.

13. Execute o modelo tabular neste nível.14. Abra o assunto de consulta listMain no Explorador de Consultas e conclua as etapas a seguir.

a) Arraste e solte os itens de consulta a seguir para a área de janela Itens de Dados:

• [PEN_NAME00]• [Count of Controls]• [Count of Ineffective Controls]

b) Na área de janela Propriedades para cada um dos controles anterior, configure a FunçãoAgregada para Nenhuma.

15. No Explorador de Página, navegue até Page1 e conclua as seguintes etapas.a) Clique na guia Itens de Dados.b) Arraste os seguintes objetos da consulta listMain na lista:

• [PEN_NAME00]• [Count of Controls]• [Count of Ineffective Controls]

16. Inclua um prompt de entidade de negócios conforme descrito em “Incluindo um Prompt de Entidadede Negócios” na página 52.


Resultados

Neste exemplo, havia quatro riscos que compartilhavam dois controles. Se este método não foi utilizadopara calcular a contagem de controles, o valor teria sido retornado incorretamente como 4.


Contando Objetos Compartilhados em Relatórios de GráficoÉ necessário executar algumas tarefas adicionais em um gráfico ao contar o número de objetos em umaentidade quando alguns dos objetos são compartilhados. Por exemplo, você pode desejar relatar o totalde controles em uma entidade de negócios quando alguns controles tiverem diversos Riscos pais.

Procedimento

1. Crie um novo relatório de Gráfico e conclua as seguintes etapas.a) Selecione o agrupamento de Gráfico de Coluna.b) Selecione o tipo de gráfico Coluna.c) Clique em OK.

2. Crie uma página de prompt seguindo as instruções em “Criando uma Página de Prompt” na página 503. Inclua um prompt de entidade de negócios conforme descrito em “Incluindo um Prompt de Entidade

de Negócios” na página 52.4. No Explorador de consultas, selecione Query1 e conclua as etapas a seguir.

a) Na área de janela Propriedades em Diversos, configure o Nome para graphMain.b) Arraste os itens de consulta a seguir para a área de janela Itens de Dados:

• DEFAULT|DEFAULT_REL|GRC_OBJECTS|SOXBUSENTITY_FOLDER| [SOXBUSENTITY_GPC]|[CEN_NAME00]

• DEFAULT|DEFAULT_REL|GRC_OBJECTS|SOXBUSENTITY_FOLDER| [SOXBUSENTITY_GPC]|ID_FIELDS|[CEN_ENTITY_ID]

• DEFAULT|DEFAULT_REL|GRC_OBJECTS|SOXCONTROL_FOLDER| [SOXCONTROL]| ID_FIELDS|[CN_CONTROL_ID]


• Categories (x-axis) - [CEN_NAME00]• Measures (y-axis) - [CN_CONTROL_ID]

6. No Explorador de consultas, selecione a consulta graphMain e conclua as seguintes etapas.a) Selecione CN_CONTROL_ID.b) Na área de janela Propriedades na categoria Item de Dados, configure a propriedade Função

Agregada para Contagem Distinta.c) Configure a propriedade Função de Agregado de Sintetização para Automática.

7. Dê um clique duplo no título e configure o valor para Contagem de controle.8. Abra Títulos do Eixo e conclua as etapas a seguir.


9. Selecione o gráfico inteiro e na área de janela Propriedades na categoria Gráfico Anotações,configure a propriedade Legenda para Ocultar.


Resultados

O relatório exibe os resultados da contagem de controle que é filtrada pela entidade de negócios que foiselecionada. Deve-se escolher uma entidade de negócios na qual seja possível verificar os valores nográfico.

Capítulo 10. Trabalhando com Objetos Compartilhados 133

Listagem de Objetos Compartilhados em Relatórios de ListaÉ possível listar objetos compartilhados em relatórios de lista.

Há uma propriedade chamada Grupo e Resumo Automáticos anexada a todos os assuntos de consultaque ajuda a eliminar ou mostrar registros duplicados. É possível fazer as seguintes seleções napropriedade:

SimSe desejar exibir cada controle somente uma vez, não importa quantos riscos pais ele possuir. Este éo padrão.

NãoSe você desejar exibir um controle uma vez para cada objeto de risco ao qual ele estiver associado.Portanto, se um controle possuir três riscos pais, então o controle será exibido três vezes.

Dependendo de como você gravou seu relatório e se o objetivo é mostrar os objetos compartilhados, seránecessário ajustar essa configuração em seu assunto de consulta.


Capítulo 11. Trabalhando com Objetos RecursivosPara ver todos os itens conectados aos diferentes níveis da hierarquia recursiva no seu relatório, há umaconstrução chamada de triângulo de relatório.


Para obter informações sobre como os objetos recursivos são manipulados em modelos de estruturabásica, veja “Modelos de estrutura” na página 15.

Triângulos de Relatório

No Capítulo 9, “Trabalhando com Entidades de Negócios”, na página 115, discutimos como trabalhar comobjetos de entidade de negócios recursivos. No entanto, há três outros objetos recursivos no IBMOpenPages with Watson que existirão em seu sistema se você tiver as soluções apropriadas:

• Subprocesso• Submandato• Subconta

Geralmente a partir de um ponto de vista do autor do relatório, você deseja ver todos os itens conectadosaos diferentes níveis da hierarquia recursiva em seu relatório. Para isso, é necessário criar umrelacionamento em seu namespace em que um objeto tinha mais de um pai, o que não é permitido.

Para contornar este problema, criamos uma construção chamada de triângulo de relatório. Há três tiposde triângulos que podem ser criados, conforme mostrado nas figuras a seguir:

Figura 52. Triângulo de Processo, Subprocesso e de Risco

Figura 53. Triângulo de Mandato, Submandato e de Requisito

Figura 54. Triângulo de Conta, Subconta e de Asserção

O fator comum aqui é que o objeto recursivo é o centro do triângulo. Assim, ao criar um triângulo sempreque lidar com um objeto recursivo, o autor do relatório não precisa gravar um código separado paramanipular o caso em que os dados são anexados ao objeto principal e o caso em que os dados sãoanexados ao subobjeto.

Se o triângulo não for suportado no namespace que está sendo usado, sempre é possível unir osresultados de dois namespaces para produzir os mesmos valores como se o triângulo existisse.

O Guia do administrador do IBM OpenPages with Watson descreve como criar um triângulo. O único avisoé que cada vez que você cria um novo triângulo ou inclui um em outro namespace, deve-se executar umscript SQL que ativa o relacionamento de triângulo específico e, em seguida, recriar o esquema.


Capítulo 12. Internacionalização e localizaçãoO aplicativo IBM OpenPages with Watson é totalmente internacionalizado e localizado.

Tradução de DadosO IBM OpenPages with Watson contém dados estáticos e de aplicativo (instância).

Geralmente todos os dados estáticos são traduzidos por meio da estrutura de relatório ou pelo relatórioenquanto os dados do aplicativo não são traduzidos, com exceção de sequências enumeradas.

O idioma no qual um usuário visualiza estes dados tem como base a configuração do código de idioma dousuário que é definida no OpenPages with Watson quando o usuário é criado ou modificadoposteriormente. Isso é o que determina como o relatório será traduzido.

É possível configurar o código de idioma do usuário no IBM Cognos Analytics, que o separaria do códigode idioma configurado no aplicativo OpenPages with Watson. Isso normalmente é feito pelo autor dorelatório para deixar um usuário específico com um código de idioma no aplicativo OpenPages withWatson e outro código de idioma quando usar relatórios. Consulte “Configurando seu código de idioma noIBM Cognos Analytics” na página 42.

Dados EstáticosHá quatro categorias de dados estáticos: rótulos dinâmicos, campos de texto fixo, texto de botão e textoem prompts.Dados de rótulo dinâmicos

Isso inclui o texto do rótulo exibido para os tipos de objeto (como entidade de negócios, conta,controle, etc.) e os nomes de campo do objeto (como Eficácia Operacional, etc.), além de botões,rótulos, caixas de texto, os títulos de coluna, etc. Esses dados (e as traduções) são criados quando oscampos são definidos no aplicativo IBM OpenPages with Watson.

Dados do campo de texto fixoIsso inclui qualquer sequência de texto fixo que tiver sido incluída no relatório pelo autor do relatóriousando um objeto de texto.

Texto do botãoIsso inclui o texto exibido por qualquer botão ou botões de prompt na página de prompt.

Texto estático em promptsIsso inclui qualquer texto estático incluído em um prompt (como Todos) ou em um prompt que é todoo texto estático.

Traduzindo Dados de Rótulo DinâmicoAo criar um relatório utilizando o Report Design Language, a área de janela Objetos que Podem SerInseridos e a janela de design de relatório mostram os nomes do objeto e de campo utilizando o nome dosistema interno.

Ao executar o relatório, o texto estático é exibido no código do idioma do usuário definido no IBMOpenPages with Watson:

• Se o código de idioma do usuário estiver configurado para Report Design Language (RDL), os títulos dascolunas estão em RDL, mas os dados estão em inglês.

• Se o código do idioma do usuário estiver configurado como inglês dos EUA no aplicativo OpenPageswith Watson, quando o relatório for executado, os títulos de coluna serão traduzidos para o inglês dosEUA.

• Se o código do idioma do usuário estiver configurado como espanhol no aplicativo OpenPages withWatson, quando o relatório for executado no código do idioma espanhol, os títulos de coluna serãotraduzidos para o espanhol.

Estes exemplos demonstram por que utilizamos o Report Design Language como o idioma padrão paraprojetar o relatório e como o sistema converte internamente os títulos estáticos com base nas definiçõescarregadas no aplicativo OpenPages with Watson. Isto economizará tempo e esforço para o autor dorelatório se os relatórios estiverem sendo criados para uma empresa de diversos códigos do idioma.

Os dados do aplicativo inseridos pelo usuário não são traduzidos. Se os dados tiverem sido inseridos porum usuário espanhol, descrições em espanhol serão exibidas para cada código do idioma porque osdados do aplicativo não são traduzidos por código do idioma.

Utilizando uma variável de condição para conversão de dados de campo de texto fixoTodos os objetos de texto (títulos, subtítulos e rótulos de relatório) que forem incluídos em um relatórioprecisarão ser localizados. É possível utilizar variáveis de condição para executar esta tradução no textoestático. Para fazer isso, uma variável de condição deve ser criada primeiro.

Procedimento

1. Abra o menu Explorador de Condição e selecione Variáveis.2. Arraste e solte um objeto Variável de Idioma de Relatório da caixa de ferramentas para a caixa

Variáveis.A caixa de diálogo Idiomas é aberta.

3. Complete as seguintes etapas.a) Selecione os idiomas para os quais o texto precisa ser localizado. A lista a seguir mostra os idiomas

que são suportados no OpenPages with Watson:

• Inglês (Reino Unido)• Inglês (Estados Unidos)• Francês (França)• Alemão (Alemanha)• Italiano (Itália)• Japonês (Japão)• Espanhol

b) Clique em OK.

4. Na área de janela Propriedades, insira o nome da variável no Campo de nome. Utilize Localizaçãocomo o nome.

5. Para converter um campo de texto em um idioma específico no seu relatório, selecione um dos rótulosque precisa ser traduzido. Neste exemplo, o título do relatório Lista de Teste foi selecionado.

6. Na área de janela Propriedades do Item de texto selecionado, no grupo Condicional, na propriedadeVariável de Origem de Texto, selecione a variável Localização que você acabou de criar.

7. No Explorador de Condição, selecione um dos idiomas na variável de idioma.8. Na área de janela Propriedades em Origem de Texto, conclua as etapas a seguir.

a) Na propriedade Texto, insira a sequência localizada do rótulo, por exemplo, Prueba Lista.b) Clique em OK.c) Repita as etapas 3-4 e defina a sequência de texto para todos os idiomas.d) Quando todas as sequências de idiomas forem definidas, selecione Nenhuma Variável no

Explorador de Condição.

9. Para visualizar o relatório, conclua as seguintes etapas.a) Efetue login utilizando um usuário que possui seu código do idioma configurado para espanhol (se

você ainda não estiver com login efetuado com um usuário do código do idioma espanhol).b) Execute o relatório.


Resultados

O título do relatório agora aparece traduzido.

Esta metodologia pode ser seguida por qualquer rótulo de texto em seu relatório. A variável de condiçãoque foi criada pode ser reutilizada para cada objeto que precisar de conversão.

Traduzindo Texto do BotãoNormalmente os botões de texto na página de prompt não requerem localização porque isso émanipulado pela ferramenta de relatório. Por outro lado, se você criar seu próprio botão de prompt, seránecessário localizar seu texto.

Procedimento

1. Identifique o botão que deseja localizar.2. Selecione um Item de texto a partir da caixa de ferramentas e conclua as seguintes etapas.

a) Solte o Item de texto no botão.b) Insira Atualizar Linha de Negócios como a sequência de texto padrão.c) Na área de janela de propriedades do Item de Texto, insira a variável de condição Localização

como a propriedade Variável de Origem de Texto.

3. No Explorador de Condição, conclua as etapas a seguir.a) Enquanto o Item de Texto é selecionado, selecione cada idioma na variável Localização que

deseja especificar.b) Insira a sequência de texto apropriada na propriedade Texto.c) Repita para cada idioma que deseja especificar.

4. Para visualizar o relatório, conclua as seguintes etapas.a) Efetue login utilizando um usuário cujo código do idioma é diferente do usuário atual.b) Execute o relatório.

Traduzindo Texto Estático nos PromptsPode ser necessário traduzir texto estático em prompts para o código de idioma do usuário.

Procedimento

1. Identifique o prompt no qual deseja localizar o texto estático. Neste exemplo, iremos localizar o textoestático no prompt Região.

2. Selecione o prompt Região e conclua as seguintes etapas.a) Selecione a propriedade Opções Estáticas na área de janela Propriedades.b) Na lista Variáveis, selecione Localização, a variável de condição que foi criada para traduzir o texto

para outros idiomas.c) Na lista Valor, selecione Inglês (Estados Unidos).d) Usando o ícone Incluir, insira os valores para a lista de seleção estática para inglês.e) Selecione Espanhol na lista Valor e insira os valores em espanhol usando o ícone Editar.f) Clique em OK para salvar os valores.

3. Para visualizar o relatório, conclua as seguintes etapas.a) Efetue login usando um usuário que possua um código padrão de idioma configurado para

Espanhol (se você ainda não estiver com login efetuado com um usuário do código do idiomaespanhol).

b) Execute o relatório.

Capítulo 12. Internacionalização e localização 139

Resultados

O texto no prompt aparece traduzido em espanhol.

Quando o código do idioma é configurado para Inglês (Estados Unidos) o prompt Região aparece comseus valores em inglês.

Dados de aplicativoHá quatro categorias de dados do aplicativo: dados inseridos pelo usuário, sequências enumeradas,campos de moeda e campos de data.Dados inseridos pelo usuário

Isso inclui todos os dados inseridos pelos usuários. Isso não é traduzido.Dados de sequência enumerada

Isso inclui todos os dados selecionados pelos usuários de uma lista de valores de sequênciaenumerada. Esses dados (e as traduções) são criados quando a lista de sequências enumeradas édefinida no aplicativo IBM OpenPages with Watson.

Campos de moedaIsso inclui quaisquer dados que forem configurados como uma moeda.

Campos de dataIsso inclui quaisquer dados que forem formatados como uma data ou data e hora.

Traduzindo Sequências Enumeradas de Valor ÚnicoUm campo de sequência enumerada com valor único permite que um usuário selecione apenas um valorna lista. Por exemplo, o tipo de objeto de risco possui um campo de sequência enumerada chamadaimpacto inerente a partir do qual apenas um valor pode ser selecionado na lista.

Em um campo de sequência enumerada com valor único, a sequência é traduzida dentro do assunto deconsulta com base na configuração de código de idioma do usuário.

Quando estiver com login efetuado no aplicativo com o código de idioma do usuário configurado paraespanhol, o mesmo campo aparecerá.

Quando a sequência enumerada de impacto inerente foi definida por meio do aplicativo IBM OpenPageswith Watson, os valores em espanhol para a sequência também foram inseridos no sistema.

Arquitetura da Pasta de Estrutura para Enumerações de Valor ÚnicoCada assunto de consulta para um objeto contém uma pasta chamada ENUMERATION_FIELDS com assequências enumeradas para esse objeto específico.

O exemplo em Figura 55 na página 140 mostra o objeto SOXRisk e a enumeração de INHERENT_IMPACTque possui um valor único.

Figura 55. Estrutura de Pasta SOXRisk

Definições de Campo para Enumerações de Valor ÚnicoCada enumeração com valor único tem os itens de consulta a seguir: <field_name>_SYSTEM_NAME,<field_name> e <field_name>_ID.


<field_name>_SYSTEM_NAMEContém os valores de sequência no Report Design Language.

<field_name>Contém os valores de sequência baseados na configuração do código de idioma do aplicativo IBMOpenPages with Watson do usuário com logon efetuado.

<field_name>_IDContém um identificador numérico para um valor de sequência enumerada. Não é garantido que esteidentificador será o mesmo entre as instalações.

Ao exibir o valor em um relatório, <field_name> deverá sempre ser usado. Ao filtrar esse valor, use ocampo <field_name>_ID porque ele está indexado.

O Figura 56 na página 141 mostra as enumerações de Impacto Inerente no código do idioma inglês. Onome do sistema e o nome do código do idioma são os mesmos porque nenhuma mudança foi feita novalor Inglês quando o item de dados foi carregado no sistema. Possivelmente o nome do sistema (emRDL) e o nome em inglês são diferentes.

Figura 56. Impacto Inerente no Código do Idioma Inglês

O Figura 57 na página 141 mostra as enumerações de Impacto Inerente no código do idioma espanhol. Onome do sistema permanece em RDL, ao passo que o nome do código do idioma é traduzido para oespanhol.

Figura 57. Impacto Inerente no Código do Idioma Espanhol

Traduzindo Sequências Enumeradas com Diversos ValoresUm campo de sequência enumerada com diversos valores permite que um usuário selecione diversosvalores de sequência a partir de uma lista.

Em um campo de sequência enumerada com diversos valores, a sequência é traduzida dentro do assuntode consulta com base na configuração de código de idioma do usuário.

Quando a sequência enumerada de domínio é definida por meio do aplicativo IBM OpenPages withWatson, os valores em espanhol para a sequência são inseridos no sistema, permitindo que os usuáriosvisualizem os valores traduzidos no código do idioma espanhol.

Arquitetura da Pasta de Estrutura para Enumerações Com Diversos ValoresA estrutura de pasta para enumerações contém enumerações de valor único e com diversos valores.

A Figura 58 na página 142 mostra a pasta de enumerações para o objeto SOXProcess expandido com apasta de domínio aberta para mostrar seus campos. O campo de domínio é de diversos valores.


Figura 58. Estrutura de Pasta

Definições de Campo para Enumerações com Diversos ValoresCada enumeração com diversos valores tem os itens de consulta a seguir:<field_name>_SYSTEM_NAME, <field_name>, <field_name>_ID, <field_name>_SYSTEM_LIST e<field_name>_LIST.<field_name>_SYSTEM_NAME

Contém os valores de sequência no Report Design Language. Haverá um registro para cadaenumeração selecionada. Isso retorna um registro para cada valor selecionado pelo usuário.

<field_name>Contém os valores de sequência convertidos baseados na configuração do código de idioma doaplicativo IBM OpenPages with Watson do usuário. Isso retorna um registro para cada valorselecionado pelo usuário.

<field_name>_IDContém um identificador numérico para um valor de sequência enumerada. Não é garantido que esteidentificador será o mesmo entre as instalações. Isso é retornado como uma lista separada por barravertical ( | ).

<field_name>_SYSTEM_LISTContém uma lista separada por vírgula dos valores de sequência baseados no Report DesignLanguage.

<field_name>_LISTContém uma lista separada por vírgula dos valores de sequência baseados na configuração do códigode idioma do usuário.

Para obter uma lista separada por vírgula dos valores convertidos da sequência, o autor do relatórioprecisa selecionar o campo <field_name>_LIST e usar isso no relatório. Esse é o melhor campo a serutilizado para exibir o valor de uma sequência enumerada com diversos valores.

O Figura 59 na página 143 mostra os campos de domínio, no código do idioma inglês dos EUA, para osriscos que são carregados no sistema. Apenas um registro por risco é retornado quando qualquer um doscampos agregados é utilizado.


Figura 59. Campos de Diversos Valores de Domínio em Inglês

Ao incluir campos RI_DOMAIN_SYSTEM_NAME ou RI_DOMAIN, você verá o seguinte resultado (um filtrofoi colocado no relatório para um risco que teve diversos valores de domínio):

Figura 60. Campos de Todos os Domínios em Inglês

Observe que esses campos retornam um único registro para cada valor que o usuário selecionou.

Estes dois campos são utilizados para filtrar e não para exibir dados para o usuário devido a registrosduplicados. O filtro típico utilizado para o domínio de risco seria semelhante ao seguinte:

[DEFAULT_REL].[SOXRISK].[RI_DOMAIN] in ?Domain? ou ?Domain? = 'All'

Esse filtro é utilizado em conjunto com um prompt multisseleção para filtrar valores de domínio. Eletambém inclui um valor para Todos que foi incluído como um valor estático para o prompt.

Quando alternamos para um usuário com um código de idioma espanhol, vemos o seguinte para oscampos agregados de ID do domínio de risco, Lista de sistemas de domínio de risco e Lista de domíniosde risco:

Figura 61. Campos com Diversos Valores de Domínio em Espanhol

Observe que os valores de ID de Domínio de Risco e os valores de Lista de Sistema de Domínio de Riscosão idênticos aos valores vistos em Figura 59 na página 143. A Lista de Domínio de Risco e os títulos decabeçalho do campo estão agora no código do idioma espanhol do usuário.

O exemplo em Figura 55 na página 140 mostra o objeto SOXRisk e a enumeração de Impacto Inerenteque possui um valor único. O Figura 62 na página 143 mostra o que vemos quando incluímos o Nome doSistema de Domínio de Risco e o Domínio de Risco no relatório (um filtro foi incluído no relatório para umrisco com diversos valores de domínio):

Figura 62. Campos de Todos os Domínios em Espanhol


Observe novamente que esses campos retornam um único registro para cada valor que o usuárioselecionou.

Traduzindo Campos de Data Usando Formatos de Data PredefinidaHá formatos de data predefinida para todos os códigos do idioma do OpenPages with Watson.

Sobre Esta Tarefa

Os formatos descritos aqui podem ser utilizados ou os autores do relatório podem especificar seuspróprios formatos customizados.

A tabela a seguir especifica o formato para cada código do idioma.

Tabela 46. Formatos de Data Predefinida

Código de idioma Formato de Data Formatado

Inglês (Reino Unido) dd mmm aaaa

Inglês (Estados Unidos) mmm dd, aaaa

Francês (França) dd mmm. aa

Alemão (Alemanha) dd.mm.aaaa

Italiano (Itália) dd/mmm/aa

Japonês (Japão) aaaa/mm/dd

Espanhol (Espanha) dd/mm/aaaa

Procedimento

1. Neste exemplo, vamos localizar a data de criação do risco. Crie um relatório simples que exiba o nomedo risco, a descrição do risco, e a data de criação do risco.O relatório deve assemelhar-se ao exemplo a seguir:

2. Selecione o campo de data RI_CREATION_DATE e conclua as seguintes etapas.a) Clique com o botão direito do mouse e selecione Estilo > Formato de Dados.b) Configure o Tipo de formato para Data, mas não configure nenhuma das propriedades.c) Clique em Ok.

3. Salve o relatório.

Resultados

Ao configurar o campo para ser uma data sem propriedades de formatação, a data agora terá o formatopadrão para o código do idioma inglês dos Estados Unidos, conforme visto na tabela no início destetópico.

Agora execute este relatório com um usuário que tenha um código do idioma espanhol, com a data agorapossuindo o formato padrão para o código do idioma espanhol, conforme visto na tabela no início destetópico.

Traduzindo Campos de Data Usando Formatos de Data CustomizadosPara criar um formato de data customizado para diversos idiomas, é necessário localizar o campo de datacom um formato condicional e configurar os formatos para cada idioma.


Procedimento

1. Neste exemplo, vamos localizar a data de criação de risco para obtermos formatos customizadospara os códigos do idioma alemão e francês. Crie um relatório simples que exiba o nome do risco, adescrição do risco e a data de criação do risco.

2. Selecione o campo de dados RI_CREATION_DATE.3. Na área de janela Propriedades, no título Condicional, configure a Variável de Estilo para a

Localização da variável condicional.4. No Explorador de Condição, selecione Alemão que está presente na variável Localização.5. Clique com o botão direito do mouse e selecione Estilo > Formato de Dados.6. Na tela Formato de Dados, configure as seguintes propriedades:

a) Configure o Tipo de Formato para Data.b) Configure o Separador de Data para um ponto (.).c) Configure a Ordem da Data para Dia,Mês,Ano.d) Configure Exibir Anos para Mostrar século.e) Configure Exibir Meses para Mostrar nome.f) Configure Exibir Dias para Dois dígitos.

7. Clique em OK.8. No Explorador de Condição, selecione Francês que está presente na variável Localização.9. Clique com o botão direito do mouse e selecione Estilo > Formato de Dados.

10. Na tela Formato de Dados, configure as seguintes propriedades:a) Configure o Tipo de Formato para Data.b) Configure o Separador de Data para um ponto (.).c) Configure a Ordem da Data para Dia,Mês,Ano.d) Configure Exibir Anos para Mostrar século.e) Configure Exibir Meses para Mostrar nome.f) Configure Exibir Dias para Dois dígitos.

11. Clique em OK.12. Salve o relatório.

Resultados

Ao optar por configurar as propriedades customizadas do campo de data, a data agora possui o formatodefinido customizado para o código do idioma francês ao invés do formato de data padrão.

Agora execute este relatório com um usuário que possua um código do idioma alemão, com a data agorapossuindo o formato customizado para o código do idioma alemão ao invés do formato de data padrão.

Traduzindo Campos de Moeda Usando Formatos PredefinidosExistem formatos de moeda predefinidos para todos os códigos de idioma do IBM OpenPages withWatson.

Siga este procedimento para utilizar um formato predefinido.

Sobre Esta Tarefa

Os formatos descritos aqui podem ser utilizados ou os autores do relatório podem especificar seuspróprios formatos customizados.

A tabela a seguir especifica o formato para cada código do idioma.


Tabela 47. Formatos de Moeda Predefinidos

Código de idioma Formato de Moeda Formatado

Inglês (Reino Unido) £ NNN,NNN.NN

Inglês (Estados Unidos) $ NNN,NNN.NN

Francês (França) NNN NNN,NN €

Alemão (Alemanha) NNN.NNN,NN €

Italiano (Itália) € NNN.NNN,NN

Japonês (Japão) ¥ NNN,NNN

Espanhol (Espanha) NNN.NNN,NN €

Procedimento

1. Neste exemplo, vamos localizar o nível de aceitação de risco da entidade. Crie um relatório simplesque exiba o nome da entidade, a descrição da entidade e o nível de aceitação de risco da entidadepara o nível do avô.

2. Selecione o campo moeda GEN_RISK_APPETITE_BA e conclua as seguintes etapas.a) Clique com o botão direito do mouse e selecione Estilo > Formato de Dados.b) Configure o Tipo de formato para Moeda, mas não configure nenhuma das propriedades.c) Clique em Ok.

3. Salve o relatório.

Resultados

Ao configurar o campo para ser uma moeda sem propriedades de formatação, a moeda agora terá oformato padrão para o código do idioma inglês dos Estados Unidos, conforme visto na tabela no iníciodeste tópico.

Agora execute este relatório com um usuário que possua um código do idioma espanhol.

A moeda agora possui o formato padrão para o código do idioma espanhol, conforme visto na tabela noinício deste tópico.

Traduzindo Campos de Moeda Usando Formatos CustomizadosPara criar um formato da moeda customizado para diversos idiomas, é necessário localizar o campo demoeda com um formato condicional e configurar os formatos para cada idioma.

Procedimento

1. Neste exemplo, vamos localizar o nível de aceitação de risco da entidade. Crie um relatório simplesque exiba o nome da entidade, a descrição da entidade e o nível de aceitação de risco da entidadepara o nível do avô. Também vamos configurar o formato para alemão e inglês do Reino Unido.

2. Selecione o campo de dados GEN_RISK_APPETITE_BA.3. Na área de janela Propriedades, no título Condicional, configure a Variável de Estilo para a

Localização da variável condicional.4. No Explorador de Condição, selecione Alemão que está presente na variável Localização.5. Clique com o botão direito do mouse e selecione Estilo > Formato de Dados.6. Na tela Formato de Dados, configure as seguintes propriedades:

a) Configure o Nº de Casas Decimais para 0.b) Configure o Separador de Decimal para uma vírgula (,).c) Configure Utilizar Separador de Milhares para Sim.


d) Configure o Separador de Milhares para uma vírgula (,).

7. Clique em OK.8. No Explorador de Condição, selecione Inglês do Reino Unido que está presente na variável

Localização.9. Clique com o botão direito do mouse e selecione Estilo > Formato de Dados.

10. Na tela Formato de Dados, configure a Posição do Símbolo de Moeda para Final.

11. Clique em OK.12. Salve o relatório.

Resultados

Ao optar por configurar as propriedades do campo de moeda personalizado (o separador é uma vírgula), amoeda agora possui o formato que foi definido customizado, em vez do formato da moeda padrão para oidioma alemão.

Agora execute este relatório com um usuário que possua um código do idioma inglês do Reino Unido.

A moeda agora possui o formato customizado (símbolo de moeda no final) para o código do idioma inglêsdo Reino Unido ao invés do formato de moeda padrão.

Utilizando Mapas de Parâmetro com Filtros de Sequência EnumeradaTraduzida

Para criar filtros com base em sequências enumeradas que são independentes de códigos de idioma,deve-se usar mapas de parâmetro. Como o mapa do parâmetro é considerado o código do idioma RDL,deve-se utilizar valores em inglês e executar a sua comparação nos campos de ID.

Para cada definição de sequência enumerada, um mapa do parâmetro correspondente é criado naestrutura. O mapa do parâmetro retorna o ID de cada valor de sequência enumerada transmitido para ele.

Use a seguinte convenção de nomenclatura para os mapas de parâmetro:

<Object Name>_<Enumerated String>_DEFINITION_MAP

Os mapas de parâmetro devem ser utilizados em todos os filtros que envolverem enumerações quepodem ser traduzidas porque eles sempre retornarão o mesmo ID, independentemente do código doidioma que estiver configurado para o usuário.

Por exemplo, queremos filtrar um valor do prompt de Alto para o campo de impacto inerente no objetoSOXRisk. Digitaremos o seguinte em um campo de filtro:

?Inherent Impact Id? = #$SOXRISK_INHERENT_IMPACT_DEFINITION_MAP("High")#

?Inherent Impact Id? é o parâmetro de prompt definido no relatório.



Capítulo 13. Utilizando Funções de Banco de DadosPredefinidas

O IBM OpenPages with Watson expôs determinadas funções do banco de dados para uso pelos autoresde relatório a fim de resolver determinados problemas técnicos que são comuns entre os ambientes.

Este capítulo descreve essas funções e fornece exemplos de como utilizá-las.

Transmitindo ParâmetrosNa SQL, os parâmetros são transmitidos posicionalmente (primeiro valor para o primeiro parâmetro,segundo valor para o segundo parâmetro, terceiro valor para o terceiro parâmetro, e assim por diante).

Embora não seja possível, por exemplo, transmitir um valor para o terceiro parâmetro enquanto ignora osegundo parâmetro, é possível, no entanto, aproveitar os parâmetros com valores padrão.

Por exemplo:

A função predefinida a seguir (localizada em “Obtendo IDs de Recurso de Caminho de Árvore” na página175) possui sete parâmetros:

"OP_RPS_AUX.IS_REL_PARENT_CHILD" (P1, P2, P3, P4, P5, P6, P7)

Os parâmetros P1 e P2 não possuem valores padrão, os parâmetros P3 a P7 possuem valores padrão.

Você poderia, por exemplo, especificar valores para os parâmetros P1 a P3 e omitir valores para osparâmetros P4 a P7. Nesse caso, a função usaria os valores padrão para P4 - P7, tal como na expressãode amostra a seguir:

"OP_RPS_AUX.IS_REL_PARENT_CHILD" ([DEFAULT_REL].[SOXPROCESS].[PR_PROCESS_ID], [DEFAULT_REL].[SOXCONTROL].[CN_CONTROL_ID], -1)

Devido à natureza posicional dos parâmetros em SQL, se você desejasse usar um valor diferente do valorpadrão para o parâmetro P6 (o padrão é Y, mas desejamos N), precisaria incluir os valores padrão para P4(que é N) e P5 (que é Y) também, como na expressão de amostra a seguir:

"OP_RPS_AUX.IS_REL_PARENT_CHILD" ([DEFAULT_REL].[SOXPROCESS].[PR_PROCESS_ID], [DEFAULT_REL].[SOXCONTROL].[CN_CONTROL_ID], -1, 'N', 'Y', 'Y')

Determinando um ID de Tipo de ObjetoAlgumas das funções de banco de dados predefinidas possuem parâmetros que requerem um ID do tipode objeto (um identificador numérico para o tipo de objeto). Para determinar um valor de ID numérico deum tipo de objeto específico, é possível executar uma consulta utilizando uma ferramenta SQL ou criar eexecutar um relatório.

Utilizando SQL para Obter IDs de ObjetoPara obter uma lista de objetos e de IDs de tipo de objeto a partir do banco de dados, execute umcomando SQL.

Utilizando uma ferramenta SQL, execute o seguinte comando SQL para obter uma lista de objetos e deIDs de tipo de objeto a partir do banco de dados.

SELECT name,

assettypeidFROM assettypesORDER BY nome

Os IDs de tipo de ativo podem ser diferentes de um ambiente para outro.

Algumas funções de SQL são diferentes em IBM Db2 do que no Oracle. Se utilizar uma função Oracle queestiver listada na tabela a seguir, deve-se substituir a função do DB2 correspondente.

Tabela 48. Mapeando o Oracle para as funções do DB2

Substitua essa função do DB2... Por esta função do Oracle...

INSTR (P1, P2, P3, P4 {CODEUNITS32}) INSTR (P1, P2, P3, P4)

SUBSTR2 SUBSTR

LISTAGG STRAGG

OP_LENGTH (P1) LENGTH (P1)

Em que P1, P2, P3, P4 representam parâmetros.

O código de exemplo a seguir mostra a função INSTR do Oracle:

INSTR([CEN_FULL_PATH], ’/’, 1, 2)

Para DB2, você substituiria esse código pela função INSTR:

INSTR([CEN_FULL_PATH], ’/’, 1, 2, {CODEUNITS32})

Utilizando um Relatório para Obter IDs de ObjetoÉ possível criar um relatório e, em seguida, executá-lo para obter os nomes de objeto e os IDs de tipo deobjeto.

Sobre Esta Tarefa

Por exemplo, a coluna CONTENT_TYPE_ID do relatório de amostra mostrada na figura a seguir lista todosos IDs de tipo de objeto disponíveis que podem ser usados. Suponha que você deseja usar a funçãoOP_RPS_AUX.IS_REL_PARENT_CHILD_PRIM. Os parâmetros P1 e P3 desta função requererem os IDs detipo de objeto do tipo de objeto filho e pai. É possível utilizar, por exemplo, 18 em P1 (ID do tipo de objetoRiskAssessment filho) e 4 no P3 (SOXBusEntity pai).


Figura 63. Relatório de Amostra Mostrando o Identificador Numérico de Tipo de Objeto

Procedimento

1. Crie um novo relatório de Lista.2. Navegue para DEFAULT_REL|MISCELLANEOUS.3. No: assunto de consulta LOCALIZED_CONTENT_TYPES, arraste o SYSTEM_NAME e o

CONTENT_TYPE_ID para o modelo de relatório.4. Mude o valor do campo Classificar para Classificação crescente para o título SYSTEM_NAME.5. Execute o relatório em PDF.6. Salve o arquivo PDF resultante em sua unidade local.

Determinando Nomes da Tabela de Banco de DadosOs nomes de tabela de banco de dados possuem convenções de nomenclatura específicas.

em que:

<OBJECT TYPE> é o nome do tipo de objeto.

<ENUMERATION> é o nome de um campo de sequência enumerada com diversos valores.

Esta convenção de nomenclatura... Indica que é...

RT_<OBJECT TYPE>


Tabela principal

Por exemplo, RT_RISKASSESSMENT

RT_<OBJECT TYPE>_<ENUMERATION>


Tabela de Enumeração com Diversos Valores

Por exemplo, RT_RISKASSESSMENT_DOMAIN

RT__<OBJECT TYPE>_<OBJECT TYPE>

(RT__ com um sublinhado duplo)

Tabela de ponte entre 2 tipos de objeto

Por exemplo, RT__RISKASSESSMENT_PROCESS

Importante:

• O banco de dados Oracle possui uma limitação de 30 caracteres para um nome de tabela. Algunsnomes de tabela serão truncados.

Capítulo 13. Utilizando Funções de Banco de Dados Predefinidas 151

• As tabelas 'RT_' devem estar todas em letras maiúsculas e entre aspas simples, por exemplo,'RT_RISK'.

• Qualquer entrada 'RT_' com mais de um sublinhado na sequência é uma tabela de seleção comdiversos valores. Por exemplo, em registros de Risco, há um campo de seleção com diversos valoreschamado Confirmações de declaração financeira. Essas informações de campo são armazenadas natabela RT_RISK_FINANCIAL_STATEMENT_AS.

Obtendo uma lista de nomes de tabela RTÉ possível usar uma ferramenta SQL para obter uma lista de nomes de tabelas RT.

Use uma ferramenta SQL para executar o seguinte comando:

SELECT object_nameFROM dba_objectsWHERE object_name like 'RT_%'ORDER BY object_name

O resultado é a lista de todas as tabelas RT no banco de dados.

Determinando Nomes da Coluna da Tabela de Banco de DadosHá três técnicas para determinar os nomes de colunas da tabela de banco de dados.

Muitos nomes de colunas da tabela podem ser determinados por um dos seguintes métodos:

• Expandindo um assunto de consulta no IBM Cognos Analytics - Reporting para obter os nomes decampo

• Abrindo a pasta de tabelas em uma ferramenta SQL e expandindo a definição de tabela que você estáprocurando

• Utilizando a função <table_name> DESCRIBE em SQL para obter a definição de tabela

Nota:

• Nomes de campo longos que excederem 22 caracteres são truncados após o caractere 22 (porexemplo, FINANCIAL_STATEMENT_ASSERTIONS torna-se FINANCIAL_STATEMENT_AS). No entanto,se dois ou mais nomes de campo tiverem os mesmos 22 primeiros caracteres, então os nomes serãotruncados no caractere 20, e um identificador sequencial de dois dígitos será anexado. Exemplo:

FINANCIAL_STATEMENT_ASSERTIONS becomes FINANCIAL_STATEMENT_00FINANCIAL_STATEMENT_ASSERTIONS_MINOR becomes FINANCIAL_STATEMENT_01

• Se diversos atributos forem necessários, será possível concatenar diversos valores de campo com umdelimitador, por exemplo:

'NAME00' || '||' || '''=''' || '||' || 'FULL_PATH'

O Nome concatenado e delimitado mais 'FULL_PATH' é um impulso no desempenho para evitarchamada da função duas vezes. Esse método pode ser usado somente com propriedades regulares nãoenumeradas.

• O truncamento de variáveis será diferente em diferentes ambientes.

Utilizando Funções GeraisEsta seção descreve as funções gerais do banco de dados.


Converter Enumerações Multivalor em NomesEssa função converte uma lista separada por tokens de IDs de valor enumerado em uma lista separada eclassificada de nomes localizados.

Os autores de relatório podem utilizar esta função para transformar um ID de enumeração multivalor emuma sequência única. Essa função elimina a necessidade de utilizar instruções SQL customizadas ouassuntos de consulta adicionais.

Importante: Para Oracle, há um limite máximo de 4000 caracteres para uma sequência única.

Sintaxe

Esta função possui a sintaxe a seguir:

"OP_RPS_AUX.CONVERT_EVIDLIST_TO_NAME" (P1, P2, P3, P4, P5)

em que:

Tabela 49. Parâmetros da função

Parâmetro Descrição

P1 Obrigatório. O nome de variável da variável enumerada multivalor a ser convertidaem uma sequência.

P2 Obrigatório. O ID do código do idioma (um identificador numérico). Usado paratraduzir automaticamente o texto das sequências enumeradas para o código deidioma do usuário que está executando o relatório.

Nota: Um valor igual a NULL (sem aspas) pode ser usado; no entanto, fornecer oparâmetro de sessão de código de idioma ou o ID do código de idioma proporciona omelhor desempenho de processamento. O uso de NULL forçará a função a usar o IDdo código de idioma padrão do sistema.

Para retornar o parâmetro de sessão que fornece o valor do código do idioma dousuário que está executando o relatório, utilize a seguinte expressão:

#$account.parameters.openPagesLocaleId#

Padrão: NULL (sem aspas e sem distinção entre maiúsculas e minúsculas)

P3 Opcional.

Especifica o caractere delimitador a ser utilizado como um separador dos itens naslistas de seleção com diversos valores (enumerações com diversos valores).

Normalmente, esse valor pode ser uma vírgula (,), um ponto e vírgula (;) ou umcaractere de barra vertical (|).

Padrão: ','


Tabela 49. Parâmetros da função (continuação)


P4 Opcional.

Especifica a coluna na qual os valores da lista de seleção (enumerações comdiversos valores) serão classificados.

Valores possíveis:'EV_DISPLAY_ORDER'

Usar para classificar os valores de lista pela ordem de exibição de seu valorenumerado, conforme eles aparecem na interface com o usuário do aplicativo(padrão).

'EV_NAME'Usar para classificar os valores de lista pelo nome do valor enumeradolocalizado.

P5 Opcional.

Especifica a direção de classificação para os itens nas listas de seleção com diversosvalores (enumerações com diversos valores).

Valores possíveis:'ASC'

Isso classifica os valores de lista em ordem crescente (padrão).'DESC'

Isso classifica os valores de lista em ordem decrescente.

Exemplo de uso

O exemplo a seguir mostra como obter o campo Domínio na tabela RT_PROCESS e convertê-lo em umalista de sequência de texto. Figura 64 na página 154 mostra a saída do relatório de amostra.

Figura 64. Converter EVIDLIST em Saída de Nome


Converter Enumerações de Valor Único em NomesEssa função converte um ID do valor enumerado único em um nome localizado.

Os autores de relatório podem utilizar esta função para transformar um ID de enumeração em um nome.Essa função elimina a necessidade de utilizar instruções SQL customizadas ou assuntos de consultaadicionais.

Sintaxe


"OP_RPS_AUX.CONVERT_EVID_TO_NAME" (P1, P2)

em que:



P1 Obrigatório. O ID numérico da variável enumerada de valor único a ser convertido emuma sequência.






Exemplo de uso

O exemplo a seguir mostra como obter o ID de Nível de Maturidade de Processo a partir do objetoSOXProcess e convertê-lo em sua sequência de texto. Figura 65 na página 155 mostra a saída dorelatório de amostra.

Figura 65. Converter EVID em Saída de Nome


Contando o Número de Ocorrências de TextoEsta função retorna a contagem de um texto especificado em uma determinada sequência.

Sintaxe


"OP_UTILITIES.COUNT_TEXT_OCCURENCE" (P1, P2)

em que:



P1 Obrigatório. A sequência de texto a ser avaliada.

P2 Obrigatório. A sequência a ser contada.

Exemplo de uso

O exemplo a seguir conta o número de barras (/) no caminho completo de uma entidade de negócios avó.Figura 66 na página 156 mostra a saída do relatório de amostra.

Figura 66. Contagem de Saída de Ocorrência de Texto

Determinando um Relacionamento de Estrutura Entre ObjetosEsta função identifica se um relacionamento pai-filho existe ou não (direto ou indireto, primário ou nãoprimário) entre quaisquer dois objetos em uma estrutura dimensional.

Esta função é usada especificamente no modelo dimensional na estrutura do IBM OpenPages para juntarobjetos independentes quando solicitado pelo usuário. Ela elimina a contagem duplicada de objetosacumulados e manipula corretamente dados que são enviados por push a partir de um nível superior nahierarquia.

Sintaxe


"OP_RPS_AUX.IS_FM_REL_PARENT_CHILD" (P1, P2, P3, P4, P5, P6, P7, P8, P9, P10)

em que:



P1 Obrigatório. O ID do objeto (um valor numérico) do tipo de objeto pai que está maisalto na hierarquia de objeto do que o objeto fornecido no parâmetro P2.

P2 Obrigatório. O ID do objeto (um valor numérico) do tipo de objeto-filho que está maisbaixo na hierarquia de objeto do que o objeto fornecido no parâmetro P1.




P3 Obrigatório. O ID do período de relatório (um valor numérico).

Padrão: -1 (o identificador numérico para o período de relatório atual)

Nota: O valor do ID do período de relatório também pode ser transmitido como umavariável de parâmetro de prompt (por exemplo, ?rpid? em que rpid representa umnome de variável). Fornecer um valor otimiza o desempenho do relatório.

P4 Obrigatório. A profundidade de hierarquia com base no Tipo de Objeto de Recurso Pai(isto é, o número de níveis na hierarquia). Este número é 1 para hierarquia de Tipo deObjeto não recursiva e 1 ou maior para hierarquias recursivas.

Padrão: 1

P5 Obrigatório. O Nível nativo OP do Recurso raiz de hierarquia pai. Este número é 1 paratodas as Hierarquias de Tipo de Objeto de não Entidade e 1 ou maior para hierarquiasbaseadas em Entidade.

Padrão: 1

P6 Obrigatório. O Nível nativo OP do Recurso-pai.

Padrão: 1

P7 Obrigatório. Indicador do tipo de relacionamento pai-filho para procurar entre osobjetos designados nos parâmetros P1 e P2.

Valores possíveis:

'N'Verifica se há qualquer relacionamento (primário ou não primário) entre os objetos(padrão)

'Y'Verifica um relacionamento somente primário entre os objetos.

P8 Opcional. Indicador que direciona como o mecanismo de SQL deve executar suaInstrução ConnectBy.

Valores possíveis:

'Y'Executa a instrução ConnectBy de baixo para cima (ascendente) (padrão)

'N'Executa a instrução ConnectBy de cima para baixo (descendente).

Nota: Este parâmetro será ignorado se o parâmetro P4 for configurado pararelacionamento somente primário.

P9 Opcional. Define o resultado se qualquer um dos recursos (pai ou filho) for nulo.

Valores possíveis:

'Y'Retorna um Y quando objetos pais ou filhos são nulos.

'N'Retorna um N quando objetos pais ou filhos não são nulos (padrão)

P10 Opcional. O identificador do conjunto numérico.

Padrão: 1 (sempre usar o valor padrão)


Exemplo de uso

A função de amostra a seguir é utilizada em uma junção entre um assunto de consulta de entidade e umassunto de consulta de problema independente para obter todos os problemas relacionados direta ouindiretamente a uma entidade. Esta função é utilizada porque o sub-relatório que contém essa junção échamado a partir de um relatório dimensional e as quantias nos dois relatórios precisam corresponder.

"OP_RPS_AUX.IS_FM_REL_PARENT_CHILD"([Entity].[LOB FUNCTION_ENTITY_ID], [Issue].[IS_ISSUE_ID], [Entity].[LOB FUNCTION_REPORTING_PERIOD_ID], 3, 1, [Entity].[Native Level]) = 'Y'

O valor [Entidade].[Nível Nativo] é transmitido do relatório de chamada como um parâmetro. Como issoenvolve uma hierarquia de entidade fixa, a profundidade da hierarquia e o nível nativo são codificadospermanentemente.

Determinando um Relacionamento de Pai Principal Entre ObjetosEsta função identifica se um relacionamento (direto ou indireto) entre quaisquer dois objetos é primárioou não.

Os autores de relatório podem utilizar esta função, por exemplo, para exibir em um relatório qual objeto éo pai principal dos objetos filhos com diversos pais, ou como um filtro para retornar detalhes apenas dosobjetos com um relacionamento primário.

Sintaxe


"OP_RPS_AUX.IS_REL_PARENT_CHILD_PRIM" (P1, P2, P3, P4, P5, P6, P7, P8, P9, P10)

em que:



P1 Obrigatório. O ID do objeto (um valor numérico) do objeto pai. Este tipo de objetodeve ser superior na hierarquia de objeto do que o objeto-filho fornecido noparâmetro P2.

P2 Obrigatório. O ID do objeto (um valor numérico) do objeto-filho. Este tipo de objetodeve ser inferior na hierarquia de objeto do que o objeto pai fornecido no parâmetroP1.

P3 Obrigatório. O ID do período de relatório (um valor numérico) para o qual o atributo depai principal será retornado.



P4 Obrigatório. O ID do tipo de objeto (um valor numérico) do objeto pai. Este valor seráconsultado dinamicamente para relacionamentos diretos.

Padrão: NULL (sem aspas e sem distinção entre maiúsculas e minúsculas; sempre useo valor padrão)

P5 Obrigatório. O ID do tipo de objeto (um valor numérico) do objeto-filho. Este valor seráconsultado dinamicamente para relacionamentos diretos.





P6 Obrigatório. Indicador para sempre usar Conectar pelo SQL.

Padrão: ‘N’ (sempre utilizar o valor padrão)

P7 Obrigatório. indicador que identifica se um relacionamento (direto ou indireto) entrequaisquer dois recursos é primário ou não.

Valores possíveis:

'Y'Retorna um Y quando dois objetos possuírem um relacionamento direto eprimário (por exemplo, entre objetos Teste e Resultado de teste) (padrão)

'N'Retorna um Y se o objeto-filho puder rastrear um relacionamento primário atravésda hierarquia de objeto para o objeto pai. Utilize esta configuração quando osobjetos especificados possuírem um relacionamento do tipo pai-filho indiretodentro da hierarquia de objeto (por exemplo, objetos de Processo e Controlepossuem um relacionamento indireto quando os objetos Objetivo de Controle eRisco são configurados entre Processo e Controle na hierarquia).

P8 Obrigatório. Função reservada.


P9 Obrigatório. Solicite o resultado se qualquer um dos recursos (pai ou filho) for nulo.

Valores possíveis:

'Y'Retorna um Y quando o relacionamento entre dois objetos é primário (padrão)

'N'Retorna um N quando o relacionamento entre dois objetos não é primário.



Exemplo de uso

A função de amostra a seguir retorna um Y ou N em uma linha para um determinado Controle, se esseControle puder rastrear um relacionamento primário acima na hierarquia por meio de Risco, por Objetivode controle e, por último, até o Processo no Período de relatório atual.

A coluna calculada Processo para controle na Figura 67 na página 159 descreve se há umrelacionamento primário entre um determinado objeto Processo e um objeto Controle.

Figura 67. A Saída Primária de Pai e Filho É Relativa


A inclusão de um filtro para o parâmetro P7, tal como mudar N para Y para o Processo para controle,removerá todos os detalhes da linha em que não há um relacionamento primário (caminho) entre umdeterminado objeto Processo e Controle.

Determinando um Relacionamento entre ObjetosEsta função identifica se um relacionamento pai-filho existe ou não (direto ou indireto, primário ou nãoprimário) entre quaisquer dois objetos.

Sintaxe


"OP_RPS_AUX.IS_REL_PARENT_CHILD" (P1, P2, P3, P4, P5, P6, P7)

em que:



P1 Obrigatório. O ID do objeto (um valor numérico) do tipo de objeto pai que está maisalto na hierarquia de objeto do que o objeto fornecido no parâmetro P2.

P2 Obrigatório. O ID do objeto (um valor numérico) do tipo de objeto-filho que está maisbaixo na hierarquia de objeto do que o objeto fornecido no parâmetro P1.

P3 Obrigatório. O ID do período de relatório (um valor numérico).



P4 Opcional. Indicador do tipo de relacionamento pai-filho para procurar entre os objetosdesignados nos parâmetros P1 e P2.

Valores possíveis:

'N'Verifica se há qualquer relacionamento (primário ou não primário) entre os objetos(padrão).

'Y'Verifica se há um relacionamento somente primário entre objetos.

P5 Opcional. Indicador que direciona como o mecanismo de SQL deve executar suaInstrução ConnectBy.

Valores possíveis:

'Y'Executa a instrução ConnectBy de baixo para cima (ascendente) (padrão).

'N'Executa a instrução ConnectBy de cima para baixo (descendente).

Nota: Este parâmetro será ignorado se o parâmetro P4 for configurado pararelacionamento somente primário.




P6 Opcional. Define o resultado se qualquer um dos recursos (pai ou filho) for nulo.

Valores possíveis:

'Y'Retorna um Y quando objetos pais ou filhos são nulos.

'N'Retorna um N quando objetos pais ou filhos não são nulos (padrão).



Exemplo de uso

A função de amostra a seguir indica se qualquer tipo de relacionamento existe ou não entre o registro deRisco e o registro de Controle (primário ou não primário, direto ou indireto).

A coluna Está relacionado no Figura 68 na página 161 retorna as informações indicando se há umrelacionamento pai-filho entre um determinado objeto de Risco e controle.

Figura 68. É Saída Pai-Filho Relativa

Formatando o Valor de MoedaEssa função formata um valor de moeda com o número adequado de casas e separadores decimais parao código do idioma especificado. Essa função pode ser útil para campos computados.

Nota: O símbolo da moeda NÃO é exibido na saída.

Sintaxe


"OP_CURRENCY_MGR.FORMAT_CURRENCY_VALUE" (P1, P2, P3)

em que:



P1 Obrigatório. O número (como o valor monetário) que deseja formatar.

P2 Obrigatório. O código de moeda ISO de 3 caracteres que determina o número decasas decimais a serem exibidas.




P3 Obrigatório. O identificador numérico do código de idioma do usuário OpenPageswith Watson que determina o tipo de separadores de grupo.

Nota: Um valor igual a NULL (sem aspas) pode ser usado; no entanto, fornecer oparâmetro de sessão de código de idioma ou o ID do código de idioma proporcionao melhor desempenho de processamento. O uso de NULL forçará a função a usar oID do código de idioma padrão do sistema.




Exemplo de uso 1

O exemplo a seguir traduz o valor para 1234.5 em um formato para o código do idioma dos EUA.

Figura 69. Formato de Moeda para USD

Exemplo de uso 2

O exemplo a seguir traduz o valor para 1234.5 em um formato para o código do idioma Alemão. Figura 70na página 162 mostra a saída do relatório de amostra.

Figura 70. Formato de Moeda para EUR

Exemplo de uso 3

O exemplo a seguir traduz o valor para 1234.5 em um formato para o código do idioma Japonês. Figura71 na página 162 mostra a saída do relatório de amostra.

Figura 71. Formato de Moeda para JPY

Obtendo um Nome de Exibição do Agente pelo IDEssa função se aplica apenas a ambientes Oracle e retorna o nome de exibição formatado (usuário ougrupo) do agente utilizando o número do ID do Agente interno.

Se o agente for um grupo, apenas o nome da conta do grupo será retornado, e a sequência deformatações fornecida será ignorada. Se um nome de agente inválido for fornecido, o valor fornecido seráretornado.


Sintaxe


"OP_ACTOR_MGR.GET_DISPLAY_NAME" (P1, P2, P3)

em que:



P1 Obrigatório. Um ID numérico para o agente (usuário ou grupo) a ser exibido.






P3 Opcional. É possível usar as seguintes opções de exibição de formato:%FN;

Para exibir o nome do usuário.%LN;

Para exibir o sobrenome do usuário.%EM;

Para exibir o endereço de e-mail do usuário.

Padrão: O nome da conta de logon do agente será exibido se nenhum formato forespecificado.

Exemplo de uso 1

O exemplo a seguir exibe o nome e o sobrenome do agente de ID 281. Figura 72 na página 163 mostra asaída do relatório de amostra.

Figura 72. Nome de Exibição pelo de Nome e Sobrenome do ID

Exemplo de uso 2

O exemplo a seguir exibe o e-mail do agente de ID 281. Figura 73 na página 164 mostra a saída dorelatório de amostra.


Figura 73. Nome de Exibição pelo E-mail do ID

Exemplo de uso 3

O exemplo a seguir exibe o nome do agente de ID 281. Figura 74 na página 164 mostra a saída dorelatório de amostra.

Figura 74. Nome de Exibição pelo Nome do ID

Obtendo um Nome de Exibição do Agente pelo ID do AgenteEssa função se aplica apenas a ambientes IBM Db2 e retorna o nome de exibição formatado (usuário ougrupo) do agente utilizando o número do ID do Agente interno.

Se o agente for um grupo, apenas o nome da conta do grupo será retornado, e a sequência deformatações fornecida será ignorada. Se um nome de agente inválido for fornecido, o valor fornecido seráretornado.

Sintaxe


"OP_ACTOR_MGR.GET_DISPLAY_NAME_BY_ACTOR_ID" (P1, P2, P3)

em que:



P1 Obrigatório. Um ID numérico para o agente (usuário ou grupo) a ser exibido.









P3 Opcional. É possível usar as seguintes opções de exibição de formato:%FN;




Padrão: O nome da conta de logon do agente será exibido se nenhum formato forespecificado.

Exemplo de uso 1

O exemplo a seguir exibe o nome e o sobrenome do agente de ID 281. Figura 75 na página 165 mostra asaída do relatório de amostra.

Figura 75. Nome de Exibição pelo de Nome e Sobrenome do ID

Exemplo de uso 2

O exemplo a seguir exibe o e-mail do agente de ID 281. Figura 76 na página 165 mostra a saída dorelatório de amostra.

Figura 76. Nome de Exibição pelo E-mail do ID

Exemplo de uso 3

O exemplo a seguir exibe o nome do agente de ID 281. Figura 77 na página 165 mostra a saída dorelatório de amostra.

Figura 77. Nome de Exibição pelo Nome do ID

Obtendo um Nome de Exibição do Agente pelo ID de LogonEsta função retorna os nomes de exibição formatados do agente (usuários e grupos).

Se os agentes forem um grupo, apenas os nomes da conta do grupo serão retornados, e a sequência deformatações fornecida será ignorada. Se um ID de Login do agente inválido dor fornecido, o valorfornecido será retornado.

Sintaxe



"OP_ACTOR_MGR.GET_DISPLAY_NAME" (P1, P2, P3, P4)

em que:



P1 Obrigatório. Os nomes de usuário de logon do valor de sequência para os agentes(usuários ou grupos) a serem exibidos.






P3 Opcional. As opções de exibição de formato são:%FN;




Padrão: O ID de logon do agente será exibido se nenhum formato for especificado.

P4 Opcional. Separador para nomes de exibição retornados. Padrão: Uma vírgula seguidapor um espaço.

Exemplo de uso 1

O exemplo a seguir exibe o nome e sobrenome dos usuários que estão designados como um Proprietáriode Controle no aplicativo. Figura 78 na página 166 mostra a saída do relatório de amostra.

Figura 78. Nome e Sobrenome do Proprietário de Controle

Exemplo de uso 2

O exemplo a seguir exibe o e-mail dos usuários que estão designados como um Proprietário do Controleno aplicativo. Figura 79 na página 167 mostra a saída do relatório de amostra.


Figura 79. E-mail do Proprietário de Controle

Exemplo de uso 3

O exemplo a seguir exibe o nome dos usuários que estão designados como um Proprietário do Controleno aplicativo. Figura 80 na página 167 mostra a saída do relatório de amostra.

Figura 80. Nome do Proprietário de Controle

Obtendo Texto de Chave ExternaEsta função retorna uma sequência de chaves externa localizada.

Essa função pode ser útil para localizar campos computados com um tipo de dados de Sequênciasimples, pois esses tipos de campos não são localizados pelo aplicativo. Quando sequências localizadassão necessárias para um campo computado (exceto nomes de rótulo de campo que já estão localizados),um autor de campo computado pode incluir uma nova chave de texto de aplicativo através da interfacecom o usuário do IBM OpenPages with Watson e, em seguida, fazer referência a ela com esta função.Desta maneira, é possível gerenciar todo o texto localizado em um único local e evitar codificar umalógica específica do código do idioma nas equações.

Sintaxe


"OP_I18N_MGR.GET_EXTERNAL_KEY_TEXT" (P1, P2, P3)

em que:



P1 Obrigatório. O nome da chave do texto do aplicativo.

P2 Obrigatório. A categoria de texto do aplicativo.

P3 Obrigatório. O identificador numérico do código de idioma do usuário OpenPageswith Watson.

Nota: Um valor igual a NULL (sem aspas) pode ser usado; no entanto, fornecer oparâmetro de sessão de código de idioma ou o ID do código de idioma proporcionao melhor desempenho de processamento. O uso de NULL forçará a função a usar oID do código de idioma padrão do sistema.





Exemplo de uso

O exemplo a seguir mostra como obter o valor de classificação de risco de 'crítico' e substituir um valor desequência localizado por ele. Figura 81 na página 168 mostra a saída do relatório de amostra.

Figura 81. Obtendo a Saída de Texto de Chave Externa

Obtendo os Atributos de um Objeto Pai PrincipalEsta função retorna o valor de um ou mais atributos de um objeto pai principal.

Os autores de relatórios podem usar essa função, por exemplo, para consultar diretamente qualquervalor de campo de propriedade (com valor único ou com diversos valores regular ou enumerado) para umdeterminado objeto, sem precisar consultar a hierarquia de objeto inteira. Essa função deve ser usadacom muito cuidado em situações em que um objeto pode ter diversos pais.

Nota: Revise também Obtendo os Atributos Diretos de um Objeto de Pai Principal antes de usar essafunção porque a última função é mais fácil de usar.

Sintaxe


"OP_RPS_AUX.GET_PRIM_PARENT_ATTRIBUTE" (P1, P2, P3, P4, P5, P6, P7, P8, P9,P10, P11, P12, P13, P14)

em que:



P1 Obrigatório. O ID do objeto (um valor numérico) do objeto-filho para o qual osatributos de pai principal serão retornados.

P2 Obrigatório. O ID do período de relatório (um valor numérico) do objeto-filho para oqual os atributos de pai principal serão retornados.



P3 Obrigatório. O ID do tipo de objeto do objeto pai (este valor numérico é diferente dovalor do ID do objeto no parâmetro P1). Por exemplo, se o objeto pai for umaEntidade de negócios, ele será o ID de tipo de objeto do tipo de objeto Entidade denegócios (SOXBusEntity).

Nota: Os relatórios podem não ser móveis entra as instalações (os mesmos tipos deobjeto podem ter IDs diferentes)




P4 Obrigatório. O nível do objeto pai principal na hierarquia. Utilizado apenas paraobjetos recursivos como: Entidade de Negócios, Subprocesso, Submandato eSubconta.

Valores possíveis:

1O pai de nível mais alto (padrão)

0Pai de nível mais baixo mais próximo do objeto.

4Pai de quarto nível. Se ele não existir, use o nível 0.

-1Pai de segundo nível mais baixo.

-4Pai de quarto nível da parte inferior. Se não existir, use o nível 1.

É possível especificar qualquer nível, conforme necessário. Se um valor especificadonão existir na hierarquia, o objeto pai de nível mais alto será utilizado.

Nota: Se o tipo de objeto pai for não recursivo, use 1.

P5 Obrigatório. O nome da tabela RT do tipo de objeto pai no Esquema de Relatório.

Nota: Esse valor NÃO é o nome do assunto de consulta que um autor de relatório vêno IBM Cognos Analytics - Reporting. Um autor do relatório deve ser capaz dedeterminar os nomes das tabelas ao conectar-se com o banco de dados.

Padrão: 'RT_ENTITY'

P6 Obrigatório. O nome da coluna do ID do objeto na tabela RT do tipo de objeto pai noEsquema de Relatório.

Nota: Esse NÃO é o nome do item de consulta que o autor do relatório vê no IBMCognos Analytics - Reporting. Um autor do relatório deve ser capaz de determinar osnomes das colunas ao conectar-se com o banco de dados.

Padrão: 'ENTITY_ID'

P7 Obrigatório. O nome da coluna do ID do período de relatório na tabela RT do tipo deobjeto pai no Esquema de Relatório.


Padrão: 'REPORTING_PERIOD_ID'

P8 Obrigatório. O nome da coluna do atributo na tabela RT do tipo de objeto pai noEsquema de Relatório. Isso representa o item de dados que será a saída de voltapara o relatório ou filtro.


Padrão: 'FULL_PATH'




P9 Obrigatório. Especifica o tipo de atributo de valores retornados no parâmetro decoluna P8.

Nota: Os valores não fazem distinção entre maiúsculas e minúsculas.

Valores possíveis:

'NONE'Usar para campos ordinários (não enumerados) (padrão).

'SINGLE'Usar para enumerações com valor único.

'MULTI'Usar para enumerações com diversos valores.






P11 Opcional.



Padrão: ','

P12 Opcional.

Especifica a coluna na qual os valores da lista de seleção (enumerações comdiversos valores) serão classificados.



'EV_NAME'Usar para classificar os valores de lista pelo nome do valor enumeradolocalizado.




P13 Opcional.







Exemplo de uso 1

O exemplo a seguir mostra os valores do atributo ENTITY_TYPE para a entidade pai de um processo.Figura 82 na página 171 mostra a saída do relatório de amostra.

Figura 82. Obter Saída do Atributo de Pai Principal

Exemplo de uso 2

Ao usar a função OP_RPS_AUX.GET_PRIM_PARENT_ATTRIBUTE, um relatório poderia ser criadoexclusivamente por meio do assunto de consulta Problema sem precisar ser incluído nos objetosadicionais. Nesse exemplo, a consulta gerada pelo relatório não precisa atravessar a hierarquia completae, mesmo assim, retornará todos os itens de dados necessários para a saída ou filtro de relatório. Oresultado desse uso é a possibilidade de melhorar tremendamente o tempo de execução do relatório.

O exemplo a seguir retorna o Nome da entidade de nível superior para um determinado identificador doproblema. Figura 83 na página 171 mostra a saída do relatório de amostra.

Figura 83. Obter Saída do Atributo de Pai Principal


Obtendo os Atributos Diretos de um Objeto de Pai PrincipalEsta função retorna o valor de um atributo de um objeto pai principal

Os autores de relatório podem utilizar esta função para consultar diretamente determinados valores depropriedade de um determinado objeto sem precisar consultar a hierarquia de objeto inteira. Esta funçãonão requer que o autor do relatório saiba qual tipo de objeto pai principal ele está consultando.

Sintaxe


"OP_RPS_AUX.GET_DIRECT_PRIM_PRNT_VALUE" (P1, P2, P3, P4, P5)

em que:



P1 Obrigatório. O ID do objeto (um valor numérico) do objeto-filho para o qual osatributos de pai principal serão retornados.

P2 Obrigatório. O ID do período de relatório (um valor numérico) para o qual o valor seráretornado.

Padrão: NULL (sem aspas e sem distinção entre maiúsculas e minúsculas) retorna oID do período de relatório atual, que é -1. Fornecer um valor otimiza o desempenhodo relatório.

P3 Obrigatório. O ID do agente do usuário que está com login efetuado. Isso é utilizadopara determinar qual acesso a dados o usuário possui.

P4 Obrigatório. O nome da propriedade do atributo do tipo de objeto pai no Esquema deRelatório. Isso representa o item de dados que será a saída de volta para o relatórioou filtro. A seguir há a lista de nomes de propriedades válidos:RESOURCE_ID

O ID do sistema exclusivo do recurso.RESOURCE_NAME

O nome do pai.RESOURCE_NAME_RAW

O nome pai inteiro com identificadores internos.RESOURCE_LOCATION

O caminho completo.RESOURCE_LOCATION_RAW

Todo o caminho pai completo sem os identificadores internos divididos.RESOURCE_URL

A URL da página de detalhes do pai.OBJECT_TYPE_ID

O ID do recurso do objeto pai.OBJECT_TYPE_NAME_SYS

O nome do objeto do sistema-pai.OBJECT_TYPE_NAME_I18N

O nome do objeto pai localizado.









Exemplo de uso 1

O exemplo a seguir retorna o tipo-pai de um determinado ID do problema. Figura 84 na página 173mostra a saída do relatório de amostra.

Figura 84. Tipo de Pai Principal

Exemplo de uso 2

O exemplo a seguir retorna o ID de recurso-pai de um determinado ID do problema. Figura 85 na página174 mostra a saída do relatório de amostra.


Figura 85. ID do Pai Principal

Obtendo a Taxa de CâmbioEsta função retorna a taxa de câmbio para o código de moeda ISO e data especificados.

Se nenhuma data for especificada, a data atual do sistema será utilizada. Essa função pode ser útil paracampos computados.

Sintaxe


"OP_CURRENCY_MGR.GET_EX_RATE_ISO" (P1, P2)

em que:



P1 Obrigatório. O código de moeda ISO de 3 caracteres.

P2 Opcional. A data em que a taxa de câmbio entrou em vigor no sistema.

Padrão: a data do sistema atual será utilizada se nenhuma data for especificada.

Exemplo de uso 1

O exemplo a seguir retorna a taxa de câmbio atual para Euros. Figura 86 na página 174 mostra a saída dorelatório de amostra.

Figura 86. Taxa de Câmbio de Moeda

Exemplo de uso 2

O exemplo a seguir retorna a taxa de câmbio para Euros na data em que foi mudada pela última vez, queé 1º de janeiro de 1970. Figura 85 na página 174 mostra a saída do relatório de amostra.

Figura 87. Taxa de Câmbio de Moeda por Data


Obtendo IDs de Recurso de Caminho de ÁrvoreEssa função retorna os IDs dos objetos que estiverem no caminho de dois objetos que são fornecidoscomo entradas para a função.

Sintaxe


"OP_RESOURCES_MGR.GET_TREE_PATH_RESOURCE_IDS" (P1, P2, P3, P4, P5)

em que:



P1 Obrigatório. O identificador de recurso para o início do seu segmento da árvore.

P2 Obrigatório. O identificador de recurso para a final do seu segmento da árvore.

P3 Obrigatório. Uma lista de tipos de objeto entre parênteses e separados por vírgulas aserem visitados.

P4 Opcional. O ID do período de relatório.

Padrão: O relatório atual será utilizado se nenhum período de relatório forespecificado.


P5 Opcional. O ID da hierarquia. Padronizado para a hierarquia atualmente suportada.


Exemplo de uso

O exemplo a seguir mostra que ?ControlObjectiveID? (id_start) e ?TestID? (id_end) são parâmetros para orelatório dos objetos listados (SOXControlObjective, SOXRisk, SOXControl e SOXTest). Figura 88 napágina 175 mostra a saída do relatório de amostra.

"OP_RESOURCES_MGR.GET_TREE_PATH_RESOURCE_IDS"(?ControlObjectiveID?,?TestID?, '(' || '''SOXControlObjective''' || ',' || '''SOXRisk''' || ',' || '''SOXControl''' || ',' || '''SOXTest''' || ')' )

Figura 88. Obtendo a Saída do Caminho de Árvore

Outros resultados podem ser:

• -1 se existir apenas um caminho direto entre os recursos• -2 se não existir nenhum caminho entre os recursos

Acumulando Enumerações com Diversos Valores em uma ListaEsta função retorna uma lista delimitada de nomes de enumeração com diversos valores localizados paraum campo de propriedade de recurso de enumeração com diversos valores especificado.


Os autores de relatório podem utilizar esta função para acumular enumerações multivalor em uma listaseparada por vírgula (ou outro delimitador desejado). Essa função elimina a necessidade de utilizarinstruções SQL customizadas ou uma abordagem de Detalhe Mestre.

Sintaxe


"OP_RPS_AUX.GET_MVAL_STRAGG_GENERIC" (P1, P2, P3, P4, P5, P6, P7, P8, P9, P10)

em que:



P1 Obrigatório. O nome da tabela RT que armazena os valores enumerados com diversosvalores de um determinado tipo de objeto fornecido

P2 Obrigatório. O nome da coluna da tabela RT especificada em P1 que armazena o ID dorecurso.

P3 Obrigatório. O nome da coluna da tabela RT especificada no P1 que armazena os IDsde valor enumerado.

P4 Obrigatório. O nome da coluna da tabela RT especificada no P1 que armazena o ID doperíodo de relatório.

P5 Obrigatório. O ID do recurso (um valor numérico) para o qual a lista será retornada. Éo Item de Consulta a partir do Assunto de Consulta que contém o ID do recursoprincipal pelo qual os valores enumerados serão agregados.

P6 Obrigatório. O ID do período de relatório (um valor numérico) para o qual a lista seráretornada.

Padrão: NULL (sem aspas e sem distinção entre maiúsculas e minúsculas) retorna oID do período de relatório atual, que é -1. Fornecer um valor otimiza o desempenhodo relatório.






P8 Obrigatório.



Padrão: ','




P9 Obrigatório.

Especifica a coluna na qual os valores da lista de seleção (enumerações com diversosvalores) serão classificados.



'EV_NAME'Usar para classificar os valores de lista pelo nome do valor enumerado localizado.

P10 Obrigatório.





Exemplo de uso

O exemplo a seguir retorna uma lista delimitada por vírgulas de valores selecionados para o campo Riscomultisseleção chamado Confirmações de Declaração Financeira para cada Risco filtrado pelo período derelatório selecionado. Figura 89 na página 177 mostra a saída do relatório de amostra.

Figura 89. Obter Saída STRAGG MVAL

Utilizando Funções Dependentes de HorárioEsta seção descreve as funções de banco de dados baseadas em tempo.

Obtendo o Valor do Campo Customizado por IDEsta função retorna o valor de um campo customizado de um objeto a partir de uma determinada data.

Ele utiliza o PropertyDefId para identificar o valor do campo customizado para retornar.

Sintaxe


"OP_RESOURCES_MGR.GET_CUSTOM_FIELD_VALUE_BY_ID" (P1, P2, P3, P4, P5, P6)

em que:




P1 Obrigatório. O ID do objeto (um valor numérico) do objeto para o qual o valor docampo customizado será retornado.

P2 Obrigatório. O atualizado do campo customizado.

P3 Obrigatório. O PropertyDefId do campo customizado (um valor numérico).

P4 Opcional. Use somente a tabela de trilha de auditoria do sistema.

Valores possíveis:

FalseUm valor será retornado para a propriedade independentemente se ele estiver natabela de auditoria do sistema (padrão)

Verdadeiroum valor só será retornado se o valor estiver na tabela de trilha de auditoria dosistema.

Nota: Quando uma propriedade é criada primeiro, um valor não é inserido na tabelade trilha de auditoria do sistema.

Padrão: False

P5 Optional. This field determines the type of output for thisfunction.

Valores possíveis:

• EV_ID• EV_CODE• EV_SYSTEM_NAME• EV_NAME_I18N

Padrão: EV_ID

P6 Opcional. O ID do código do idioma (um identificador numérico). Usado para traduzirautomaticamente o texto das sequências enumeradas para o código de idioma dousuário que está executando o relatório.





Nota: Um valor de erro será retornado se a sua solicitação continuar com a criação da variável.

Exemplo de uso

O exemplo a seguir mostra como obter um valor para o campo customizado utilizando seu PropertyDefId.Neste exemplo queremos obter a Classificação de Risco Inerente como uma função de tempo. O valor


140 é o propertyDefId para a Classificação de Risco Inerente que era pesquisada na tabela propertydefsutilizando a seguinte SQL:

select * from propertydefs where name = 'Inherent Risk Rating'

Após o propertydefId ser conhecido, deve-se decidir o formato da saída. O exemplo mostra a saída comoEV_NAME_118N, que é o nome da propriedade traduzido para esse ID do código do idioma.

A seguir está o código utilizado neste exemplo:

"OP_RESOURCES_MGR.GET_CUSTOM_FIELD_VALUE_BY_ID" ([RI_RISK_ID], to_date(?Date?,'DD-MON-YYYY'), 140, 'N', 'EV_NAME_I18N', #$account.parameters.openPagesLocaleId#)

Se eu selecionar a data 1-Jan-1970 (antes de o campo ter sido criado), obtenho o seguinte, mostrado emFigura 90 na página 179:

Figura 90. Classificação de Risco Inerente – 1-Jan-1970

Como é possível ver a partir dos resultados, o valor atual da Classificação de Risco é Médio, mas o valornão foi localizado na data solicitada. Se eu selecionar a data 24-Feb-2011, obtenho o seguinte mostradoem Figura 91 na página 179:

Figura 91. Classificação de Risco Inerente – 24-Feb-2011

Agora é possível ver que, na data 24-Feb-2011, o valor da Classificação de Risco Inerente era Baixo. Seeu inserir a data de hoje, obtenho o seguinte, mostrado em Figura 92 na página 179:

Figura 92. Classificação de Risco Inerente – 1-Apr-2011

O valor do campo é igual à atual Classificação de Risco Inerente.

Obtendo o Valor do Campo Customizado por NomeEsta função retorna o valor de uma propriedade customizada pelo nome do grupo de campo e o nome dapropriedade como uma função de data.

Sintaxe


"OP_RESOURCES_MGR.GET_CUSTOM_FIELD_VALUE_BY_NAME" (P1, P2, P3, P4, P5, P6, P7)

em que:




P2 Obrigatório. O atualizado do campo customizado.




P3 Obrigatório. O nome do grupo de campo que contém o campo customizado.

P4 Obrigatório. O nome da propriedade customizada.


Valores possíveis:

FalseUm valor será retornado para a propriedade, independentemente de ele estar natabela de auditoria do sistema (padrão).

VerdadeiroUm valor só será retornado se o valor estiver na tabela de trilha de auditoria dosistema.


P6 Opcional. Este campo determina o tipo de saída para esta função.

Valores possíveis:

• EV_ID• EV_CODE• EV_SYSTEM_NAME• EV_NAME_I18N

Padrão: EV_ID

P7 Opcional. O ID do código do idioma (um identificador numérico). Usado para traduzirautomaticamente o texto das sequências enumeradas para o código de idioma dousuário que está executando o relatório.






Exemplo de uso

O exemplo a seguir mostra como obter um valor de campo customizado utilizando seu grupo de campo eo nome da propriedade. Neste exemplo queremos obter a Classificação de Risco Inerente como umafunção de tempo. Não utilize a IU para consultar o nome do grupo de campo para o objeto risco quecontém a Classificação de Risco Inerente.

Após o propertydefId ser conhecido, deve-se decidir o formato da saída. O exemplo mostra a saída comoEV_NAME_118N, que é o nome da propriedade traduzido para esse ID do código do idioma.

A seguir está o código utilizado neste exemplo:


"OP_RESOURCES_MGR.GET_CUSTOM_FIELD_VALUE_BY_NAME" ([RI_RISK_ID], to_date(?Date?,'DD-MON-YYYY'), 'OPSS-Risk-Qual', 'Inherent Risk Rating', 'N', 'EV_NAME_I18N', #$account.parameters.openPagesLocaleId#)

Se eu selecionar a data 1-Jan-1970 (antes de o campo ter sido criado), obtenho o seguinte, mostrado emFigura 93 na página 181:

Figura 93. Classificação de Risco Inerente – 1-Jan-1970

Como é possível ver a partir dos resultados, o valor atual da Classificação de Risco é Médio, mas o valornão foi localizado na data solicitada. Se eu selecionar a data 24-Feb-2011, obtenho o seguinte mostradoem Figura 94 na página 181:

Figura 94. Classificação de Risco Inerente – 24-Feb-2011

Agora é possível ver que, na data 24-Feb-2011, o valor da Classificação de Risco Inerente era Baixo. Seeu inserir a data de hoje, obtenho o seguinte, mostrado em Figura 95 na página 181:

Figura 95. Classificação de Risco Inerente – 1-Apr-2011

O valor do campo é igual à atual Classificação de Risco Inerente.

Obtendo a Descrição do Campo do SistemaEsta função retorna o valor para a propriedade de descrição de um objeto como uma função de tempo.

Sintaxe


"OP_RESOURCES_MGR.GET_SYSTEM_FIELD_VALUE_DESC" (P1, P2, P3)

em que:




P2 Obrigatório. O atualizado do campo do sistema.





Valores possíveis:





Exemplo de uso 1

O exemplo a seguir mostra o uso desta chamada de função para obter a propriedade de descrição dosistema como uma função de tempo. A expressão a seguir foi usada:

No primeiro exemplo obtivemos o valor da descrição do sistema a partir da data 1 de fevereiro de 2011.Isso ocorre após o objeto ter sido criado, mas antes de ter sido modificado. O campo Descrição deriso atual sempre mostra o valor do campo conforme ele existe quando o relatório é executado,mostrado na figura.

Figura 96. Obter o Valor da Descrição do Sistema - 1º de fevereiro de 2011

Exemplo de uso 2

No próximo exemplo, mostrado na figura a seguir, obtivemos o valor da descrição do sistema a partir dadata 11 de fevereiro de 2011. Observe que a descrição de A partir da data agora é igual o valor daDescrição de risco atual value. Isso ocorre após a modificação final do objeto.

Figura 97. Obter o Valor da Descrição do Sistema - 11 de fevereiro de 2011

Exemplo de uso 3

No exemplo final, mostrado na figura a seguir, obtivemos o valor da descrição do sistema a partir da data11 de fevereiro de 2009, antes de existir.

Figura 98. Obter o Valor de Descrição do Sistema - 11 de fevereiro de 2009

O sistema retorna um valor de erro de que a propriedade não foi localizada.


Obtendo o Caminho Completo do Campo do SistemaEsta função retorna o valor para a propriedade de caminho completo de um objeto como uma função detempo.

Sintaxe

Essa função possui a sintaxe "OP_RESOURCES_MGR.GET_SYSTEM_FIELD_VALUE_FULLPTH" (P1,P2, P3) em que a tabela a seguir descreve as variáveis.






Valores possíveis:





Exemplo de uso 1

O exemplo a seguir mostra o uso desta chamada de função para obter a propriedade de caminhocompleto do sistema como uma função de tempo. A expressão a seguir foi usada:

No primeiro exemplo, mostrado em Figura 99 na página 183, obtivemos o valor do caminho completo dosistema como 1-Feb-2011. Isso ocorre após o objeto ter sido criado, mas antes de ter sido modificado.

Figura 99. Obter Valor do Caminho Completo do Sistema – Exemplo 1


Exemplo de uso 2

No próximo exemplo, mostrado na figura a seguir, obtivemos o valor do caminho completo do sistema apartir da data 11 de fevereiro de 2011. Observe que o Caminho completo a partir da data agora é igual aovalor do caminho completo atual. Isso ocorre após a modificação final do caminho completo.



Exemplo de uso 3

No exemplo final, mostrado na figura a seguir, obtivemos o valor do caminho completo do sistema a partirda data 11 de fevereiro de 2009, antes de existir.



Obtendo o Nome do Campo do SistemaEsta função retorna o valor para a propriedade nome de um objeto como uma função de tempo.

Sintaxe


"OP_RESOURCES_MGR.GET_SYSTEM_FIELD_VALUE_NAME" (P1, P2, P3)

em que:






Valores possíveis:





Exemplo de uso 1

O exemplo a seguir mostra o uso desta chamada de função para obter a propriedade de nome do sistemacomo uma função de tempo. A expressão a seguir foi usada:

No primeiro exemplo, mostrado em Figura 103 na página 184, obtivemos o valor do nome do sistema,como 1-Feb-2011. Isso ocorre após o nome ter sido criado, mas antes de ter sido modificado.

Figura 103. Obter o Valor do Nome do Sistema - 1º de fevereiro de 2011


Exemplo de uso 2

No próximo exemplo, mostrado em Figura 104 na página 185, obtivemos o valor do nome do sistemacomo 11-Feb-2011. Observe que o Nome Atualizado agora é igual ao Nome do Risco Atual. Isso ocorreapós a modificação final do nome.

Figura 104. Obter o Valor do Nome do Sistema - 11 de fevereiro de 2011

Exemplo de uso 3

No exemplo final, mostrado em Figura 105 na página 185, obtivemos o valor do nome do sistema como11-Feb-2009.

Figura 105. Obter o Valor do Nome do Sistema - 11 de fevereiro de 2009

É possível ver que o nome do sistema não foi localizado.

Obtendo o ID da Pasta Pai do Campo do SistemaEsta função retorna o valor para a propriedade de ID da pasta pai de um objeto como uma função detempo.

Sintaxe


"OP_RESOURCES_MGR.GET_SYSTEM_FIELD_VALUE_PFLDRID" (P1, P2, P3)

em que:






Valores possíveis:






Exemplo de uso 1

O exemplo a seguir mostra o uso desta chamada de função para obter a propriedade do ID da pasta paido sistema como uma função de tempo. A expressão a seguir foi usada:

"OP_RESOURCES_MGR.GET_SYSTEM_FIELD_VALUE_PFLDRID" ([RI_RISK_ID], to_date(?Date?,'DD-MON-YYYY'))

No primeiro exemplo obtivemos o ID da pasta pai de sistema como 1-Feb-2011. Isso ocorre após oobjeto ter sido criado, mas antes de ter sido modificado. Podemos ver no Figura 106 na página 186 quemodificar um atributo em um objeto não afeta o ID da pasta pai.

Nota: Os tipos de objetos autocontidos modificarão a pasta se você mudar o nome do objeto.

Figura 106. Obter o ID da Pasta Pai do Sistema - 1º de fevereiro de 2011

Exemplo de uso 2

No próximo exemplo, mostrado em Figura 107 na página 186, obtivemos o ID da pasta pai do sistemacomo 11-Feb-2011. Observe que mais uma vez que este valor não foi mudado. Isso ocorre após amodificação final do nome.

Figura 107. Obter o ID da Pasta Pai do Sistema - 11 de fevereiro de 2011

Exemplo de uso 3

No exemplo final, mostrado em Figura 108 na página 186, obtivemos o ID da pasta pai do sistema como11-Feb-2009.

Figura 108. Obter o ID da Pasta Pai do Sistema - 11 de fevereiro de 2009



Capítulo 14. Formatando Relatórios para SaídaAlém da saída HTML padrão, os três formatos de saída mais comuns são PDF, Excel e CSV.

Para poder usar os formatos de maneira eficiente, esse capítulo descreve algumas melhores práticas paraformatar seus relatórios, portanto, eles aparecerão bem formatados quando exibidos.

Configurando o Relatório para Saída PDFÉ possível configurar o relatório para saída PDF.

Procedimento

1. Clique em Arquivo > Configuração da página PDF.2. Na página de configuração PDF, selecione o modo retrato ou paisagem, dependendo do tamanho e do

estilo de seu relatório. Deixe o tamanho da página como padrão para que a impressora não precise terpapel de um determinado tamanho.

Incluindo Prompts Sequenciais na Saída em PDFÉ possível ver um prompt de entidade de negócios na saída em PDF.

Sobre Esta Tarefa

Prompts sequenciais não aparecem em um arquivo PDF. Ao converter um relatório em PDF, vocêobservará que o prompt e o botão foram removidos do formato.

Procedimento

1. Coloque uma segunda linha de cabeçalho no seu relatório apenas com o nome e o valor do prompt nalinha.

2. Crie uma condição de sequência utilizando o Explorador Condicional com o seguinte código:

if (ReportOutput() starts with 'XL') then ('XLS')else (ReportOutput())

3. Renomeie a variável para Saída de Relatório.4. Inclua como valores XLS, PDF e HTML.5. Na Linha da tabela com o prompt sequencial, configure a Variável de Estilo para Saída de Relatório.6. No Explorador Condicional, selecione PDF na Saída de Relatório.7. Na Área de Janela de Propriedades, em Caixa, configure o Tipo de Caixa para Nenhuma.8. Repita as mesmas etapas para a linha sem o prompt sequencial, mas selecione HTML ao invés de PDF.9. Execute o relatório em HTML.

Resultados

O relatório é igual ao que era antes em HTML. Agora, ao convertê-lo em PDF, você verá a linha de promptrecém-criada.

Formatando o Relatório para Saída PDFA formatação do relatório para saída PDF ou para saída HTML compartilha muitas das mesmas técnicasde formatação. Qualquer uma das técnicas de formatação utilizadas para ajustar o layout em uma páginaHTML pode ser utilizada para ajustar o formato do arquivo PDF. Se você estiver utilizando ambas as saídasHTML e PDF, deverá decidir qual formato otimizar.

Se você iniciar com um relatório simples que mostra um nome de entidade com hiperlink e o caminhocompleto da mesma entidade, será possível fazer mudanças no relatório e mostrar como elas sãorefletidas na saída PDF.

Procedimento

1. Configure a fonte da variável de caminho completo para Negrito.2. Configure a largura da variável de nome para 300 px.3. Configure a borda para 1 1/2 pt e vermelha.4. Execute o relatório.

Resultados

As técnicas de formatação básicas utilizadas para HTML também se aplicam ao formato PDF.

Formatando para Saída do Microsoft ExcelAo projetar um relatório para ser formatado para o software de planilha do Microsoft Excel, a limitaçãochave é que todos os contêineres no relatório devem ter o mesmo número de colunas.

As planilhas do Microsoft Excel não dependem de valores de largura da coluna como um relatórioformatado em PDF ou HTML. Elas dependem estritamente da quantidade de colunas para alinhar umcontêiner com o outro.

Portanto, cabeçalhos, rodapés, listas e tabelas devem ter colunas simuladas incluídas neles para fazercom que fiquem alinhados na saída. Essas colunas não requerem dados, apenas precisam existir.

A inclusão de colunas extras melhora o alinhamento das colunas no relatório Excel.

Formatando para Saída CSVO formato CSV (valores separados por vírgula) é o formato de saída mais básico porque não háformatação de estilo.

Este tipo de saída é projetado para ser gerado de maneira que possa ser lido por outros sistemas. A únicalimitação conhecida desse formato é a impossibilidade de junções na consulta, ou o IBM Cognosproduzirá um erro. Para evitar esse problema, é possível criar um único CQS que é usado para a saídaCSV.

Quando o relatório é gerado, ele ainda aparece em formato do Excel, e o diálogo Download de Arquivo éaberto. Isso é semelhante ao diálogo do Excel sem nenhuma indicação de que se trata de um arquivoCSV.

Ao abrir o arquivo, você verá que o arquivo está formatado corretamente para CSV (Mostrando duascolunas, com a segunda coluna reduzida devido a seu tamanho). Em formatação CSV, não é possível terquebra automática de linha.

Para salvar isso em seu formato final, clique em Salvar como e selecione um nome de arquivo e o tipo dearquivo como CSV.


Ao abrir o arquivo TXT no Bloco de Notas, você verá as vírgulas separando as duas colunas e quandohouver uma vírgula sozinha nos dados, também será possível ver as aspas duplas no início da segundacoluna para alguns registros indicando que este problema foi resolvido.

Capítulo 14. Formatando Relatórios para Saída 189


Capítulo 15. Criando RelatóriosEsta seção descreve as técnicas utilizadas para criar relatórios utilizando a estrutura do IBM OpenPageswith Watson.

Ele fornece um exemplo detalhado das tarefas usadas para desenvolver relatórios e quando aplicá-las.

Manual de Definições de Configuração do IBM CognosHá diversas configurações do ambiente IBM Cognos no IBM OpenPages with Watson. Algumas delasforam definidas pelo instalador do OpenPages with Watson, ao passo que outras devem ser definidasmanualmente.

Esta seção descreve as configurações que precisam ser definidas manualmente.

Comportamento de Drill

Ao criar um relatório dimensional em que drill up e drill down são necessários, há uma configuração quedeve ser verificada para que esse comportamento funcione.

Na barra de menus, clique em Dados > Comportamento de drill. O diálogo Comportamento de drill éaberto.

Para que drill up e drill down funcionem, Permitir drill up e drill down deve ser marcado.

Opções de Validação

Por padrão, o IBM Cognos mostrará mensagens de aviso ao validar uma fórmula ou o relatório inteiro.Também há a opção de suprimir essas mensagens. Para isso, acesse a barra de menus e clique emFerramentas > Validar opções.

Configure o Nível de Validação: para Erro para que as mensagens de aviso não sejam mais exibidas.

Formatos de Dados Padrão

Se estiver desenvolvendo relatórios que requerem dados com estilo em determinados formatos, talvezvocê queira configurar os formatos de dados padrão no seu modelo de relatório de projeto. Paraconfigurá-los, acesse a barra de menus e clique em Dados > Formatos de dados padrão.

Configure as propriedades padrão dos tipos de itens de dados para que um item desse tipo herde essaspropriedades ao ser inserido no relatório.

Configurando RelatóriosHá muitos itens que precisam ser configurados no IBM OpenPages with Watson antes de o autor dorelatório poder iniciar.

A lista a seguir descreve alguns dos itens que precisam ser considerados.

Modelos de estrutura

A estrutura de relatório contém um modelo de estrutura predefinido chamadoOPENPAGES_FRAMEWORK_V6, que é usado para os relatórios predefinidos que são fornecidos com oOpenPages. Além do modelo de estrutura OPENPAGES_FRAMEWORK_V6, é possível criar seuspróprios modelos de estrutura. A capacidade de usar vários modelos de estrutura permite destinarum modelo de estrutura para soluções, funções de usuário ou perfis do objeto específicos.

Espaços de TabelasSerão fornecidos namespaces OOB que suportam os relatórios fornecidos com o OpenPages withWatson. Eles podem ou não suportar as necessidades de seu relatório. É possível estender essesnamespaces ou criar namespaces completamente novos de acordo com suas necessidades. Se vocêdefine seus próprios modelos de estrutura, deve-se definir namespaces para eles. Os namespacessão objetos globais.

Tipos de fatoOs tipos de funções de resumo que serão necessárias em seu modelo dimensional. Essa é umaconfiguração global que afeta todos os namespaces.

Códigos de IdiomasQuais idiomas você deseja que sua estrutura suporte. Essa é uma configuração global que afeta todosos namespaces.

TriângulosSe o seu relatório precisará usar um triângulo devido a um objeto recursivo. Esta configuração édefinida nos níveis global e de namespace.

Tabelas AuxiliaresSe é necessário extrair tabelas/CQS para um namespace para suportar seus relatórios. Isso é definidono nível de namespace.

Prefixos de objetoSe os objetos customizados tiverem sido incluídos no sistema, o prefixo do objeto terá que serdefinido. Essas são configurações globais.

Fatos e DimensõesSe estiver utilizando o modelo dimensional, será necessário definir fatos e dimensões para os objetosque serão relatados. Isso é definido no nível do objeto.

Níveis de objeto recursivo de entidade de negóciosEstas são as hierarquias de entidade de negócios definidas pelo usuário que podem ser utilizadaspara criar uma estrutura de relatório jurídica versus de negócios, por exemplo.

Níveis de objetos recursivo de entidadeQuais níveis de objeto recursivo de entidade de negócios você deseja em cada namespace.

Dimensões de Tipo de ObjetoEstas são as hierarquias que podem ser definidas para serem usadas no namespace dimensional.Pelo menos uma delas é necessária para criar relatórios dimensionais úteis. A Dimensão de Tipo deObjeto mais comum é uma dimensão entidade de negócios. Essa é uma configuração global.

Texto de dimensão TodosEssa configuração determina o que é exibido ao realizar drill up para o nível Todos em uma hierarquia.Essa é uma configuração global que afeta todas as dimensões.

Criação de índiceDependendo do design do relatório, poderá ser necessário incluir um índice em um campo paramelhorar o desempenho. Isso geralmente afeta a tabela na qual o índice é incluído.

Além dos itens configuráveis, há também as definições de campo do cliente que devem ser carregadaspara iniciar o desenvolvimento de relatórios. A lista a seguir descreve alguns desses itens.

Pacotes configuráveis e grupos de campoEstas são coleções de campos que são designadas a um objeto.

CamposEsta é a definição de um campo individual que o cliente solicitou para facilitar a configuração do seusistema.

Valores de Sequência EnumeradosEssa é a lista de valores permitidos para sequências enumeradas.

Todos os itens anteriores requerem que a estrutura seja gerada novamente quando uma mudança forfeita neles. O objetivo é investigar o que precisa ser definido, fazer as mudanças na configuração e, emseguida, gerar sua estrutura.


SQL de Relatório SubjacenteVocê deve tomar decisões sobre qual tipo de construção subjacente é usada para criar o relatório.

É necessário tomar as seguintes decisões.

Usando namespacesIncluir namespaces para criar seus relatórios.

Usando Custom Query Subjects (CQS)Os arquivos CQS precisam ser usados quando a SQL subjacente que precisa ser gerada não segueuma abordagem descendente ou requer junções entre objetos que não são padrão. A decisão deutilizar um CQS para um relatório não se baseia mais somente no desempenho esperado do relatório.O modelo V6 gera uma SQL de desempenho igual ou melhor do que possa ser criado manualmente. Adecisão tem como base se a estrutura pode suportar a construção de SQL subjacente para criar orelatório.

Vamos supor que o relatório a ser criado usará namespaces para criar a SQL subjacente. A Criação deAssuntos de Consulta Customizada é explicada em Capítulo 18, “Assuntos de Consulta Customizada”, napágina 209.

Utilizando um Modelo de RelatórioO melhor local para iniciar é com o modelo de relatório que deve ter sido desenvolvido durante a fase derequisitos de relatório do projeto. O modelo reflete o estilo no qual todos os relatórios para este projetotambém devem ser desenvolvidos.

Esse modelo inclui fórmulas condicionais úteis, o layout para a página de prompt, o layout para a páginade relatório e para assuntos de consulta predefinidos para entidades de negócios e períodos de relatório.Ao iniciar com um modelo, você mais provavelmente criará relatórios uniformes que podem ser editadospor qualquer autor do relatório em sua organização.

• A página de prompt contém os dois prompts mais populares e sua SQL subjacente. Esses promptsserão obtidos do namespace DEFAULT e, se outro namespace for utilizado nesse relatório, seránecessário ajustar a origem desses campos de dados. Além disso, o espaçamento padrão das célulasda tabela foi configurado.

• A página de relatório possui o cabeçalho configurado com o logotipo, o javascript para hiperlinkscarregado, o layout de subcabeçalhos definido, uma lista simulada incluída e o rodapé configurado.

• O logotipo está localizado na página como um exemplo para o cliente. Ele pode ficar em qualquer lado.Para substituir o logotipo, deve-se substituir o arquivo logo.gif pelo logotipo correto no servidor IBMCognos.

• O objeto html contém o javascript para os hiperlinks. Se você não usar hiperlinks neste relatório, serápossível remover esse objeto. A lista simulada contém a parte de exibição do código de hiperlink comouma expressão definida no objeto de hiperlink.

• O cabeçalho é configurado para ser comprimível para que quando você desejar tornar o relatório menorque a tela cheia, os títulos se comprimam corretamente.

• O valor de nenhum dado exibido foi configurado no objeto de lista simulada. Isso aparece quando ousuário seleciona uma combinação de prompts que não produz nenhum dado no relatório.

• Por último, o rodapé foi configurado para ser localizado. Os formatos de data e hora são configuradospara serem genéricos de maneira que o IBM Cognos irá localizar esses campos de acordo com o códigodo idioma associado ao usuário do login.

• Fórmulas condicionais comuns foram incluídas no modelo:

LocalizaçãoEssa fórmula é usada para localizar campos de texto para os idiomas suportados além do inglês dosEUA.

Capítulo 15. Criando Relatórios 193

Cabeçalho de RelatórioComo não há conceito de um cabeçalho de relatório no IBM Cognos, esta fórmula simula um com ocabeçalho da página.

Destaque de linhaÉ usado para destacar todas as linhas em um relatório de lista. Isso é útil apenas para relatórios delista simples.

Saída de RelatórioÉ usado quando é preciso criar uma condição, dependendo do tipo de saída de relatório.

Nota: Entre em contato com o líder do projeto para obter uma cópia do modelo do IBM OpenPages withWatson.

Organização do Assunto de ConsultaAo criar assuntos de consulta para relatórios, você deve seguir várias diretrizes.

Ao criar assuntos de consulta para relatórios, as diretrizes a seguir devem ser observadas:

• Coloque as consultas de prompt no final da página. Elas são utilizadas com frequência e você nãodeseja rolar constantemente através delas.

• Coloque as consultas de apoio em uma junção ou união diretamente nessa construção. Isso facilita alocalização delas.

• Nomeie os assuntos de consulta de maneira lógica de modo que o próximo autor do relatório possaentender o relatório.

Normalmente os assuntos de consulta são projetados do final para o início, com as consultas maisdetalhadas no final e as consultas mais agregadas no início, conforme mostrado na Figura 109 na página194. A ideia é preencher assuntos de consulta com os valores que são necessários para atender aosrequisitos do relatório. Construções como filtros são colocadas no nível mais baixo do assunto deconsulta na hierarquia na ordem para acelerar o desempenho.

Figura 109. Filhos do Assunto de Consulta

Este exemplo demonstra as seguintes informações:


• Há campos incluídos no relatório a partir do objeto de entidade de negócios e do objeto de risco.• Há itens de dados customizados incluídos nesta consulta.• Há filtros incluídos nessa consulta porque é a consulta-filha do relatório.

Conforme você constrói cada assunto de consulta, deve-se verificar os dados que estão sendo produzidospara assegurar que os dados corretos sejam extraídos do banco de dados e registros duplicados nãosejam incluídos. Ao fazer isso em cada assunto de consulta, você aumenta a qualidade do que estáconstruindo e seu entendimento de como os dados são construídos. Lembre-se de que o IBM OpenPageswith Watson é um sistema muito flexível que permite uma quantia ilimitada de configuração. Se o seuentendimento do modelo de dados diferir do entendimento do cliente, você produzirá resultadosincorretos.

É possível produzir saída a partir de qualquer um dos assuntos de consulta ao selecionar um item noassunto de consulta e utilizar a Visualização de Dados Tabulares. Isso exibirá os prompts que estiveremincluídos no assunto de consulta (e em qualquer assunto de consulta que for filho do assunto de consultaque você está exibindo). Para executar essa ação, selecione o seguinte a partir do menu Executar.

Uma página de prompt será exibida, que deverá ser preenchida com valores válidos, e a saída do assuntode consulta será exibida em um formato de lista de base. Isso exibe todos os dados que a consultaretornou do banco de dados, que agora podem ser revisados para determinar se esses são os dadosesperados.

Construções de Assunto de ConsultaTodos os objetos independentes devem ser unidos manualmente junto de quaisquer objetos primáriosque precisam ser unidos devido à complexidade de um relatório.

Além disso, algumas das construções foram atualizadas. Por exemplo, as uniões podem agora manipularmais de dois assuntos de consulta. Isso cria SQL mais eficiente do que em versões anteriores do IBMCognos.

A união agora inclui também as seguintes propriedades:

Configurar OperaçãoIsto permite que o usuário mude a operação para outro tipo de operador de conjunto. Isso deve serconfigurado sempre como União.

DuplicaDetermina se as linhas duplicadas são removidas do conjunto de resultados. Isso normalmente éconfigurado para Remover.

Lista de ProjeçõesIsso determina se o conjunto de itens de dados que é resultado dessa união é geradoautomaticamente ou manualmente. Recomendamos que isto seja configurado sempre como GeradoAutomaticamente. Isto ocorre devido a problemas que foram vistos quando nem todos os itens deconjunto de dados foram incluídos no conjunto de resultados (quando a seleção era manual),causando problemas de validação.

Formatando Tabelas ou Listas VaziasUm problema que deve ser resolvido é das listas em branco, tabelas e tabulações on-line em umrelatório. Se o contêiner principal não retornar nenhum dado, utilize a propriedade Nenhum Conteúdo deDados do contêiner para informar o usuário que os valores de prompt que ele escolheu não geramnenhum dado. A segunda situação é quando você tem uma subtabela ou uma lista em um relatório quenão possui nenhum dado quando o relatório é executado. Somente um cabeçalho é exibido e nada mais.


Sobre Esta Tarefa

No exemplo a seguir temos um relatório que exibe informações de entidade e, no rodapé da lista,exibimos uma lista de problemas ligados a essa entidade. Ao executarmos o relatório pela primeira vez,vimos o seguinte, conforme mostrado no Figura 110 na página 196:

Figura 110. Seção Em Branco Exibida

O que vemos é que na primeira seção há um problema listado, mas nas seções segunda e terceira,nenhum dado foi localizado e o cabeçalho da lista aparece.

Procedimento

1. Usando o Explorador de condição, conclua as seguintes etapas.a) Crie uma nova Variável booleana.b) Na variável Booleana, insira a seguinte fórmula:

[Issue].[IS_ISSUE_ID] is missing or[Issue].[IS_ISSUE_ID] is null

c) Clique em OK.d) Na área de janela Propriedades, em Diversos, configure a propriedade Nome para Ocultar Títulos.

2. Na página principal do relatório, conclua as seguintes etapas.a) Selecione um cabeçalho de lista na lista de problema.b) Utilizando o seletor anterior, selecione Listar Estilo de Coluna de Lista.c) Na área de janela Propriedades, na seção Condicional, configure a Variável de Estilo para Ocultar

Títulos.

3. No Explorador de condição, conclua as etapas a seguir.a) Selecione Sim na variável Ocultar Títulos.b) Na área de janela Propriedades, na seção Caixa, configure o Tipo de Caixa para Nenhum.


Resultados

Agora, ao executar o relatório, o Figura 111 na página 197 mostra que o título do cabeçalho de lista foiremovido e que não há nenhum dado na lista.


Figura 111. Ocultando Lista em Branco



Capítulo 16. Campos CalculadosOs campos computados permitem definir campos em um objeto cujo valor é calculado a partir dosvalores de outros campos. Estes outros campos podem existir no mesmo objeto ou em outro objetorelacionado. Esses cálculos estarão disponíveis em ambos os aplicativos e também para fins de relatório.

Os campos computados são definidos na interface com o usuário do aplicativo. Para obter informaçõessobre como definir um novo campo computado, consulte o Guia do administrador do IBM OpenPages withWatson ou entre em contato com o administrador do sistema para obter assistência.

Limitações de Campos Computados

• Há uma limitação no tamanho do valor de atributo de cálculo que pode ser armazenado pelo aplicativo.O atributo principal em questão é Equação, em que uma equação complexa comprimida pode sermuito longa.

Há um limite de 20.000 bytes no tamanho do texto inserido. Observe que o aplicativo suportacaracteres multibytes e, portanto, isso poderá não ser o equivalente a 20.000 caracteres.

Se mais de 20.000 bytes de informações forem necessários para a equação, deve-se criar o cálculo noarquivo do assunto de consulta customizada, conforme descrito em “Criando Cálculos” na página 218.

• Ao explorar todas as possibilidades de cálculo, há uma grande diferença no que deve ser feito. Emboraseja possível consultar a árvore de relacionamento (ou seja, calcular valores com base emantecessores), isso é altamente desaconselhável.

A geração automática de estrutura é configurada de modo a criar junções que levam a um melhordesempenho ao consultar a árvore de relacionamentos para baixo.

Nota: Uma consulta da árvore para cima prejudica o desempenho do campo computado, além desobrecarregar enormemente o banco de dados e causar uma lentidão no aplicativo inteiro.

• Os campos computados podem, às vezes, agir como blocos de construção para outros camposcomputados. Isso é referido como cálculos intermediários. Atualmente, o aplicativo IBM OpenPageswith Watson não suporta definições de cálculo intermediário por meio da interface com o usuário doaplicativo. Se desejar fazer referência a outro campo computado, deve-se replicar a equação utilizadanesse campo computado dentro da equação para o campo atual.

Por exemplo:

Por exemplo, se tivéssemos um campo computado A e o definíssemos como A = B * C e tambémsoubéssemos que C = D + E, poderíamos apenas criar um campo computado A no aplicativo no quala equação seria B * (D + E). Embora esta abordagem possa ser detalhada, às vezes é a maissimples.

• As definições usadas em um campo computado devem estar presentes no namespace que está sendousado e devem estar relacionadas ao objeto no qual está sendo criado o campo computado. É possívelcriar um campo computado que será válido no formato, mas que não produzirá nenhum resultadodevido a esta limitação.

Considerações de Design

Considere os seguintes itens ao projetar o campo computado:

LocalizaçãoTodos os tipos de dados calculados serão localizados pelo aplicativo, exceto para sequência simples,que deve ser localizada como parte do cálculo (equação).

Campos computados dependentesUm cálculo que usa outro cálculo como parte de sua equação não é suportado.

Produtos cruzados de cálculoAo gravar um cálculo que agrega diversos tipos de objetos, normalmente nos deparamos com umproblema em que alguns objetos são contados várias vezes e, portanto, é necessário considerar isso.

Manipulando valores nulosAo gravar uma equação, deve-se considerar que se parte da equação for avaliada como nula e depoisfor usada em alguma outra operação aritmética, a segunda operação também retornará nulo. Asolução para esse problema é a função nvl() que utiliza dois argumentos: uma expressão paraavaliar e verificar se ela é nula e um valor a ser usado caso ela seja nula. Exemplo:

average (nvl(Loss Impacts, 0) for Loss Events) * count ( nvl(distinct Loss Impacts for Loss Events, 0))

Criando um Campo ComputadoÉ possível criar um campo computado.

Procedimento

1. Crie um novo relatório de lista.2. Inclua os seguintes itens de consulta na lista:

• DEFAULT|DEFAULT_REL|GRC_OBJECTS|[SOXRISK]|ID_FIELDS| [RI_REPORTING_PERIOD_ID]

• DEFAULT|DEFAULT_REL|GRC_OBJECTS|[SOXRISK]|ID_FIELDS|[RI_RISK_ID]

3. Clique na guia Caixa de ferramentas na área de janela Objetos que podem ser inseridos.4. Arraste e solte um objeto Cálculo de consulta na lista.5. Nomeie o Campo computado do cálculo de consulta.6. Na área de janela Definição de Expressão, insira a seguinte expressão:

total([DEFAULT_REL].[SOXRISK].[RI_INHERENT_SEVERIT_BA] for [DEFAULT_REL].[SOXRISK].[RI_RISK_ID]) / 100

7. Clique no ícone Validar para validar a expressão e, então, clique em OK.Seu relatório deve ser semelhante ao seguinte exemplo:

Figura 112. Campo Computado Incluído em um Relatório de Lista8. Execute o relatório.

Fornecendo Campos ObrigatóriosAntes de o administrador do sistema criar o campo computado no IBM OpenPages with Watson, deve-sefornecer os campos a seguir: Equação, Namespace Primário, Namespaces Alternativos, Coluna do ID doObjeto, Coluna do ID do Período de Relatório e Nome do Pacote.

Crie os campos a seguir.


EquaçãoA equação é a SQL usada para definir o valor calculado para o campo do objeto. Ela pode ser umareferência a um item de consulta existente na estrutura publicada ou uma equação que envolvediversos itens de consulta.

Namespace primárioO namespace primário é o namespace de estrutura no qual o cálculo será incluído durante a geraçãoda estrutura de relatório.

Nota: Todos os itens de consulta referenciados nos valores para Equação, Coluna de ID do objeto eColuna de ID do período de relatório devem estar no mesmo namespace.

Namespaces alternativosO namespace alternativo é outro namespace de estrutura no qual o cálculo será incluído durante ageração da estrutura de relatório.

Coluna de ID do objetoA Coluna de ID do objeto é uma referência a um item de consulta de estrutura que contém o ID dorecurso do tipo de objeto do campo computado. Esse valor deve ser o mesmo para todos os camposcomputados em um determinado namespace para um tipo de objeto.

Coluna de ID do período de relatórioA Coluna de ID de período de relatório é um item de consulta de estrutura que contém o ID doperíodo de relatório do tipo de objeto do campo computado. Esse valor deve ser o mesmo para todosos campos computados em um determinado namespace para um tipo de objeto.

Nota: O ID de Recurso e o ID de Período de Relatório devem corresponder no grupo de campo e notipo de objeto. Se estes valores não corresponderem, a validação falhará.

Nome do pacoteO nome do pacote define o pacote de relatórios com relação ao qual o cálculo é executado. Se o nomedo pacote estiver vazio, o pacote para o modelo de estrutura OPENPAGES_FRAMEWORK_V6 seráusado.

Criando um Arquivo de DadosPara obter os valores do campo obrigatório, o melhor método é recortar e colar os valores de um arquivode texto e enviá-los para seu Administrador do Sistema para que o campo possa ser criado. Siga esteprocedimento para obter os valores.

Procedimento

1. No início do arquivo, crie um rótulo chamado Nome e dê um nome ao campo computado.2. Crie um rótulo denominado Descrição e insira um valor para a descrição do campo computado.3. Dê um clique duplo na coluna Campo Calculado.4. Recorte e cole a equação da área de janela Definição de Expressão em um arquivo de texto.

Assegure-se de rotular essa equação como Expressão no arquivo.5. Clique em Cancelar.6. Crie um rótulo para o Namespace Primário e insira o nome do namespace no arquivo de texto. Este é

o namespace de nível superior, não o sub-namespace.7. Se houver Namespaces Alternativos que utilizarão este cálculo, crie o elemento apropriado no

arquivo de texto.8. Repita as etapas 3-5 para os campos ID de Objeto e Período de Relatório, rotulando-os

adequadamente no arquivo de texto.

Capítulo 16. Campos Calculados 201

Resultados

Agora deve-se enviar o arquivo de texto para seu Administrador do Sistema para que eles possam incluiro campo computado no sistema. As instruções para fazer isso estão no Guia do administrador do IBMOpenPages with Watson.

Usando Campos Computado em Diversos NamespacesNo aplicativo IBM OpenPages with Watson, permitimos diversos tipos de objetos pais para um tipo deobjeto filho especificado.

Isso não se aplica ao IBM Cognos para um determinado namespace devido a algumas das limitaçõestécnicas no IBM Cognos. Por exemplo, no namespace ORM o único caminho para um Evento de Perda épor meio de uma Entidade de Negócios. Isso significa que se um Evento de Perda estiver associado a umRisco, mas não a uma Entidade de Negócios, esse Evento de Perda não será mostrado nas consultas comrelação a esse namespace. A solução alternativa para esse problema é introduzir diversos namespaces,com cada um deles possuindo um caminho distinto para um tipo de objeto.

Para disponibilizar o cálculo em vários namespaces para os autores de relatórios, temos o campoNamespaces adicionais. Trata-se de uma lista delimitada por vírgulas de namespaces alternativos para osquais um objeto Cálculo deve ser criado durante o processo de geração de estrutura. Durante esseprocesso, um objeto de cálculo é criado primeiro para o namespace primário utilizando o valor do atributoEquação. Em seguida, ele cria outros objetos de cálculo em outros namespaces ao usar a equação esubstituir os namespaces alternativos para o namespace primário.

Importante: Uma equação pode ser válida em um namespace, mas inválida em outros. Na maioria doscasos isso não é um problema, mas se o nome do assunto de consulta ou o nome do item de consultavariar entre os namespaces, pode ser necessário criar instâncias de campo computado separadas comdiferentes equações.


Capítulo 17. Fragmentos de RelatóriosUm fragmento de relatório é geralmente um gráfico, uma crosstab ou uma lista que pode ser colocada emuma página do aplicativo para que o usuário possa ver uma representação visual dos dados ao lado dosdados da página.

Limitações nos Fragmentos de Relatórios

Os fragmentos de relatório possuem as seguintes limitações:

• Quebras de página não são suportadas.• Dicas de ferramentas não são suportadas.• Um relatório que possuir prompts necessários diferentes de ID do Objeto e ID de Período de Relatório

não pode ser utilizado.• Prompts sequenciais na página do relatório não são suportados.• Não é possível configurar a cor do plano de fundo de um fragmento para transparente.• O método para implementar CrossTracks é diferente em um fragmento de relatório.• Pode haver somente um fragmento de relatório em um relatório. Colocar diversos fragmentos de

relatórios em um único relatório fará com que todos os fragmentos sejam executados toda vez que umfragmento único for executado na IU.

• O fragmento pode ser utilizado somente com o objeto que estiver sendo transmitido para o relatóriocomo um prompt.

• Drill throughs não são suportados.• A propriedade Nenhum conteúdo de dados não funciona para contêineres de dados.

Criando Fragmentos de RelatóriosFragmentos de relatórios são desenvolvidos da mesma maneira que um relatório. Um fragmento derelatório é um contêiner de dados único (mais provavelmente um gráfico ou uma lista) com dados. Não hácabeçalhos, rodapé nem ou outros elementos de relatório.

O fragmento de relatório, quando renderizado no aplicativo, é uma imagem (no caso de um gráfico) ouuma tabela HTML no caso de uma lista ou de uma crosstab. O único recurso interativo que está disponívelé um hiperlink que é descrito na próxima seção.

Há poucos requisitos ao criar seu fragmento:

• Deve-se transmitir um ID do recurso para o fragmento. No seu relatório, isso assumirá a forma de umfiltro:

[DEFAULT_REL].[SOXBUSENTITY_GPC].[GEN_ENTITY_ID] = ?Business Entity?

• Deve -se também transmitir o ID de Período de Relatório para o relatório. Mais uma vez, isso assumirá aforma de um filtro:

[DEFAULT_REL].[SOXBUSENTITY_GPC].[GEN_REPORTING_PERIOD_ID] = ?Reporting Period ID?

• É necessário fornecer o elemento de relatório que deseja publicar como um nome de fragmento:

1. Selecione o contêiner de dados (gráfico, lista ou crosstab) e, utilizando o seletor anterior na área dejanela Propriedades, selecione o próprio contêiner.

2. Na categoria Diversos, configure a propriedade Nome para listMain ou para o que desejar.

O último item tem a ver com a configuração da altura e largura do fragmento. Há duas maneiras para isso:

• Ao configurar a altura e a largura no relatório do contêiner de dados. Isso funciona melhor com listas ecrosstabs.

• Ao configurar a altura e a largura no aplicativo IBM OpenPages with Watson quando o campo defragmento de relatório é definido. Isso funciona melhor com gráficos.

Utilizando CrossTracks em Fragmentos de RelatóriosCrosstracks são suportados em fragmentos de relatório. No entanto, o modo em que normalmentecriamos links CrossTrack (com um objeto Hyperlink no IBM Cognos) não funciona a partir de fragmentosde relatório.

Para obter a funcionalidade crosstrack, será necessário usar tags HTML em vez de hiperlinks.

Criando um Link para Abertura na Mesma JanelaÉ possível criar um hiperlink em um fragmento de relatório que é aberto na mesma janela do navegador.

Dica: Neste exemplo estamos usando o objeto Risco, mas é possível substituir qualquer objeto.

Procedimento

1. Utilizando o Explorador de Consultas, selecione a consulta principal para o fragmento de relatório.2. No relatório de lista existente, arraste e solte um Item de HTML como uma coluna em seu relatório e

conclua as seguintes etapas.a) Na área de janela Propriedades em Origem de HTML, configure a propriedade Tipo de Origem

para Expressão.b) Na propriedade Expressão de Relatório, insira o seguinte:

'<a href="' + [DEFAULT_REL].[SOXRISK].[RI_DETAIL_PAGE_URL] + '">' + [DEFAULT_REL].[SOXRISK].[RI_NAME00] + '</a>'

c) Clique em OK.

3. Selecione o texto do título da coluna e na área de janela Propriedades, em Origem de Texto,configure a propriedade Texto para Nome do Risco.

4. Recorte a coluna Nome do Risco original do relatório.5. Para fazer RI_NAME00, uma propriedade da lista, conclua as etapas a seguir.

a) Selecione o objeto Lista na página principal do relatório.b) Na área de janela Propriedades na categoria Dados, dê um clique duplo em Propriedades.c) Selecione [RI_NAME00].d) Clique em OK.

6. Salve o relatório.7. Peça ao seu administrador do sistema para configurar um campo de fragmento de relatório para este

relatório.

Resultados

Quando o campo de fragmento de relatório é executado no IBM OpenPages with Watson, ele aparececomo uma célula em uma visualização detalhada.

Ao clicar no CrossTrack, ele levará você para a página de detalhes do objeto na mesma janela.

Criando um Link para Abertura em uma Nova JanelaÉ possível criar um hiperlink em um fragmento de relatório que abre a página de detalhes do objeto emuma nova janela do navegador.


Procedimento

1. No Explorador de consulta, conclua as etapas a seguir.a) Arraste e solte um Item de Dados para a área de janela Itens de Dados.b) Na área de janela Propriedades, na categoria Item de Dados, clique duas vezes na propriedade

Expressão.c) Insira a seguinte expressão:

'<a href="#"' + ' onclick="' + 'javascript:window.open(' + chr(39) + [DEFAULT_REL].[SOXRISK].[RI_DETAIL_PAGE_URL] + chr(39) + ')' + '">' + [DEFAULT_REL].[SOXRISK].[RI_NAME00] + '</a>'

d) Configure a propriedade Nome para Informações de URL.e) Configure a Função Agregada para Nenhuma.f) Configure a Função de Agregado de Sintetização para Nenhuma.g) Clique em OK.

2. Na página principal do seu relatório de lista, arraste e solte um Item de HTML como uma coluna emseu relatório e conclua as seguintes etapas.a) Na área de janela Propriedades, em Origem HTML, configure a propriedade Tipo de Origem para

Valor do Item de Dados.b) Configure a propriedade Valor do Item de Dados para Informações de URL.c) Na área de janela Propriedades, em Origem de Texto, configure a propriedade Texto para Nome

do Risco.

3. Recorte a coluna Nome do Risco original do relatório.4. Para tornar a RI_DETAIL_PAGE_URL uma propriedade da lista, conclua as etapas a seguir.

a) Selecione o objeto Lista na página principal do relatório.b) Na área de janela Propriedades na categoria Dados, dê um clique duplo em Propriedades.c) Selecione [RI_DETAIL_PAGE_URL].d) Clique em OK.

5. Salve o relatório.6. Peça ao seu administrador do sistema para configurar um campo de fragmento de relatório para este

relatório.

Resultados

Quando o fragmento de relatório for executado no IBM OpenPages with Watson, ele aparecerá como umcampo em uma visualização detalhada.

Ao clicar no link CrossTrack, ele levará você para a página de detalhes do objeto em uma nova janela pop-up.

Fornecendo Campos de ConfiguraçãoAntes de o administrador do sistema criar o campo de fragmento no aplicativo IBM OpenPages withWatson, é necessário fornecer os seguintes campos: Caminho do relatório, Nome do fragmento, Promptde ID do objeto, Prompt de ID do período de relatório, Altura e Largura.

Crie os seguintes campos.

Caminho do relatórioO local do relatório no repositório do CommandCenter. Consulte “Obtendo o Caminho de Relatório”na página 206.

Capítulo 17. Fragmentos de Relatórios 205

Nome do FragmentoO nome do elemento de relatório a ser exibido no fragmento de relatório. Geralmente é o nome de umcontêiner de dados. Consulte “Obtendo o Nome do Fragmento” na página 206.

Prompt de ID de ObjetoO nome do prompt de ID do objeto no relatório. Esse campo é opcional. Consulte “Obtendo Promptsde Objeto” na página 206.

Prompt de ID de Período de RelatórioO nome do prompt de período de relatório. Esse campo é opcional. Consulte “Obtendo Prompts deObjeto” na página 206.

Altura e LarguraA altura e a largura da área de exibição em pixels. Geralmente é utilizado apenas quando uma listaestá sendo exibida. Consulte “Obtendo Altura e Largura” na página 207.

Para obter os valores anteriores, o melhor método é recortar e colar os valores do CommandCenter emum arquivo de texto e enviá-los para o administrador do sistema. Crie rótulos em seu arquivo de textocorrespondentes aos campos anteriores. Inicie o arquivo de texto com um campo Nome e Descrição paraseu fragmento de relatório.

Obtendo o Caminho de RelatórioÉ possível obter o Caminho de Relatório para um fragmento de relatório.

Procedimento

1. No portal de relatório, navegue para a pasta que contém o relatório de fragmento de geração derelatório.

2. Clique no ícone Configurar propriedades.3. Clique no hiperlink Visualizar caminho da procura, ID e URL.4. No pop-up, recorte e cole o Caminho da Procura no arquivo de texto como o Caminho de Relatório.5. Clique em Concluir.

Obtendo o Nome do FragmentoÉ possível obter o Nome do Fragmento para um fragmento de relatório.

Procedimento

1. Selecione a página principal do relatório.2. Selecione o elemento de relatório que deseja exibir no fragmento. Esta será uma lista, gráfico ou

tabulação cruzada.3. Na Área de Janela de Propriedades em Diversos, recorte e cole a propriedade Nome em seu arquivo

de texto.

Obtendo Prompts de ObjetoÉ possível obter um Prompt de ID do Objeto para um fragmento do relatório.

Procedimento

1. Se uma página de prompt não existir, selecione o assunto de consulta principal do fragmento noExplorador de Consultas e localize o nome do prompt em um dos filtros. Ignore o restante destaseção.

2. Caso contrário, use o Explorador de Página e navegue para a página de prompt. Selecione o controleque contém o Prompt de ID de Objeto.

3. Na Área de Janela de Propriedades em Geral, recorte e cole a propriedade Parâmetro no arquivo detexto.

4. Repita a etapa 3 para obter o Prompt de ID de Período de Relatório (se existir).


Obtendo Altura e LarguraOs parâmetros de altura e largura são opcionais Se o relatório for um gráfico, os valores poderão serdeixados em branco, e o gráfico será escalado automaticamente. Se o relatório for uma lista ou crosstab,determine uma Altura e Largura ideais para minimizar a rolagem.

Usando imagens em Fragmentos de relatóriosÉ possível inserir uma imagem em um relatório que é usado em Fragmentos de relatórios.

Antes de IniciarAs imagens que você insere devem primeiro ser transferidas por upload para o servidor IBM CognosAnalytics e o servidor IBM OpenPages with Watson. As imagens devem estar nos formatos gif ou jpg.

Sobre Esta Tarefa

Depois de fazer upload da imagem, deve-se usar um caminho relativo para fazer referência a ela. Ocaminho relativo deve ser válido em ambos os servidores, IBM Cognos Analytics e IBM OpenPages withWatson.

Siga estas melhores práticas:

• Copie a imagem para as seguintes pastas:

– <COGNOS_HOME>\webcontent\bi\images– <OP_Home>\profiles\(servername)-OPNode1\installedApps\OpenPagesCell\op-apps.ear\sosa.war\images

• Acesse a imagem no relatório que é usado para o fragmento de relatório usando o caminho relativo ../images/<image file name>.

Capítulo 17. Fragmentos de Relatórios 207


Capítulo 18. Assuntos de Consulta CustomizadaOs Assuntos de Consulta Customizada (CQS) são um recurso que é oferecido pelo IBM OpenPages withWatson para que um autor do relatório possa criar uma instrução SQL definida pelo usuário para resolverum problema que não pode ser resolvido por meio do uso da estrutura. O modelo de estrutura prontopara uso representa um ambiente que normalmente resolve a maioria das necessidades de relatório deum cliente; o restante é resolvido utilizando assuntos de consulta customizada.

A lista a seguir descreve o fluxo do processo para criar relatórios usando um assunto de consultacustomizada

1. Revisar o documento de design de relatório.2. Criar um diagrama de ER dos objetos necessários.3. Criar instruções SQL na ferramenta de desenvolvimento de SQL.4. Incluir funções de banco de dados do OpenPages.5. Substituir variáveis.6. Concluir o teste na ferramenta de desenvolvimento de SQL.7. Criar um novo relatório.8. Incluir SQL em um objeto SQL.9. Colocar as variáveis de volta na SQL.

10. Concluir desenvolvimento de relatório.11. Criar uma entrada no arquivo CQS.12. Gerar novamente a estrutura.13. Substituir referências de objeto SQL por CQS.

Revisando seu Design de RelatórioA primeira etapa no design de um Assunto de Consulta Customizada é revisar o design do relatório.

Deve-se prestar atenção especial para os campos e objetos necessários para produzir o relatório. Issopermite decidir se irá criar um assunto de consulta customizada ou utilizar o modelo de estrutura derelatório existente.

Criando um Diagrama de Relacionamento de EntidadeO IBM OpenPages with Watson permite determinar os campos anexados a um objeto e osrelacionamentos entre os objetos.

A próxima etapa na criação de um assunto de consulta customizada é gerar um diagrama deRelacionamento de Entidade (ER).

Clique em Administração > Tipos de objeto. A lista que é aberta contém todos os objetos definidos emseu sistema.

Se selecionar um objeto individual, será possível ver os grupos de campos definidos para o objeto.

O grupo de campos para o objeto contém a definição de todos os campos definidos para o objeto. Istonão inclui chaves e outros campos de ID que podem ser necessários para criar prompts ou junções entretabelas. Consulte Capítulo 1, “Modelos de Banco de Dados”, na página 1 para obter mais informaçõessobre os campos necessários para unir tabelas.

Utilizando essas informações, agora é possível determinar quais objetos são necessários em suainstrução SQL. Conforme especificado no Capítulo 1, “Modelos de Banco de Dados”, na página 1, cada um

desses objetos corresponde a uma tabela de relatório e a um conjunto de tabelas de ponte. É necessáriodeterminar o relacionamento entre os objetos e, portanto, qual tipo de junção é necessário e quaistabelas de ponte utilizar.

Nesse momento, é possível criar um diagrama ER em uma ferramenta de diagramação que formará abase se sua instrução SQL. É uma boa prática revisar o diagrama com um dos arquitetos do sistema paraverificar sua precisão.

Criando uma Instrução SQLUtilizando uma ferramenta de desenvolvimento SQL, é possível criar sua instrução SQL.

Seguindo as normas de codificação SQL listadas no Apêndice A, “Diretrizes de Codificação de SQL”, napágina 223, grave sua SQL assegurando que todos os campos obrigatórios para o relatório sejamincluídos. Verifique no conjunto de resultados se há registros duplicados e agrupamento adequado. Aoconcluir, será possível recortar e colar essa instrução SQL nos relatórios.

É necessário lembrar-se de usar as visualizações RV_ ao criar sua instrução SQL. Cada visualização RV_contém uma coluna Segurança do OpenPages, OP_FLAG_READ_ACCESS, com esses valores possíveis:S

Se o usuário que está executando o relatório tiver acesso de leitura ao registro.N

Se o usuário que está executando o relatório não tiver acesso de leitura ao registro.Por exemplo, se desejar que a segurança do desejar IBM OpenPages with Watson seja integrada no CQS,deve-se incluir o filtro nesta coluna:

OP_FLAG_READ_ACCESS ='Y'

Se estiver utilizando o Oracle SQL Developer, existem casos em que o SQL Developer não funcionacorretamente devido a um problema quando um ID de usuário não tem um valor padrão configuradocorretamente. É possível configurar manualmente a variável de código do idioma executando a seguinteinstrução SQL em sua sessão:

begin OP_SESSION_MGR.SET_ACTOR_ID_PRIVATE (#$account.parameters.openPagesUserId#); end;

Em que você substitui a macro IBM Cognos por um valor de ID de usuário válido.

Instruções SQL com a criptografia de nível de campo

Quando você usar a tabela PROPERTY.AUDIT.TRAIL em sua consulta SQL e a criptografia no nível docampo estiver ativada, decriptografe o valor da propriedade da tabela PROPERTY.AUDIT.TRAIL parapermitir que os usuários vejam os valores de texto não criptografado.

A função de banco de dados a seguir é usada para decriptografar valores de propriedade:op_crypt_mgr.decrypt_property_value Isso é usado para decriptografar valores na tabelaPROPERTY.AUDIT.TRAIL.

As propriedades de entrada a seguir são usadas para a função de banco de dadosop_crypt_mgr.decrypt_property_value:

• Propriedade 1: propertydefs.propertydefid (ID de PropertyDef do campo.)• Propriedade 2: propertyvals.value (Valor da Propriedade do campo.)

Por exemplo, selecione op_crypt_mgr.decrypt_property_value(t.propertydefid, t.old_value) a partir do tproperty_audit_trail.

Incluindo Funções de Banco de DadosÉ possível usar muitas funções de banco de dados no IBM OpenPages with Watson.


O Capítulo 13, “Utilizando Funções de Banco de Dados Predefinidas”, na página 149 descreve todas asfunções do banco de dados do IBM OpenPages with Watson que foram expostas para o autor do relatório.Há três funções principais que precisarão ser utilizadas:

OP_ACTOR_MGR.GET_DISPLAY_NAMEUsada para converter userIds nos nomes de usuários reais.

OP_RPS_AUX.CONVERT_EVID_TO_NAMEUsada para converter uma única sequência enumerada de seleção em seu texto.

OP_RPS_AUX.CONVERT_EVIDLIST_TO_NAMEUsada para converter uma sequência enumerada multisseleção em uma lista separada por vírgula detexto.

Depois de criar sua instrução SQL, você poderá ver nos conjuntos de resultados quais itens sãoretornados como IDs e quais são retornados como texto. Será necessário converter as sequênciasretornadas como IDs em texto legível para tornar o relatório útil. Você deve verificar se os campos queestão sendo convertidos são sequências enumeradas reais, clicando em Administração > Tipos deobjeto e procurando os campos nos objetos individuais.

A função GET_DISPLAY_NAME é usada (com base nos requisitos de sua organização específica) paramostrar nomes do usuário em relatórios ao invés do nome de login.

Substituindo VariáveisApós ter incluído as funções do banco de dados, haverá referências às sequências de substituição queestão disponíveis apenas no ambiente de relatório do IBM Cognos.

Para testar sua SQL, será necessário fazer as seguintes substituições.

#$account.parameters.openPagesLocaleId#Este é o código de idioma do usuário que está com login efetuado no sistema. Use 1 (EN_US).

#$account.parameters.openPagesUserId#Esse é o número do ID do usuário que está com login efetuado no sistema. Consulte a tabelaactorinfo e use o valor actorId para o OpenPagesAdministrator em vez dessa variável.

Testando uma Instrução SQLDepois de criar uma instrução SQL válida, você deve testá-la.

Você deve examinar o conjunto de resultados para os itens a seguir:

• Registros duplicados• Junções inválidas• Dados que precisam de conversão• Campos ausentes ou errados• Campos nomeados incorretamente• Desempenho do teste

Criando o RelatórioÉ possível selecionar um tipo de relatório para criar um novo relatório.

Neste ponto, você terá uma instrução SQL totalmente funcional contendo todos os campos necessáriospara concluir seu relatório.

Selecione um tipo de relatório para criar um novo relatório.

Capítulo 18. Assuntos de Consulta Customizada 211

Incluindo um Objeto SQLÉ possível incluir um objeto SQL para um relatório.

Procedimento

1. Abra o explorador de consultas e selecione a consulta que foi criada para o relatório.2. Selecione um objeto SQL a partir do menu caixa de ferramentas e solte-o no assunto de consulta ao

lado do assunto de consulta existente.3. Selecione o objeto SQL e altere a propriedade Origem de Dados para OpenPages DataSource. Esse

é o nome fornecido para o driver que se conecta ao seu banco de dados do IBM OpenPages withWatson.

Incluindo SQL no Objeto SQLÉ possível incluir código SQL em um objeto SQL.

É possível incluir seu código ao dar um clique duplo no objeto de SQL e colar o código SQL na caixa dediálogo SQL.

Clique no ícone Validar para assegurar que não haja erros em seu código SQL. Clique em OK paracontinuar.

Agora é possível selecionar o assunto de consulta a partir do explorador de consultas e ver que o objetode SQL aparece como um assunto de consulta com itens de consulta que podem ser selecionados.

Neste ponto, é possível concluir seu design de relatório utilizando a SQL customizada como base para seurelatório.

Colocando Variáveis De Volta na SQLApós a instrução SQL ser copiada para o objeto SQL, será necessário substituir os valores padrão dasfunções do banco de dados, segurança e prompts pelas variáveis e prompts corretos.

Incluindo PromptsUm prompt perguntará ao usuário um valor durante a execução de uma instrução SQL. Um prompt é umamacro no IBM Cognos que não pode ser executada pelas ferramentas de desenvolvimento SQL. É por issoque os prompts são incluídos após incluir a SQL no objeto SQL.

O exemplo a seguir mostra a sintaxe básica para o prompt:

prompt (Name, Data Type, Default Text)

As variáveis a seguir são usadas na macro de prompt:

NameEste é o nome do prompt. Isso também pode ser o mesmo nome que um parâmetro na página deprompt. Se utilizar o parâmetro como o nome do prompt, a página de prompt de relatório aparecerá.Isso é necessário.

Tipo de DadosEste é o tipo de dados retornado pelo prompt. Os valores incluem: número inteiro, data e sequência.Isso é necessário.

Texto PadrãoEste é o valor padrão do prompt. Isto é opcional.

Os exemplos a seguir mostram a sintaxe para usar prompts:


Prompt de sequência#prompt("bundle_name", "string")#

Prompt de número inteiro#prompt("resourceId", "integer", "1")#

Prompt de Data#prompt("Start Date", "date")#

Inclua prompts na SQL somente quando usar instruções SQL aninhadas. É sempre melhor colocar osprompts no relatório. Além disso, ao incluir o CQS no arquivo xml, deve-se incluir uma seção de promptna consulta.

Para obter mais informações sobre como usar prompts, veja a documentação do IBM Cognos FrameworkManager.

Concluindo Desenvolvimento de RelatórioNeste ponto, é possível concluir todo o desenvolvimento de relatório utilizando o objeto SQL como basepara seu relatório.

Você pode achar, conforme continua seu desenvolvimento de relatórios, que estão faltando campos ou épreciso aplicar funções de IBM OpenPages with Watson a alguns dos campos na consulta. É possíveleditar o objeto SQL e incluir estes itens ausentes, já que você ainda não converteu o relatório paraexecução com um Assunto de Consulta Customizada.

Criando uma Entrada no Arquivo CQSA geração de estrutura contém duas partes, a parte gerada dinamicamente e a parte customizada.

A parte dinâmica da estrutura é criada pelo gerador estrutura com base nos metadados de um usuário. Aparte customizada da estrutura está contida em dois arquivos: static-modelquerysubjects.xml ecustom-static-modelquerysubjects.xml. Eles contêm assuntos de consulta definidos pelousuário e os relacionamentos entre eles.

O arquivo static-modelquerysubjects.xml é usado pelo IBM OpenPages with Watson para definirassuntos de consulta customizada, incluindo auditoria, segurança, permissão de usuário, arquivodesassociado e arquivos retirados. Este arquivo é fornecido com cada instalação e será sobrescritodurante o processo de upgrade. Recomendamos não fazer nenhuma modificação neste arquivo.

O custom-static-modelquerysubjects.xml é o arquivo utilizado pelos clientes para incluir seuspróprios assuntos de consulta customizada. Este arquivo não é fornecido e não será sobrescrito durante oprocesso de upgrade. Este arquivo está localizado em seu servidor OpenPages with Watson na pastaCommandCenter|framework|conf da sua estrutura do IBM OpenPages.

A lista a seguir mostra os caminhos padrão:Usando o Legacy Model Framework em um sistema operacional Windows

C:\OpenPages\CommandCenter\framework\confUsando o V6 Framework em um sistema operacional Windows

C:\OpenPages\CommandCenter\framework\conf\mqsUsando o Legacy Model Framework em um sistema operacional AIX ou Linux

/opt/OpenPages/CommandCenter/framework/confUsando o V6 Framework em um sistema operacional AIX ou Linux

/opt/OpenPages/CommandCenter/framework/conf/mqs

O arquivo que contém o CQS é um arquivo XML. O melhor método a ser utilizado para incluir um assuntode consulta adicional é copiar um existente e substituir todos os dados. Ao editar o arquivo, deve-se tercuidado ao criar as tags de início e de encerramento corretamente.

O arquivo é construído das seguintes tags:


<MODELQUERYSUBJECTS>Esta é a tag mais distante do arquivo. Esta é uma coleção de definições de <MODELQUERYSUBECT>.

<MODELQUERYSUBJECT>Este é um assunto de consulta customizada individual.

<RELATIONSHIPS>Esse é o relacionamento entre dois assuntos de consulta.

<CALCULATIONS>Este é um cálculo customizado.

<PARAMETERMAPS>Este é um mapa do parâmetro definido pelo usuário.

As seções a seguir descreverão o uso adequado dos elementos de cada seção do arquivo XML.

Incluindo um Assunto de Consulta de ModelosO assunto de consulta de modelos é a definição da instrução SQL que você deseja incluir na estrutura.Isso contém a definição de onde deseja incluir a consulta, a consulta em si, as colunas na consulta e osprompts (se utilizados).

É recomendado colocar um comentário antes do assunto de consulta de modelos indicando o nome dorelatório no qual o CQS é utilizado e o autor de CQS.

As seções a seguir listam os elementos contidos em um assunto de consulta de modelos, os atributosdesses elementos, os elementos que eles contêm e os elementos nos quais eles estão contidos.

MODELQUERYSUBJECTS

Contém: MODELQUERYSUBJECT

Contido por: Nenhum.

MODELQUERYSUBJECT

Atributos:name

Nome do assunto de consulta customizada. Todos os nomes de assunto de consulta devem serexclusivos. Não é possível usar um hífen no nome de um assunto de consulta.

Obrigatório.

modelsO modelo de estrutura no qual incluir a consulta. Pode ser ALL ou uma lista separada por vírgula denomes de modelo de estrutura. Se esse campo for omitido, OPENPAGES_FRAMEWORK_V6 será usado.

Opcional.

namespacesO namespace no qual incluir a consulta. Pode ser ALL ou uma lista separada por vírgula denamespaces. Se este campo for omitido, DEFAULT será usado.

Opcional.

passthroughConfigure como true se a otimização do IBM Cognos for ignorada, false se a otimização do IBMCognos for aplicada.

Opcional.

folderA pasta que será criada/utilizada para armazenar o novo assunto de consulta customizada em cadanamespace definido. O local recomendado é: /MISCELLANEOUS/CUSTOM QUERY SUBJECTS


Opcional.

childId

Opcional.

parentId

Opcional.

Contém: <![CDATA[ SQL statement ]]>, COLUMNS, PROMPTS, KEYS

Contido por: MODEQUERYSUBJECTS.

<![CDATA[ SQL statement ]]>

Esta seção da XML contém a expressão SQL efetiva.

Atributos: Nenhum.

Contém: Nenhum.

Contido por: MODELQUERYSUBJECT

COLUNAS

Atributos: Nenhum.

Contém: coluna


coluna

Este elemento contém todas as colunas expostas da instrução SQL real.

Atributos:name

Todos os nomes de colunas devem aparecer em maiúsculas.

Obrigatório.

Contém: Nenhum.

Contido por: COLUMNS

PROMPTS

Atributos: Nenhum.

Contém: prompt


prompt

Atributos:name

O nome do prompt que aparece no assunto de consulta. Ele deve corresponder exatamente.


defaultvalueO valor padrão para o prompt.

Opcional.

Contém: Nenhum.

Contido por: PROMPTS

KEYS

Atributos: Nenhum.

Contém: Nenhum.


Exemplo MODELQUERYSUBJECT

<MODELQUERYSUBJECT name="Control_Owner_Assignment" passthrough="false" folder="/MISCELLANEOUS/CUSTOM QUERY SUBJECT"> <![CDATA[ SELECT RA.CHECKED_IN_BY as RA_OWNER, RA.NAME00 as RA_NAME, RI.CHECKED_IN_BY AS RI_OWNER, CN.CONTROL_ID as CN_CONTROL_ID, CN.NAME00 as CN_NAME, CN.DESCRIPTION as CN_DESCRIPTION, CN.CHECKED_IN_BY as CN_OWNER FROM RV_RISKASSESSMENT RA, RT__RISKASSESSMENT_RISK RA2RI, RV_RISK RI, RT__RISK_CONTROL RI2CN, RV_CONTROL CN WHERE RA.RISKASSESSMENT_ID = RA2RI.RISKASSESSMENT_ID AND RA.REPORTING_PERIOD_ID = RA2RI.REPORTING_PERIOD_ID AND RA2RI.RISK_ID = RI.RISK_ID AND RA2RI.REPORTING_PERIOD_ID = RI.REPORTING_PERIOD_ID AND RA2RI.IS_PRIMARY = 'Y' AND RA2RI.HIER_INSTANCE_ID = 1 AND RI.RISK_ID = RI2CN.RISK_ID AND RI.REPORTING_PERIOD_ID = RI2CN.REPORTING_PERIOD_ID AND RI2CN.CONTROL_ID = CN.CONTROL_ID AND RI2CN.REPORTING_PERIOD_ID = CN.REPORTING_PERIOD_ID AND RI2CN.IS_PRIMARY = 'Y' AND RI2CN.HIER_INSTANCE_ID = 1 AND RA.REPORTING_PERIOD_ID = #prompt("reportingperiodid", "integer")# AND RA.OP_FLAG_READ_ACCESS ='Y' AND RI.OP_FLAG_READ_ACCESS ='Y' AND CN.OP_FLAG_READ_ACCESS ='Y' ]]> <COLUMNS> <column name="RA_OWNER"/> <column name="RA_NAME"/> <column name="RI_OWNER"/> <column name="CN_NAME"/> <column name="CN_DESCRIPTION"/> <column name="CN_OWNER"/> </COLUMNS> <PROMPTS> <prompt name="reportingperiodid" defaultValue="-1"/> </PROMPTS></MODELQUERYSUBJECT>


Especificando RelacionamentosA seção de relacionamento é utilizada para criar junções entre assuntos de consulta customizada ouassuntos de consulta customizada e assuntos de consulta pré-definidas. Se estiver projetando umconjunto de consultas que estiverem relacionadas entre si, esse relacionamento precisará serespecificado. Esta parte do arquivo XML permite criar esses relacionamentos.

As seções a seguir listam os elementos de relacionamento, os atributos desses elementos, os elementosque eles contêm e os elementos nos quais eles estão contidos.

RELATIONSHIPS

Atributos:

Contém: relationship

Contido por: MODELQUERYSUBJECTS

relacionamento

Atributos:parent

O nome do assunto de consulta pai.

Obrigatório.

childO nome do assunto de consulta-filho.

Obrigatório.

pidO campo para juntar no pai.

Obrigatório.

cidO campo para juntar no filho.

Obrigatório.

innerjoinEsta é uma junção interna? Os valores são true ou false.

Opcional.

useReportingPeriodIdSe a junção deve ser feita no período de relatório. Os valores são true ou false.

Opcional.

one-to-n-left-outer-joinEsta é uma junção externa esquerda? Os valores são true ou false.

Opcional.

Contém: Nenhum.

Contido por: RELATIONSHIPS


Exemplo de RELATIONSHIPS

<RELATIONSHIPS> <relationship parent="RISKEVAL-BY-SOXRISK" child="RISK_RATINGS" pid="RE_RISKEVAL_ID" cid="RE_RISKEVAL_ID" useReportingPeriodId="true" one-to-n-left-outer-join="true"/>

<relationship parent="RISKEVAL-BY-SOXRISK" child="RISK_ALLOCATED" pid="RE_RISKEVAL_ID" cid="RE_RISKEVAL_ID" useReportingPeriodId="true" one-to-n-left-outer-join="true"/>

</RELATIONSHIPS>

Criando CálculosÉ possível criar cálculos customizados para fornecer aos autores do relatório valores calculados que elesutilizam regularmente. Cálculos podem usar itens de consulta, parâmetros, variáveis, membroscalculados, expressões e componentes da expressão, como funções.

As seções a seguir listam os elementos de cálculo, os atributos desses elementos, os elementos que elescontêm e os elementos nos quais eles estão contidos.

CALCULATIONS

Atributos:

Contém: calculation


Cálculo

Atributos:name

O nome do cálculo. Espaços não são permitidos.

Opcional.

namespaceO namespace no qual o objeto de cálculo deve ser criado.

Obrigatório.

folderO caminho de pasta no qual aninhar o objeto de cálculo. Como padrão, o cálculo é armazenado napasta de cálculos sob o objeto mais estritamente relacionado ao cálculo.

Opcional.

levelIsso é utilizado para ajudar a definir a ordem na qual os cálculos são criados. Um nível maior significaque ele será criado posteriormente com relação a outros cálculos.

Opcional.

Contém: expression

Contido por: CALCULATIONS


expression

Atributos: Nenhum.

Contém: <![CDATA[ expression ]]>

Contido por: calculation

<![CDATA[ expression ]]>

A expressão SQL. Ele é obrigatório.

Atributos: Nenhum.

Contém: Nenhum.

Contido por: expression

Exemplo de CALCULATIONS

<CALCULATIONS> <calculation name = "RISK_LOSS" namespace = "DEFAULT_REL" folder = "/GRC_OBJECTS/SOXRISK_FOLDER/COMPUTED FIELDS" level = "2"> <expression> <![CDATA[nvl(average([DEFAULT_REL].[SOXRISK]. [RI_INHERENT_SEVERIT_BA] for [DEFAULT_REL].[SOXRISK].[RI_RISK_ID]),0)]]> </expression> </calculation></CALCULATIONS>

Utilizando Mapas de Parâmetro para Criar Expressões no Tempo de ExecuçãoMapas de parâmetro são utilizados para criar substituições no tempo de execução.

Por exemplo, o valor de ID de uma Categoria de risco com o nome de Fraude pode ser diferente em seussistemas de produção e de teste. Ao invés de criar uma expressão com o ID numérico, crie a expressãocom o nome da variável e, ao utilizar o mapa do parâmetro, o valor do ID é preenchido no tempo deexecução.

As seções a seguir listam os elementos de mapa do parâmetro, os atributos desses elementos, oselementos que eles contêm e os elementos nos quais eles estão contidos.

PARAMETERMAPS

Atributos:

Contém: parametermap


parametermap

Atributos:name

O nome do mapa de parâmetros que deseja criar. Espaços não são permitidos.


Opcional.

Contém: param

Contido por: PARAMETERMAPS

param

Atributos:key

A chave que será substituída pelo valor.

Opcional.

valueO valor que será utilizado na expressão de mapa de parâmetro.

Opcional.

Contém: Nenhum.

Contido por: parametermap

Exemplo de PARAMETERMAPS

<PARAMETERMAPS> <parametermap name = "CUSTOM_RISK_CATEGORY"> <param key = "Internal Fraud" value = "2345"/> <param key = "External Fraud" value = "2346"/> <param key = "Employee Theft" value = "2347"/> </parametermap></PARAMETERMAPS>

Gerando novamente a estruturaÉ possível seguir os procedimentos no Guia do administrador do IBM OpenPages with Watson paraatualizar a estrutura. É possível escolher gerar todos os modelos de estrutura ou os selecionados. Seránecessário somente verificar os Assuntos de Consulta Customizada e as opções de Rótulos.

Os erros a seguir poder ser emitidos quando a estrutura é gerada:

• Você se esqueceu de incluir uma tag de coluna para cada campo na instrução SQL.• Você digitou incorretamente um dos atributos de MODELQUERYSUBJECT.• Está faltando uma tag de fechamento.• Você se esqueceu de definir uma tag de prompt para cada prompt no código SQL.• O número de instruções de coluna deve ser igual ao dos campos na instrução SQL.• Os nomes de coluna na instrução SQL não estão escritos da mesma forma que nas tags de coluna.• Os nomes de coluna devem estar na mesma ordem que as tags de coluna.• Não é possível usar um hífen ( - ) no nome do CQS.• O limite de caracteres para nomes de campo é de 30 caracteres (isso truncará o nome do campo).

O detalhe das mensagens de erro pode ser localizado no arquivo script-player-error.loglocalizado em seu servidor de relatório em C:\OpenPages\CommandCenter\framework\logs


Se um erro de análise for detectado no arquivo, o erro será listado no arquivo framework-generator.log no mesmo diretório.

Nota: O AIX, o Linux e o Windows possuem locais padrão diferentes.

Substituindo Referências de Objeto SQL por Referências CQSVocê deve remover as referências ao objeto SQL no relatório e substituí-las pelas referências do novoassunto de consulta customizada.

É possível fazer isso um campo por vez abrindo cada variável no relatório e mudando as referências doobjeto [SQL<N>] para o nome do novo CQS [<CQS Name>].

Também é possível salvar o relatório em um arquivo de texto, fazer uma procura global e substituir no[SQL<N>] por [<CQS Name>] no arquivo.

Em seguida, é necessário excluir todos os objetos SQL que criados porque eles não estão sendoutilizados.

Editando o arquivo de texto de relatórioÉ possível editar o arquivo de texto para substituir o conteúdo do relatório que deve ser atualizado.

Sobre Esta Tarefa

É possível salvar o relatório em um arquivo de texto e fazer uma procura global e substituir [SQL<N>] por[<CQS Name>] no arquivo. Em seguida, recarregue o arquivo e valide-o para assegurar que suas ediçõesestavam corretas.

Procedimento

1. Para copiar o relatório para a área de transferência, clique em Ferramentas > Copiar Relatório paraÁrea de Transferência.

2. Abra um editor de texto e cole a área de transferência no documento.3. Procure em [SQL<N>] e substitua-o por [<CQS Name>].4. Salve o arquivo.5. Selecione o arquivo inteiro.6. Copie o relatório para a área de transferência.7. Salve o relatório existente.8. Abra um novo relatório em branco.9. Clique em Ferramentas > Abrir Relatório a partir da Área de Transferência para restaurar o

relatório a partir da área de transferência.10. Teste se o relatório funciona.11. Salve o relatório.

Removendo um objeto SQLÉ possível excluir todos os objetos SQL que criados, se eles não estão sendo utilizados.

Procedimento

1. No seu relatório, abra o Explorador de Consultas e selecione Consultas.2. Selecione o Objeto SQL que deseja remover.3. Clique no ícone Excluir na barra de ferramentas.

4. Clique no ícone Validar . Se você fez a substituição correta, o relatório ainda deverá validar.



Apêndice A. Diretrizes de Codificação de SQLEste tópico descreve algumas informações gerais a serem seguidas ao trabalhar com instruções SQL noarquivo de assunto de consulta customizada.

Diretrizes gerais

Use as diretrizes a seguir com instruções SQL no arquivo de assunto de consulta customizada.

• Todas as indentações devem ser salvas como espaços e não tabulações.• A indentação deve consistir em três espaços.• Cada instrução aninhada deve iniciar com um novo nível de indentação.• Todas as palavras reservadas do banco de dados estarão em maiúsculas.• O comprimento das linhas não deve exceder 80 caracteres.• Os comentários devem ser utilizados na SQL para descrever a funcionalidade. Os comentários devem

estar no formato /* <text> */.• Filtros e agrupamento não devem ser colocados no CQS, a menos que seja realmente necessário. Eles

devem ser executados no relatório.• Use UNION ALL em vez de UNION porque UNION ALL é muito mais rápido. UNION removerá todas as

linhas duplicadas, mas UNION ALL não removerá. Linhas duplicadas podem ser removidas no relatórioao utilizar a propriedade Grupo Automático e Resumo.

• Você utilizará as visualizações RV_ ao invés das tabelas RT_ porque as visualizações possuemsegurança do usuário integrada nelas.

Convenções de nomenclaturaOs mnemônicos listados neste tópico serão utilizados como nomes da tabela e como prefixos para nomesde colunas.

O Prefixo de Tabela Alternativo é utilizado quando o campo Prefixo de Campo/Tabela é uma palavrareservada do banco de dados.

Tabela 71. Convenções de nomenclatura

Nome de objeto Rótulo do Objeto Prefixo do Objeto Alt. Prefix

Asserção Asserção AO

Atestado Atestado AN

AuditableEntity Entidade Passível deAuditoria

AE

Auditor Auditor AD

AuditPhase Seção Auditoria AH

AuditProgram Auditoria AU

Iniciativa Iniciativa CP

CostCenter Centro de Custo Cc

CtlEval Avaliação de Controle CV

Funcionário Funcionário EE

Localização Localização FD

Tabela 71. Convenções de nomenclatura (continuação)


Incidente Incidente IN INC

KeyPerfIndicator KPI KP

KeyPerfIndicatorValue Valor KPI KY

KeyRiskIndicator KRI KR

KeyRiskIndicatorValue valor de KRI KE

LossEvent Evento de perda LE

LossImpact Impacto de Perda LO

LossRecovery Recuperação de Perda LR

Obrigatório Obrigatório MD

ORXLoss Perda de ORX OL

Plan Plan PN

Diretiva Diretiva PL

PolicyReviewComment Comentário de Revisão dePolítica

RP

Preferência Preferência PF

PrefGrp Grupo de Preferência PG

Procedimento Procedimento PC

ProjectActionItem Item de Ação do Marco PA

Qsection Seção QE

Quest Questão QF

Questionário Questionário QD

RAEval Exame de Avaliação de Risco AV

RegApp Aplicabilidade deRegulamento

RB

RegChange Mudança Regulatória RD

RegInt Interação com Regulador RF

RegTask Tarefa Regulatória RT

Regulador Regulador RE

Exigência Exigência RQ

Recurso Recurso RU

ResourceLink Link para Recurso RL

ReviewComment Comentário de Revisão deAuditoria

RC

RICat Categoria de RI RH

RIReq Solicitação de RI RR


Tabela 71. Convenções de nomenclatura (continuação)


RiskAssessment Avaliação de Risco RA

RiskEntity Plano de Controle RN

RiskEval Avaliação de Risco RV

RiskSubEntity Determinação de DadosComparativos

RS

ScenarioAnalysis Análise do Cenário BS

SOXAccount Conta AC

SOXBusEntity Entidade de Negócios PT_BR

SOXControl Controle CN

SOXControlObjective Objetivo de Controle CO

SOXDocument Arquivo FI

SOXExternalDocument Efetuar o Link LI

SOXIssue Issue IS ISU

SOXMilestone Etapa MI

SOXProcess Processo PR

SOXProject --- OC

SOXRisk Risco RI

SOXSignature Assinatura SI

SOXSubaccount Subconta SU

SOXSubprocess Subprocesso SB

SOXTask Item de Ação AT ATI

SOXTest ~Refazer\tCtrl+Y TE

SOXTestResult Resultado do Teste TR

Submandate Submandato SM

Planilha de Hora Planilha de Hora TI

Isenção Isenção WV

Documento de Trabalho Documento de Trabalho WP

Cláusula SELECTUtilize as seguintes diretrizes ao utilizar cláusulas SELECT.

• Coloque cada campo na cláusula SELECT em uma linha separada.• Não use instruções curingas na cláusula SELECT. Por exemplo,

SELECT * from RV_ENTITY

selecionará todos os campos da visualização da entidade, mas será lento.

Apêndice A. Diretrizes de Codificação de SQL 225

• Os valores de campo SELECT sempre utilizam aliases:

PR.NAME00 as PR_NAME

• Todas as variáveis de relatório serão prefixadas com o nome do objeto. Por exemplo, Nome do Processoaparecerá no relatório como PR_NAME. O Tabela 71 na página 223 contém os prefixos e alternativasaceitáveis quando o prefixo é uma palavra reservada do banco de dados.

• Se o CQS tiver que se unir a outros Assuntos de Consulta, uma das colunas deverá se chamarREPORTING_PERIOD_ID. Ela não pode ter um prefixo.

• Sempre inclua colunas chave (resource_id, REPORTING_PERIOD_ID) de cada uma das tabelas do tipode objeto (RV_) como um campo na cláusula SELECT. O desempenho não é prejudicado e são úteis parafiltragem do relatório.

• Sempre inclua as colunas IS_PRIMARY e DISTANCE a partir de cada uma das tabelas de ponte (RT_) nacláusula SELECT. O desempenho não é prejudicado e é útil para filtragem do relatório.

• Use subseleções SQL para converter sequências enumeradas de valor único em conversões de nome dousuário. Por exemplo, utilize o seguinte para obter um valor de status do problema:

(SELECT EV.LCLTXT_NAME FROM I18N_INT_ENUM_VALS EV WHERE EV.ENUM_VAL_ID = ISS.STATUS AND EV.I18N_LOCALE_ID = #$account.parameters.openPagesLocaleId# ) AS IS_STATUSUse the following to obtain the first and last names from a userId: (SELECT UI.FIRSTNAME||' '||UI.LASTNAME FROM ACTORINFO ACI, USERINFO UI WHERE PR.ITRM_RISK_MGR = ACI.NAME AND ACI.ACTORID = UI.ACTORID ) AS PR_RISK_MANAGER_NAME

• Utilize a função de banco de dados CONVERT_EVIDLIST_TO_NAME do IBM OpenPages with Watsonpara converter sequências enumeradas com diversos valores em listas.

Cláusula FROMUtilize as seguintes diretrizes ao utilizar cláusulas FROM.

• Coloque cada tabela em uma cláusula FROM em sua própria linha.• Liste as tabelas na cláusula FROM na ordem em que elas serão acessadas.• Os nomes da tabela também terão um alias atribuído com mnemônicos do Tabela 71 na página 223.

Por exemplo, visualização RV_PROCESS será:

RV_PROCESS como PR

a visualização Incidente será

RV_INCIDENT como INC• As tabelas de Ponte serão nomeadas com os objetos de origem e de destino, por exemplo, Entidade de

Negócios para Processo, EN2PR.

Cláusula WHEREUtilize as seguintes diretrizes ao usar cláusulas WHERE.

• Utilize o formato ANSI-92 de junção:


EV.REPORTING_PERIOD_ID (+)= EN.REPORTING_PERIOD_ID

para uma junção externa esquerda. Isso melhora a capacidade de leitura da SQL.• Deve-se utilizar colunas indexadas em junções ou durante a filtragem. Isso gera um desempenho maior

da SQL.• Cada junção deve ser uma junção INNER, se possível. Nunca use CROSS JOIN, apenas INNER e OUTER.• Além disso, evite a procura com operadores de não igual (<> e NOT), pois eles resultam em varreduras

de tabela e índice.• Evite caracteres curinga no início de uma procura em uma coluna indexada utilizando a palavra-chave

LIKE. Isso resulta em uma varredura de índice lenta. O primeiro exemplo resulta em uma varredura deíndice, ao passo que o segundo exemplo resulta em uma procura de índice:

SELECT entity_id FROM rv_entity as EN WHERE en.full_path LIKE ' %Financial Services''%Financial Services’ AND EN.RA.OP_FLAG_READ_ACCESS ='Y'SELECT entity_id FROM rv_entity as EN WHERE en.full_path LIKE '/%Financial Services'’/%Financial Services’ AND EN.RA.OP_FLAG_READ_ACCESS ='Y'

• As junções típicas serão feitas pelo ID do recurso (ID do objeto) e pelo ID do período de relatório.Ambas são campos indexados.

• Utilize o HEIR_INSTANCE_ID = 1 somente em uma junção quando estiver unindo para e a partir de umatabela de ponte. Essas junções utilizarão <parent>_ID, <child>_ID e REPORTING_PERIOD_ID eforçarão o uso do índice do sistema nesta tabela.

• Se estiver utilizando o campo IS_PRIMARY, não utilize o campo HEIR_INSTANCE_ID.

Cláusula ORDER BYUtilize a seguinte diretriz ao utilizar as cláusulas ORDER BY.

• Não utilize os números de coluna na cláusula ORDER BY, utilize apenas nomes de colunas.

Apêndice A. Diretrizes de Codificação de SQL 227


Apêndice B. Definições de NamespaceEste apêndice contém as definições de todos os namespaces prontos para uso do IBM OpenPages withWatson na data da liberação deste documento. Dependendo da configuração do sistema e quais soluçõesestão sendo usadas, nem todos esses namespaces estarão disponíveis.

Estes namespaces foram utilizados para suportar relatórios prontos para uso que foram fornecidos com osistema. Os namespaces podem ser reutilizados para requisitos de relatórios adicionais e editados deacordo com as suas necessidades. Lembre-se de que se você editar um namespace ao excluir ou alterar orelacionamento entre os objetos, os relatórios prontos para uso poderão não mais funcionar.

A definição mais precisa de seus namespaces pode ser localizada nas configurações de registro para seusistema. Clique em Administração > Configurações e acesse a pasta OpenPages | Platform | ReportingFramework V6 | Models | OPENPAGES_FRAMEWORK_V6 | Namespaces para visualizar as definiçõesde namespace do sistema.

A lista a seguir exibe os namespaces prontos para utilização.

AUD1Namespace de auditoria 1.

AUD2Namespace de auditoria 2.

DEFAULTO namespace padrão usado por todas as soluções.

ITG1Namespace de Controle de TI 1.

ITG2Namespace de Controle de TI 2.

MAND1Namespace de Mandato 1.

MAND2Namespace de Mandato 2.

ORM1Namespace de Operational Risk Management 1.



POL1Namespace de Política 1.

RA1Namespace de Avaliação de risco 1.

RA2Namespace de Avaliação de risco 2.

REGAPP1Namespace de Aplicabilidade de regulamentação 1.

AUD1

Figura 113. Namespace de Auditoria 1


AUD2

Figura 114. Namespace de Auditoria 2

Apêndice B. Definições de Namespace 231

DEFAULT

Figura 115. Namespace Padrão

ITG1

Figura 116. Namespace de Controle de TI 1


ITG2

Figura 117. Namespace de Controle de TI 2


MAND1

Figura 118. Namespace de Mandato 1


MAND2

Figura 119. Namespace de Mandato 2


ORM1

Figura 120. Namespace de Gerenciamento de Risco Operacional 1

ORM2



ORM3


POL1

Figura 123. Namespace de Política 1

RA1

Figura 124. Namespace de Avaliação de Risco 1

Nota: O objeto de Avaliação de Risco é desativado por padrão e pode precisar ser ativado, dependendodos requisitos do sistema.


RA2

Figura 125. Namespace de Avaliação de Risco 2

Nota: O objeto de Avaliação de Risco é desativado por padrão e pode precisar ser ativado, dependendodos requisitos do sistema.


REGAPP1

Figura 126. Namespace de Aplicabilidade de Regulamento 1



Apêndice C. Limitações e Soluções AlternativasEste apêndice lista os problemas e as limitações conhecidos que os autores do relatório podem encontrarao criar relatórios e quaisquer soluções alternativas possíveis.

Limitação de Comprimento de EquaçãoHá uma limitação no tamanho do valor de atributo de cálculo que pode ser armazenado pelo aplicativoIBM OpenPages with Watson.

O atributo principal em questão é Equação, em que uma equação complexa pode ser muito longa. Há umlimite de 20.000 bytes no tamanho do texto inserido. Observe que o OpenPages with Watson suportacaracteres multibytes e, portanto, isso poderá não ser o equivalente a 20.000 caracteres se estiverutilizando um idioma multibyte.

Solução

É possível criar seu cálculo no arquivo CQS.

Problemas de Exibição de LocalizaçãoSe estiver projetando relatórios para uso com diversos idiomas, você pode, às vezes, encontrarproblemas de formato.

Se estiver projetando relatórios para uso com diversos idiomas, ocasionalmente podem ocorrerproblemas de formato como o seguinte:

• Uma barra de rolagem horizontal pode ser exibida na janela do relatório. Por exemplo, todos osrelatórios fornecidos no IBM OpenPages with Watson são projetados para exibir dados gerados em umtamanho da janela do conjunto. Quando alguns desses relatórios são localizados em outros idiomas,como o alemão ou francês, a largura da página aumenta e uma barra de rolagem horizontal aparece.

Solução

As sugestões de solução alternativa a seguir podem corrigir o problema de rolagem horizontal:

• Configure o recurso no IBM Cognos Analytics - Reporting para permitir quebras automáticas depalavras.

• Quebre manualmente uma palavra longa em partes menores utilizando, por exemplo, hífen e caracteresde espaço (a palavra será quebra após o espaço). Pode ser necessário tentar quebrar manualmente apalavra para que ela seja exibida corretamente dentro da coluna.

Erro ao agrupar campos de sequência grandesSe agrupar um campo de sequência grande com um comprimento não especificado, seja de modoimplícito ou explícito, o agrupamento resultará em um erro de coluna não indexada.

Dependendo de seu relatório, você poderá ver um erro semelhante ao texto a seguir: Using a blobcolumn in this query requires that the query subject [TABLES].[PROPERTYVALS_CLOB] must have either a key or a unique index.

Um exemplo de um agrupamento explícito é configurar a propriedade de consulta Agrupamentoautomático e resumo para Sim para uma consulta que inclui um campo de sequência grande. Umexemplo de um agrupamento implícito é incluir um agrupamento em um campo de sequência grande emum relatório de lista.

Solução

Se desejar agrupar um campo de sequência grande, deve-se primeiro convertê-lo em um tipo de dadosde caractere com um comprimento máximo suportado por seu banco de dados, por exemplo:

cast ([MAND1_REL].[REQUIREMENT].[RQ_SUPPORTING_REQUIREMENT], varchar (4000))

RQP-DEF-0162 Erro de cardinalidade ilegal ao executar um relatórioAo abrir um relatório, você obtém o erro a seguir: RQP-DEF-0162 Illegal cardinality cardTwo.

O erro pode ocorrer quando uma palavra reservada, tal como um nome do tipo de objeto, é usado nonome de um campo de sequência enumerada.

Para evitar esse erro, não use palavras reservadas ao criar campos de sequência enumerada.

Solução

Use uma ferramenta SQL, como SQL*Plus ou CLPPlus, para renomear o campo e limpar a tabelaRPS_PRESET_COLS.

Por exemplo:

UPDATE rps_obj_col_presetsSET column_name = 'keyriskindicatr'WHERE column_name = 'keyriskindicator'AND property_def_id = SELECT propertydefid FROM propertydefs WHERE enumtypeid = (SELECT enumtypeid FROM enumtypes WHERE upper(name) LIKE ‘KEYRISKINDICATOR’ ) );COMMIT;


Avisos

Estas informações foram desenvolvidas para produtos e serviços oferecidos nos Estados

É possível que a IBM não ofereça os produtos, serviços ou recursos discutidos nesta publicação emoutros países. Consulte um representante IBM local para obter informações sobre produtos e serviçosatualmente disponíveis em sua área. Qualquer referência a um produto, programa ou serviço IBM nãosignifica que apenas produtos, programas ou serviços IBM possam ser utilizados. Qualquer produto,programa ou serviço funcionalmente equivalente, que não infrinja nenhum direito de propriedadeintelectual da IBM poderá ser utilizado em substituição. Entretanto, a avaliação e verificação da operaçãode qualquer produto, programa ou serviço não IBM são de responsabilidade do Cliente. Este documentopode descrever produtos, serviços ou recursos que não estão incluídos no Programa ou autorização delicença adquirido pelo Cliente.

A IBM pode ter patentes ou solicitações de patentes pendentes relativas a assuntos tratados nestapublicação. O fornecimento deste documento não concede ao Cliente nenhuma licença a essas patentes.É possível enviar consultas sobre licenças, por escrito, para:

Gerência de Relações Comerciais e Industriais da IBM BrasilAv. Pasteur, 138-146BotafogoRio de Janeiro, RJCEP 22290-240

Para pedidos de licença relacionados a informações sobre DBCS (Conjunto de Caracteres de Byte Duplo),entre em contato com o Departamento de Propriedade Intelectual IBM em seu país ou envie pedidos delicença, por escrito, para:

Intellectual Property LicensingLegal and Intellectual Property LawIBM Japan Ltd.19-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ão estejam de acordo com alegislação local: A INTERNATIONAL BUSINESS MACHINES CORPORATION FORNECE ESTA PUBLICAÇÃO"NO ESTADO EM QUE SE ENCONTRA", SEM AS GARANTIAS IMPLÍCITAS DE NÃO-INFRAÇÃO,COMERCIALIZAÇÃO OU ADEQUAÇÃO A UM DETERMINADO PROPÓSITO. Alguns países não permitem arenúncia de responsabilidade de garantias expressas ou implícitas em certas transações; portanto, essainstrução pode não se aplicar ao cliente.

Estas informações podem conter imprecisões técnicas ou erros tipográficos. Periodicamente, são feitasalterações nas informações aqui contidas; tais alterações serão incorporadas em futuras edições destapublicação. A IBM pode fazer melhorias e/ou alterações no(s) produto(s) e/ou no(s) programa(s)descrito(s) nesta publicação a qualquer momento sem aviso.

Referências nestas informações a websites não IBM são fornecidas apenas por conveniência e nãorepresentam de forma alguma um endosso a esses websites. Os materiais nesses websites não fazemparte dos materiais desse produto IBM e o uso desses websites é de inteira responsabilidade do Cliente.

A IBM pode utilizar ou distribuir as informações fornecidas da forma que julgar apropriada sem incorrerem qualquer obrigação para com o Cliente.

Licenciados deste programa que desejam obter informações sobre este assunto com objetivo de permitir:(i) a troca de informações entre programas criados independentemente e outros programas (incluindoeste) e (ii) a utilização mútua das informações trocadas, devem entrar em contato com:

Gerência de Relações Comerciais e Industriais da IBM Brasil Av. Pasteur, 138-146

Botafogo Rio de Janeiro, RJ CEP 22290-240

Tais informações podem estar disponíveis, sujeitas a termos e condições apropriados, incluindo, emalguns casos, o pagamento de uma taxa.

O programa licenciado descrito nesta publicação e todo o material licenciado disponível são fornecidospela IBM sob os termos do IBM Customer Agreement, Contrato de Licença do Programa InternacionalIBM ou de qualquer outro contrato equivalente.

Todos os dados de desempenho aqui contidos foram determinados em um ambiente controlado.Portanto, os resultados obtidos em outros ambientes operacionais poderão variar significativamente.Algumas medidas podem ter sido tomadas em sistemas em nível de desenvolvimento e não há garantiade que estas medidas serão as mesmas nos sistemas geralmente disponíveis. Além disso, algumasmedidas podem ter sido estimadas por dedução. Resultados reais podem variar. Os usuários destedocumento devem verificar os dados aplicáveis para seus ambientes específicos.

As informações sobre produtos não IBM foram obtidas junto aos fornecedores dos respectivos produtos,de seus anúncios publicados ou de outras fontes disponíveis publicamente. A IBM não testou essesprodutos e não pode confirmar a precisão do desempenho, da compatibilidade ou de outras afirmaçõesrelacionadas aos produtos não IBM. Perguntas sobre os recursos de produtos não IBM devem serendereçadas aos fornecedores desses produtos.

Todas as instruções relativas à orientação ou intenção futura da IBM estão sujeitas a alterações ouretiradas sem aviso prévio e representam apenas metas e objetivos.

Estas informações contêm exemplos de dados e relatórios utilizados em operações comerciais diárias.Para ilustrá-los da forma mais completa possível, os exemplos incluem nomes de indivíduos, empresas,marcas e produtos. Todos esses nomes são fictícios e qualquer semelhança com nomes e endereçosusados por uma empresa real é totalmente coincidência.

Se você estiver visualizando este formato eletrônico de informações, as fotografias e as ilustraçõescoloridas poderão não aparecer.

Esta Oferta de Software não usa cookies ou outras tecnologias para coletar informações pessoais.

Copyright

Licensed Materials - Property of IBM Corporation.© Copyright IBM Corporation, 2003, 2019.

Direitos Restritos aos Usuários do Governo dos EUA - Uso, duplicação ou divulgação restritos pelodocumento GSA ADP Schedule Contract com a IBM Corp.

Estas informações contêm programas de aplicativos de amostra na linguagem fonte, ilustrando astécnicas de programação em diversas plataformas operacionais. O usuário pode copiar, modificar edistribuir essas amostras de programas de qualquer forma gratuitamente, para finalidades dedesenvolvimento, uso, comercialização ou distribuição de programas aplicativos compatíveis com ainterface de programação de aplicativos da plataforma operacional para a qual as amostras de programasforam gravadas.

Esses exemplos não foram totalmente testados sob todas as condições. Por essa razão, a IBM não podegarantir ou implicar em confiabilidade, capacidade de manutenção ou funcionamento desses programas.O Cliente pode copiar, modificar e distribuir estes programas de amostra de qualquer maneira sempagamento à IBM, com objetivos de desenvolvimento, utilização, marketing ou distribuição de programasaplicativos em conformidade com interfaces de programação de aplicativos da IBM.

Marcas comerciais

244 Avisos

IBM, o logotipo IBM e ibm.com são marcas comerciais ou marcas registradas da International BusinessMachines Corp., registradas em diversas jurisdições no mundo todo.

Os termos a seguir são marcas comerciais ou marcas registradas de outras empresas:

• Microsoft, Windows, Windows NT, e Windows logo são marcas registradas da Microsoft Corporation nosEstados Unidos e/ou em outros países.

• Linux é uma marca registrada de Linus Torvalds nos Estados Unidos e/ou em outros países.• Java e todas as marcas registradas e logotipos baseados em Java são marcas ou marcas registradas da

Oracle e/ou suas afiliadas.

Outros nomes de produtos e serviços podem ser marcas registradas da IBM ou de outras empresas. Umalista atual de marcas comerciais da IBM está disponível na web em " Copyright and trademarkinformation " em www.ibm.com/legal/copytrade.shtml.

Avisos 245

http://www.ibm.com/legal/copytrade.shtml

http://www.ibm.com/legal/copytrade.shtml


Índice Remissivo

Caracteres Especiaisícones de estrutura de relatório xiv

Aagregação 69agrupar dados 66, 67assunto de consulta customizada 213assuntos de consulta customizada

arquivo de texto do relatório 221assunto de consulta de modelos 214cálculos 218concluindo o desenvolvimento de relatório 213criando o relatório 211criando uma entrada de arquivo CQS 213design de relatório 209diagrama de ER 209especificando relacionamentos 217funções de banco de dados 210gerando novamente a estrutura 220Instrução SQL 210mapas de parâmetros 219objeto SQL 212Prompts. 212referências CQS 221remover objeto SQL 221substituindo variáveis 211testando 211

autoria de relatórioconfiguração 191construções de assunto de consulta 195definições de configuração 191formatando tabelas e listas vazias 195modelos 193organização do assunto de consulta 194SQL subjacente 193

Ccabeçalho do grupo 67campos computados

limitações 199Campos computados

arquivo de dados 201campos obrigatórios 200considerações sobre design 199criando 200diversos namespaces 202

classificarcom base no prompt 64customizada 63

códigos de idiomaestrutura de relatório 18

conversão de dados 137CrossTrack 83culturas 41

currencyestrutura de pasta 49usar 47, 48, 50

Ddados

aplicativo 140estático 137

dados da instância 140dados dimensionais

filtrar com base em prompts 93dados do aplicativo

definições de campo para enumerações com diversosvalores 142definições de campo para sequências enumeradas comvalor único 140estrutura de pasta para enumerações com diversosvalores 141estrutura de pasta para sequências enumeradas devalor único 140sequência enumerada com diversos valores 141sequência enumerada com valor único 140traduzindo campos de data 144traduzindo campos de moeda 145, 146

dados estáticostraduzindo dados de rótulo dinâmicos 137traduzindo dados do campo de texto fixo 138traduzindo nos prompts 139traduzindo texto do botão 139

de instância (NR=..)a partir de SQL 59a partir do período de relatório 52

definições de namespaceAUD1 230AUD2 231DEFAULT 232ITG1 232ITG2 233MAND1 234MAND2 235ORM1 236ORM2 236ORM3 237POL1 237RA1 237RA2 238REGAPP1 239

design da tabela de relatório 2destacar dados 73diretrizes de codificação SQL

Cláusula FROM 226Cláusula ONDE 226cláusula ORDER BY 227Cláusula SELECT 225naming conventions 223

Índice Remissivo 247

Eentidade

multinível 116entidades de negócios

assunto de consulta SOXBUSENTITY_GPC 115campos de contexto de entidade dimensional 124campos de contexto de entidade relacional 118dimensão do tipo de objeto GPC 116drill down/drill up 126exibindo dados 122filtragem de dados 122filtragem de profundidade de hierarquia 119filtrando entidades de negócios dimensionais 123filtrando entidades de negócios relacionais 117filtrando utilizando o caminho completo 117filtrando utilizando prompts em cascata 119hierarquia de entidade definida pelo usuário 115modelo de dados de GPC 116modelo dimensional 125níveis 116objetos do componente GPC 116prompts dimensionais 126relatório sobre 116

espaço de nomesdefinição 16visão geral 16

Estrutura de RelatórioAssuntos de Consulta GPC (Modelo Relacional) 24Itens de Consulta de Campos de Enumeração (ModeloRelacional) 26Namespace Padrão 17naming conventions 17pacote 16Pasta Avançado (Modelo Relacional) 31Pasta Campos Computados (Modelo Relacional) 20Pasta de Dimensões de Tipo de Objeto (ModeloDimensional) 36Pasta de Objeto (Modelo Relacional) 25Pasta de Objeto Primário (Modelo Dimensional) 34Pasta de Período de Relatório (Modelo Relacional) 30pasta Diversos (Modelo Relacional) 28Pasta Enumerações (Modelo Relacional) 21Pasta Moedas (Modelo Relacional) 30Pasta Objetos GRC (Modelo Dimensional) 33Pasta Objetos GRC (Modelo Relacional) 23Pasta Objetos GRC Independentes (Modelo Relacional)27Pasta Objetos Independentes GRC (ModeloDimensional) 35Pasta Segurança (Modelo Relacional) 31Pasta SOXBusEntity (Modelo Dimensional) 33Pasta SOXBusEntity (Modelo Relacional) 23Pasta Trilha de Auditoria (Modelo Relacional) 18Pastas de Nível Superior do Modelo Dimensional 32Pastas de Nível Superior do Modelo Relacional 18Pastas de Objeto (Modelo Dimensional) 35Pastas de Objeto Secundário (Modelo Relacional) 27Sequências Enumeradas (Modelo Relacional) 22visão geral 15

extensão de nível 68

Ffiltro

com base em prompts 50ID do período de relatório 66, 98Período de Geração de Relatórios 66, 98

filtro parametrizadoprompt de data 56, 97

filtros de sequência enumerada traduzidamapas de parâmetros 147

formatação condicional 72, 73formatando relatórios

configurando para saída PDF 187prompts sequenciais para a saída em PDF 187saída CSV 188saída do Microsoft Excel 188saída PDF 188

fragmentos de relatórioaltura e largura 207caminho de relatório 206campos de configuração 205criando 203ligações 204links de crosstrack 204nome do fragmento 206prompts de objeto 206

funções do banco de dados predefinidasacumulando enumerações com diversos valores 175atributos de um objeto pai principal 168, 172caminho da árvore 175campo do sistema 181, 183–185dependente do horário 177enumerações de valor único em nomes 155enumerações multivalor em nomes 153formatação de moeda 161gerais 152ID do tipo de objeto 149nome de exibição do agente 162nome de exibição do agente por ID do agente 164nomes de colunas da tabela Oracle 152nomes de exibição do agente 165nomes de tabela de banco de dados 151nomes de tabela RT 152ocorrências de texto 156relacionamento entre os objetos 156, 158, 160relatório para obter os IDs de objeto 150sequência de chaves externa localizada 167SQL para obter os IDs de objeto 149taxa de câmbio 174transmitindo parâmetros 149valor do campo customizado 177, 179

Gglobalização 41

Iidiomas 41internacionalização 137


Llimitações 241localização 137

Mmapa do parâmetro 65, 147mapas de parâmetros

filtros de sequência enumerada traduzida 147modelo de dados da estrutura

modelo de dados dimensionais 8, 9modelo de dados relacionais 7, 8

modelo de dados dimensionais 8, 9modelo de dados do aplicativo 1modelo de dados relacionais 7, 8modelo de objeto

características 11relacionamentos 11Terminologia 11

modelos de banco de dadosdesign da tabela de relatório 2modelo de dados do aplicativo 1tabela de relacionamento 5tabelas de enumeração 4tabelas de objeto 3visualizações de objeto 4

Nnamespace padrão 17

Oobjetos recursivos

triângulos relatório 135OPENPAGES _REPORTS 16

Ppastas

Nível superior 18performance

excluir entidades de negócios de nível superior 37ignorar índice 37

período de relatóriode instância (NR=..) 52filtrar no ID 98

promptdate 56, 97em cascata 58intervalo de data 57opções estáticas 57

prompt de data 56, 97prompt de intervalo de data 57

Rrelatório de gráfico

contando o número de objetos 133

Ssequência enumerada

considerações sobre desempenho 37mapa do parâmetro 147

soluções alternativas 241

Ttabela de relacionamento 5tabela PROPERTY.AUDIT.TRAIL

decriptografar valores de propriedade 210tabelas de enumeração 4tabelas de objeto 3tipo de objeto primário 11tipos de objeto

principal 11secondary 11

tipos de objeto secundários 11triângulos relatório

objetos recursivos 135

Vvariáveis de idiomas 138visualizações de objeto 4

Índice Remissivo 249


IBM®

Documents

Guia do autor do relatóriopublic.dhe.ibm.com/software/data/cognos/...Nota Antes de usar estas informações e o produto suportado por elas, leia as informações em “Avisos” na