Cognos Cube

IBM Cognos TM1
Verso 10.1.0
Guia para Desenvolvedores
Nota
Antes de usar estas informaes e o produto suportado por elas, leia as informaes em Avisos na pgina 205.
Informaes do Produto
Este documento se aplica ao IBM Cognos TM1 Verso 10.1.0 e tambm pode se aplicar aos releases subsequentes.
Para procurar novas verses do documento, visite os Centros de Informaes do IBM Cognos (http://
publib.boulder.ibm.com/infocenter/cogic/v1r0m0/index.jsp).
Capturas de tela dos produtos Microsoft usadas com permisso da Microsoft.
Materiais Licenciados - Propriedade da IBM
Copyright IBM Corporation 2007, 2012.
ndice
Introduo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix
Captulo 1. Introduo ao TM1 Development . . . . . . . . . . . . . . . . . . . . 1
Entendendo a Multidimensionalidade . . . . . . . .
Cubo Durables . . . . . . . . . . . . . .
Sua Funo como Desenvolvedor . . . . . . . . .
Compreendendo as Convenes de Nomenclatura de Objeto
Caracteres Reservados . . . . . . . . . . . .
Instrues de Regras. . . . . . . . . . . . .
Excees de Nomenclatura de Objeto . . . . . . .
.
.
.
do
.
.
.
. .
. .
. .
TM1
. .
. .
. .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
1
1
3
3
3
4
4
Captulo 2. Criando Cubos e Dimenses . . . . . . . . . . . . . . . . . . . . . . 7

Projetando Cubos . . . . . . . . . . . . . . . . . .
Selecionando o Nmero de Dimenses . . . . . . . . .
Consolidando Detalhe Usando Hierarquias da Dimenso . . .
Tipos de Elementos . . . . . . . . . . . . . . . .
Atributos de Elementos . . . . . . . . . . . . . .
Projetando Cubos - Resumo . . . . . . . . . . . . .
Criando Dimenses. . . . . . . . . . . . . . . . .
Criando Dimenses Usando a Janela Editor de Dimenso . . .
Modificando uma Dimenso. . . . . . . . . . . . .
Gerenciando a Exibio de Elementos no Editor de Dimenso .
Criando Dimenses Usando Planilhas de Dimenso . . . . .
Usando Nveis de Hierarquia Nomeada com Dimenses do TM1
Criando Cubos . . . . . . . . . . . . . . . . . .
Ordenando Dimenses em um Cubo . . . . . . . . . .
Criando um Cubo . . . . . . . . . . . . . . . .
Otimizando a Ordem de Dimenses em um Cubo . . . . .
Editando Propriedades do Cubo . . . . . . . . . . .
Criando Listas de Seleo. . . . . . . . . . . . . . .
Observaes de Uso da Lista de Seleo . . . . . . . . .
Tipos de Listas de Seleo . . . . . . . . . . . . .
Criando Listas de Seleo com Atributos de Elementos . . . .
Criando Listas de Seleo com Cubos de Controle . . . . .
Valores Nulos em Listas de Seleo . . . . . . . . . .
Ordem de Precedncia de Listas de Seleo. . . . . . . .
Replicando Cubos Entre Servidores . . . . . . . . . . .
Relacionamentos de Cubos . . . . . . . . . . . . .
Relacionamentos de Servidores . . . . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 7
. 8
. 9
. 12
. 12
. 15
. 16
. 16
. 17
. 22
. 24
. 29
. 31
. 31
. 32
. 33
. 34
. 35
. 35
. 35
. 36
. 37
. 39
. 39
. 40
. 40
. 40
Captulo 3. Clculos Avanados para Dados de Negcios . . . . . . . . . . . . . . 41

Viso Geral de Regras de Cubo . . . . . . . . . .
Diretrizes para Gravao de Instrues de Regras do TM1.
Consideraes Gerais . . . . . . . . . . . .
Sintaxe para Descrever a rea . . . . . . . . .
Sintaxe para Frmulas . . . . . . . . . . . .
Usando Referncias de Cubo . . . . . . . . .
Organizando Instrues de Regras. . . . . . . .
Especificando Diferentes Regras nos Nveis N: e C: . .
Ignorando Regras . . . . . . . . . . . . .
Qualificando Nomes de Elementos . . . . . . .
Editor de Regras e Planilhas de Regras . . . . . . .
Criando Planilhas de Regras . . . . . . . . . .
Salvando Planilhas de Regras . . . . . . . . .
Regras e Consolidaes de Dimenses . . . . . . .
Copyright IBM Corp. 2007, 2012
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
41
42
42
42
43
46
47
47
48
48
49
49
50
50
iii
Ordem de Clculo . . . . . . . . . .
Substituindo Elementos de Nvel C: por Regras
Empilhando Regras. . . . . . . . . .
Aplicativos de Amostra . . . . . . . . .
Calculando Propores . . . . . . . .
Compartilhando Dados entre Cubos . . . .
Restringindo Regras a Valores Simples . . .
Calculando um Preo Mdio. . . . . . .
Vinculando Dois Cubos Assimtricos . . . .
Criando Processos e Regras de Drill Through . .
Criando um Processo de Drill . . . . . .
Editando Processos de Drill . . . . . . .
Excluindo Processos de Drill. . . . . . .
Criando uma Regra de Designao de Drill. .
Exemplo de Drill Through . . . . . . .
Depurando Regras . . . . . . . . . . .
Rastreando Clculos . . . . . . . . .
Rastreando Alimentadores . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
50
50
52
52
52
55
57
58
59
60
60
62
63
63
64
67
67
69
Captulo 4. Organizando Objetos em Aplicativos do TM1 . . . . . . . . . . . . . . 71

Viso Geral do Aplicativo TM1 . . . . . . . . . . . . . . . . . . . . . . . . . . .
Tipos de Referncias . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Comportamento de Referncias . . . . . . . . . . . . . . . . . . . . . . . . . .
Ordem de Exibio para Referncias em Aplicativos . . . . . . . . . . . . . . . . . . .
Usando Aplicativos e Referncias no TM1 Web . . . . . . . . . . . . . . . . . . . .
Pastas e Arquivos de Aplictativos no TM1 server . . . . . . . . . . . . . . . . . . . .
Consideraes de Segurana sobre Criao e Visualizao de Aplicativos . . . . . . . . . . . . .
Criando e Gerenciando Aplicativos . . . . . . . . . . . . . . . . . . . . . . . . .
Criando um Aplicativo de Nvel Superior . . . . . . . . . . . . . . . . . . . . . .
Renomeando Aplicativos . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Excluindo Aplicativos . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Criando um Aplicativo de Nvel Secundrio em um Aplicativo Existente . . . . . . . . . . . .
Incluindo Referncias do Objeto do TM1 a um Aplicativo . . . . . . . . . . . . . . . . . .
Tornando uma Referncia Pblica . . . . . . . . . . . . . . . . . . . . . . . . .
Incluindo Referncias a Visualizaes e Subconjuntos Particulares em um Aplicativo . . . . . . . .
Criando Simultaneamente um Novo Objeto e Incluindo uma Referncia a um Aplicativo . . . . . .
Incluindo Referncias de Arquivo em um Aplicativo. . . . . . . . . . . . . . . . . . . .
Entendendo Referncias de Arquivos Pblicas e Particulares . . . . . . . . . . . . . . . .
Comportamento de Arquivos Transferidos por Upload ao TM1 Server. . . . . . . . . . . . .
Atualizando Arquivos Excel no TM1 Server . . . . . . . . . . . . . . . . . . . . .
Atualizando Arquivos No Excel no TM1 server . . . . . . . . . . . . . . . . . . . .
Incluindo Referncias de URL em um Aplicativo . . . . . . . . . . . . . . . . . . . . .
Trabalhando com Referncias de Objeto, Arquivo e Localizador Uniforme de Recursos em Aplicativos do TM1
Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Visualizando Propriedades do Aplicativo do TM1 . . . . . . . . . . . . . . . . . . .
Excluindo Referncias de Objeto, Arquivo e Localizador Uniforme de Recursos de Aplicativos do TM1. .
Renomeando Referncias de Objeto, Arquivo e Localizador Uniforme de Recursos em Aplicativos do TM1
Excluindo Objetos de Origem Referidos por Aplicativos do TM1 . . . . . . . . . . . . . .
Administrando a Segurana para Aplicativos do TM1 . . . . . . . . . . . . . . . . . . .
Designando Privilgios de Segurana a Aplicativos e Referncias do TM1 a Grupos de Usurios . . . .
Publicando Aplicativos e Referncias do TM1 . . . . . . . . . . . . . . . . . . . . .
Privatizando Aplicativos e Referncias do TM1 . . . . . . . . . . . . . . . . . . . .
Visualizando Agrupamentos Lgicos em Aplicativos do TM1 . . . . . . . . . . . . . . . . .
Publicando Aplicativos do TM1 no TM1 Web . . . . . . . . . . . . . . . . . . . . . .
Configurando Propriedades da Planilha da Web do TM1 . . . . . . . . . . . . . . . . .
Publicando Arquivos do Excel no TM1 Web sem Usar o Excel no Servidor TM1 Web . . . . . . . .
Criando Hyperlinks para Arquivos Transferidos por Upload . . . . . . . . . . . . . . . .
Exibindo Planilhas da Web que Contm o Caractere Hexadecimal 0x1A . . . . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
71
71
72
72
72
73
73
74
75
75
75
76
77
77
78
79
80
81
82
82
83
83
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
84
85
86
87
87
87
87
89
89
90
90
91
92
93
94
Captulo 5. Importando Dados com Planilhas de Processamento. . . . . . . . . . . 95

iv
IBM Cognos TM1 Verso 10.1.0: Guia para Desenvolvedores
Viso Geral de Planilhas de Processamento . . . . . . . . . . . . . . . . . . . . . . . . . 95

Importando Dados Usando Planilhas de Processamento . . . . . . . . . . . . . . . . . . . . 96
Lendo a Primeira Linha de Entrada . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Comparando Registros de Entrada com Estruturas de um Cubo . . . . . . . . . . . . . . . . . 97
Convertendo Usando Frmulas SE . . . . . . . . . . . . . . . . . . . . . . . . . . 98
Convertendo Usando um Cubo de Consulta . . . . . . . . . . . . . . . . . . . . . . . 99
Criando Frmulas Database Send (DBS) . . . . . . . . . . . . . . . . . . . . . . . . 102
Processando uma Origem de Dados em um Cubo . . . . . . . . . . . . . . . . . . . . . 103
Captulo 6. Controlando o Acesso de Objetos do TM1 . . . . . . . . . . . . . . . 105

Designando Direitos de Segurana a Grupos . . . . . . . . . . . .
Interao de Diferentes Direitos de Segurana do Objeto . . . . . . . .
Protegendo Cubos . . . . . . . . . . . . . . . . . . . . .
Designando Direitos de Segurana para Cubos . . . . . . . . . .
Reservando e Liberando Cubos . . . . . . . . . . . . . . .
Bloqueando e Desbloqueando um Cubo . . . . . . . . . . . .
Protegendo Elementos . . . . . . . . . . . . . . . . . . .
Designando Direitos de Segurana para Elementos . . . . . . . . .
Reservando e Liberando Elementos . . . . . . . . . . . . . .
Bloqueando e Desbloqueando um Elemento . . . . . . . . . . .
Protegendo Dimenses . . . . . . . . . . . . . . . . . . .
Designando Direitos de Segurana para Dimenses. . . . . . . . .
Reservando e Liberando Dimenses . . . . . . . . . . . . . .
Bloqueando e Desbloqueando uma Dimenso . . . . . . . . . .
Protegendo Processos . . . . . . . . . . . . . . . . . . . .
Atribuindo Direitos de Segurana para Processos . . . . . . . . .
Permitindo que Processos Modifiquem Dados de Segurana . . . . . .
Protegendo Tarefas de Organizao de Processos . . . . . . . . . .
Atribuindo Direitos de Segurana para Tarefas de Organizao de Processos
Protegendo Aplicativos e Referncias . . . . . . . . . . . . . .
Protegendo Clulas . . . . . . . . . . . . . . . . . . . .
Criando um Cubo de Controle de Segurana de Clula . . . . . . .
Usando Regras para Definir a Segurana em Nvel de Clula . . . . .
. . . . . . . . . . . . 105
. . . . . . . . . . . . 110
. . . . . . . . . . . . 111
. . . . . . . . . . . . 111
. . . . . . . . . . . . 112
. . . . . . . . . . . . 112
. . . . . . . . . . . . 112
. . . . . . . . . . . . 112
. . . . . . . . . . . . 113
. . . . . . . . . . . . 114
. . . . . . . . . . . . 114
. . . . . . . . . . . . 114
. . . . . . . . . . . . 115
. . . . . . . . . . . . 115
. . . . . . . . . . . . 116
. . . . . . . . . . . . 116
. . . . . . . . . . . . 116
. . . . . . . . . . . . 117
. . . . . . . . . . . . 117
. . . . . . . . . . . . 118
. . . . . . . . . . . . 118
. . . . . . . . . . . . 119
. . . . . . . . . . . . 121
Captulo 7. Usando os Botes de Ao do TM1 para Construir Aplicativos de

Planilhas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
Viso Geral . . . . . . . . . . . . . . . . . . . . . . . . . . .
Incluindo um Boto de Ao em uma Planilha . . . . . . . . . . . . . . .
Configurando um Boto de Ao para Executar um Processo . . . . . . . . . .
Selecionando o Processo a Ser Executado . . . . . . . . . . . . . . . .
Configurando Parmetros do Processo . . . . . . . . . . . . . . . . .
Configurando Opes do Processo para Clculo . . . . . . . . . . . . . .
Configurando Opes do Processo para Mostrar Mensagens. . . . . . . . . .
Usando a Propriedade de Nome do Servidor do Boto de Ao . . . . . . . .
Configurando um Boto de Ao para Navegar para Outra Planilha . . . . . . . .
Selecionar uma Planilha de Destino . . . . . . . . . . . . . . . . . .
Ativar a Opo Corresponder Elementos de Ttulo . . . . . . . . . . . . .
Configurando a Opo Substituir Pasta de Trabalho Atual . . . . . . . . . .
Configurando Opes de Clculo para Depois de Navegar para uma Planilha . . . .
Configurando um Boto de Ao para Executar um Processo e Navegar para uma Planilha
Configurando um boto de ao para recalcular ou reconstruir uma planilha . . . . .
Compreendendo o Comportamento do Boto de Ao com os Formulrios Ativos do TM1
Comportamento Bsico do Boto de Ao . . . . . . . . . . . . . . . .
Comportamento Adicional do Boto de Ao . . . . . . . . . . . . . . .
Configurando Propriedades de Aparncia de um Boto de Ao . . . . . . . . .
Usando Opes Avanadas de Navegao e Mapeamento . . . . . . . . . . .
Configurando o Mapeamento de Origem para Destino . . . . . . . . . . .
Exemplo de Mapeamento de um Valor de Origem para uma Clula de Destino . . .
Exemplo de Mapeamento de um SUBNM de Origem para uma Clula de Destino . .
Exemplo de Mapeamento do DBRW Selecionado para a Planilha de Destino . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
123
123
124
125
126
128
128
128
129
129
130
130
131
131
131
132
132
132
133
133
133
135
136
137
ndice
Modificando um Boto de Ao Existente . . . . . . . . . . . . . . . . . . . . .

Editando a Legenda, Imagem do Plano de Fundo e Propriedades de um Boto de Ao Existente .
Movendo e Redimensionando um Boto de Ao Existente . . . . . . . . . . . . . .
.
.
.
.
.
.
.
.
.
. 137
. 137
. 137
Captulo 8. Desenvolvendo Aplicativos da Web Customizados com a API da URL . . . 139

Viso Geral da Interface de Programao de Aplicativos do Localizador Uniforme . . . . . .
Sintaxe da API da URL Bsica . . . . . . . . . . . . . . . . . . . . . . . .
URL Base. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Parmetros . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Parmetro ObjectId . . . . . . . . . . . . . . . . . . . . . . . . . .
Usando Caracteres de Escape da URL . . . . . . . . . . . . . . . . . . . .
Conceitos Bsicos da API da URL . . . . . . . . . . . . . . . . . . . . . .
Configurando os Parmetros de Nome do Host Administrador e de Nome do Servidor TM1 Web
Gerenciando Login e Logout do Usurio . . . . . . . . . . . . . . . . . . .
Usando o Parmetro de Ao com Objetos do TM1 Web . . . . . . . . . . . . . .
Usando o Parmetro OpenObject para Abrir um Objeto do TM1 Web . . . . . . . . .
Operando em um Objeto Existente do TM1 Web com o Parmetro ObjectId . . . . . . .
Acessando o Objeto Planilha da Web . . . . . . . . . . . . . . . . . . . . .
Abrindo um Objeto Planilha da Web . . . . . . . . . . . . . . . . . . . .
Selecionando Elementos de Ttulo para um Objeto Planilha da Web . . . . . . . . . .
Aplicando Aes a um Objeto Planilha da Web . . . . . . . . . . . . . . . . .
Configurando Propriedades de Exibio para o Objeto Planilha da Web . . . . . . . . .
Acessando o Objeto Cubeviewer . . . . . . . . . . . . . . . . . . . . . . .
Abrindo um Objeto Cubeviewer . . . . . . . . . . . . . . . . . . . . . .
Configurando Propriedades de Exibio para o Objeto Cubeviewer . . . . . . . . . .
Selecionando Elementos de Ttulo para o Objeto Cubeviewer . . . . . . . . . . . .
Aplicando Aes a um Objeto Cubeviewer . . . . . . . . . . . . . . . . . .
Exibindo Grficos com o Objeto Cubeviewer . . . . . . . . . . . . . . . . . .
Definindo Funes de Retorno de Chamada de Evento para Objetos Cubeviewer e Planilha da Web
Ativando uma Funo de Retorno de Chamada para Objetos Planilha da Web e Cubeviewer . .
Definindo uma Funo de Retorno de Chamada Global para Todas as Dimenses de Ttulo . .
Acessando o Objeto rvore de Navegao. . . . . . . . . . . . . . . . . . . .
Abrindo o Objeto rvore de Navegao . . . . . . . . . . . . . . . . . . .
Usando o Objeto rvore de Navegao em Modo HTML. . . . . . . . . . . . . .
Usando o Objeto rvore de Navegao em Modo XML . . . . . . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
139
139
139
140
140
140
141
141
141
142
144
144
145
145
146
147
147
148
149
150
151
151
151
154
154
156
157
157
158
159
Captulo 9. Usando Reservas de Dados . . . . . . . . . . . . . . . . . . . . . 163

Viso Geral da Reserva de Dados. . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
Entendendo o Comportamento da Reserva de Dados com Outros Recursos do TM1 . . . . . . . . . . . 164
Reservas de Dados e Segurana . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
As Reservas de Dados e a Interface com o Usurio do TM1 . . . . . . . . . . . . . . . . . . 165
Reservas de Dados e Difuso de Dados . . . . . . . . . . . . . . . . . . . . . . . . 165
Reservas de Dados e Processos e Tarefas do Turbo Integrator . . . . . . . . . . . . . . . . . 165
Reservas de Dados e Ambientes de Simulao . . . . . . . . . . . . . . . . . . . . . . 167
Reservas de Dados, Ambientes de Simulao e Fila de Tarefas . . . . . . . . . . . . . . . . . 167
Ativando a Reserva de Dados . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
Ativando a Reserva de Dados para Cubos . . . . . . . . . . . . . . . . . . . . . . . . 168
Ativando Grupos de Usurios para Gerenciar as Reservas de Dados . . . . . . . . . . . . . . . 169
Monitorando Reservas de Dados . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
Exibindo o Status da Clula da Reserva de Dados no Server Explorer . . . . . . . . . . . . . . 170
Usando o TM1 Top para Monitorar Encadeamentos que Esto Aguardando Reservas de Dados . . . . . . 171
Usando o Log de Auditoria para Monitorar Eventos de Reserva de Dados . . . . . . . . . . . . . 171
Usando Funes do Turbo Integrator e da Interface de Programao de Aplicativos para Monitorar Reservas
de Dados . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
Gerenciando Reservas de Dados com Funes do Turbo Integrator . . . . . . . . . . . . . . . . 172
CubeDataReservationAcquire . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
CubeDataReservationRelease . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
CubeDataReservationReleaseAll . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
CubeDataReservationGet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
CubeDataReservationGetConflicts . . . . . . . . . . . . . . . . . . . . . . . . . . 177
vi
Gerenciando Reservas de Dados com as Funes da Interface de Programao de Aplicativos do TM1

TM1DataReservationAcquire . . . . . . . . . . . . . . . . . . . . . . . .
TM1DataReservationRelease . . . . . . . . . . . . . . . . . . . . . . . .
TM1DataReservationReleaseAll . . . . . . . . . . . . . . . . . . . . . . .
TM1DataReservationGetAll. . . . . . . . . . . . . . . . . . . . . . . . .
TM1DataReservationGetConflicts . . . . . . . . . . . . . . . . . . . . . . .
TM1DataReservationValidate . . . . . . . . . . . . . . . . . . . . . . . .
Cdigos de Erro da Interface de Programao de Aplicativos para Reservas de Dados . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
178
178
179
180
181
181
182
183
Apndice A. Funes do Excel Suportadas - TM1 Web . . . . . . . . . . . . . . 185

Funes Suportadas . . . . . . . .
Funes de Data e Hora . . . . . .
Funes Financeiras . . . . . . .
Funes de Informao . . . . . .
Funes Lgicas . . . . . . . .
Funes de Consulta e Referncia . .
Funes Matemticas e Trigonomtricas
Funes de Texto e de Dados . . . .
Funes Estatsticas . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
185
185
186
187
187
187
188
190
192
Apndice B. Funes do Excel No Suportadas - TM1 Web . . . . . . . . . . . . 197

Funes
Funes
Funes
Funes
Funes
Funes
Funes
Funes
de Banco de Dados e de Gerenciamento de Listas .

de Data e Hora . . . . . . . . . . . . .
Financeiras . . . . . . . . . . . . . .
de Informao . . . . . . . . . . . . .
de Consulta e Referncia . . . . . . . . .
Matemticas e Trigonomtricas . . . . . . .
Estatsticas . . . . . . . . . . . . . .
de Texto e de Dados . . . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
197
198
198
200
201
201
202
203
Avisos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205
ndice Remissivo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
ndice
vii
viii
Introduo
Este documento foi projetado para ser usado com o IBM Cognos TM1 .
Este manual descreve como criar e manter objetos no IBM Cognos TM1 server ,
administrar a segurana e desenvolver aplicativos do TM1 . O guia tambm
descreve aspectos da segurana do TM1 .
Localizando Informaes
Para localizar a documentao do produto IBM Cognos na web, incluindo toda a
documentao traduzida, acesse um dos Centros de Informaes do IBM Cognos
(http://publib.boulder.ibm.com/infocenter/cogic/v1r0m0/index.jsp). As Notas
sobre a Liberao so publicadas diretamente nos Centros de Informaes e
incluem links para as mais recentes notas tcnicas e APARs.
Termo de responsabilidade das amostras

A Companhia das Grandes Aventuras, as Vendas da GA, qualquer variao do
nome Grandes Aventuras e Amostra de Planejamento descrevem operaes de
negcios fictcias com dados de amostra usados para desenvolver aplicativos de
amostra para a IBM e os clientes IBM. Esses registros fictcios incluem dados de
amostra para transaes de vendas, distribuio de produtos, finanas e recursos
humanos. Qualquer semelhana com nomes, endereos, nmeros de contato ou
valores de transao reais mera coincidncia. Outros arquivos de amostras
podem conter dados fictcios gerados manualmente ou por mquinas, dados reais
compilados de fontes acadmicas ou pblicas, ou dados usados com a permisso
do proprietrio dos direitos autorais, para o uso como dados de amostra para o
desenvolvimento de aplicativos de amostras. Os nomes de produtos citados podem
ser marcas registradas dos respectivos proprietrios. A cpia no autorizada est
proibida.
Recursos de Acessibilidade
Atualmente este produto no compatvel com recursos de acessibilidade que
ajudam usurios com deficincias fsicas, como mobilidade ou viso restritas, a
us-lo.
Declaraes prospectivas
Esta documentao descreve a funcionalidade atual do produto. Referncias a itens
que no esto disponveis no momento podero ser includas. Nenhuma
implicao sobre qualquer disponibilidade futura deve ser inferida. Referncias
desse tipo no so um compromisso, promessa ou obrigao legal de fornecer
materiais, cdigos ou funcionalidades. O desenvolvimento, a liberao e a
sincronizao de recursos ou a funcionalidade permanecem a critrio exclusivo da
IBM.
ix
Captulo 1. Introduo ao TM1 Development

Esta seo fornece uma introduo para o conceito de multidimensionalidade e
descreve algumas responsabilidades comuns de desenvolvedores usando o IBM
Cognos TM1 .
Entendendo a Multidimensionalidade
Com o IBM Cognos TM1 , possvel criar bancos de dados multidimensionais que
forneam significado instantneo a gerentes de negcios e financeiros para modelos
de negcios complexos e dinmicos.
Para entender a multidimensionalidade, considere o exemplo do vice-presidente de
vendas de uma empresa varejista que deseja analisar vendas de produtos em uma
rede varejista que opera nos Estados Unidos e no Canad. Cada loja varejista
registra as vendas unitrias, vendas em dlares e descontos para os produtos de
consumidor durveis.
As vendas so analisadas por produto, cenrio (real versus oramento), regio,
medidas (unidades, vendas em dlares e descontos) e semana. O que identificamos
um modelo de cinco dimenses. As dimenses identificam como os dados so
organizados e como os tipos de dado so controlados.
No TM1 , a anlise de vendas pode residir em uma ou mais estruturas
multidimensionais denominadas cubos. Uma coleo de cubos forma um banco de
dados. Cada ponto de dados em um cubo identificado por um elemento em cada
dimenso do cubo; por exemplo, vendas reais em dlares de secadoras durante a
segunda semana de janeiro na loja de Boston. Os cubos do TM1 devem conter no
menos do que duas e no mais do que 256 dimenses.
Cubo Durables
No diagrama a seguir, cada dimenso no cubo Durables representada por um
segmento de linha vertical. Os elementos na dimenso so representados por
intervalos de unidades.
Suponha que voc seja o vice-presidente de vendas e precise comparar

rapidamente o desempenho de produtos e lojas para identificar as melhores
estratgias e pontos de problemas. Ao usar as visualizaes multidimensionais do
TM1, possvel criar um nmero ilimitado de consultas ad hoc.
No exemplo a seguir, possvel comparar rapidamente as vendas em dlares reais
versus oradas durante as semanas. A regio Boston e o produto um modelo de
secadora.
Reorganizando a visualizao, possvel comparar vendas em dlares para o

modelo de secadora em todas as regies.
As sees seguintes deste manual descrevem como possvel usar o TM1 para
reconfigurar visualizaes e fazer drill-down nos dados multidimensionais para
atender os requisitos de anlise.
Sua Funo como Desenvolvedor

Como um desenvolvedor do IBM Cognos TM1 , suas responsabilidades se dividem
em quatro tarefas principais:
v Projetar e criar os cubos que contm anlises de negcios.
v Decidir onde armazenar os cubos para que eles possam ser compartilhados na
organizao.
v Importar dados para os cubos de sistemas transacionais e de outras origens de
dados.
v Criar frmulas que executam clculos, tais como, mdia de preos, converses
de moedas e propores de preo/lucro.
necessrio ter direitos de acesso aos dados do TM1 a fim de executar essas
tarefas. Normalmente o administrador do TM1 responsvel por configurar
direitos de acesso. A seo a seguir descreve a distino entre um servidor local e
um remoto, e lista os direitos de acesso necessrios para executar tarefas em um
servidor remoto.
Compreendendo as Convenes de Nomenclatura de Objeto do TM1

Como desenvolvedor, voc responsvel por criar e nomear muitos objetos no
sistema IBM Cognos TM1 . Voc deve observar as seguintes convenes ao nomear
objetos do TM1 .
Caracteres Reservados
A lista de caracteres invlidos diferente ao nomear objetos e ao gravar regras ou
instrues de regras.
Os seguintes caracteres so reservados. No possvel usar esses caracteres
reservados quando voc nomear aplicativos, cubos, visualizaes, dimenses,
subconjuntos, processos e tarefas de organizao de processos do TM1 :
Caractere
Descrio
barra
barra invertida
dois pontos
ponto de interrogao
"
aspas duplas
<
menor que
>
maior que
barra vertical
asterisco
Nota: A chave direita (}) no pode ser o primeiro caractere em nenhum nome do
objeto do TM1 .
Instrues de Regras
Os seguintes caracteres so reservados ao gravar instrues de regras. No
possvel usar esses caracteres reservados nas instrues de regra do TM1 :
Caractere
Descrio
vrgula
Fechar parnteses
barra vertical
til
ponto e vrgula
arroba
Ao gravar regras com construes "!dimension-name", no use nenhum dos

caracteres reservados. Caracteres de nomes da dimenso invlidos para escritores
de regras so:, ) | ~ ; @ \ / : * ? " < >
Consulte Excees de Nomenclatura do Objeto para obter informaes adicionais.
Excees de Nomenclatura de Objeto

No h restrio nos caracteres que podem ser usados em nomes de elementos,
clientes, grupos ou alias, com as seguintes excees:
Expresses MDX
Um nome de elemento no pode conter um circunflexo (^), porque este caractere
usado para indicar relacionamentos no MDX. O IBM Cognos TM1 usa MDX para
filtrar visualizaes e gerar subconjuntos dinmicos. Portanto, um nome de
elemento que contm um circunflexo provoca erros ao aplicar filtros ou criar
subconjuntos dinmicos.
Um nome de elemento pode conter um colchete direito ( ] ), mas quando um nome
de elemento que contm esse caractere mencionado em uma expresso MDX,
necessrio fazer o escape desse caractere duplicando-o. Por exemplo, um elemento
chamado Array[N] Elements pode ser referido em uma expresso MDX como
[Array[N]] Elements].
Regras do TM1
Voc deve estar ciente de que alguns caracteres especiais em nomes de objetos
podem entrar em conflito quando usados em uma expresso de regras. Por
exemplo, o caractere @ e o caractere ponto de exclamao ! so caracteres vlidos
para nomes de objetos, mas tambm so usados em expresses de regras.
O caractere @ pode ser usado em qualquer nome do objeto do TM1 . Entretanto, o
caractere @ um operador de comparao de sequncia nas regras do TM1 . Se
fizer referncia a qualquer objeto contendo o caractere @ em regras, o nome do
objeto dever ser colocado entre aspas simples. Por exemplo, uma dimenso
denominada products@location deve ser mencionada como 'products@location' em
regras.
O caractere ponto de exclamao ! tambm usado em expresses de regras e no
deve ser usado em nomes de objetos que sero usados em regras. Por exemplo, a
funo DB de regras usa o ponto de exclamao como parte do argumento
!dimension.
DB(MarketExchange,!market,!date)
Comprimento Mximo de Sequncia para Diretrios de Dados e

Nomes de Objetos
A sequncia inteira representada pela combinao do nome do diretrio de dados e
do nome do objeto do IBM Cognos TM1 server limitado a 256 bytes. Por
exemplo, se seu diretrio de dados for C:\Financial data\TM1\ (22 bytes), os
nomes de objetos sero limitados a 234 bytes, inclusive de uma extenso do
arquivo, tal como, .cub ou .rux.
Alguns objetos do TM1 , como visualizaes, subconjuntos e aplicativos, so
armazenados em sub-diretrios do diretrio de dados do TM1 server . Nesse caso,
o limite de 256 bytes aplica-se combinao do diretrio de dados, do subdiretrio
e do nome do objeto do TM1 server .
Distino entre Maisculas e Minsculas

Os nomes de objetos no fazem distino entre maisculas e minsculas. Por
exemplo, o nome da dimenso actvsbud equivalente a ActVsBud.
Espaos em Nomes de Objetos

Os espaos so permitidos em todos os nomes do objeto, mas so ignorados pelo
IBM Cognos TM1 server . O TM1 server considera o nome da dimenso Act Vs
Bud equivalente a ActVsBud (ou actvsbud).
Nomes de Usurios
Os nomes de usurios com caracteres reservados no podem salvar objetos
particulares.
Captulo 2. Criando Cubos e Dimenses

O IBM Cognos TM1 armazena dados de negcios em cubos. Esta seo descreve
como criar cubos e seus blocos de construo, dimenses.
Nota: Todas as tarefas descritas nesta seo requerem o TM1 Perspectives ou TM1
Architect . No possvel criar cubos, criar/editar dimenses ou estabelecer
replicaes com o TM1 Client.
Projetando Cubos
O TM1 armazena suas anlises de negcios nos cubos. Cada clula em um cubo
contm uma medida que est sendo rastreada em uma anlise. Um cubo pode
armazenar dados em uma ou mais medidas.
Voc forma um cubo com dimenses, que identificam como organizar os dados ou
as medidas que voc deseja controlar. Um elemento em cada dimenso identifica o
local de uma clula em um cubo.
O cubo de exemplo a seguir contm trs dimenses: Produto, Medidas e Ms.
Cada medida, como Vendas, organizada ou dimensionada por um produto e um
ms. Por exemplo, o valor de clula 30000 representa as vendas de Sed-1 no ms
de Janeiro (Jan).
O TM1 trata todas as dimenses da mesma forma, tanto se eles contm elementos
que identificam medidas como se descrevem como voc organiza as medidas.
Selecionando o Nmero de Dimenses

Cada cubo possui pelo menos duas dimenses e um mximo de 256 dimenses.
Por exemplo, um cubo bidimensional mais apropriado como uma tabela de
consulta quando voc deseja calcular valores em outros cubos que possuem mais
dimenses. Por exemplo, possvel converter os valores monetrios locais em uma
moeda de relatrio, usando um cubo bidimensional que armazena as taxas de
cmbio. A taxa recuperada usando a regra do TM1 .
O nmero de dimenses em um cubo depende muito da dimensionalidade de seus
dados. Considere as contas em uma Demonstrao de Lucro e Prejuzo.
Demonstrao de Lucro e Prejuzo (em milhares)
Encerramento do Ano, 31 de dezembro de 2002
Vendas lquidas
200.000
Custos diretos
35.000
Mo de obra direta
50.000
Lucro Bruto
115.000
Salrios
30.000
Folha de Pagamento
3.500
Eletricidade
5.000
Aluguel
10.000
Depreciao
6.000
Se desejar examinar como a receita e as despesas variam por seus fatores, voc
precisar dividir as contas em dois grupos.
Contas acima da linha de Lucro Bruto, tais como, Vendas lquidas e Custos
diretos, que podem ser dimensionadas por produto, regio, cenrio (Real versus
Oramento) e meses.
v Contas abaixo da linha de Lucro Bruto, tais como, Folha de Pagamento,
Eletricidade e Aluguel, que podem ser dimensionadas por regio, cenrio (Real
versus Oramento) e meses, mas no por produto. No possvel atribuir
diretamente os gastos adicionais a produtos, portanto, eles no podem ser
analisados no mesmo nvel de detalhe.
Esta diferena em dimensionalidade sugere dois cubos:

v Cubo de cinco dimenses para as contas acima da linha de Lucro Bruto
v Cubo de quatro dimenses para as contas abaixo da linha de Lucro Bruto
Cubo de Cinco Dimenses

O diagrama a seguir representa as dimenses e elementos no cubo de cinco
dimenses. Cada dimenso representada por um segmento de linha vertical. Os
elementos na dimenso so representados por intervalos de unidades.
Cubo de Quatro Dimenses

O diagrama a seguir representa as dimenses e elementos no cubo de quatro
dimenses. Cada dimenso representada por um segmento de linha vertical. Os
elementos na dimenso so representados por intervalos de unidades.
Consolidando Detalhe Usando Hierarquias da Dimenso

Os dados importados para um cubo fornecem uma captura instantnea de seus
negcios em um nvel de detalhe especfico. Por exemplo, voc pode importar os
dados de vendas toda semana ou todo ms para produtos por cidade. Os
elementos de dimenso que identificam estes pontos de dados so elementos
simples ou de nvel folha em cada dimenso: vendas para uma semana, um
produto, uma cidade.
Usando hierarquias da dimenso, possvel agregar facilmente dados numricos em

categorias que so significativas em suas anlises. Cada categoria corresponde a
uma agregao de detalhe para dois ou mais elementos em uma dimenso. Por
exemplo, possvel criar elementos trimestrais que somam valores de vendas
mensais. No TM1 , os elementos que representam agregaes so denominados
elementos consolidados ou consolidaes.
O diagrama a seguir mostra trs nveis de consolidao para elementos de uma
dimenso Regio. As cidades fornecem o nvel mais baixo de detalhe (Nvel 0). As
cidades fazem rolagem em consolidaes de estados (Nvel 1), que fazem rolagem
em consolidaes regionais que, por ltimo, fazem rolagem na consolidao do
Leste dos EUA (Nvel 3).
Navegando em uma Hierarquia da Dimenso

Uma hierarquia da dimenso fornece um caminho de navegao para analisar
dados em diferentes nveis de detalhe. Drill down significa navegar para nveis
mais altos de detalhe em uma dimenso. Por exemplo, conforme faz drill down a
partir de New England na dimenso Regio acima, voc acessa os dados
subjacentes para dois estados e, depois, quatro cidades. Drill up significa navegar
para nveis de resumo em dimenses.
Usando Pesos para Express ar Consolidaes

Os fatores de peso determinam a contribuio de um elemento para uma
consolidao. Para expressar que o total de vendas de Connecticut uma soma de
Hartford e New Haven, atribua um fator de peso padro de 1,0 a Hartford e New
Haven.
Tambm possvel consolidar elementos, subtraindo os valores associados aos
elementos. Por exemplo, possvel expressar Lucro Lquido como Valor de
Mercado - Valor de Aquisio. Atribua um fator de peso de 1,0 ao Valor de
Mercado e -1,0 ao Valor de Aquisio. A tabela a seguir apresenta quatro exemplos
de pesos de consolidao.
10
Dimenso
Elemento
Consolidado
Mtodo de
Consolidao
Elementos
Subordinados
Conta
Lucro Lquido
Subtrao
Valor de
Mercado
Fatores de Peso
1,0
-1,0
Valor de
Aquisio
Ms
Perodo
Regio
1Trimestre
Oramento
Anual
Connecticut
Adio
Distribuio
4-4-5
Adio
Janeiro
1,0
Fevereiro
1,0
Maro
1,0
Janeiro
,07692
Fevereiro
,07692
Maro
,09615
Hartford
1,0
New Haven
1,0
Criando Vrias Rolagens em uma Dimenso

possvel fazer a rolagem de dados numricos de baixo nvel, tais como, vendas e
unidades, de diversas maneiras, criando vrias hierarquias em uma dimenso.
Criando vrias rolagens em uma dimenso, possvel reduzir o nmero de
dimenses e o nmero de clulas vazias em um cubo.
No exemplo a seguir, Hartford, um elemento simples na dimenso Regio, faz
rolagem em dois caminhos: geogrfico e de gerenciamento.
Rolagem Geogrfica:
Rolagem de Gerenciamento:
11
Criando Clculos Complexos

O TM1 agrega as consolidaes criadas em dimenses pelos fatores de peso
designados. Para criar propores entre os elementos ou multiplicar os valores
associados aos elementos, necessrio criar um clculo complexo, chamado de
regra. Estes so dois clculos que requerem regras do TM1 :
v Margem Bruta = (Lucro Bruto Vendas Lquidas) x 100
v Vendas = (Preo x Unidades)
Tambm possvel usar regras para fazer a contagem total dos elementos. No
entanto, as regras tm um processamento mais demorado do que as consolidaes,
principalmente em cubos grandes ou esparsos. Os cubos esparsos tm uma alta
porcentagem de clulas vazias.
Para uma explicao abrangente de regras, consulte o Guia de Regras do IBM
Cognos TM1 .
Tipos de Elementos
At agora, voc conheceu elementos simples ou de nvel base dos quais pode-se
fazer rolagem para consolidaes. O TM1 suporta trs tipos de elementos:
Elemento
Descrio
Numrico
Identificar o detalhe de nvel mais baixo em uma dimenso. Em um

cubo que contm apenas membros, o TM1 define todos os elementos
de nvel mais baixo como numricos.
Consolidado
Agregaes de detalhe de nvel mais baixo. Por exemplo, voc pode

usar o elemento 1Trimestre em uma dimenso de tempo para somar
os valores de vendas para os trs primeiros meses do ano.
Sequncia
Armazena sequncias de texto em clulas. Para incluir uma sequncia

em uma clula em um cubo, o elemento da ltima dimenso que
define a clula deve ser um elemento de sequncia. O TM1 trata
elementos de sequncia que ocorrem em qualquer dimenso diferente
da ltima como elementos numricos.
O uso tpico para elementos de sequncia est em um cubo
bidimensional que converte cdigos em um arquivo de entrada em
nomes de elementos formais. Por exemplo, se voc desejar converter
cdigos de contas em nomes de contas.
Atributos de Elementos
Os elementos identificam dados em um cubo, e os atributos de elementos
descrevem os prprios elementos.
Os atributos podem ser usados para:
12
v Listar recursos de elementos. Por exemplo, a metragem de uma loja e o tamanho

do motor de um modelo de carro.
v Fornecer nomes alternativos, ou aliases. Por exemplo, nomes descritivos de
contas do livro-razo geral e as verses de idioma local de nomes de produtos.
v Controlar o formato de exibio para os dados numricos. Geralmente, voc
seleciona um formato de exibio para as medidas controladas em um cubo.
possvel selecionar elementos por valor de atributo no Editor de Subconjuntos.
Tambm possvel exibir nomes de elementos nas caixas de dilogo do TM1
usando seus aliases.
Para criar atributos e atribuir valores de atributos, use o Editor de Atributos.
Atributos Descritivos
A tabela a seguir mostra atributos de amostra que descrevem modelos de carros.
Atributos
Elementos
Cavalo-vapor
(Numrico)
Motor (Texto)
udio (Texto)
Sed 1
190
V-8
CD
Sed 2
140
Em Linha 4
Cassete / Rdio
Sed 3
120
Em Linha 4
Cassete / Rdio
Sed 4
180
V-8
CD
Sed 5
140
Em Linha 4
Cassete / Rdio
Atributos de Alias
A tabela a seguir mostra as verses em alemo, espanhol e francs de nomes de
mveis em ingls.
Atributos de Alias
Elementos
Deutsche
Espaol
Franais
Coordenador
Stuhl
Silla
Chaise
Desk
Schreibtisch
Escritrio
Bureau
Lamp
Lampe
Lmpara
Lampe
Atributos de Formato de Exibio

A janela Cube Viewer exibe dados numricos nos formatos mostrados na tabela a
seguir.
Nome do
Formato
Descrio
Exemplo
Moeda
R$ 90,00
Os nmeros aparecem com um smbolo
monetrio e o nmero especificado de casas
decimais (Preciso). O TM1 usa o smbolo atual
definido na caixa de dilogo Microsoft Windows
Regional Settings.
Geral
Os nmeros aparecem com um nmero

especificado de casas decimais (Preciso).
-90
Porcentagem
Os nmeros aparecem como porcentagens, com

um nmero especificado de casas decimais
(Preciso).
90,00%
13
Nome do
Formato
Descrio
Exemplo
Cientfico
Os nmeros aparecem em formato exponencial,

com um nmero especificado de casas decimais
(Preciso).
9.0e+001
Data
Os nmeros aparecem como uma sequncia de

datas. 1=1 de janeiro de 1900. Existem vrios
formatos de data disponveis.
31 de maro de 2002
Hora
Os nmeros aparecem como uma sequncia de

hora. Existem vrios formatos de hora
disponveis.
19:53:30 A
Ponto
Coloca pontos nos locais apropriados em

nmeros grandes.
1.000.000
Customizado
Um formato definido pelo usurio.
Customizado
Usando a janela Editor de Atributos, possvel selecionar um formato de exibio

para cada elemento em cada dimenso em um cubo. No entanto, recomendvel
selecionar formatos de exibio apenas para uma dimenso, as medidas
controladas em um cubo. Tambm possvel selecionar um formato na janela
Cube Viewer, que seja aplicvel a clulas cujos elementos no possuem um
formato de exibio definido.
O TM1 determina qual formato de exibio ser usado na janela Cube Viewer ,
como a seguir:
Procedimento
1. O TM1 primeiro verifica os elementos na dimenso da coluna para formatos de
exibio. Se as dimenses estiverem empilhadas, o TM1 verificar de baixo para
cima.
2. Se nenhum formato for localizado, o TM1 verificar os elementos na dimenso
da linha para obter formatos de exibio. Se as dimenses estiverem
empilhadas, o TM1 verificar da direita para a esquerda.
3. Se nenhum formato for localizado, o TM1 verifica os elementos do ttulo para
obter formatos de exibio. Os elementos so inspecionados da direita para a
esquerda.
4. Se nenhum formato for localizado, o TM1 aplica o formato para a visualizao
atual.
Para garantir que o TM1 aplique o formato para as medidas do cubo, posicione
a dimenso que contm as medidas conforme a dimenso da coluna mais
baixa.
Configurando Formatos de Exibio para Linhas ou Colunas

Talvez voc queira formatar os nmeros em uma nica coluna ou linha. Por
exemplo, os nmeros em uma coluna ou em uma linha que contm duas vrgulas
decimais, talvez sejam melhor representados como nmeros inteiros sem vrgulas
decimais. Para formatar os nmeros em uma nica coluna ou linha, use o Editor
de Atributos.
A dimenso Ms exibida na coluna da visualizao. Qualquer formato de
exibio atribudo a uma dimenso de coluna substitui o formato de exibio
selecionado para a dimenso de linha.
14
Para a primeira tarefa, iremos assegurar que nenhuma formatao seja aplicada ao
elemento Ano da dimenso Ms. Siga estas etapas.
Procedimento
1. Abra a visualizao Formato de SalesPriorCube.
2. No Server Explorer, expanda o cubo SalesPriorCube para poder ver suas
dimenses.
3. Clique com o boto direito do mouse em uma dimenso Ms e selecione
Editar Atributos de Elementos.
O Editor de Atributos se abre.
Observe que no existem valores de atributos de Formato para a dimenso
Ms. Agora possvel assegurar que nenhum formato configurado para a
dimenso de linha ter precedncia no Cube Viewer (ou In-Spreadsheet
Browser).
4. Clique em Cancelar para fechar o Editor de Atributos.
Para esta tarefa, siga as etapas para formatar os nmeros na linha Unidades
como nmeros inteiros com zero (0) casa decimal.
5. No Server Explorer, clique com o boto direito do mouse na dimenso Conta1
e selecione Editar Atributos de Elemento.
O Editor de Atributos se abre.
6. Clique na clula na interseo da linha do elemento Unidades e da coluna
Formato.
7. Clique no boto Formato.
A caixa de dilogo Formato Numrico se abre.
8. Selecione a categoria Vrgula, insira 0 na caixa Preciso e clique em OK.
9. Clique em OK na caixa de dilogo Editor de Atributos.
para recalcular a visualizao Formato.
10. Clique em Recalcular
Os valores de Unidades agora so exibidos como nmeros inteiros sem pontos
decimais.
Atributos versus Elementos

Quando desejar listar vrios valores de atributos para um nico elemento,
recomendvel criar elementos adicionais ou dimenses adicionais. Por exemplo, a
cor externa um atributo de modelos de carros. Os modelos vermelhos geralmente
so mais vendidos do que os outros modelos de cores. Se criar um elemento por
carro e outra dimenso com elementos para cada cor, possvel usar o TM1 para
rastrear as vendas de carros por cor. Se voc combinar vendas em um nico
modelo, poder perder um detalhe importante.
Considere outro exemplo. Na tabela de modelos de carros, h uma categoria de
atributos para configurao de motor. Cada carro possui uma nica configurao
de motor, por exemplo, V-8. Se os seds estiverem disponveis em mais de uma
configurao de motor, recomendvel criar um elemento por configurao de
motor.
Projetando Cubos - Resumo

A seguir esto as diretrizes a serem usadas ao projetar cubos:
15
Procedimento
1. Liste as medidas que deseja controlar em sua anlise de negcios. Exemplos de
medidas incluem valores de vendas, unidades vendidas, despesas, valores de
aquisio e custos de campanha.
2. Determine como deseja organizar ou dimensionar as medidas. Na maioria das
anlises, voc controla medidas no decorrer do tempo.
v Qual o intervalo de tempo base: dias, semanas, meses?
v Existe uma dimenso geogrfica?
v As medidas variam por cliente e produto?
v Existe uma dimenso de cenrio (real versus oramento)?
3. Determine como deseja consolidar os elementos de dimenso.
4. Crie uma lista de atributos que deseja associar aos elementos do cubo.
Exemplos de atributos incluem metragem da loja, IDs de clientes e verses de
idioma local de nomes de elementos.
5. Defina os formatos de exibio para as medidas em seus cubos. Por exemplo,
defina Margem Bruta como uma porcentagem e Vendas como um valor
monetrio.
Criando Dimenses
Ao criar uma dimenso, voc identifica os elementos de nvel folha que formam a
dimenso e, opcionalmente, as hierarquias (consolidaes) na dimenso.
Existem quatro maneiras de criar dimenses:
v Editor de Dimenso - Inclua elementos, alm de criar e reorganizar
consolidaes enquanto projeta dimenses. Para obter mais informaes,
consulte Criando Dimenses Usando a Janela Editor de Dimenso.
v TurboIntegrator - Importe nomes de elementos de uma origem de subconjunto
ASCII, ODBC, de visualizao de cubo ou de dimenso. Crie simultaneamente
vrias dimenses e estabelea a consolidao nessas dimenses. Para obter mais
informaes, consulte o Guia de Turbo Integrator do IBM Cognos TM1 .
Nota: O TM1 requer drivers DataDirect para acessar uma origem Oracle ODBC
no Solaris ou AIX. Estes drivers no so fornecidos com o TM1 e devem ser
adquiridos separadamente.
v Importando Dados para um Novo Cubo - Use o TurboIntegrator para mapear
linhas de entrada de uma origem de dados para um cubo. Em seguida,
identifique as colunas de entrada que fornecem os valores de clulas e os
elementos que identificam o local da clula. Para obter mais informaes sobre
esse processo, consulte o Guia de TurboIntegrator do IBM Cognos TM1 .
v Planilhas de Dimenso - Use estas planilhas modificadas do Microsoft Excel
para listar os elementos e relacionamentos hierrquicos para uma dimenso.
Para obter mais informaes, consulte Criando Dimenses Usando Planilhas de
Dimenso na pgina 24.
Criando Dimenses Usando a Janela Editor de Dimenso

Esta seo orienta-o durante as etapas de criao de uma dimenso rea simples
usando a janela Editor de Dimenso. Assuma que a hierarquia para a dimenso de
rea inclua o elemento New England consolidado e trs elementos simples,
Connecticut, Massachusetts e Vermont.
16
Procedimento
1. Na rea de janela em rvore do Server Explorer, selecione Dimenses abaixo
do servidor que voc deseja que contenha a dimenso.
2. Clique em Dimenses, Criar Nova Dimenso.
O Editor de Dimenso se abre.
Agora possvel incluir elementos na dimenso.
3. Clique em Editar, Inserir Elemento ou clique em Inserir Irmo
A caixa de dilogo Insero de Elemento de Dimenso se abre.
4. Para incluir um elemento consolidado, faa o seguinte:
v Digite New England no campo Inserir Nome de Elemento.
v Selecione Consolidado da lista Tipo de Elemento.

v Clique em Adicionar.
v Clique em OK.
New England agora aparece como o primeiro elemento da dimenso, que
um elemento consolidado. Vamos incluir trs elementos filhos no elemento
New England. Como resultado, New England torna-se o elemento-pai dos trs
elementos filhos.
5. Selecione o elemento New England.
.
6. Clique em Editar, Inserir Filho ou clique em Inserir Filho
A caixa de dilogo Insero de Elemento de Dimenso se abre. O TM1 exibe
um nome Pai de New England, indicando que qualquer elemento criado ser
filho de New England.
7. No campo Inserir Nome de Elemento, digite Connecticut e clique em Incluir.
8. No campo Inserir Nome de Elemento, digite Massachusetts e clique em
Incluir.
9. No campo Inserir Nome de Elemento, digite Vermont e clique em Incluir.
A caixa de dilogo agora contm trs filhos de New England, cada um com
um peso padro de 1.
10. Clique em OK.
O Editor de Dimenso mostra os novos elementos como filhos de New
England.
.
11. Clique em Dimenso, Salvar ou clique em Salvar
A caixa de dilogo Salvar Dimenso como se abre.
12. Insira um nome de dimenso e clique em Salvar.
Os nomes de dimenses podem ter um mximo de 256 caracteres. Use sempre
nomes de dimenses descritivos.
A nova dimenso exibida na lista de dimenses no servidor.
Modificando uma Dimenso

Depois de criar uma dimenso, possvel fazer as seguintes modificaes:
v Incluir irmos em elementos existentes.
v Incluir filhos em elementos existentes.
v Reorganizar a estrutura da hierarquia, por exemplo, reposicionar elementos em
consolidaes.
v Excluir elementos da dimenso.
17
v Excluir elementos de consolidaes.

v Editar propriedades do elemento, por exemplo, alterar o peso de um elemento
em uma consolidao.
v Reorganizar a ordem de elementos na dimenso.
Incluindo Irmos em Elementos Existentes

Siga estas etapas para incluir irmos em um elemento existente no Editor de
Dimenso.
Procedimento
1. Clique com o boto direito do mouse no elemento no qual deseja incluir irmos
e selecione Editar Estrutura da Dimenso.
2. Clique em Editar, Inserir Irmo.
3. Insira o nome do primeiro irmo no campo Inserir Nome de Elemento.
4. Se aplicvel, insira um Peso de Elemento.
O peso do elemento padro 1.
5. Clique em Adicionar.
6. Repita as etapas 3 a 5 para cada irmo que voc deseja incluir.
7. Clique em OK.
O TM1 inclui os novos elementos como irmos do elemento que voc
selecionou na etapa 1.
Incluindo Filhos em Elementos Existentes

Siga estas etapas para incluir filhos em elementos existentes no Editor de
Dimenso.
Procedimento
1. Clique com o boto direito do mouse no elemento no qual deseja incluir irmos
e selecione Editar Estrutura da Dimenso.
Se voc incluir filhos em um elemento simples (nvel folha), o elemento se
tornar automaticamente um elemento consolidado.
2. Clique em Editar, Inserir Filho.
3. Insira o nome do primeiro filho no campo Inserir Nome de Elemento.
4. Se aplicvel, insira um Peso de Elemento.
O peso do elemento padro 1.
6. Repita as etapas 3 a 5 para cada filho que voc deseja incluir.
7. Clique em OK.
O TM1 inclui os novos elementos como filhos do elemento que voc selecionou
na etapa 1.
Reorganizando a Hierarquia da Dimenso

Siga estas etapas para alterar a posio de elementos na hierarquia da dimenso.
Procedimento
1. No Editor de Dimenso, selecione os elementos que deseja mover.
v Para selecionar um nico elemento, clique no elemento.
18
v Para selecionar vrios elementos adjacentes, clique no primeiro elemento,

mantenha pressionada a tecla SHIFT e clique no ltimo elemento. Tambm
possvel pressionar CTRL-A para selecionar todos os elementos visveis.
v Para selecionar vrios elementos no adjacentes, mantenha pressionada a
tecla CTRL e clique em cada elemento.
2. Arraste e solte os elementos para seu novo local na hierarquia da dimenso.
medida em que arrasta os elementos, o cursor alterado para indicar o local
em que o TM1 soltar os elementos. Alm disso, a barra de status exibe uma
mensagem que indica o local em que o TM1 soltar os elementos.
Tambm possvel recortar e colar elementos para reorganizar a hierarquia da
dimenso.
Excluindo Elementos de uma Dimenso

Siga estas etapas para excluir elementos de uma dimenso.
Procedimento
1. Selecione os elementos que voc deseja excluir.
mantenha pressionada a tecla SHIFT e clique no ltimo elemento.
v Para selecionar os elementos por nvel de hierarquia, valor de atributo ou
padro de ortografia, consulte o Guia do Usurio do IBM Cognos TM1 .
2. Clique em Editar, Excluir Elemento.
exibida uma caixa de dilogo de confirmao que lista o nome da dimenso e
pergunta se voc tem certeza de que deseja excluir o objeto selecionado. Clique
em Sim para prosseguir com a excluso, clique em No ou em Cancelar para
cancelar a excluso.
Excluindo Elementos de uma Consolidao

Siga estas etapas para excluir elementos de uma consolidao.
Procedimento
1. Selecione os elementos que voc deseja excluir.
.
2. Clique em Editar, Excluir Elemento da Consolidao ou clique em Excluir
exibida uma caixa de dilogo de confirmao que lista o nome da dimenso e
pergunta se voc tem certeza de que deseja excluir o objeto selecionado. Clique
em Sim para prosseguir com a excluso, clique em No ou em Cancelar para
cancelar a excluso.
O TM1 exclui o elemento da consolidao e mantm qualquer outra instncia
do elemento na dimenso.
Nota: Se definir o elemento somente na consolidao, o TM1 tambm excluir
o elemento da dimenso.
19
Editando Propriedades do Elemento

possvel editar as propriedades do elemento para atribuir um novo peso a um
elemento de uma consolidao, ou alterar o tipo de elemento de um elemento de
nvel folha.
Nota: No possvel alterar o tipo de elemento de elementos consolidados, e no
possvel atribuir um peso de elemento a nenhuma instncia de um elemento que
no seja membro de uma consolidao.
Procedimento
1. Selecione o elemento.
2. Clique em Editar, Propriedades do Elemento.
A caixa de dilogo Propriedades do Elemento de Dimenso se abre.
3. Se necessrio, selecione um novo tipo de elemento da lista Tipo de Elemento.
4. Se necessrio, insira um novo Peso de Elemento.
5. Clique em OK.
Configurando a Ordem de Elementos em uma Dimenso

O TM1 permite configurar a ordem dos elementos em uma dimenso para
determinar o valor de ndice para cada elemento em uma dimenso. O primeiro
elemento em uma dimenso possui um valor de ndice de 1, o segundo elemento
possui um valor de ndice de 2, e assim por diante.
Configurar a ordem de elementos em uma dimenso um fator importante, pois
muitas funes do TM1 (planilha, regras e TurboIntegrator) fazem referncia aos
valores do ndice de elemento.
Nota: Se voc alterar a ordem de elementos em uma dimenso, as funes que
fazem referncia a valores de ndice de elementos retornaro valores novos e
possivelmente inesperados.
Procedimento
1. Ordene os elementos conforme deseja que eles apaream na dimenso.
possvel usar as opes de classificao e a funcionalidade arrastar e soltar do
Editor de Dimenso para alterar a ordem de elementos.
2. Clique no boto Configurar Ordem de Dimenso.
3. Clique em Dimenso, Salvar.
v Quando a propriedade de classificao da dimenso configurada em
Automtica, o TM1 solicita que altere a propriedade de classificao para
Manual.
v Quando a propriedade de classificao da dimenso configurada como
Manual, o TM1 insere quaisquer elementos includos na dimenso no local
em que os posicionou manualmente no Editor de Dimenso.
4. Clique em Sim para salvar a nova ordem de dimenso e configurar a
propriedade de classificao de dimenso como Manual.
possvel configurar a ordem de elementos, mesmo quando o Editor de
Dimenso exibir apenas um subconjunto de todos os elementos de dimenso.
Por exemplo, se voc tiver uma dimenso grande, talvez queira alterar e
configurar a ordem apenas de alguns elementos. Observe que, ao configurar a
ordem de elementos com apenas um subconjunto de elementos exibidos no
Editor de Dimenso, toda a dimenso ser afetada.
20
O seguinte exemplo mostra como configurar a ordem dos elementos ao

trabalhar com um subconjunto que afeta toda a dimenso no Editor de
Subconjunto.
Para simplificar, esta dimenso de amostra contm dez elementos com nomes
de uma nica letra, mas o conceito ilustrado neste exemplo aplicvel a
dimenses maiores e mais complexas.
v a
v b
v c
v d
v e
v f
v g
v h
v i
5. Agora, se voc selecionar os elementos c, d e g, em seguida, clicar em Editar,
Manter, o Editor de Dimenso conter apenas o subconjunto selecionado de
elementos.
6. Agora, voc decide se deseja alterar a ordem destes trs elementos. Voc deseja
que d seja o primeiro elemento e c o ltimo elemento.
7. Agora que os elementos aparecem na ordem desejada, clique em Configurar
.
Ordem da Dimenso
A ordem de elementos para toda a dimenso agora est configurada. Se olhar a
dimenso toda, ver que ela se abre no Editor de Dimenso da seguinte forma.
v i
v a
v
v
v
v
v
v
v
b
d
g
c
e
f
h
v i
Para o exemplo, ao configurar a ordem de elementos para um subconjunto, a
nova ordem afeta toda a dimenso da seguinte maneira:
v O subconjunto de elementos que estava ativo quando a ordem de elementos
foi configurada aparece com cones ocultos.
v O primeiro elemento do subconjunto mantm sua posio na dimenso em
relao a seu predecessor mais prximo.
v No exemplo, o elemento d o primeiro elemento no subconjunto durante a
configurao da ordem de elementos.
v O elemento b o predecessor mais prximo, exclusivo de elementos do
subconjunto, a d na dimenso, portanto, d agora segue b na estrutura da
dimenso.
v Os outros elementos do subconjunto aparecem na estrutura da dimenso
mantendo sua posio em relao ao primeiro elemento no subconjunto.
21
Configurando a Ordem de Elementos de Dimenso a partir do Server Explorer:

Tambm possvel configurar a ordem de elementos de dimenso a partir do
Server Explorer sem abrir o Editor de Dimenso. Tambm possvel selecionar
uma propriedade de classificao para a dimenso a partir destas trs ordens de
classificao automticas:
v Nome
v Nvel
v Hierarquia
Aps configurar a propriedade de classificao, o TM1 insere os elementos
includos na dimenso conforme sua posio na ordem de classificao. Por
exemplo, se configurar uma ordem de classificao automtica de Nome, o TM1
inserir os novos elementos na dimenso em ordem alfabtica.
Procedimento
1. Clique com o boto direito do mouse na dimenso no Server Explorer.
2. Clique em Configurar Ordem de Elementos.
A caixa de dilogo Ordenao de Elementos de Dimenso se abre.
3. Selecione um tipo de classificao.
Tipo de Classificao
Descrio
Automtico
Ativa as opes Classificao Automtica por: Nome, Nvel e

Hierarquia.
Manual
Ordena elementos conforme eles existem atualmente na

estrutura da dimenso e configura a propriedade de
classificao de dimenso como Manual.
4. Se voc selecionar o tipo de classificao Manual, v para a etapa 7.

5. Selecione uma opo Classificao Automtica por.
Classificar por
Descrio
Nome
Classifica elementos em ordem alfabtica
Nvel
Classifica elementos por nvel de hierarquia.
Hierarquia
Classifica elementos de acordo com a hierarquia da dimenso.
6. Se aplicvel, selecione uma Direo de Classificao.

7. Clique em OK.
Resultados
Agora voc configurou a ordem de elementos de dimenso. Quando abrir a
dimenso, voc ver os elementos por ordem, de acordo com a opo Classificar
por especificada na etapa 5.
Gerenciando a Exibio de Elementos no Editor de Dimenso

O Editor de Dimenso inclui vrios recursos que permitem gerenciar a forma de
exibio dos elementos. Por exemplo, ao trabalhar com dimenses grandes, pode
ser til exibir apenas os elementos de um determinado nvel de hierarquia, ou
talvez voc queira visualizar os elementos em ordem alfabtica.
22
Ao alterar a exibio de elementos no Editor de Dimenso voc no altera a

estrutura da dimenso, apenas altera a maneira como o TM1 apresenta os
elementos na janela.
As sees seguintes descrevem como gerenciar a exibio de elementos no Editor
de Dimenso.
Mantendo Elementos
Siga estas etapas para exibir apenas os elementos selecionados no Editor de
Dimenso.
Procedimento
1. Selecione os elementos que voc deseja exibir.
.
2. Clique em Editar, Manter ou clique em Manter
O Editor de Dimenso exibe apenas os elementos selecionados.
Ocultando Elementos
Siga estas etapas para ocultar os elementos selecionados no Editor de Dimenso.
Procedimento
1. Selecione os elementos que voc deseja ocultar.
.
2. Clique em Editar, Ocultar ou clique em Ocultar
O Editor de Dimenso oculta os elementos selecionados. Os demais elementos
permanecem visveis.
Classificando Elementos em Ordem Alfabtica

Os elementos no Editor de Dimenso podem ser classificados em ordem alfabtica
crescente ou decrescente.
Ordem de Classificao
Descrio
Ordem Alfabtica
Crescente
Clique em Editar, Classificar por, Crescente ou clique em

Classificao Crescente
Ordem Alfabtica
Decrescente
Clique em Editar, Classificar por, Decrescente ou clique em

Classificao Decrescente
Classificando Elementos por Valor de ndice

Os elementos podem ser classificados no Editor de Dimenso em ordem crescente
ou decrescente, de acordo com o valor de ndice.
23
Ordem de Classificao
Descrio
Valor de ndice em
Ordem Crescente
Clique em Editar, Classificar por, ndice em Ordem Crescente

ou clique em Classificar por ndice, Crescente
Valor de ndice em
Ordem Decrescente
Clique em Editar, Classificar por, ndice em Ordem

Decrescente ou clique em Classificar por ndice, Decrescente
Classificando Elementos por Hierarquia

Tambm possvel classificar elementos conforme eles aparecem na hierarquia da
dimenso.
Tipo de Classificao
Descrio
Conforme eles aparecem

na hierarquia da
dimenso
Clique em Editar, Classificar por, Hierarquia ou clique em

Classificao de Hierarquia
Visualizando Elementos por Alias

Se voc definiu um atributo de alias para uma dimenso, poder visualizar os
elementos por seus aliases no Editor de Dimenso.
As dimenses no diretrio Dados de Amostra do TM1 tm aliases definidos para
francs e alemo, portanto possvel visualizar todos os nomes de elementos por
seus equivalentes em idioma estrangeiro.
Procedimento
1. Abra a dimenso Ms no Editor de Dimenso.
2. Clique em Visualizar, Barras de Ferramentas, Alias para exibir a barra de
ferramentas Alias.
A barra de ferramentas Alias contm dois objetos: um boto de alternncia
Usar Aliases, para ativar ou desativar a exibio de aliases, e uma lista
Selecionar Alias, da qual possvel selecionar um alias.
3. Selecione Monat ('Ms' em alemo) da lista Selecionar Alias.
4. Clique no boto Usar Aliases.
Resultados
Por padro, o TM1 no exibe os aliases. O Editor de Dimenso agora exibe todos
os elementos por seus aliases em alemo.
Criando Dimenses Usando Planilhas de Dimenso

Uma planilha de dimenses uma planilha do Excel modificada, na qual voc lista
os elementos e relacionamentos hierrquicos para uma dimenso. O TM1 salva os
dados da planilha em dois arquivos: planilha de dimenses (dimname.xdi) e o
arquivo compilado (dimname.dim).
v Ao criar uma dimenso usando a janela Editor de Dimenso ou o
TurboIntegrator, o TM1 grava somente no arquivo dimname.dim (compilado).
v Ao modificar uma dimenso usando o Editor de Dimenso, o TM1 salva as
alteraes no arquivo .dim. Se um arquivo .xdi existir para a dimenso, o TM1
24
solicita que salve as alteraes na planilha de dimenses. Se voc no atualizar a

planilha de dimenses, a estrutura da dimenso no arquivo .dim ser diferente
da estrutura no arquivo .xdi.
v Para garantir que o TM1 tenha acesso a todas as alteraes de dimenso, crie e
mantenha dimenses com as planilhas de dimenso ou com o Editor de
Dimenso. No misture mtodos. Isto pode causar perda de dados.
Mantendo seus Dados Sincronizados

O TM1 salva os arquivos da planilha de dimenso no primeiro diretrio listado no
campo Diretrio de Dados do Servidor Local, na caixa de dilogo Opes.
Portanto, o TM1 poder salvar a planilha de dimenses (.xdi) em um diretrio
diferente daquele do arquivo de dimenso (.dim).
Nota: Tenha muita ateno ao editar dimenses usando planilhas. Existem vrias
maneiras nas quais os dados podem ser perdidos se voc no tomar as precaues
apropriadas. Os exemplos a seguir mostram duas maneiras nas quais voc pode
perder dados de dimenso.
v Na segunda-feira, voc edita uma planilha de dimenses para a dimenso
Conta1 e salva a dimenso. Na tera-feira, outro administrador usa o Editor de
Dimenso para fazer mudanas na dimenso. As mudanas feitas por ele no
so propagadas para o arquivo de planilha de dimenses. Na quarta-feira, voc
faz outra mudana na dimenso usando a planilha de dimenses desatualizada.
Suas mudanas sobrescrevem as mudanas feitas pelo outro administrador.
v Dois administradores decidem atualizar uma dimenso no mesmo servidor
usando duas planilhas de dimenses diferentes. Isto muito perigoso. O TM1
pode sobrescrever as alteraes muito facilmente. Use um conjunto de planilhas de
dimenses. Tente evitar ter mais de um arquivo .xdi para qualquer dimenso.
Para evitar confuso e possvel perda de dados, tome precaues ao editar
planilhas de dimenso. recomendvel usar um dos seguintes procedimentos.
v Use o diretrio de dados do servidor remoto para armazenar as planilhas de
dimenso.
v Use um diretrio especial para armazenar suas planilhas de dimenso.
Usando o Diretrio de Dados do Servidor Remoto:
Para editar as planilhas de dimenso no diretrio de dados do servidor no servidor
remoto, siga estas etapas.
Procedimento
1. Configure o Diretrio de Dados do Servidor Local na caixa de dilogo Opes
para o diretrio de dados usado por seu IBM Cognos TM1 server remoto.
2. Desative a opo Conectar ao Servidor Local na Inicializao.
3. Verifique se os servidores locais em execuo em seu computador foram
encerrados.
4. Efetue login no TM1 server remoto.
5. Faa todas as modificaes em suas dimenses usando os arquivos de planilha
no diretrio de dados do servidor remoto.
6. Clique em TM1, Planilhas de Dimenses, Salvar no Excel.
O TM1 grava o arquivo .dim e o arquivo .xdi no diretrio de dados do servidor
remoto.
Usando um Diretrio de Planilha:
25
Usando um diretrio de planilha especial, possvel restringir precisamente o

acesso s suas planilhas de dimenses. Isto pode ser muito til em instalaes que
seguem especificaes de segurana. Para configurar um diretrio de planilha, siga
estas etapas.
Procedimento
1. Crie um diretrio de planilha em algum lugar no sistema de arquivos.
2. Mova todos os seus arquivos de planilha (.xdi para dimenses e .xru para
regras) para o diretrio de planilha.
3. Configure o Diretrio de Dados do Servidor Local na caixa de dilogo Opes
como o diretrio de planilha.
4. Conecte-se ao servidor remoto que contm a dimenso que voc deseja
atualizar e a quaisquer outros servidores desejados.
5. Faa todas as modificaes em suas dimenses usando os arquivos de planilha
no diretrio de planilha.
6. Clique em TM1, Planilhas de Dimenses, Salvar no Excel.
A caixa de dilogo Selecionar Nome do Servidor se abre.
7. Selecione o servidor no qual voc deseja salvar a dimenso compilada.
8. Clique em OK.
Criando Planilhas de Dimenso

Siga estas etapas para criar uma dimenso usando planilhas de dimenso.
Procedimento
1. Clique em TM1,Planilhas de Dimenses, Novo no Excel.
A caixa de dilogo Criar uma Dimenso se abre.
2. Na caixa superior, insira um nome para a dimenso, da seguinte forma:
v Para criar uma dimenso em seu servidor local, digite o nome da dimenso.
Por exemplo: Produto.
v Para criar uma dimenso em um servidor remoto, digite o nome do servidor,
dois pontos e, em seguida, o nome da dimenso. Por exemplo,
vendas:Produto cria a dimenso Produto no servidor de vendas.
Nota: Voc deve ser o administrador do TM1 para criar uma dimenso em um
servidor remoto.
3. Clique em OK.
aberta uma planilha de dimenses em branco no Excel.
26
Preenchendo Planilhas de Dimenses

A planilha a seguir define a estrutura para uma dimenso Ms.
As sees a seguir descrevem como definir elementos simples e consolidados em

uma planilha de dimenses.
Definindo Elementos Simples:
Inicie o preenchimento da planilha de dimenses definindo os elementos simples
(de nvel folha) da dimenso, iniciando na linha 1.
Procedimento
1. Na coluna A, especifique o tipo de elemento.
v Para elementos numricos, digite N.
v Para elementos de sequncia, digite S.
No exemplo, todos os elementos so numricos.
2. Na coluna B, digite o nome de um elemento.
27
Definindo Elementos Consolidados:

Depois de definir os elementos simples na dimenso, voc poder definir os
elementos consolidados.
Procedimento
1. Em uma linha vazia abaixo do ltimo elemento simples, digite C na coluna A.
2. Digite o nome do elemento consolidado na coluna B.
3. Em linhas subsequentes, digite os nomes dos filhos do elemento consolidado na
coluna B.
Por exemplo, o seguinte resumo de uma planilha de dimenses mostra o
elemento consolidado 1 Trimestre definido como a consolidao dos filhos Jan,
Fev e Mar.
Pesando Elementos em uma Consolidao:

Use a coluna C para pesar os elementos em uma consolidao. Para calcular a
Margem Bruta, por exemplo, subtraia Custos Variveis de Vendas. Para expressar
este clculo, atribua o peso -1 ao elemento Custos Variveis na consolidao. A
planilha a seguir mostra o peso na dimenso Conta1.
28
Salvando Planilhas de Dimenso

Para salvar a planilha de dimenses e compilar a dimenso, clique em TM1,
Planilha de Dimenso, Salvar em Excel. O TM1 atualiza o arquivo de planilha de
dimenses (dimname.xdi) e cria o arquivo de dimenso compilado (dimname.dim).
Nota: Certifique-se de no usar Arquivo, Salvar no Excel. Esta ao salva somente
o arquivo .xdi; o TM1 no compila a dimenso e salva o arquivo .dim.
Usando Nveis de Hierarquia Nomeada com Dimenses do

TM1
possvel atribuir seus prprios nomes customizados aos nveis de hierarquia de
uma dimenso do TM1 usando o cubo de controle }HierarchyProperties. Os
nveis nomeados criados podem, ento, ser usados ao acessar externamente os
dados do TM1 com IBM Cognos Report Studio, instrues MDX ou outras
ferramentas MDX OLAP. Tambm possvel atribuir um membro padro para a
dimenso.
Por exemplo, em vez de usar os nomes genricos de nvel de hierarquia de
level000, level001, level002, voc pode atribuir nomes que descrevem os nveis em
uma dimenso Clientes, conforme mostrado na tabela a seguir.
Nveis de Dimenso do TM1
Nveis de Dimenso Nomeados de Exemplo
nvel000
Todos
nvel001
Estado
nvel002
Cidade
nvel003
Individual
Configurando Nveis Nomeados

Use o cubo de controle }HierarchyProperties para configurar nveis nomeados.
Para obter detalhes adicionais sobre o cubo de controle }HierarchyProperties,
consulte a seo sobre os cubos de controle no Guia de Operaes do IBM Cognos
TM1
29
Procedimento
1. No TM1 Architect, clique no menuVisualizar e selecione Exibir Objetos de
Controle.
2. Na rea de janela de navegao, clique para expandir o n Cubos.
3. Clique duas vezes no cubo de controle }HierarchyProperties.
O cubo de controle }HierarchyProperties se abre.
4. Clique na lista de dimenses de ttulos para selecionar a dimenso para a qual
voc deseja atribuir nveis nomeados.
5. Na clula defaultMember, insira um nome de elemento existente para ser
definido como o membro padro para esta dimenso.
O nome do elemento inserido aqui pode filtrar a dimenso quando os dados do
TM1 so recuperados de um aplicativo externo como o IBM Cognos Report
Studio.
Insira o nome do elemento superior na hierarquia da dimenso para que todos
os elementos de dimenso sejam recuperados por padro.
Por exemplo, defina Mundo como o membro padro para a dimenso Regio.
6. Nas clulas level000 a level020, insira seu prprio nome customizado para
cada nvel de hierarquia existente na dimenso.
Nota: Os nveis nomeados so limitados a um comprimento de 255 caracteres
de byte nico. Para obter detalhes, consulte Limite de Comprimento de
Sequncia para Nveis Nomeados.
7. Depois de configurar nveis nomeados, necessrio proceder de uma das
seguintes formas para aplicar as mudanas:
v Reinicie o IBM Cognos TM1 server ou
v Execute a funo RefreshMdxHierarchy em um processo do TurboIntegrator.
Para obter detalhes, consulte Usando a Funo RefreshMdxHierarchy do
TurboIntegrator com Nveis Nomeados na pgina 31.
Resultados
Nota: As alteraes em nomes de elementos ou na estrutura da dimenso no so
automaticamente detectadas pelo recurso de nveis nomeados. Se a dimenso for
alterada, primeiro ser necessrio atualizar manualmente as designaes de nvel
nomeado no cubo de controle }HierarchyProperties e, ento, reiniciar o TM1 server
ou executar a funo RefreshMdxHierarchy do TurboIntegrator para atualizar as
hierarquias MDX no TM1 server .
Limite de Comprimento de Sequncia para Nveis Nomeados

Os nveis nomeados so limitados a um comprimento de 255 caracteres de byte
nico. Mesmo que o cubo de controle }HierarchyProperties suporte sequncias
longas, as instrues MDX podem retornar um erro com nveis nomeados com
mais de 255 caracteres.
Se inserir um nvel nomeado com um comprimento maior do que 255 caracteres de
byte nico, o TM1 exibir um erro quando o servidor for iniciado:
4648 ERRO 27-06-2008 13h50min04,532s TM1. Nome do nvel definido pelo
Usurio da Hierarquia modificado a partir de ...
30
Usando a Funo RefreshMdxHierarchy do TurboIntegrator com

Nveis Nomeados
Depois de configurar ou editar os nveis nomeados no cubo de controle
}HierarchyProperties, use a funo RefreshMdxHierarchy para atualizar as
hierarquias MDX no servidor TM1 sem precisar reiniciar o servidor.
Procedimento
1. Crie um novo processo do TI.
2. Insira a funo RefreshMdxHierarchy na guia Prlogo usando o seguinte
formato:
RefreshMdxHierarchy(dimensionName)
em que o parmetro opcional, dimensionName, pode especificar uma dimenso

especfica para atualizao ou pode ficar em branco para atualizar todas as
dimenses.
Por exemplo, para atualizar todas as dimenses:
RefreshMdxHierarchy();
Para atualizar apenas a dimenso de clientes:

RefreshMdxHierarchy(customers);
3. Execute o processo do TI.
Criando Cubos
Sempre possvel criar cubos em seu servidor local. Voc deve ser o administrador
do TM1 para criar cubos em servidores remotos.
Existem duas maneiras de criar cubos:
v Cubo Vazio - Selecione de uma lista de dimenses existentes na janela Criando
Cubo, para criar um novo cubo sem dados.
v Origens de Dados Externas - Use o TurboIntegrator para identificar e mapear
dimenses e dados de uma origem de dados externa para um cubo novo ou
existente.
Esta seo documenta a criao de cubos na janela Criando Cubo. Para obter
informaes sobre a criao de cubos no TurboIntegrator, consulte o Guia do
TurboIntegrator do IBM Cognos TM1 .
Ordenando Dimenses em um Cubo

As dimenses em um cubo possuem uma ordem selecionada durante a criao de
um cubo. A ordem selecionada pode afetar o desempenho do sistema, portanto,
necessrio considerar a ordem de dimenses antes de criar um cubo.
Como uma primeira etapa relacionada ordenao de dimenses, divida as
dimenses em dois grupos: dimenses esparsas e densas. Uma dimenso densa
tem uma alta porcentagem de valores para seus elementos. possvel estimar a
densidade respondendo a esta pergunta: Se um elemento na dimenso tiver um
valor, mantendo os elementos das outras dimenses constantes, qual a
probabilidade dos outros elementos na dimenso terem valores?
Por exemplo, se voc tiver um oramento em Janeiro para uma determinada conta
e regio, provavelmente tambm ter um valor para os meses restantes. Portanto, a
dimenso Ms provavelmente densa. De forma semelhante, se voc tiver um
valor de oramento para um determinado ms, conta e regio, provavelmente
tambm ter um valor real, tornando ActVsBud uma dimenso densa.
31
No entanto, em um cubo de vendas global, provavelmente voc no vender todos

os produtos em todas as regies. Portanto, voc trataria Produto e Regio como
dimenses esparsas.
Geralmente recomendvel ordenar as dimenses da seguinte forma: da menos
esparsa mais esparsa, seguidas da menos densa mais densa. No entanto,
necessrio ter alguma flexibilidade. Por exemplo, provavelmente melhor colocar
uma dimenso muito pequena e densa, como ActVsBud, que possui apenas dois
ou trs elementos antes de uma dimenso muito grande, mas esparsa, como
Produto, que pode ter milhares de elementos.
Criando um Cubo
Siga estas etapas para criar um cubo.
Procedimento
1. Abra o Server Explorer.
2. Na rea de janela em rvore, selecione Cubos, abaixo do servidor no qual
voc deseja criar o cubo.
3. Clique em Cubos, Criar Novo Cubo.
A caixa de dilogo Criando Cubo se abre. A caixa Dimenses Disponveis,
esquerda, lista as dimenses armazenadas no servidor.
4. Digite um nome de cubo no campo Nome do Cubo.
Nota: Se no digitar um nome, o TM1 nomear o novo cubo Sem Nome.
5. Na caixa Dimenses Disponveis, clique duas vezes no nome da dimenso
que voc deseja usar como a primeira dimenso no novo cubo.
O nome da dimenso movido para a caixa Dimenses no novo cubo.
para mover os nomes selecionados da
Tambm possvel usar o boto
caixa Dimenses Disponveis para a caixa Dimenses no novo cubo. Para
selecionar vrios nomes adjacentes, clique e arraste entre os nomes. Para
selecionar vrios nomes no adjacentes, mantenha pressionada a tecla CRTL e
clique em cada nome.
6. Repita o processo de seleo para todas as dimenses que voc deseja incluir
no novo cubo. necessrio selecionar pelo menos duas dimenses. O nmero
mximo de dimenses 256.
e para baixo , reorganize as dimenses, se
7. Usando as setas para cima
necessrio. Para remover uma dimenso da lista, clique duas vezes no nome
da dimenso.
8. Se desejar especificar as propriedades do cubo, clique em Propriedades. Se
no desejar atribuir as propriedades do cubo, v para a etapa 13.
A caixa de dilogo Propriedades do Cubo se abre.
Daqui, possvel definir as dimenses Medidas e Tempo para o cubo, e
especificar se o cubo foi carregado automaticamente ou on demand.
Nota: O OLE DB para clientes OLAP pode incluir provises para fazer
referncia s dimenses Medidas e Hora. O TM1 no faz referncia s
dimenses Medidas e Tempo, mas permite que configure essas propriedades
para outros clientes OLAP que possam acessar o cubo.
9. Para definir uma dimenso Medidas, selecione uma dimenso da lista
Dimenso Medidas.
32
10. Para definir uma dimenso Tempo, selecione uma dimenso da lista
Dimenso Tempo.
11. Especifique como carregar o cubo:
v Para carregar o cubo na memria do servidor apenas quando um cliente
solicitar dados do cubo, selecione a caixa Carregar On Demand.
v Para carregar automaticamente o cubo na memria quando o servidor for
iniciado, limpe a caixa Carregar On Demand.
12. Clique em OK para salvar as propriedades e retornar caixa de dilogo
Criando Cubo.
13. Clique em Criar Cubo para criar o cubo.
A janela Server Explorer se abre. O novo cubo exibido em ordem alfabtica
na lista Cubos na rea de janela em rvore.
Otimizando a Ordem de Dimenses em um Cubo

Se no estiver extremamente familiarizado com seus dados de negcios, possvel
especificar uma ordem de dimenses durante a criao do cubo que resulte em um
desempenho abaixo do ideal. De forma semelhante, possvel que a distribuio
de dados em um cubo seja alterada no decorrer do tempo, tornando a ordem de
dimenses especificada durante a criao do cubo abaixo da ideal. Para tratar estes
problemas, o TM1 inclui um recurso que permite otimizar a ordem de dimenses
em um cubo, consumindo, portanto, menos memria e melhorando o desempenho.
Quando a ordem das dimenses em um cubo otimizada, o TM1 no altera a
ordem real das dimenses na estrutura do cubo. O TM1 altera a maneira como as
dimenses so ordenadas internamente no servidor, mas como a estrutura do cubo
no alterada, as regras, funes ou aplicativos que fazem referncia ao cubo
permanecem vlidas.
Conforme voc altera a ordem de dimenses, pode visualizar instantaneamente um
relatrio detalhando o impacto de suas mudanas no consumo de memria do
cubo.
Pelas seguintes razes, necessrio otimizar a ordem de dimenses em um cubo
apenas em um ambiente de desenvolvimento durante a tentativa de determinar a
configurao ideal do cubo:
v So necessrios recursos de memria expressivos para que o IBM Cognos TM1
server reconfigure a ordem das dimenses em um cubo. Durante o processo de
reordenao, a RAM temporria no TM1 server aumentada por um fator de
dois para o cubo que est sendo reordenado. Por exemplo, um cubo de 50 MB
requer 100 MB de RAM para reconfigurao.
v A reordenao coloca um bloqueio de leitura no servidor, bloqueando todos os
pedidos do usurio durante a execuo da reordenao.
Nota: Voc deve ser um membro do grupo ADMIN para otimizar a ordem das
dimenses nos cubos. A opo de otimizao est disponvel apenas para cubos em
servidores remotos; no possvel otimizar a ordem das dimenses em cubos em
um servidor local. Alm disso, ao otimizar a ordem de dimenses em um cubo,
voc no deve mover as dimenses da sequncia da ltima posio, nem mover as
dimenses da sequncia para a ltima posio.
Procedimento
1. Na rea de janela em rvore do Server Explorer, selecione o cubo que voc
deseja otimizar.
33
2. Clique em Cubo, Reordenar Dimenses.

A caixa de dilogo Otimizador de Cubo se abre.
3. Selecione uma dimenso na caixa de listagem Nova Ordem de Dimenses.
ou para baixo
para alterar a ordem da
4. Clique nas setas para cima
dimenso no cubo.
5. Clique em Testar.
Observe o valor junto ao rtulo Mudana em Porcentagem. Se este valor for
negativo, a nova ordem de dimenses consumir menos memria e, portanto,
ser mais eficiente.
6. Repita as etapas 3 a 5 at obter a ordenao mais eficiente de dimenses.
7. Clique em OK.
Editando Propriedades do Cubo

O TM1 permite configurar as propriedades do cubo que especificam dimenses de
medidas e de tempo usadas por aplicativos OLE DB para OLAP e que determinam
se um cubo carregado automaticamente ou on demand. Geralmente, voc define
estas propriedades do cubo ao criar um cubo, mas pode editar as propriedades a
qualquer momento.
Editando Dimenses de Medidas e do Tempo

Os aplicativos clientes OLE DB para OLAP incluem provises para as dimenses
de medidas e do tempo. Mesmo que os clientes do TM1 no incluam essas
provises, possvel usar o TM1 para configurar dimenses de medidas e do
tempo para cubos acessados por clientes OLE DB para OLAP.
Procedimento
1. Selecione o cubo na rea de janela em rvore do Server Explorer.
2. Clique em Cubo, Propriedades.
3. Selecione uma dimenso de medidas na lista Dimenso de Medidas.
4. Selecione uma dimenso do tempo na lista Dimenso do Tempo.
5. Clique em OK.
Editando a Propriedade de Carregamento on Demand

Por padro, o TM1 carrega todos os cubos na memria quando um servidor
iniciado. Embora isso permita o acesso rpido a dados do TM1, pode consumir
importantes recursos do servidor. Se seu servidor contiver cubos acessados com
pouca frequncia, voc poder preservar recursos definindo esses cubos para serem
carregados apenas quando um cliente tentar acessar os dados do cubo.
Procedimento
1. Selecione o cubo na rea de janela em rvore do Server Explorer.
2. Clique em Cubo, Propriedades.
3. Especifique como carregar o cubo:
v Selecione a caixa Carregar On Demand para carregar o cubo on demand.
v Limpe a caixa Carregar On Demand para carregar automaticamente o cubo
quando o servidor for iniciado.
4. Clique em OK.
34
Criando Listas de Seleo

Uma lista de seleo uma lista de valores vlidos para um elemento ou clula de
cubo especfica. Quando um administrador define uma lista de seleo para um
elemento ou uma clula, um menu suspenso que contm os valores definidos
torna-se disponvel na clula especificada ao navegar em um cubo em qualquer um
dos clientes do TM1 .
Os valores em clulas contendo uma lista de seleo so validados; um usurio
deve selecionar um dos valores predefinidos para a clula. Se um usurio tentar
inserir um valor invlido para a clula, aparecer um erro indicando que apenas os
valores da lista de seleo podem ser inseridos na clula.
Observaes de Uso da Lista de Seleo

necessrio estar ciente dos seguintes requisitos e comportamentos ao usar listas
de seleo.
v As edies de clulas aplicadas por meio de operaes de difuso de dados e de
processos do TurboIntegrator no so validadas. As edies aplicadas por meio
de qualquer um destes mtodos podem resultar em valores de clulas que no
esto em conformidade com valores vlidos da lista de seleo. A difuso de
dados pode ser aplicada em Clulas que contm listas de seleo somente por
meio de caixas de dilogo de difuso de dados; os atalhos de difuso de dados
no podem ser usados em clulas que contm listas de seleo.
v Ao definir uma lista de seleo que contenha valores numricos, necessrio
usar o estilo Invariante Cultural, que usa um ponto (.) como um separador
decimal. O estilo Invariante Cultural equivalente ao estilo ingls.
v Ao usar listas de seleo com o Excel 2007, voc deve ter o Excel 2007 Service
Pack 2 instalado, se desejar usar listas de seleo juntamente com o modo de
clculo automtico. Se voc estiver executando Excel 2007 sem o Service Pack 2,
deve configurar o modo de clculo do Excel para manual. O uso do clculo
automtico na ausncia do Service Pack 2 pode resultar em erros de acesso em
clulas contendo listas de seleo.
v No use aspas duplas em um valor da lista de seleo que possa ser visualizado
no TM1 Web Cube Viewer. No TM1 Web, os valores da lista de seleo que
contm aspas duplas impedem a exibio de contedos na lista de seleo e
podem inutilizar a exibio. As aspas duplas em listas de seleo funcionam
corretamente em Planilhas da Web do TM1 .
v Todas as listas de seleo no TM1 Web contm automaticamente um valor nulo
selecionvel. Para tornar valores nulos disponveis em listas de seleo no TM1
Architect e no TM1 Perspectives, necessrio definir explicitamente um valor
nulo em uma lista de seleo esttica. Os valores nulos no podem ser usados
em listas de seleo de dimenso ou de subconjunto no TM1 Architect e no TM1
Perspectives .
Tipos de Listas de Seleo

possvel criar trs tipos de listas de seleo: esttica, de subconjunto e de
dimenso.
Listas de Seleo Estticas

Uma lista de seleo esttica composta de uma lista delimitada por vrgula de
valores que utilizam a sintaxe static:value1:value2:value3:value4.
Por exemplo, static:red:orange:yellow:green resulta em uma lista de seleo que
contm os valores vermelho, laranja, amarelo e verde.
35
Para incluir um valor nulo em uma lista de seleo esttica, inclua dois pontos
consecutivos sem caracteres intermedirios na definio de lista de seleo. Por
exemplo, static:value1:value2:value3:value4:: resulta em uma lista de seleo
com um valor nulo no final.
Listas de Seleo de Subconjunto

Uma lista de seleo de subconjunto contm valores correspondentes a todos os
elementos de um subconjunto nomeado. Se os membros do subconjunto forem
alterados, os valores disponveis na lista de seleo sero alterados de forma
correspondente.
Uma lista de seleo de subconjunto definida usando a sintaxe
subset:dimension_name:subset_name.
Por exemplo, subset:Products:Winter resulta em uma lista de seleo que contm
todos os elementos do subconjunto Inverno da dimenso Produtos.
Listas de Seleo de Dimenso

Uma dimenso de seleo de subconjunto contm valores correspondentes a todos
os elementos de uma dimenso. Se os membros da dimenso forem alterados, os
valores disponveis na lista de seleo sero alterados de forma correspondente.
Uma lista de seleo de dimenso definida usando a sintaxe
dimension:dimension_name.
Por exemplo, o dimension:Months resulta em uma lista de seleo contendo todos
os elementos da dimenso Meses.
Criando Listas de Seleo com Atributos de Elementos

A maneira mais fcil de criar uma lista de seleo definir um atributo de texto
chamado Lista de Seleo para uma dimenso. possvel ento especificar os
membros de uma lista de seleo para cada elemento na dimenso, usando
qualquer um dos tipos de lista de seleo descritos acima. Quando um elemento
tiver uma lista de seleo definida, qualquer clula de cubo identificada por esse
elemento exibir uma lista suspensa contendo os valores de lista de seleo.
Procedimento
1. No Server Explorer, clique com o boto direito do mouse na dimenso para a
qual voc deseja definir listas de seleo, em seguida, clique em Editar
Atributos de Elementos.
2. No Editor de Atributos, clique em Editar, Incluir Novo Atributo.
3. Na caixa de dilogo Novo Atributo, insira Lista de Seleo como o nome do
atributo.
4. Selecione Texto como o tipo de atributo.
5. Clique em OK.
O Editor de Atributos agora contm uma nova coluna chamada Lista de
Seleo.
6. Para cada elemento para o qual voc deseja criar uma lista de seleo, insira
uma definio vlida de lista de seleo na interseo do nome de elemento e
da coluna Lista de Seleo.
a. Para inserir uma lista de seleo esttica, insira uma lista delimitada por
vrgulas de valores usando a sintaxe static:value1:value2:value3:value4.
36
b. Para inserir uma lista de seleo de subconjunto, insira a definio de lista

de seleo usando a sintaxe subset:dimension_name:subset_name.
c. Para inserir uma lista de seleo de dimenso, insira a definio de lista de
seleo usando a sintaxe dimension:dimension_name.
7. Clique em OK para fechar o Editor de Atributos e salvar as definies da lista
de seleo.
Criando Listas de Seleo com Cubos de Controle

Tambm possvel criar listas de seleo com cubos de controle. Isto oferece maior
controle sobre quais clulas de cubo devem conter listas de seleo e permite maior
flexibilidade na definio de listas de seleo para clulas individuais. Tambm
possvel criar regras para o cubo de controle de lista de seleo, que permite
definir listas de seleo para qualquer seo de um cubo, de uma nica clula ao
cubo inteiro.
Um cubo de controle de lista de seleo composto das mesmas dimenses s
quais o cubo regular est associado, juntamente com uma dimenso adicional
chamada }Picklist. A dimenso }Picklist contm um nico elemento de sequncia,
chamado Valor.
Criando um Cubo de Controle de Lista de Seleo

Use este procedimento para criar um cubo de controle de lista de seleo.
Procedimento
No Server Explorer, clique com o boto direito no cubo regular para o qual voc
deseja criar um cubo de controle de lista de seleo e, em seguida, em Criar Cubo
de Lista de Seleo.
criado um novo cubo de controle usando a conveno de nomenclatura
}Picklist_cubename. Por exemplo, ao criar um cubo de controle de lista de seleo
para o cubo Orders, o cubo de controle chamado }Picklist_Orders.
Nota: Se no puder visualizar cubos de controle no Server Explorer, clique em
Visualizar, Exibir Objetos de Controle para ativar a exibio de cubos de controle
e outros objetos de controle.
Definindo Listas de Seleo para Clulas Individuais em um

Cubo de Controle
Siga estas etapas para definir listas de seleo para clulas individuais em um cubo
de controle. As listas de seleo definidas no cubo de controle so usadas para
exibir valores de lista de seleo no cubo regular associado.
Procedimento
1. Clique duas vezes no cubo de controle no Server Explorer.
O cubo de controle aberto no Cube Viewer.
2. Configure a visualizao do cubo de controle conforme necessrio para
visualizar as clulas para as quais voc deseja definir listas de seleo. Para
obter detalhes sobre a configurao das visualizaes de cubo, consulte
"Trabalhando com Visualizaes de Cubo" no Guia do Usurio do IBM Cognos
TM1 .
3. Em cada clula para a qual voc deseja criar uma lista de seleo, insira uma
definio de lista de seleo. possvel inserir qualquer um dos tipos de lista
de seleo no cubo de controle: esttica, de subconjunto ou de dimenso.
4. Clique em Arquivo, Recalcular para recalcular a visualizao de cubo.
37
Usando Regras para Definir Listas de Seleo em um Cubo de

Controle
As regras que definem as listas de seleo seguem as mesmas convenes que
todas as outras regras do TM1 . Como outras regras do TM1, uma instruo de
regra que define uma lista de seleo deve incluir uma definio de rea (a parte
do cubo qual a regra se aplica), um qualificador de sequncia e uma frmula. No
caso de regras de lista de seleo, a frmula apenas a definio de lista de
seleo que voc deseja aplicar.
Como em todas as outras regras do TM1, quando mltiplas instrues de regras se
aplicam sobreposio de reas, as instrues devem ser ordenadas da rea mais
restritiva rea menos restritiva.
Para obter informaes adicionais sobre a criao de regras, incluindo detalhes
sobre uma definio de rea, consulte o Guia de Regras do IBM Cognos TM1 .
Procedimento
1. No Server Explorer, clique com o boto direito do mouse no }Cubo de controle
da lista de seleo para o qual voc deseja criar uma regra e, ento, clique em
Criar Regra.
O Editor de Regras se abre.
2. Usando uma definio de rea de regras padro, especifique as clulas nas
quais voc deseja que a lista de seleo aparea.
3. Imediatamente aps a definio de rea, digite =S:. Este o qualificador de
sequncia, que indica que a regra aplicvel a clulas de sequncia.
4. Imediatamente aps o qualificador de sequncia, insira uma definio de lista
de seleo, entre aspas simples, em seguida, coloque entre parnteses. Por
exemplo, (static:spring:summer:winter:fall).
5. Imediatamente aps a definio de lista de seleo, digite um ponto e vrgula
(;) para finalizar a instruo de regra.
Usar o procedimento descrito nestas etapas deve resultar em uma instruo de
regra semelhante ao exemplo a seguir, o que indica que a clula identificada
pelo elemento de malha exibir uma lista de seleo esttica contendo valores
de l, algodo, seda e nylon.
[fabric]=S:(static:wool:cotton:silk:nylon);
Outros Exemplos de Regras de Lista de Seleo:
Os exemplos a seguir ilustram instrues de regras que definem listas de seleo.
38
Instruo de Regra
Descrio
[size,shirts]=S:(static:16:17:18);
Essa instruo de regra indica que qualquer

clula identificada pelos elementos tamanho
e camadas exibir uma lista de seleo
esttica composta por valores de 16 17 e 18.
[size,{sweaters,vests,jackets}]=
S:(static:XS:S:M:L:XL);
Esta instruo de regra indica que qualquer

clula identificada pelo elemento tamanho e
qualquer dos elementos suteres, coletes ou
jaquetas exibir uma lista de seleo esttica
composta dos valores PP, P, M, G e GG.
Instruo de Regra
Descrio
[fabric]=S:(dimension:materials);
Esta instruo de regra indica que qualquer

clula identificada pelo elemento malha
exibir uma lista de seleo composta de
todos os elementos na dimenso de
materiais.
Excluindo Clulas de Listas de Seleo

Pode haver algumas circunstncias em que voc no deseja que uma clula
individual ou uma rea especfica de um cubo use listas de seleo. Para evitar que
uma clula exiba uma lista de seleo, insira none na clula de cubo de controle de
lista de seleo apropriada ou use ('none') como a frmula em uma instruo de
regras. Por exemplo, ['season']=S:('none');.
Valores Nulos em Listas de Seleo

Todas as listas de seleo no TM1 Web (Planilhas da Web e Cube Viewer) sempre
contm um valor nulo que um usurio pode selecionar. O valor nulo
automaticamente inserido em todas as listas de seleo no TM1 Web; ele no
precisa ser explicitamente definido.
Listas de seleo em TM1 Architect e TM1 Perspectives contm somente um valor
nulo se a lista de seleo for do tipo esttica e um valor nulo tiver sido
explicitamente definido para a lista de seleo. As listas de seleo de dimenso e
de subconjunto jamais podero conter um valor nulo quando usadas no TM1
Architect e no TM1 Perspectives .
Selecionando Valores Nulos em Listas de Seleo

Existem duas maneiras de selecionar valores nulos de listas de seleo.
Procedimento
1. Em qualquer um dos clientes TM1 , possvel clicar na lista de seleo e, ento,
clicar no valor nulo.
Importante: Em fatias TM1 Perspectives e Active Forms, no clique no valor
nulo em uma clula de sequncia. Isso eliminar a frmula DBRW da clula e
voc no conseguir mais recuperar os dados para essa clula a partir do IBM
Cognos TM1 server . possvel clicar seguramente no valor nulo em clulas
numricas.
2. No TM1 Web and Architect, possvel pressionar a chave Excluir em uma
clula que contenha uma lista de seleo para selecionar o valor nulo.
Importante: No pressione Excluir para selecionar um valor nulo em fatias do
TM1 Perspectives ou Active Forms. Isso excluir a frmula DBRW da clula e
voc no conseguir mais recuperar os dados para essa clula a partir do TM1
server .
Ordem de Precedncia de Listas de Seleo

Quando vrias listas de seleo se aplicam a uma clula de cubo individual, a
seguinte ordem de precedncia usada para determinar qual lista de seleo
usada na clula:
v Se um cubo de controle de lista de seleo existir e contiver uma definio de
lista de seleo para a clula de cubo atual, ser usada a definio no cubo de
controle de lista de seleo.
39
v Se um cubo de controle de lista de seleo no existir, os elementos que

identificam a clula atual so examinados em ordem reversa em uma procura
por atributos de elemento de Lista de Seleo. O primeiro atributo de elemento
de Lista de Seleo encontrado nesta procura usado na clula.
Replicando Cubos Entre Servidores

Usando o recurso do TM1 Replication, possvel copiar os cubos e outros objetos
associados de um servidor remoto para o servidor local ou entre dois servidores
remotos. Tambm possvel sincronizar as atualizaes de dados entre os cubos
copiados, em intervalos de tempo especificados ou on demand.
A replicao oferece as seguintes vantagens:
v Aprimora o tempo de resposta, porque possvel atualizar um cubo localmente,
sem comunicao em uma rede.
v Permite copiar os dados compartilhados mais recentes para um laptop para
apresentaes fora de sua organizao.
O TM1 fornece sincronizao bidirecional para dados replicados. Durante o
processo de sincronizao, o TM1 verifica os servidores envolvidos em uma
replicao para obter as atualizaes e os dados mais recentes e, ento, copia as
atualizaes mais recentes em outros servidores.
A replicao cria um relacionamento entre dois cubos e entre dois servidores. Estes
relacionamentos so descritos em Relacionamentos de Cubos.
Relacionamentos de Cubos
A replicao cria um relacionamento entre dois cubos:
v Cubo de origem - O cubo original em uma replicao
v Cubo de espelho - Uma cpia do cubo de origem
Dependendo de seus privilgios de acesso, voc pode replicar um nico cubo em
muitos servidores diferentes, e pode replicar um cubo replicado.
Relacionamentos de Servidores
Antes de replicar um cubo, necessrio efetuar logon em um servidor remoto e
criar uma conexo de replicao. A replicao cria um relacionamento entre dois
servidores:
v Servidor de origem - O servidor remoto no qual voc efetua login
v Servidor de destino - O servidor a partir do qual voc efetuou login
A janela Server Explorer lista as conexes de replicao atuais abaixo do cone
Replicaes. Neste exemplo, regio 1 o servidor de destino e vendas um
servidor de origem.
Privilgios de Acesso Necessrios

Os seguintes privilgios de acesso so necessrios para replicar um cubo:
v Seu grupo de segurana deve ter acesso Read ou superior para o cubo que voc
deseja replicar.
v Voc deve ser o administrador do TM1 no servidor de destino. No servidor
local, voc sempre o administrador do TM1 .
40
Captulo 3. Clculos Avanados para Dados de Negcios

Esta seo descreve como criar processos e regras de "drill through", que permitem
vincular as clulas a dados relacionados para fornecer os detalhes ou contexto para
valores de cubo.
Para um exame minucioso de regras em um cenrio de negcios, consulte o Guia
de Regras do IBM Cognos TM1 . O guia contm um tutorial sobre desenvolvimento
de regras em um ambiente de negcios.
Nota: As imagens do Editor de Regras nesta seo mostram o Editor de Regras
antigo. Para ver imagens do novo Editor de Regras, consulte o Guia de Regras do
IBM Cognos TM1 .
Dependendo da plataforma, alguns dos dados de exemplo fornecidos podem no
estar disponveis a todos os usurios.
Viso Geral de Regras de Cubo

Os clculos mais comuns em aplicativos OLAP envolvem a agregao de dados em
uma dimenso. No TM1 , voc cria esses clculos usando as hierarquias de
consolidao. Por exemplo, em uma dimenso Ms, possvel definir um total
trimestral que soma os valores de Janeiro, Fevereiro e Maro.
Em muitos aplicativos, necessrio executar clculos que no envolvem agregao,
como clculos de custos e converses cambiais. Com regras de cubo, possvel
criar frmulas para executar estes clculos.
Com regras de cubo, possvel executar as seguintes tarefas:
v Multiplicar preos por unidades para gerar valores de vendas.
v Substituir consolidaes quando necessrio. Por exemplo, possvel evitar que
um preo trimestral exiba uma contagem total de preos mensais individuais.
v Usar dados em um cubo para executar clculos em outro cubo, ou compartilhar
dados entre cubos. Por exemplo, possvel extrair dados de vendas em um cubo
que contm informaes de Lucro e Prejuzo.
v Designar os mesmos valores a vrias clulas.
Nota: Voc deve ser membro do grupo ADMIN para criar ou editar as regras do
TM1 .
Associe uma regra de cubo a um cubo individual. Ao criar uma regra, o TM1
armazena as informaes de regras em dois arquivos:
cube_name .rux - Armazena as regras compiladas. Ao carregar um cubo para o qual
definiu regras na memria, o TM1 procura pelo arquivo .rux do cubo no diretrio
de dados que contm o cubo.
cube_name .blb - Armazena as informaes de formato para o Editor de Regras.
Nota: Se desejar editar um arquivo .rux em um editor de texto diferente do Editor
de Regras, certifique-se de excluir o arquivo .blb correspondente. Se o arquivo no
41
for excludo, haver uma discrepncia entre o contedo do arquivo .rux e a

exibio no Editor de Regras, pois o arquivo .blb determina a exibio no Editor de
Regras.
Diretrizes para Gravao de Instrues de Regras do TM1

O formato geral de uma instruo de regras :
[Area]=Formula;
Varivel
Descrio
rea
Especifica a parte de um cubo afetada pela regra.
Frmula
Descreve como o TM1 calcula as clulas na rea do cubo.
Para restringir uma regra a valores simples na rea:

[Area]=N:>Formula;
Para restringir uma regra a valores consolidados na rea:

[Area]=C:>Formula;
Consideraes Gerais
v A sintaxe no faz distino entre maisculas e minsculas. possvel usar letras
maisculas e minsculas.
v possvel usar espaos em regras para melhorar a clareza.
v Uma instruo de regras pode ocupar uma ou mais linhas no Editor de Regras.
Uma instruo tambm pode conter uma ou mais frmulas.
v necessrio terminar cada instruo com um ponto e vrgula (;).
v Para incluir comentrios e para excluir instrues de processamento, insira um
sinal numrico (#) no incio de uma linha ou instruo. Por exemplo:
#
The following rule is not active
# [Gross Margin]=[Sales]*0.53;
Sintaxe para Descrever a rea

A rea identifica uma ou mais clulas em um cubo.
Considere as seguintes diretrizes ao criar uma definio de rea.
v No especifique nenhum elemento de dimenso, ou um ou mais elementos de
dimenso.
v Cada elemento deve ser de uma dimenso diferente do cubo.
v Coloque cada elemento entre aspas simples.
v Use vrgulas para separar cada elemento.
v Coloque toda a definio de rea entre colchetes.
A tabela a seguir mostra quatro exemplos de rea. Cada exemplo sucessivo
estreita o escopo.
42
rea de Amostra
Escopo
[]
Todas as clulas no cubo.
rea de Amostra
Escopo
['Janeiro']
Todas as clulas identificadas por um elemento Janeiro.
['Vendas','Janeiro']
Todas as clulas identificadas pelos elementos Vendas e

Janeiro.
['Alemanha','Vendas','Janeiro'] Todas as clulas identificadas pelos elementos Alemanha,

Vendas e Janeiro.
Usando Subconjuntos em uma Definio de rea

possvel usar um subconjunto no lugar de um nico elemento em uma definio
de rea, colocando todos os membros do subconjunto entre chaves.
Por exemplo, a seguinte definio de rea aplica uma regra a todas as clulas do
cubo identificadas pelo elemento Vendas, e o elemento Janeiro, Fevereiro ou Maro:
[Sales, {January, February, March}] =
Usando Caracteres Especiais e Nomes de Elementos no

Exclusivos em uma Definio de rea
possvel usar a sintaxe 'dimensionname':'elementname' em uma definio de
rea de regras para especificar elementos que no so exclusivos para uma nica
dimenso, ou para nomes de dimenses que contm caracteres especiais.
Por exemplo,
[Units,Mar,}Groups:ADMIN]
permite gravar uma regra para a dimenso }Groups, que contm o caractere
especial chave (}).
De forma semelhante,
[Units,Mar, Region:North America]
permite gravar uma regra quando o elemento Amrica do Norte no exclusivo

para a dimenso Regio.
Sintaxe para Frmulas

Uma frmula de regras uma expresso composta de:
v Constantes numricas
v Operadores aritmticos e parnteses
v Funes numricas e de sequncia -- consulte o Guia de Referncia do IBM
Cognos TM1 .
v Lgica condicional
v Referncias de cubo
Constantes Numricas
Os componentes mais simples de frmulas de regras so constantes numricas.
v Consistem em numerais, em um sinal de menos inicial opcional (-) e em um
ponto decimal opcional. Por exemplo, 5.0, 6, -5. Alguns exemplos de constantes
numricas invlidas so: 1-, 1A, 3..4.
v Contm um comprimento mximo de 20 caracteres.
v possvel usar anotao cientfica para inserir uma constante numrica.
43
Por exemplo, a instruo de regras a seguir designa o valor 200 a todas as clulas
no cubo.
[ ] = 200;
Operadores Aritmticos
possvel combinar constantes numricas com os seguintes operadores aritmticos.
Operador
Significado
+ (Sinal de mais)
Adio
- (Sinal de menos)
Subtrao
* (Asterisco)
Multiplicao
/ (Barra)
Diviso - retorna um valor indefinido e exibe

N/A na visualizao
\ (Barra Invertida)
Exibio de Diviso por Zero - igual ao operador

Diviso, mas retorna zero quando voc divide
por zero.
^ (Sinal de Intercalao)
Exponenciao
O TM1 avalia operadores aritmticos na seguinte ordem:

v Exponenciao
v
v
v
v
Multiplicao
Diviso
Adio
Subtrao
Use parnteses para forar uma ordem de avaliao diferente. Por exemplo, a
expresso 2*3+4 produz o mesmo resultado que (2*3)+4, porque a multiplicao
tem precedncia sobre a adio. O resultado 10. No entanto, se desejar executar a
adio primeiro, grave novamente a frmula como 2*(3+4). O resultado alterado
de 10 para 14.
Usando a Lgica Condicional

Use a funo SE para incluir lgica condicional em regras. O formato geral :
IF(test, value1, value2)
v A funo SE retorna um de dois valores, dependendo do resultado de um teste

lgico.
v Quando a expresso Teste for verdadeira, a funo SE retornar Valor1.
v Quando a expresso Teste for falsa, a funo SE retornar Valor2.
v O tipo de dado retornado por uma funo SE determinado pelos tipos de dado
de Valor1 e Valor2.
v Valor1 e Valor2 devem ser o mesmo tipo de dado, sequncia ou numrico.
v Uma funo SE em que Valor1 uma sequncia e Valor2 um nmero resulta
em uma instruo de erro.
Tambm possvel aninhar instrues SE:
44
IF(test1, value1, IF (test2, value2, value3))
A tabela a seguir mostra dois exemplos de SE.

Expresso
Resultado
SE (7>6,1,0)
resulta em 1
SE (7>6, 'Verdadeiro', 'Falso')
resulta em 'Verdadeiro'
Usando Operadores de Comparao

possvel comparar nmeros com os seguintes operadores.
Operador
Significado
>
Maior que
<
Menor que
>=
Maior que ou igual a
<=
Menor que ou igual a
Igual a
<>
Diferente de
Para comparar dois valores de sequncia, insira o smbolo @ antes do operador de

comparao, conforme mostrado no exemplo a seguir:
IF (A@=B,0,1) yields the number 1.
possvel combinar expresses lgicas com operadores lgicos.

Operador
Significado
Exemplo
& (E Comercial)
(Valor1 > 5) & (Valor1 < 10)

Retorna VERDADEIRO se o valor for maior que
5 e menor que 10.
% (Sinal de
porcentagem)
OU
~ (Til)
NO
(Valor1 > 10) % (Valor1 < 5)

Retorna VERDADEIRO se o valor for maior que
10 ou menor que 5.
~(Valor1 > 5)
Equivalente a (Valor1 <= 5)
possvel concatenar sequncias usando a barra vertical (|).

Por exemplo, as seguintes expresses retornam Rheingold.
45
(Rhein | gold)
Se a sequncia resultante de uma concatenao for maior do que 254 bytes, o TM1
retornar um erro.
Usando Referncias de Cubo

Todas as frmulas de regras contm referncias de cubo, que apontam para reas
em um cubo para dados. As referncias de cubo podem apontar para o cubo para
o qual voc est gravando uma regra (referncias de cubo interno) ou para reas
em outros cubos (referncias de cubo externo).
Referncias de Cubo Interno

As referncias de cubo interno usam a mesma sintaxe que a rea para a qual voc
grava a regra. Os exemplos incluem:
[January]
[Sales,January]
[Germany,Sales,January]
No exemplo a seguir, o TM1 calcula a Margem Bruta para a Alemanha,

multiplicando as Vendas da Alemanha no mesmo cubo por 0,53:
[Gross Margin,Germany]=[Sales]*0.53;
Referncias de Cubo Externo

Use a funo DB para apontar para cubos externos.
DB(cube, dimension1, dimension2,...dimensionn)
Argumento
Descrio
cubo
Nome do cubo externo.
dimenso
Um dos seguintes argumentos:

v O nome de um elemento em uma dimenso do cubo externo,
colocado entre aspas simples.
v O nome de uma dimenso precedido por um ponto de
exclamao (!), que chamado de notao varivel. Um
argumento que usa notao varivel retorna o elemento de
dimenso atual na clula qual uma instruo de regra se
aplica. Por exemplo, uma clula calculada por regras
identificada pelo elemento Alemanha da regio Dimenso,
!Region, retorna Alemanha.
v Uma expresso que resolvida para um nome de elemento.
Especifique um argumento de dimenso para cada dimenso do cubo externo.

necessrio ordenar os argumentos de dimenso para corresponderem ordem das
dimenses no cubo externo.
Na seguinte instruo de regras, todos os valores de Vendas no cubo interno so
calculados multiplicando Unidades no cubo interno pelos valores no cubo externo
PriceTab:
[Sales]=[Units]*DB(PriceTab,!Region,!Product,!Month)
46
v O cubo PriceTab contm apenas preos. Cada uma de suas clulas identificada
por um elemento em trs dimenses: Regio, Produto, Ms. O cubo interno
contm estas dimenses e pelo menos uma outra dimenso que possui os
elementos Vendas e Unidades.
v Cada clula Vendas no cubo interno identificada por Vendas e os elementos
nas trs dimenses no cubo interno compartilham com o cubo PriceTab. Para
preencher a clula Vendas, o TM1 extrai um valor de PriceTab localizado na
interseo dos elementos correspondentes nas dimenses compartilhadas.
v O cubo externo pode ser diferente do cubo interno em relao ao nmero de
dimenses e ao nmero de elementos em cada dimenso. No entanto, uma
dimenso referida como uma varivel (como em !Region ou !Product) deve
conter pelo menos todos os elementos localizados na dimenso correspondente
do cubo interno.
Organizando Instrues de Regras

Quando mais de uma instruo em uma regra for aplicvel mesma rea, a
primeira instruo ter precedncia.
Considere este exemplo. Um cubo denominado Prioridade possui duas dimenses,
Regio e Ano. A regra possui quatro instrues:
[Germany, Year1] = 10;[Year1] = 5;[United States]
= 6;[ ] = 2;
A seguir esto os valores de amostra para o cubo Priority, sendo todos derivados
pela regra precedente.
Regio
Ano 1
Ano 2
Ano 3
Frana
Alemanha
10
Estados Unidos
O TM1 processa as instrues de regra da seguinte forma:

v A primeira instruo designa o valor 10 clula Alemanha, Ano1. A primeira
instruo tem precedncia sobre a segunda instruo, que especifica que todas as
clulas Ano1 contm 5.
v A segunda instruo tem precedncia sobre a terceira instruo. Portanto, a
clula para Estados Unidos, Ano 1 contm 5, mesmo que a terceira instruo
especifique que todos os valores para Estados Unidos devem ser 6.
v A ltima instruo [ ] = 2 especifica que todos os valores no cubo contm o
valor 2. Esta regra aplica-se a todas as clulas que no so afetadas por
instrues precedentes, tais como, a clula Frana, Ano2.
Especificando Diferentes Regras nos Nveis N: e C:

Geralmente, necessrio diferenciar a maneira como so tratadas as clulas do
nvel C: e do nvel N: em uma rea.
v Clulas de Nvel N: - Identificadas apenas por elementos simples.
v Clulas de Nvel C: - Identificadas por pelo menos um elemento consolidado.
47
Use a seguinte sintaxe para gravar uma instruo de regras que seja aplicvel
apenas a clulas de nvel N: em uma rea:
[Area] = N:[Formula];
Por exemplo:
[Sales] = N:[Price]*[Units]\1000;
Use a seguinte sintaxe para gravar uma instruo de regras que seja aplicvel
apenas a clulas de nvel C: em uma rea.
[Area] = C:[Formula];
Por exemplo:
[Price] = C:[Sales]\[Units]*1000;
Quando uma rea especfica de um cubo for calculada de forma diferente nos
nveis C: e N:, ser possvel usar a seguinte sintaxe:
[Area] = N:[Formula A]; C:[Formula B];
Por exemplo:
[Price] =
N:DB(PriceCube, !Actvsbud, !Region, !Model, !Month);
C:[Sales]\[Units]*1000;
Ignorando Regras
Usando a funo STET, possvel ignorar o efeito de uma instruo de regras para
reas especficas de um cubo.
Por exemplo, talvez voc queira gravar uma instruo de regras para Margem
Bruta que seja aplicvel a todas as regies, exceto Frana. possvel gravar a regra
geral e a exceo de duas maneiras.
v Grave a instruo STET primeiro seguida pela instruo geral:
[Gross
Margin, France] = STET;
[Gross Margin] = [Sales] * 0.53;
v Grave uma instruo de regras que inclua uma funo SE:

[Gross
Margin] = IF(!Region @= France, STET, [Sales]
* 0.53);
Qualificando Nomes de Elementos

Quando desejar limitar uma instruo de regras a valores identificados por um
elemento que aparece em vrias dimenses, qualifique o nome de elemento com
seu nome de dimenso usando a seguinte sintaxe:
[dimname:element]
Por exemplo, se Total ocorrer nas dimenses Regio e Produto e voc desejar que a
regra seja limitada a clulas identificadas por Total na dimenso Regio,
especifique:
[Region:Total]=
48
Editor de Regras e Planilhas de Regras

possvel criar regras por meio de duas interfaces:
v Editor de Regras - Todos os exemplos anteriores nesta seo usam esta interface.
v Planilha de Regras - Uma planilha do Excel modificada na qual voc digita
instrues de regras para um cubo na coluna A.
O TM1 salva as regras em dois arquivos:
cube .xru - Planilha de regras
cube .rux - Arquivo compilado
Nota: possvel modificar as regras criadas por meio das planilhas de regras
usando o Editor de Regras. Ao faz-lo, o TM1 solicita que salve as alteraes na
planilha. Se as mudanas no forem salvas, os arquivos .xru e .rux ficaro fora de
sincronizao. Portanto, no possvel modificar as mudanas subsequentemente,
editando a planilha de regras. Todas as regras descritas nessa seo aplicam-se s
planilhas de regras e tambm s planilhas de dimenso.
Para garantir que o TM1 tenha acesso a todas as alteraes, use uma das interfaces
exclusivamente para criar e manter regras.
Criando Planilhas de Regras

Ao usar uma planilha de regras para criar uma regra em um IBM Cognos TM1
server local ou remoto, seu cliente TM1 deve ter um diretrio vlido configurado
na caixa Diretrio de Dados do Servidor Local na caixa de dilogo do TM1
Options. O diretrio o local no qual o cliente TM1 salva as planilhas de regras
(arquivos .xru).
Nota: Se no configurar um diretrio, ou se o diretrio no for vlido, o TM1 no
poder salvar as planilhas de regras.
Procedimento
1. Clique em TM1 , Planilhas de Regras, Novo em Excel.
A caixa de dilogo Selecionar Cubo para Regras se abre. A lista contm os
cubos no servidor local e qualquer servidor no qual efetuou login durante a
sesso atual do TM1 .
2. Selecione um cubo e clique em OK.
O TM1 exibe uma planilha de regras em branco que se parece com outras
planilhas de Excel, exceto porque a primeira coluna possui uma largura de 100.
3. Coloque cada instruo de regra em uma linha separada na coluna A, como no
exemplo a seguir.
[Gross Margin%]=[Gross Margin]\[Sales]*100;
[Price]=N:DB(PriceCube,!actvsbud,!region,!model,!month);
[Sales]=N:[Price]*[Units]\1000;
Voc pode clicar em TM1 , Editar Frmula para acessar a caixa de dilogo
TM1 Editar Frmula . Esta caixa de dilogo, que ajuda-o a construir instrues
de regras precisas, fornece toda a funcionalidade localizada no Editor de
Regras. O Editor de Regras descrito posteriormente nesta seo.
49
Salvando Planilhas de Regras

Para salvar as regras em um formato que o TM1 possa usar, clique em TM1 ,
Planilhas de Regras, Salvar em Excel.
A opo Salvar atualiza o arquivo de planilha de regra (cube.xru) e cria um
arquivo de regras compilado (cube.rux). O TM1 salva o arquivo .xru no diretrio
de dados do seu servidor local, e o arquivo .rux no diretrio de dados para o IBM
Cognos TM1 server . O TM1 imediatamente aplica as novas regras no cubo.
Nota: Se voc clicar em Arquivo, Salvar no Excel, apenas o arquivo cube.xru ser
atualizado. Para usar a nova regra em um cubo, necessrio criar o arquivo de
regras compilado.
Regras e Consolidaes de Dimenses

As regras trabalham em conjunto com consolidaes definidas nas dimenses.
Embora seja possvel definir consolidaes usando regras, isto no recomendado
por motivos de desempenho. As consolidaes definidas em dimenses so
calculadas muito mais rapidamente do que valores derivados de regras,
principalmente em cubos muito grandes e esparsos.
Ordem de Clculo
As regras tm precedncia sobre consolidaes em dimenses.
Quando o TM1 calcula uma clula do cubo e uma consolidao por uma regra, o
TM1 examina primeiro a instruo de regras. Entretanto, se a instruo de regras
referir-se s clulas resultantes de consolidaes, o TM1 executa primeiro a
consolidao e, ento, calcula as instrues de regras usando os resultados.
Do contrrio, se definir uma clula somente por consolidao, o TM1 consulta nos
valores necessrios para executar a consolidao. Quando alguns valores so
resultantes de regras de clculo, o TM1 executa o clculo das regras antes de
executar a consolidao.
Substituindo Elementos de Nvel C: por Regras

Voc deve evitar gravar uma regra que substitui um valor consolidado que um
componente de outra consolidao.
Um exemplo simples ilustra este problema. Suponha que voc tenha um cubo
bidimensional chamado Vendas, que seja composto das dimenses Produto e Ms,
com consolidaes de produtos (Total) e trimestrais (1 Trimestre) definidas.
Para calcular o total geral (Total, 1 trimestre), o TM1 pode consolidar os totais do
produto para cada ms ou consolidar totais trimestrais para cada produto.
50
Suponha ainda que voc grave uma regra que calcule um valor para Total de
vendas de produtos em Jan, e que o valor calculado por regras no some os
valores de produtos individuais para Jan. Uma regra que define o valor de Total de
produtos em Jan como 999 serve como uma ilustrao.
[Jan,Total]=999;
Se o total geral for calculado pela consolidao de totais de produtos para cada
ms, o valor ser diferente da consolidao dos totais trimestrais para cada
produto. Isto ocorre porque o valor calculado por regras para total de vendas de
produtos em Jan substitui a consolidao natural definida na dimenso Produto.
Voc no tem nenhum controle sobre a ordem na qual o TM1 executa as

consolidaes de dimenses. Alm disso, dependendo de qual caminho de
consolidao ideal em um determinado momento, o TM1 pode alternar entre os
caminhos. Consequentemente, voc poder solicitar o valor Total, 1 Trimestre duas
vezes na mesma sesso e obter resultados diferentes.
51
Esta situao pode ser resolvida gravando uma instruo de regras que calcule o
valor da consolidao Total, 1 Trimestre como a soma de seus filhos imediatos na
dimenso Ms, substituindo, portanto, a consolidao da dimenso Produto. A
instruo ['Total']=ConsolidateChildren('Ms') executa este clculo.
No entanto, permanece uma inconsistncia implcita ao visualizar o cubo: a soma
dos totais trimestrais para cada produto diferente da soma do total de produtos
para cada ms. Portanto, no recomendvel substituir valores de nvel C: que
sejam componentes de outras consolidaes.
Empilhando Regras
Uma instruo de regras pode referir-se a uma clula em um cubo que seja
definida por outras instrues de regras. O TM1 empilha essas instrues de regras
at que possa obter um valor final e, ento, trabalha novamente para retornar um
resultado. O nmero de nveis de empilhamento que o TM1 pode acomodar
limitado somente pela memria disponvel.
Se uma referncia circular ocorrer em uma pilha de regras, ou o nvel mximo de
empilhamento for excedido, o TM1 exibir a mensagem de erro:
Error Evaluating Rule: Possible Circular Reference
A seguir est um exemplo de uma referncia circular:

[Sales] = [Units] * [Price] ;
[Price] = [Sales] / [Units] ;
Aplicativos de Amostra
Esta seo contm exemplos de aplicativos de regras comumente usados. Examine
estes exemplos para desenvolver um entendimento da sintaxe e escopo de regras.
Calculando Propores
No exemplo a seguir, uma regra calcula a Margem Bruta como uma porcentagem
das Vendas no cubo SalesCube. Associe esta proporo % de Margem Bruta, um
novo elemento numrico na dimenso Conta1.
Primeiro, necessrio criar o elemento % de Margem Bruta.
52
Criando o Elemento % de Margem

Se a dimenso SalesCube j contiver o elemento Margem Bruta, v para a prxima
seo. Siga estas etapas se precisar incluir o elemento % de Margem Bruta na
dimenso Conta1.
Procedimento
2. Selecione a dimenso Conta1.
3. Clique em Dimenso, Editar Estrutura de Dimenso.
4. Clique em Editar, Inserir Elemento.
5. Digite % de Margem Bruta e clique em Incluir.
6. Clique em OK.
7. Salve a dimenso.
Criando a Regra % de Margem

Siga estas etapas para criar a frmula % de Margem Bruta.
Procedimento
1. No Server Explorer, clique com o boto direito do mouse em Cubo de Vendas.
Se a regra j existir, clique em Editar Regra. Se ainda no criou a regra, clique
em Criar Regra.
.
2. Clique em rea
A caixa de dilogo Referncia ao Cubo exibe as dimenses do cubo SalesCube.
3. Clique em Conta1.
A janela Editor de Subconjuntos se abre.
4. Na rea de janela esquerda, selecione % de Margem Bruta e clique em OK.
A caixa de dilogo Referncia ao Cubo se abre novamente.
5. Clique em OK.
O Editor de Regras exibe ['% de Margem Bruta'] no campo de entrada.
6. Clique em Igual
novamente e clique em Conta1.

7. Clique em rea
8. Na janela Editor de Subconjuntos, selecione Margem Bruta e clique em OK.
9. Clique em OK na caixa de dilogo Referncia ao Cubo.
.
10. Clique em Exibio de Diviso por Zero
O TM1 coloca um sinal de diviso aps ['Margem Bruta'].
Observe que existem dois botes de diviso no Editor de Regras.
- Se voc usa este operador de diviso em uma
Operador de Diviso
regra que resulta em diviso por zero, o TM1 retorna um valor indefinido e
exibe N/D na visualizao.
- Se voc usar esse operao de
Operador de Diviso de Exibio Zero
diviso em uma regra que resulta na diviso por zero, o TM1 retornar o
valor 0.
11. Clique em rea
novamente e clique em Conta1

53
12.
13.
14.
15.
Na janela Editor de Subconjuntos, selecione Vendas e clique em OK.

Clique em OK na caixa de dilogo Referncia ao Cubo.
Clique em Multiplicao .
Digite 100 no final da frmula.
16. Clique em Ponto e Vrgula
Nota: Voc deve encerrar todas as instrues de regras com um ponto e

vrgula.
A regra completa agora deve aparecer da seguinte forma.
[Gross Margin%]*[Gross Margin]\[Sales]*100;
17. Clique em Salvar.
Resultados
O TM1 salva a regra e a aplica no cubo. Um novo objeto Regra se abre abaixo do
cubo SalesCube. Uma regra sempre suporta o mesmo nome que o cubo ao qual ela
est associada.
Entendendo a Regra Gerada

Vamos examinar os componentes da nova instruo de regras.
v rea - Especifica a rea do cubo que o TM1 calcula. Neste exemplo, o elemento
% de Margem Bruta identifica todos os valores de clula derivados por meio de
uma regra.
v Frmula - Define o clculo.
v
Terminador - Finaliza todas as instrues de regras com um ponto e vrgula (;).
Para obter mais informaes sobre sintaxe de regras, consulte o Guia de Regras do
IBM Cognos TM1 .
Navegando nos Valores de % de Margem Bruta

A visualizao simples de % de margem bruta agora exibe os valores calculados
para % de Margem Bruta.
Procedimento
1. Na janela Server Explorer, clique no cone Visualizaes para o cubo
SalesCube.
2. Clique duas vezes na visualizao % de margem de vendas.
A visualizao aberta no Cube Viewer.
O valores para % de Margem Bruta, que so derivados por meio da regra
recm-criada, aparecem na visualizao.
54
Compartilhando Dados entre Cubos

O cubo SalesCube no contm dados de preos. As informaes sobre preos para
este cubo so armazenadas em um cubo de quatro dimenses separado, chamado
PriceCube.
possvel compartilhar valores entre cubos usando a funo de regras DB. Os
valores so armazenados em um cubo e referidos em outros cubos. O exemplo a
seguir mostra como as regras para um cubo podem fazer referncia a valores em
um cubo separado.
Procedimento
1. No Server Explorer, clique duas vezes na regra SalesCube.
2. Posicione o cursor na segunda linha de entrada.
.
3. Clique em rea
A caixa de dilogo Referncia ao Cubo exibe as dimenses do cubo SalesCube.
4. Clique em Conta1.
5. Na rea de janela esquerda, selecione Preo e clique em OK.
A caixa de dilogo Referncia ao Cubo se abre novamente.
6. Clique em OK.
O Editor de Regras exibe ['Preo'] no campo de entrada.
7. Clique em Igual
8. Clique em Referncia do Banco de Dados

A caixa de dilogo Selecionar Cubo se abre.
9. Selecione PriceCube e clique em OK.
A caixa de dilogo Referncia ao Cubo exibe as dimenses do cubo PriceCube.

10. Clique em OK.
A seguinte frmula se abre no Editor de Regras.
[Price]=DB(PriceCube,!Actvsbud,!Region,!Model,!Month)
Leia a frmula conforme a seguir: Qualquer clula no cubo SalesCube

identificada pelo elemento Preo obtm seu valor de uma clula no cubo
PriceCube. O local da clula PriceCube est localizado na interseo de
elementos correspondentes nas quatro dimenses que PriceCube compartilha
com SalesCube.
Por exemplo, a clula SalesCube identificada pelos elementos Real, Alemanha,
Srie S 1.8 L Sed, Preo, Jan obtm seu valor da clula PriceCube identificada
pelos elementos Real, Alemanha, Srie S 1.8 L Sed, Jan.
para colocar ponto e vrgula no final da
frmula.
12. Clique em Salvar para salvar a regra.
Agora possvel alterar um preo no cubo PriceCube e ver a mudana
refletida no cubo SalesCube. No entanto, no possvel editar os preos em
SalesCube, porque eles so derivados por meio da regra recm-criada.
A visualizao de amostra SalesPrice inclui os valores de preos.
Para abrir a visualizao de amostra SalesPrice:
55
13. Na janela Server Explorer, clique no cone Visualizaes para o cubo

SalesCube.
14. Clique duas vezes na visualizao % de Margem de Vendas.
A visualizao se abre no Cube Viewer, completa com os valores de Preo
extrados do cubo PriceCube.
Calculando Vendas
No exerccio anterior, voc colocou preos no cubo SalesCube. Se voc alterar um
preo no PriceCube, o TM1 no alterar o valor correspondente de vendas no
SalesCube. Isto ocorre porque os valores de vendas em SalesCube existem como
valores dos dados no cubo. necessrio criar uma regra para derivar os valores de
vendas em SalesCube a partir dos preos e unidades.
Procedimento
1. Reabra o Editor de Regras para o cubo SalesCube.
2. Abaixo da frmula ['Preo'], insira a seguinte regra:
['Vendas']=['Preo']*['Unidades']\1000;
Nota: Todos os valores no cubo SalesCube esto em milhares, exceto os valores
de Preo, que so nmeros reais. Como os nmeros de Vendas devem
permanecer em milhares, divida por 1000 na instruo de regras.
3. Clique em Salvar para salvar a regra SalesCube.
4. Reabra a visualizao de amostra SalesPrice.
O TM1 cria sombras em todas as clulas identificadas pelo elemento Vendas, o
que indica que os valores nestas clulas so derivadas por meio de regras.
5. Altere o valor de unidades de Janeiro para 10.000 digitando 10000 na clula na
interseo de Unidades e Jan.
6. Pressione F9 para recalcular os valores de clulas.
7. Observe o novo valor de vendas para Janeiro.
Observe que o valor de % de Margem Bruta para Janeiro atualizado, pois este
valor derivado por meio de uma regra, que faz referncia ao elemento
Vendas.
56
8. Restaure o valor 313 para a clula na interseo de Jan e Vendas.
Restringindo Regras a Valores Simples

No exerccio anterior, foi criada uma regra aplicvel a todas as clulas contendo
nmeros de vendas. Este tipo de regra substitui consolidaes em dimenses,
gerando resultados incorretos. No exerccio a seguir, voc inspecionar um total
trimestral por meio de uma planilha de fatia, e restringir a regra SalesCube a
valores simples, permitindo, assim, que as consolidaes funcionem corretamente.
Procedimento
1. Abra a visualizao de amostra Vendas1trim do cubo SalesCube.
para fatiar a visualizao de uma planilha do Excel.
2. Clique em Fatia
A fatia deve aparecer da seguinte forma.
3. Salve a planilha de fatia com o nome Teste.

4. Examine o valor de Vendas para 1Trimestre na clula B10.
De acordo com a regra SalesCube, o valor o produto da multiplicao do
preo do primeiro trimestre por uma frao (1/1000) de unidades do primeiro
trimestre. Em vez disso, o valor deve ser a consolidao de vendas para os
primeiros trs meses. No entanto, os valores derivados pela regra SalesCube
(como ela existe no momento) tm precedncia sobre os valores derivados por
meio de consolidao. Para corrigir isso, necessrio modificar a regra para
que ela no calcule os valores para elementos consolidados.
57
5. Abra a regra SalesCube no Editor de Regras.

6. Na terceira linha, insira N: na frente de ['Preo'] para que a frmula seja lida:
[Sales]=N:>[Price]*[Units]\1000;
O limitador N: restringe a regra s clulas identificadas apenas por elementos

simples. A regra no mais aplicvel a elementos consolidados, deixando as
consolidaes funcionarem corretamente.
7. Clique em Salvar para salvar a regra editada.
8. Pressione F9 para recalcular a planilha de teste.
O valor correto agora aberto na interseo de Vendas e 1Trimestre.
Calculando um Preo Mdio

Examine o valor de Preo, 1Trimestre na planilha Teste. Este nmero a soma dos
preos para Janeiro, Fevereiro e Maro. No entanto, o nmero deve refletir o preo
mdio para os trs meses. As instrues de regras a seguir produzem o valor
desejado:
[Price]=C:[Sales]\[Units]*1000;
O limitador C: restringe esta instruo de regras a consolidaes; ou seja, apenas

quando um ou mais dos elementos que identificam uma clula Preo so
elementos consolidados.
Procedimento
1. Reabra o Editor de Regras para o cubo SalesCube.
2. Insira a seguinte instruo sem a definio de rea, como a terceira linha no
campo de entrada.
['Preo']=DB('PriceCube',!actvsbud,!region,!model,!month);C:['Vendas']\
['Unidades']*1000;
Omita a definio de rea, porque voc j definiu a rea de Preo na segunda
linha. Quando desejar aplicar diferentes frmulas mesma rea, defina a rea
e, em seguida, especifique as frmulas sequencialmente.
3. Clique em Salvar para salvar a regra editada.
4. Na planilha de teste, pressione F9 para recalcular e atualizar os valores.
Observe o valor de Preo, 1Trimestre, que ainda exibe o valor 76.132,59. Isso
ocorre porque o TM1 usa a primeira frmula de regras que encontra, que se
aplica clula Preo, 1 Trimestre:
[Price]=DB(PriceCube,!actvsbud,!region,!model,!month);
Esta instruo apropriada apenas para nveis de clula N:, tais como, Preo,
Jan. Os valores de Preo consolidados devem ser calculados por meio da
segunda instruo de Preo. Ao restringir a primeira frmula de Preo somente
as clulas de nvel N:, voc permite que o TM1 aplique a segunda frmula de
Preo a consolidaes.
Nota: O TM1 avalia as instrues de regras a fim de que apaream em uma
regra, mas a primeira frmula para uma determinada rea tem prioridade
sobre frmulas posteriores para a mesma rea. Se voc tiver vrias instrues
de regras que abordem a mesma rea, dever orden-las da menos restritiva
para a mais restritiva. Para obter detalhes, consulte Organizando Instrues de
Regras na pgina 47.
5. Para restringir a primeira frmula de Preo a nveis de clula N:, abra a regra
SalesCube no Editor de Regras.
58
6. Insira N: na frente da primeira parte da frmula da primeira instruo de

Preo:
[Price]=N:>DB(PriceCube,!actvsbud,!region,!model,!month);
Toda a regra para a rea de Preo agora deve aparecer da seguinte forma:
7. Clique em Salvar para salvar a regra.

8. Na planilha Teste, pressione F9 para recalcular e exibir os valores atualizados.
Todos os valores de Preo agora devem refletir os clculos corretos, com o valor
de 1 Trimestre, Preo como uma mdia dos primeiros trs meses do ano.
Vinculando Dois Cubos Assimtricos

A maioria das empresas no dividem custos adicionais por produto abaixo da
linha de Margem Bruta. Estes nmeros, tais como, aluguel e utilitrios, esto
disponveis apenas em uma base regional ou divisional. Em outras palavras, a
estrutura dos nmeros de custos no simtrica com os nmeros de vendas.
Portanto, normalmente voc armazenaria os dados em cubos separados.
Os dados de custos que correspondem aos dados de vendas no cubo SalesCube
esto disponveis no cubo PnLCube. Os dois cubos so comparados, da seguinte
forma:
v PnLCube possui quatro dimenses. Os dados de custos so dimensionados por
verso (real versus oramento), regio, conta e ms.
v SalesCube possui cinco dimenses. Os dados de vendas so dimensionados por
verso (real versus oramento), regio, produto (modelo), conta e ms.
v Os dois cubos compartilham trs dimenses: Regio, Actvsbud e Ms.
v As medidas controladas nestes cubos so identificadas por elementos em
dimenses diferentes. SalesCube usa a dimenso Conta1. PnLCube usa a
dimenso Conta2.
v PnLCube no possui dados para Vendas ou Custos Variveis. Estes valores j
esto calculados detalhadamente em SalesCube.
No exerccio a seguir, voc gravar regras para o PnLCube que extrai os dados de
vendas e de custos variveis de SalesCube.
Procedimento
1. Na janela Server Explorer, clique com o boto direito do mouse em PnLCube e
clique em Criar Regra.
2. Insira duas instrues para especificar que os valores de Vendas e de Custos
Variveis no PnLCube extraem os valores correspondentes de SalesCube.
v Na primeira linha do campo de entrada, crie esta frmula de Vendas:
[Sales]=DB(SalesCube, !Actvsbud,
!Region, Total,
Sales, !Month);
v Na segunda linha, crie esta frmula de Custos Variveis:

[Variable
Costs]=DB(SalesCube, !Actvsbud, !Region,
Total, Variable Costs, !Month);
3. Clique em Salvar para salvar as regras.
59
Nota: Observe que os valores de Vendas e de Custos Variveis agora aparecem

no cubo. Os valores de Margem Bruta tambm esto disponveis porque voc
definiu a Margem Bruta na dimenso conta2 como a diferena entre as Vendas
e Custos Variveis.
4. No Microsoft Excel, abra a planilha de amostra TwoCubes.
A planilha TwoCubes configurada para extrair simultaneamente nmeros de
SalesCube e PnLCube. Esta planilha demonstra como os nmeros podem fluir
entre os dois cubos.
Vamos alterar o nmero de Unidades na clula B6 para um nmero muito
grande para que seja possvel ver o efeito de propagao da mudana na
planilha.
5. Clique na clula B6 e digite 100000.
6. Pressione F9 para recalcular a planilha.
Observe que o valor de Unidades para a Srie S 2.5 L Sed altera o valor de
Vendas para esse modelo e para o total de modelos. Estas mudanas afetam os
valores de Vendas de PnLCube, que so totalmente propagados para o valor de
Lucros Antes dos Impostos no PnLCube.
Nota: Todos os valores de clulas nesta planilha so o resultado de referncias
a dois cubos, SalesCube ou PnLCube. A planilha no calcula nenhum dos
valores.
Criando Processos e Regras de Drill Through

possvel criar um processo de drill e regras de drill para associar uma clula a
dados mais detalhados. Estes dados podem fornecer detalhe subjacente para a
clula, ou outras informaes relevantes para a clula.
O drill thought do TM1 consiste em dois componentes.
v Processo de Drill - Define os dados detalhados que voc deseja associar a uma
clula
v Regra de Designao de Drill - Define o relacionamento entre a clula e os
dados detalhados
Depois de criar um processo de drill e uma regra de designao de drill para um
cubo, possvel executar o processo e abrir os dados detalhados em uma nova
janela, fazendo, portanto, "drill through" em um novo nvel de detalhe.
Criando um Processo de Drill

Um processo de drill um processo do TurboIntegrator que define os dados
detalhados, que so abertos em uma nova janela. O cubo do qual originado um
drill through chamado de cubo de origem.
Antes de criar um processo de drill, voc deve estar familiarizado com os dados
que deseja abrir ao fazer drill a partir do cubo de origem.
Procedimento
1. Clique com o boto direito do mouse no cubo de origem no Server Explorer.
2. Clique em Drill, Criar Processo de Drill.
A primeira janela do Assistente de Configurao de Processo de Drill se abre.
O assistente exibe uma tabela com valores de parmetros para o cubo de
origem e todas as suas dimenses. O TM1 usa esses valores de parmetro para
60
configurar o processo de drill. Ao executar o processo de drill para fazer drill a

partir de um cubo de origem para os dados detalhados, o TM1 atualiza os
valores de parmetro para refletir o local do cubo a partir do qual o
drill-through se origina.
3. Clique em Avanar.
A segunda janela do Assistente de Configurao de Processo de Drill se abre.
4. Selecione o Tipo de Origem de Dados para os dados detalhados que voc
deseja fazer drill through a partir do cubo de origem.
Existem trs opes de Tipo de Origem de Dados.
Opo
Descrio
ODBC
Faz drill do cubo de origem a uma origem ODBC. A origem do Open

Database Connectivity deve estar acessvel a partir do computador no
qual o IBM Cognos TM1 server est sendo executado.
Nota: NOTA: O TM1 requer drivers DataDirect para acessar uma
origem do Oracle ODBC em Solaris ou AIX. Estes drivers no so
fornecidos com o TM1 e devem ser adquiridos separadamente.
Visualizao do
Cubo
Faz drill do cubo de origem a uma visualizao de cubo diferente.

possvel fazer drill em qualquer cubo residente no mesmo servidor
que o cubo de origem.
possvel definir uma origem de dados de visualizao do cubo que
exceda a quantidade mxima de memria que o TM1 pode alocar
quando uma visualizao acessada. Por padro, o limite de memria
para o parmetro MaximumViewSize no arquivo Tm1s.cfg de 100
MB em um sistema de 32 bits, e de 500 MB em um sistema de 64 bits.
Importante: Se no especificar o tamanho mximo da visualizao no
arquivo de configurao, o TM1 exibir uma mensagem de erro
quando voc tentar fazer o drill na visualizao do cubo.
Outro
Faz drill do cubo de origem a qualquer origem de dados suportada

pelo TurboIntegrator.
O TM1 exibe as opes de origem de dados para o tipo de origem de dados

selecionados no assistente.
5. Defina a origem de dados.
v Para uma origem de dados ODBC, necessrio fornecer as seguintes
informaes.
Opo
Descrio
Nome da Origem de
Dados
Nome da origem de dados ODBC (DSN) que voc deseja acessar

ao fazer drill a partir do cubo de origem.
Nome do Usurio
O nome de usurio vlido para efetuar logon na origem ODBC.
Senha
Senha para o nome de usurio.
61
Opo
Descrio
Consulta
Consulta que define os dados a serem retornados da origem

ODBC. Os dados de resultados da consulta so exibidos em uma
janela separada quando voc faz drill a partir do cubo de
origem.
v Para uma origem de dados de Visualizao de Cubo, necessrio fornecer as

seguintes informaes.
Elemento
Descrio
Nome da Origem de
Dados
Nome da visualizao que voc deseja abrir ao fazer drill a partir

do cubo de origem. Clique em Navegar para selecionar um nome
de visualizao ou criar uma visualizao.
v Para a origem de dados Outro, clique em Iniciar TurboIntegrator para

definir a origem de dados.
6. Clique em Concluir.
A caixa de dilogo Salvar Processo como se abre.
7. Insira um nome para o processo de drill na caixa Nome.
Nota: Para uma melhor prtica, recomendvel usar um nome de processo de
drill que identifique o cubo de origem associado ao processo de drill. Por
exemplo, se voc criar um processo para fazer drill de um cubo chamado
PriceCube a uma origem ODBC, nomeie o processo de drill como
PriceCubeToODBCSource. Este tipo de conveno de nomenclatura facilita a
identificao de um nome de processo de drill quando voc edita um processo
de drill ou seleciona entre vrios processos de drill associados a um cubo.
O TM1 salva o processo de drill como um processo de TurboIntegrator, mas
prefixa o nome designado na etapa 7 como o }Drill_ da sequncia. Por exemplo,
se salvar um processo de drill com o nome PriceCubeToODBCSource, o TM1
salva o processo como }Drill_PriceCubeToODBCSource.
Editando Processos de Drill

Ao criar um processo de drill com uma origem de dados de Visualizao do Cubo,
o TurboIntegrator insere a funo ReturnViewHandle('Cubo','Visualizao') acima
ou abaixo da rea Instrues Geradas, que est localizada na subguia Eplogo da
guia Avanado na janela TurboIntegrator.
Se voc alterar a origem de dados para um processo de drill, o TurboIntegrator no
atualizar a funo com a nova origem de dados, porque a funo est fora da rea
Instrues Geradas. necessrio editar a origem de dados de Visualizao de
Cubo na funo ReturnViewHandle para o processo de drill.
Nota: Para um processo de drill com uma origem de dados ODBC, o
TurboIntegrator no insere a funo ReturnViewHandle. Portanto, no necessrio
editar a funo ao alterar uma origem de dados ODBC para um processo de drill.
Procedimento
1. No Server Explorer, clique com o boto direito do mouse no cubo de origem
ao qual o processo de drill est associado.
62
2. Clique em Drill, Editar Processo de Drill.

A caixa de dilogo Selecionar se abre.
3. Selecione um processo de drill e clique em OK.
A janela TurboIntegrator se abre.
4. Clique na guia Avanado.
5. Clique na guia Concluso.
6. Edite a funo ReturnViewHandle para refletir a nova visualizao.
Por exemplo, para usar a visualizao Europe_1Q do cubo Sales como uma
origem de dados, a funo ReturnViewHandle seria semelhante a esta:
ReturnViewHandle(Sales,Europe_1Q)
8. Feche a janela TurboIntegrator.
Excluindo Processos de Drill

Siga estas etapas para excluir um processo de drill.
Procedimento
1. No Server Explorer, clique com o boto direito do mouse no cubo de origem ao
qual o processo de drill est associado.
2. Clique em Drill, Excluir Processos de Drill.
A caixa de dilogo Excluir Processos de Drill se abre.
3. Selecione o(s) processo(s) que voc deseja excluir.
v Para selecionar vrios processos de drill adjacentes, clique e arraste entre os
processos.
v Para selecionar vrios processos no adjacentes, mantenha pressionada a
tecla CTRL e clique em cada processo de drill.
4. Clique em OK.
Criando uma Regra de Designao de Drill

Uma regra de designao de drill a regra do TM1 que vincula clulas do cubo a
dados detalhados relacionados. Conforme indicado acima, os dados relacionados
podem ser um visualizao de cubo, uma origem ODBC ou qualquer outra origem
de dados acessvel por meio do TurboIntegrator.
Procedimento
1. No Server Explorer, selecione o cubo de origem para o qual voc deseja criar
uma regra de designao de drill.
2. Clique em Cubo, Drill, Criar Regra de Designao de Drill.
Para cada rea do cubo que voc deseja associar a dados detalhados, continue
com as etapas 3 a 8.
para definir as clulas do cubo (rea) que deseja
3. Clique em rea
associar aos dados detalhados.
Ao clicar no boto rea, a caixa de dilogo Referncia ao Cubo se abre.
4. Para definir a rea, proceda de uma das seguintes formas:
v Para definir a rea como o cubo inteiro, clique em OK.
63
v Para limitar a definio da rea, clique nos botes de dimenso e selecione os

elementos que definem as clulas que voc deseja associar aos dados
detalhados e, em seguida, clique em OK.
5. Clique em Igual
.
6. Clique em Sequncia
7. Insira o nome do processo de drill entre aspas simples para definir os dados
detalhados que voc deseja associar rea. Por exemplo, insira
'PriceCubeToSource'.
Cuidado: No inclua o prefixo }Drill_ em um nome de processo de drill. Por
exemplo, insira 'PriceCubeToSource' para um processo de drill chamado
}Drill_PriceCubeToSource.
possvel associar mais de um processo de drill a uma rea. Coloque todos os
processos de drill, separados por vrgulas, entre um conjunto de aspas simples.
Nota: Tambm possvel usar lgica condicional ou outras funes para
retornar o nome de um processo de drill.
.
O ponto e vrgula indica o final de uma instruo de regras.
Resultados
Agora possvel fazer drill through em dados detalhados para os quais voc criou
um processo de drill e uma regra de designao de drill.
Exemplo de Drill Through

Esta seo orienta-o na criao de um processo de drill e de uma regra de
designao de drill, que permite fazer drill do cubo SalesByQuarter a uma tabela
relacional que a origem original dos dados do cubo. A tabela contm dados no
nvel mensal, enquanto o cubo SalesByQuarter contm dados no nvel trimestral.
Ao fazer drill through na origem relacional, possvel visualizar o detalhe
subjacente para os dados do cubo.
Configurando a Origem de Dados ODBC

O exemplo nesta seo faz drill through por meio uma origem ODBC (banco de
dados Access). Antes de examinar o exemplo, necessrio configurar a origem de
dados ODBC.
Procedimento
1. Abra a caixa de dilogo Administrador de Origem de Dados ODBC do
Microsoft Windows.
O procedimento para abrir esta caixa de dilogo varia, dependendo da verso
do Microsoft Windows que voc est executando. Para obter detalhes, consulte
a Ajuda do Microsoft Windows .
2. Na guia DSN do Sistema, clique em Incluir.
A caixa de dilogo Criar Nova Origem de Dados se abre.
3. Selecione Driver do Microsoft Access e clique em Concluir.
A caixa de dilogo Configurao do ODBC Access se abre.
4. Digite TM1_sample_data na caixa Nome da Origem de Dados.
5. Clique em Selecionar.
64
A caixa de dilogo Selecionar Banco de Dados se abre.

6. Navegue para seu diretrio \install_dir\Custom\TM1Data\PData\
RelationalData e selecione Sales.mdb.
7. Clique em OK para sair da caixa de dilogo Selecionar Banco de Dados.
8. Clique em OK para sair da caixa de dilogo Administrador ODBC.
O banco de dados Access chamado Vendas agora est disponvel como uma
origem ODBC. Os processos de drill de exemplo usam esta origem de dados
ODBC.
Criando um Processo de Drill

Agora possvel criar um processo de drill para o cubo SalesByQuarterCube. O
processo de drill define uma origem de dados ODBC como os dados detalhados
que voc pode visualizar quando fazer drill a partir do cubo SalesByQuarterCube.
Procedimento
1. No Server Explorer, clique com o boto direito do mouse em
SalesByQuarterCube.
2. Clique em Drill, Criar Processo de Drill.
O Assistente de Configurao de Processo de Drill se abre. A tabela contm os
parmetros padro para o processo de drill.
3. Selecione o valor de parmetro de Ano.
4. Clique em Selecionar Elemento.
O Editor de Subconjuntos se abre.
5. Selecione 1 Trimestre e clique em OK.
6. Repita as etapas 3 a 5 para alterar o valor de parmetro de % de Margem
Bruta para Unidades.
7. Clique em Avanar.
A segunda tela do assistente se abre.
8. Selecione ODBC como o Tipo de Origem de Dados.
9. Clique em Navegar junto caixa Nome da Origem de Dados e selecione
TM1_sample_data.
10. Insira admin como o Nome de Usurio.
11. Insira a seguinte consulta na caixa Consulta.
Esta consulta especfica do banco de dados Access de amostra. Ela usa
funes IIF que so exclusivas do Access e no podem ser usadas em nenhum
outro banco de dados.
SELECT ActvsBud, Region, Model, Account1, Month, Data
FROM Sales WHERE ( ActvsBud = ?actvsbud? AND Region = ?region?
AND Model = ?model? AND Account1 = ?account1? AND
(
IIF( ?quarter?= 1 Quarter, Month = Jan OR Month
= Feb OR Month = Mar,
IIF( ?quarter?= 2 Quarter, Month = Apr OR Month
= May OR Month = Jun,
IIF( ?quarter?= 3 Quarter, Month = Jul OR Month
= Aug OR Month = Sep,
IIF( ?quarter?= 4 Quarter, Month = Oct OR Month
= Nov OR Month = Dec,
IIF( ?quarter?= Year,TRUE,TRUE)))))
)
)
65
Nota: Certifique-se de colocar as referncias aos nomes de parmetros do TM1

entre pontos de interrogao (?).
12. Clique em Concluir.
A caixa de dilogo Salvar Processo como se abre.
13. Save o processo como RELATIONALTABLE_SalesByMonth.
Resultados
O novo processo de drill exibido como um processo disponvel no servidor.
Observe que o nome do processo inclui o prefixo }Drill_, que indica que ele um
processo de drill.
Agora possvel criar uma regra de designao de drill para disponibilizar a
origem de dados ODBC a partir do cubo SalesByQuarterCube.
Criando uma Regra de Designao de Drill para SalesByMonth

Siga estas etapas para criar uma regra de designao de drill que disponibiliza o
processo RELATIONALTABLE_SalesByMonth a partir do cubo
SalesByQuarterCube.
Procedimento
1. No Server Explorer, clique com o boto direito do mouse em
SalesByQuarterCube.
2. Clique em Drill, Criar Regra de Designao de Drill.
3. Insira a seguinte regra na caixa grande.
[Year] = S:IF( ( ELLEV( actvsbud, !actvsbud ) = 0) &
( ELLEV( region, !region)= 0 ) &( ELLEV( model, !model)= 0 ) &
( ELLEV( account1, !account1) = 0),
RELATIONALTABLE_SalesByMonth, );
[] = S:IF( ISLEAF= 1, RELATIONALTABLE_SalesByMonth,);
Esta regra indica que o processo de drill RELATIONALTABLE_SalesByMonth

ser executado quando voc selecionar a opo Drill a partir de uma clula que
seja:
v Identificada pelo elemento Ano e elementos de nvel 0 a partir das demais
dimenses
v Identificada por todos os elementos de nvel 0
4. Salve a regra.
Agora possvel testar a funcionalidade de drill through para o cubo
SalesByQuarterCube.
Visualizando o Exemplo de Drill Through

Siga estas etapas para visualizar o resultado do processo de drill e da regra de
designao de drill.
Procedimento
1. Abra a visualizao Drill_relational do SalesByQuarterCube.
2. Clique com o boto direito do mouse na clula na interseo de Unidades e
Ano.
3. Clique em Fazer Drill.
Um resumo da origem de dados TM1_sample_data se abre, exibindo o detalhe
mensal para a clula.
66
4. Clique em OK para fechar a janela.

5. Faa drill through em outras clulas na visualizao Drill_relational para
visualizar o detalhe mensal. necessrio poder fazer drill through em qualquer
clula na visualizao.
6. Altere o elemento de ttulo de Regio de Alemanha para Europa.
7. Clique com o boto direito do mouse em qualquer clula na visualizao.
Resultados
Observe que a opo Drill no est disponvel. Isto ocorre porque a regra de
designao de drill para SalesByQuarterCube indica que a opo Drill est
disponvel apenas para clulas identificadas pelos elementos de nvel 0 ou para as
clulas identificadas pelo elemento Ano e por elementos de nvel 0. Europa uma
consolidao, portanto, a opo Drill no est disponvel.
Depurando Regras
O TM1 fornece uma ferramenta denominada Rastreador de Regras para ajudar no
desenvolvimento e na depurao de regras. A funcionalidade do Rastreador de
Regras est disponvel apenas no Cube Viewer.
Com o Rastreador de Regras, possvel fazer o seguinte:
v Rastrear clculos - Certifique-se de que as regras estejam sendo designadas s
clulas selecionadas e calculadas corretamente, ou rastreie o caminho de
elementos consolidados
Rastrear alimentadores - Certifique-se de que as clulas folha selecionadas
estejam alimentando outras clulas corretamente
v Verificar alimentadores - Certifique-se de que os filhos de uma clula
consolidada selecionada estejam sendo alimentados corretamente
v
Rastreando Clculos
Para rastrear um clculo, de consolidao ou de regras, clique com o boto direito
na clula contendo o clculo e clique em Rastrear Clculo.
A janela Rastreador de Regras se abre. Daqui, possvel rastrear um clculo para
seus componentes de nvel folha. A janela Rastreador de Regras contm duas reas
de janela.
v Rastreando Clculo (rea de janela superior) - Exibe a definio do local da
clula atual, com um cone indicando se o valor na clula derivado por
ou por Regras
. Tambm exibe o valor atual da clula. Se o
Consolidao
valor for derivado por regras, a regra ser exibida na barra de status da rea de
janela Rastreando Clculo.
v Rastreio (rea de janela inferior) - Exibe os componentes do primeiro elemento
consolidado ou a primeira regra na definio de clula. possvel clicar duas
vezes em qualquer item na rea de janela inferior para rastrear um caminho
para os elementos de nvel folha que definem a clula.
Rastreando um Exemplo de Clculo de Regra (Simples)

Siga estas etapas para visualizar um exemplo simples de rastreio de um clculo de
regra.
Procedimento
1. Abra a visualizao Trace_simple do cubo SalesCube.
67
Esta visualizao contm os valores de Preo que so derivados por meio de

regras criadas anteriormente nesta seo.
2. Clique com o boto direito do mouse na clula na interseo de Preo e Jan.
3. Selecione Rastrear Clculo.
A janela Rastreador de Regras se abre.
Na rea de janela Clculo de Rastreio na parte superior, o TM1 exibe a
indicando que o
definio atual de clula, juntamente com o cone Regras
valor da clula derivado por meio de regras. A regra aplicvel clula
ocultada, e o valor Calculado da clula exibido no canto inferior direito da
rea de janela.
Na rea de janela Rastreamento na parte inferior, o TM1 mostra a avaliao da
regra que se aplica clula atual. Neste exemplo, a regra
avaliada como
[Price]=PriceCube(Actual, Germany, L Series 1.8L Sedan,
Jan)
porque a clula atual um local N: (no definido por nenhuma consolidao).

Agora voc sabe que a clula SalesCube(Real, Alemanha, Srie L 1.8L Sed,
Preo, Jan) obtm seu valor de PriceCube(Real, Alemanha, Srie L 1.8L Sed,
Jan).
Rastreando um Exemplo de Consolidao (Complexo)

O exemplo simples anterior mostra como o Rastreador de Regras funciona para
clulas no nvel N:. O exemplo a seguir mostra como o Rastreador de Regras pode
ser usado para rastrear valores que incluem consolidaes.
Procedimento
1. Abra a visualizao Trace_complex do cubo SalesCube.
2. Clique com o boto direito do mouse na clula na interseo de Vendas e 1
Trimestre.
3. Clique em Rastrear Clculo.
O Rastreador de Regras se abre.
Na rea de janela Rastreando Clculo, o TM1 exibe a definio de clula atual,
indicando que o valor da clula
juntamente com o cone Consolidao
derivado por meio de consolidao. O valor da clula Consolidada exibido no
canto inferior direito da rea de janela.
Na rea de janela Rastreamento na parte inferior, o TM1 exibe os componentes
do primeiro elemento consolidado na definio de clula. Neste exemplo, Srie
T o primeiro elemento consolidado em SalesCube(Real, Alemanha, Srie T,
Vendas, 1Trimestre). O TM1 exibe os componentes da Srie T com seus valores.
4. Clique duas vezes em Srie T 2.8L Cup na rea de janela Rastreio.
Agora voc est rastreando o valor de SalesCube(Real, Alemanha, Srie T,
Vendas, 1Trimestre) por meio de Srie T 2.8L Cup.
A rea de janela Rastreando Clculo agora exibe a definio de clula para o
elemento que foi clicado duas vezes.
SalesCube(Actual, Germany, T Series 2.8L Coupe, Sales,
1 Quarter)
A rea de janela Rastreio agora exibe os componentes do primeiro elemento

consolidado nesta definio de clula. O primeiro elemento consolidado em
68
SalesCube(Real, Alemanha, Srie T 2.8L Cup, Vendas, 1 Trimestre) 1

Trimestre. O TM1 mostra os trs componentes Jan, Fev e Mar, com seus valores.
precede cada
Na rea de janela Rastreamento, observe que um cone Regras
nome de componente, indicando que os componentes derivam seus valores por
meio de regras.
5. Clique duas vezes em Jan na rea de janela Rastreio.
Agora voc est rastreando o valor de SalesCube(Real, Alemanha, Srie T,
Vendas, 1Trimestre) por meio de Srie T 2.8L Cup e Jan.
Rastreando Clculo agora exibe a definio de clula para o elemento que foi
clicado duas vezes. Neste caso, SalesCube(Real, Alemanha, Srie T 2.8L Cup,
Vendas, Jan). Esta clula calculada por uma regra, ['Vendas']=N:['Preo']\
['Unidades']*1000, que ocultada. O valor Consolidado da clula, 18730,0772,
exibido no canto inferior direito da rea de janela.
A rea de janela Rastreio agora exibe os componentes da frmula de regra e
seus valores. O componente Preo possui um valor de 43156,86 e derivado
por outra regra. O componente Unidades tem um valor de 434 e um Valor de
Entrada, conforme denotado pelo marcador cinza .
Anexando estes valores frmula de regra, possvel ver que (43156,86 X
434)\1000 = 18730,0772, confirmando o valor de SalesCube(Real, Alemanha,
Srie T 2.8L Cup, Vendas, Jan).
6. Clique duas vezes em Preo para visualizar a regra usada para derivar o valor
de Preo.
A regra a seguir calcula o Preo:
Esta regra avaliada como:

PriceCube(Actual, Germany, T Series 2.8L Coupe, Jan)
que exibido na rea de janela Rastreamento como um Valor de Entrada,

denotado por um marcador cinza , indicando que no possvel rastrear o
clculo ainda mais.
Rastreando um Novo Caminho de Clculo

possvel clicar em qualquer definio de clula na rea de janela Rastreando
Clculo do Rastreador de Regras para iniciar o rastreio de um novo caminho de
clculo.
Por exemplo, usando o exemplo complexo anterior, voc pode clicar na primeira
definio de clula na rea de janela Rastreando Clculo para iniciar o rastreio de
um novo caminho por meio da consolidao de Srie T.
Ao clicar em uma definio de clula na rea de janela Rastreando Clculo, a rea
de janela Rastreio exibe os componentes do primeiro elemento consolidado na
definio de clula. possvel ento clicar duas vezes em qualquer componente
para iniciar o rastreio de um novo caminho de clculo.
Rastreando Alimentadores
O Rastreador de Regras permite rastrear a maneira na qual uma clula selecionada
alimenta outras clulas.
Como possvel alimentar outras clulas apenas a partir de um elemento folha, o
comando Rastrear Alimentadores est disponvel para as clulas folha definidas
por regras, mas no est disponvel para clulas consolidadas.
69
Procedimento
1. No Cube Viewer, clique com o boto direito do mouse na clula que voc
deseja rastrear.
2. Clique em Rastrear Alimentadores.
A janela Rastreador de Regras se abre. Esta janela contm duas reas de janela.
v Rastreando Alimentadores (rea de janela superior) - Exibe a definio do
local da clula atual, e as regras do alimentador associadas clula atual
v Rastreio (rea de janela inferior) - Exibe os locais alimentados pela clula
atual
3. Clique duas vezes em um local na rea de janela Rastreio.
Este local torna-se o local da clula atual na rea de janela Rastreando
Alimentadores, e a rea de janela Rastreio exibe todos os locais alimentados
pela clula atual.
4. Continue clicando duas vezes nos locais na rea de janela Rastreio at ter
rastreado os alimentadores para o nvel necessrio.
Verificando Alimentadores
Se o cubo contiver uma regra com instrues SKIPCHECK e FEEDERS, ser
possvel usar o Rastreador de Regras para verificar se o TM1 alimenta
adequadamente os componentes da consolidao.
Procedimento
1. No Cube Viewer, clique com o boto direito do mouse na clula consolidada
que voc deseja verificar.
2. Clique em Verificar Alimentadores.
O Rastreador de Regras se abre. Esta janela contm duas reas de janela.
v Verificando Alimentadores (rea de janela superior) - Exibe a definio da
clula atual (consolidao)
v Rastreio (rea de janela inferior) - Exibe todos os componentes da
consolidao que no foram alimentados corretamente
A rea de janela Rastreio est vazia, o que significa que a consolidao foi
alimentada corretamente e os valores de cubos so exatos.
Se a rea de janela Rastreio exibir os componentes da consolidao, ser
necessrio editar a regra associada ao cubo atual para incluir as instrues
FEEDERS que alimentam todos os componentes listados.
Nota: possvel verificar apenas os FEEDERS de uma clula uma nica vez
por sesso do TM1 . A ao de verificao dos ALIMENTADORES realmente
alimenta os componentes da consolidao. Qualquer verificao subsequente
dos ALIMENTADORES no produz resultados exatos. Se voc desejar verificar
os ALIMENTADORES para uma clula mais de uma vez, voc deve reciclar o
IBM Cognos TM1 server antes de cada verificao.
70
Captulo 4. Organizando Objetos em Aplicativos do TM1

O IBM Cognos TM1 permite organizar objetos localmente por aplicativos e por
tipo. Esta seo descreve como criar aplicativos do TM1 .
Viso Geral do Aplicativo TM1

Os aplicativos do TM1 so objetos que funcionam como pastas virtuais para
organizar atalhos para outros objetos, arquivos e Localizadores Uniformes de
Recursos do TM1 em um agrupamento lgico e especfico da tarefa.
Por exemplo, possvel criar um aplicativo que organiza todos os objetos e
arquivos relacionados do TM1 para uma organizao de vendas norte-americana.
Voc insere objetos, arquivos e Localizadores Uniformes de Recursos em um
aplicativo ao criar um atalho ou referncia. Os aplicativos e referncias fornecem
uma maneira rpida e organizada de abrir os objetos de destino para os quais as
referncias apontam.
Tipos de Referncias
Os aplicativos do IBM Cognos TM1 podem conter referncias a qualquer um dos
itens a seguir:
v Objetos do TM1 - Um aplicativo pode conter referncias a qualquer tipo de
objeto do TM1 exceto para regras e replicaes.
possvel referenciar objetos do TM1 no mesmo IBM Cognos TM1 server
contendo o aplicativo ou outro TM1 server para o qual voc possui acesso.
v Arquivos - Um aplicativo pode fazer referncia a qualquer tipo de arquivo,
como uma planilha do Excel, um documento do Word ou qualquer outro
arquivo. Qualquer arquivo Excel pode ser referido, independentemente de o
arquivo conter fatias do TM1 , funes ou outros recursos do TM1 .
possvel fazer referncia a arquivos externos e transferidos por upload:
Uma referncia a um arquivo externo fornece um atalho para um arquivo que
pode existir em qualquer diretrio compartilhado em sua rede.
71
Uma referncia a um arquivo transferido por upload salva uma cpia do arquivo
original no TM1 server . Entretanto, mudanas no arquivo de origem origina,
fora do TM1 , no so automaticamente refletidos na cpia transferida por
upload do arquivo no TM1 server . O arquivo deve ser atualizado no servidor
para que as mudanas fiquem disponveis.
v URLs - Um aplicativo pode conter links para quaisquer pginas da Web ou
recursos que usam o protocolo http ou https.
Comportamento de Referncias
importante entender que quando voc inclui referncias de objeto e arquivo a
um aplicativo, eles existem apenas por referncia - como um atalho que abre o
objeto ou arquivo original do IBM Cognos TM1 . Excluir uma referncia em um
aplicativo diferente de excluir a origem do objeto ou arquivo do TM1 :
v Excluir uma referncia de um aplicativo no causa nenhum impacto no objeto ou
arquivo de origem correspondente do TM1 . Apenas a referncia excluda.
v Excluir um objeto de origem do TM1 , ou um arquivo do disco, quebra qualquer
referncia correspondente em um aplicativo, mas no exclui a referncia. A
referncia permanece, mas no ser funcional se o objeto ou arquivo de origem
for excludo.
Uma exceo para o caso acima para referncias de arquivos transferidos por
upload. Neste caso, o arquivo , na realidade, copiado para o IBM Cognos TM1
server . Se uma referncia a um arquivo transferido por upload for excluda, o
TM1 exclui a cpia do arquivo transferido por upload do TM1 server .
Para obter detalhes sobre referncias de arquivos, consulte Incluindo Referncias
de Arquivo em um Aplicativo na pgina 80
Ordem de Exibio para Referncias em Aplicativos

O TM1 exibe referncias em aplicativos na seguinte ordem. Dentro de cada grupo
de referncia, o TM1 classifica as referncias de forma alfabtica, em ordem
decrescente.
v Cubos
v
v
v
v
v
v
Visualizaes
Dimenses
Subconjuntos
Processos
Tarefas de Organizao de Processos
Arquivos e URLs
Nota: No possvel configurar a ordem na qual os grupos de referncia so

exibidos, nem a ordem de classificao em grupos de referncia.
Usando Aplicativos e Referncias no TM1 Web

Ao criar aplicativos e referncias do TM1 no Server Explorer, eles ficam
automaticamente disponveis no TM1 Web. Isto se aplica a referncias a cubos,
visualizaes, arquivos e URLs.
Para obter detalhes, consulte Publicando Aplicativos do TM1 no TM1 Web na
pgina 90.
72
Pastas e Arquivos de Aplictativos no TM1 server

As pastas e arquivos que suportam aplicativos do TM1 esto armazenados no
diretrio de dados do IBM Cognos TM1 server .
Pastas
A estrutura para pastas de aplicativos no TM1 so organizadas no seguinte local:
TM1 Data Directory \ }applications
Informaes sobre arquivos referidos e transferidos por upload esto armazenadas

em suas subpastas relacionadas aqui.
Arquivos Referidos
As informaes sobre arquivos referidos esto armazenadas em arquivos do
marcador nomeados com a extenso .extr.
Por exemplo, se criar uma referncia de aplicativo a um arquivo denominado
sheet1.xls, o TM1 criar um arquivo de marcador denominado sheet1.xls.extr
para manter o controle dessa entrada.
Arquivos Transferidos por Upload

As informaes sobre arquivos transferidos por upload esto armazenadas em
arquivos do marcador nomeados com a extenso .blob.
Os arquivos reais transferidos por upload para o TM1 server so armazenados no
seguinte local:
TM1 Data Directory \ }Externals
Por exemplo, se voc fizer upload de um arquivo para o banco de dados de

amostra do Planning, ele ser salvo aqui:
C:\Program Files\Cognos\TM1\Custom\TM1Data\PlanSamp\}Externals\
O TM1 anexa automaticamente um sufixo de data e hora no final do nome do

arquivo para qualquer arquivo transferido por upload. O sufixo usa o formato ano
ms dia hora.extenso do arquivo.
Por exemplo, se fizer o upload do arquivo Sample_Budget.xls para o banco de
dados de amostra do Planning, o TM1 ir renome-lo como
Sample_Budget.xls_20090617155650.xls e armazenar o arquivo no seguinte local:
C:\Program Files\Cognos\TM1\Custom\TM1Data\PlanSamp\}Externals\Sample_Budget.
xls_20090617155650.xls
Consideraes de Segurana sobre Criao e Visualizao de

Aplicativos
A tabela a seguir descreve os privilgios de segurana necessrios para executar
aes relacionadas aos aplicativos do TM1 .
Para obter detalhes, consulte Administrando a Segurana para Aplicativos do
TM1 na pgina 87.
73
Ao
Privilgio de segurana necessrio
Criar um aplicativo de nvel superior
Ser membro do grupo ADMIN ou

DataAdmin
Criar um aplicativo de nvel secundrio
Acesso Admin ao aplicativo pai
Visualizar e usar aplicativos e referncias
Ler
Incluir uma referncia particular em um

aplicativo
Ler
Publicar um aplicativo particular
Ser membro do grupo ADMIN ou

DataAdmin
Publicar uma referncia particular para um

objeto pblico
Administrador
Publicar uma referncia particular a um

objeto particular
No pode ser feito
Privatizar um aplicativo ou referncia

pblica
Administrador
Excluir um aplicativo ou referncia pblica
Administrador
Excluir um aplicativo particular
Administrador
Excluir uma referncia particular
Ler
Criando e Gerenciando Aplicativos

Para comear a incluir aplicativos a um IBM Cognos TM1 server , um membro do
grupo do ADMINISTRADOR ou DataAdmin deve primeiro criar um ou mais
aplicativos de nvel superior. Aplicativos de nvel superior so aplicativos que
aparecem diretamente abaixo do grupo Aplicativos no Server Explorer. Os
aplicativos de nvel secundrio aparecem em um aplicativo pai, conforme
explicado em "Criando um Aplicativo de Nvel Secundrio em um Aplicativo
Existente."
No exemplo a seguir, voc v um grupo de aplicativos (Aplicativos), trs
aplicativos de nvel superior (Vendas Europeias, Vendas Norte-americanas e
Vendas de PacRim) e dois aplicativos de nvel secundrio (China e Indonsia)
abaixo do aplicativo de nvel superior Vendas de PacRim.
74
Criando um Aplicativo de Nvel Superior

Siga estas etapas para criar um aplicativo de nvel superior.
Procedimento
1. Certifique-se de que o grupo de Aplicativos est visvel em seu IBM Cognos
TM1 server . Se o grupo no estiver visvel, clique em Visualizar, Aplicativos
no Server Explorer.
2. No Server Explorer, clique com o boto direito do mouse no grupo Aplicativos
no servidor em que voc deseja criar o aplicativo e clique em Criar Novo
Aplicativo.
O TM1 insere um novo aplicativo de nvel superior temporariamente nomeado
como Nova Pasta no grupo de Aplicativos selecionada.
3. Atribua um nome ao novo aplicativo.
Observe que o Microsoft Windows possui alguns nomes de dispositivos
reservados que no podem ser usados como nomes de pastas ou de arquivos.
Consulte o Web site do MS Windows para obter uma lista atualizada de nomes
de dispositivos reservados.
Todos os aplicativos so objetos particulares que apenas o usurio que cria o
aplicativo pode acessar. necessrio publicar um aplicativo para torn-lo
disponvel para outros usurios do TM1 . Somente usurios do TM1 Architect e
do TM1 Perspectives podem criar aplicativos pblicos. Os usurios do TM1
Client podem criar somente aplicativos particulares.
4. Clique com o boto direito do mouse no aplicativo e clique em Segurana,
Tornar Pblico para disponibilizar o aplicativo para outros usurios.
Nota: O tipo de cone usado para um aplicativo depende do status particular
ou pblico do aplicativo.
v Um aplicativo particular exibido com um cone Aplicativos Particulares
que inclui um chave no canto superior direito.
.
v Um aplicativo pblico exibido cm um cone Aplicativos Pblicos
Agora possvel comear a incluir referncias e/ou aplicativos de nvel
secundrio no aplicativo.
Renomeando Aplicativos
Siga estas etapas para renomear um aplicativo.
Procedimento
1. Clique com o boto direito do mouse no aplicativo no Server Explorer.
2. Clique em Renomear.
O nome do aplicativo atual est selecionado e pronto para ser editado.
3. Digite um novo nome para o aplicativo.
4. Pressione ENTER.
Excluindo Aplicativos
possvel excluir qualquer aplicativo, pblico ou particular, para o qual voc
possui o privilgio ADMIN.
Nota: Ao excluir um aplicativo, o IBM Cognos TM1 exclui todos os sub-aplicativos
e referncias contidas no aplicativo.
75
Quando voc tem privilgio ADMIN a um aplicativo, necessrio ter tambm o

privilgio ADMIN para todas as referncias e subaplicativos no aplicativo,
independentemente dos privilgios de segurana que o TM1 aplica por meio da
janela Designaes de Segurana do TM1 . Portanto, quando tiver acesso ADMIN a
um aplicativo, voc poder excluir subaplicativos e referncias para os quais voc
recebeu atribuio apenas do privilgio READ ou NONE.
Para ilustrar o privilgio ADMIN para excluir um aplicativo, considere o exemplo
a seguir. Existem trs aplicativos em um servidor (App1, App2 e App3), todos
criados por um membro do grupo ADMIN.
O administrador definiu os seguintes privilgios de segurana para os aplicativos
para o grupo de usurios Amrica do Norte:
Nome do Aplicativo
Privilgio de Segurana para o Grupo de

Usurios Amrica do Norte
App1
Administrador
App2
Ler
App3
Nenhum
Quando um membro do grupo de usurios da Amrica do Norte efetua logon no

IBM Cognos TM1 server , ele ver App1, para o qual ele possui privilgio do
ADMINISTRADOR, e App2, para o qual ele possui privilgio de LEITURA. Ele
no ver App3, pois ele possui o privilgio NONE para esse aplicativo.
Agora, se um membro do grupo de usurios Amrica do Norte tentar excluir
App1, a excluso ser bem-sucedida. Isto esperado porque o grupo de usurios
Amrica do Norte possui o privilgio ADMIN para App1, que permite a excluso
de aplicativos. No entanto, App2 e App3 (juntamente com as referncias contidas
neles) tambm sero excludos sem aviso, apesar do fato de o grupo Amrica do
Norte ter recebido os privilgios READ e NONE para os aplicativos,
respectivamente.
Procedimento
2. Clique em Excluir.
3. Clique em Sim quando solicitada a confirmao.
Criando um Aplicativo de Nvel Secundrio em um Aplicativo

Existente
Qualquer usurio do IBM Cognos TM1 com privilgio do Administrador para um
aplicativo existente pode criar aplicativos de nvel secundrio.
Procedimento
1. Clique com o boto direito do mouse no aplicativo existente.
2. Clique em Novo, Aplicativo.
O TM1 insere um novo aplicativo de nvel secundrio temporariamente
nomeado de Nova Pasta no aplicativo existente.
3. Atribua um nome ao novo aplicativo.
76
O TM1 cria o aplicativo como um objeto particular que pode ser acessado
apenas por voc.
4. Se voc for um membro do grupo ADMIN ou DataAdmin e desejar publicar o
aplicativo para que outros usurios do TM1 possam acess-lo, clique com o
boto direito do mouse no aplicativo e clique em Segurana, Tornar Pblico.
Ao publicar um aplicativo de nvel secundrio, os privilgios de segurana para
esse aplicativo so herdados dos privilgios de segurana definidos para o
aplicativo pai. possvel alterar os privilgios de segurana segundo as etapas
em Designando Privilgios de Segurana a Aplicativos e Referncias do TM1 a
Grupos de Usurios na pgina 87.
Incluindo Referncias do Objeto do TM1 a um Aplicativo

possvel incluir referncias a objetos a partir do IBM Cognos TM1 server no qual
o aplicativo reside bem como objetos de outros servidores aos quais voc est
conectado.
Procedimento
1. Selecione o objeto no Server Explorer.
2. Arraste e solte o objeto no aplicativo.
Uma referncia ao objeto exibida no aplicativo.
Por padro, qualquer referncia includa em um aplicativo uma referncia
particular, conforme indicado por uma chave que sobrepe o cone do objeto.
Apenas voc pode acessar a referncia.
cone
Descrio
Uma referncia ao cubo SalesCube includa no aplicativo
Vendas da Amrica do Norte.
O TM1 inclui uma imagem de uma seta de atalho a um
cone do objeto para representar uma referncia.
Uma imagem de uma chave includa no canto inferior do
cone de referncia para representar referncias particulares
e em ambos os cantos inferior e superior direito para
representar objetos particulares.
Tornando uma Referncia Pblica

Se deseja tornar a referncia disponvel para outros usurios do IBM Cognos TM1 ,
voc deve publicar a referncia clicando com o boto direito na referncia e
clicando em Item do Aplicativo, Segurana, Tornar Pblico.
O TM1 combina o cone do objeto com uma seta de atalho para identificar uma
referncia pblica para um objeto pblico.
cone
Descrio
Referncia pblica a um subconjunto pblico.
77
cone
Descrio
Referncia pblica a uma visualizao pblica.
Para simplificar o processo de criao de uma referncia pblica, possvel clicar

com o boto direito do mouse em um objeto no Server Explorer, manter o boto
direito do mouse pressionado e, em seguida, arrastar e soltar o objeto em um
aplicativo. Ao soltar o objeto, o TM1 exibir um menu de atalho. Clique em Criar
Referncia Pblica.
possvel publicar referncias apenas em aplicativos pblicos. Ao publicar uma
referncia em um aplicativo, os privilgios de segurana para as referncias so
herdados dos privilgios de segurana definidos para o aplicativo pai. possvel
alterar privilgios de segurana seguindo as etapas descritas em Designando
Privilgios de Segurana a Aplicativos e Referncias do TM1 a Grupos de
Usurios na pgina 87.
Incluindo Referncias a Visualizaes e Subconjuntos

Particulares em um Aplicativo
Ao incluir uma referncia a uma visualizao ou subconjunto particular em um
aplicativo, a referncia criada como uma referncia particular, que o
comportamento padro ao criar qualquer referncia em um aplicativo.
O IBM Cognos TM1 inclui uma imagem de duas chaves para um cone de
referncia para identificar uma referncia particular a um objeto particular.
cone
Descrio
Referncia particular a um subconjunto particular.
Referncia particular a uma visualizao particular.
Estes cones ajudam a diferenciar:

v referncias particulares a objetos particulares, de
v referncias particulares a objetos pblicos.
O TM1 inclui uma chave nica para um cone de referncia para identificar uma
referncia particular para um objeto pblico.
cone
Descrio
Referncia particular a um subconjunto pblico.
78
cone
Descrio
Referncia particular a uma visualizao pblica.
Se publicar uma visualizao ou subconjunto particular para o qual existe uma

referncia, a referncia no ser mais vlida, e exibir uma mensagem de erro
quando acessada.
Por exemplo, se voc criar uma referncia a uma visualizao particular chamada
View1 e, em seguida, tornar View1 pblica, a referncia ser quebrada e no
poder abrir a visualizao. exibida a seguinte mensagem de erro: No possvel
localizar a visualizao particular 'View1' do cubo 'plan_BudgetPlan' no servidor
'planning sample'.
Neste caso, voc deve excluir a antiga referncia e inserir uma nova na
visualizao ou subconjunto (agora) pblico.
Criando Simultaneamente um Novo Objeto e Incluindo uma

Referncia a um Aplicativo
possvel criar um novo objeto de IBM Cognos TM1 a partir de um aplicativo. O
TM1 cria o novo objeto no servidor no qual o aplicativo reside e insere uma
referncia particular ao objeto no aplicativo. possvel criar dimenses, cubos,
processos e tarefas de organizao de processos a partir de um aplicativo.
Procedimento
1. No Server Explorer, clique com o boto direito do mouse no Aplicativo a partir
do qual voc deseja criar o objeto, e clique em Novo <Tipo de Objeto>, no
menu de atalhos. Por exemplo, para criar um novo cubo, clique em Novo,
Cubo.
Ao selecionar um tipo de objeto, aberta uma caixa de dilogo ou janela. Por
exemplo, se voc clicar em Novo, Cubo, a caixa de dilogo Criando Cubo se
abre.
2. Conclua o procedimento necessrio para criar o tipo de objeto escolhido.
Ao terminar, o TM1 cria o objeto no servidor e insere uma referncia particular
ao objeto no aplicativo.
O exemplo mostra o resultado da criao do cubo Novo Cubo a partir do
aplicativo Vendas Norte-americanas.
79
Incluindo Referncias de Arquivo em um Aplicativo

possvel incluir referncias de arquivos para aplicativos do IBM Cognos TM1
para qualquer tipo de arquivo no computador ou rede, como Excel, Word,
PowerPoint, PDF ou qualquer outro arquivo.
Anotaes:
v possvel incluir uma referncia a qualquer arquivo do Excel em um aplicativo.
Voc no est restrito a trabalhar somente com arquivos Excel que contenham
fatias do TM1 ou de outros recursos do TM1 .
v Os arquivos so abertos com o programa ao qual eles esto associados, conforme
configurado nas configuraes de tipo de arquivo do Microsoft Windows . O
TM1 exibe um cone para cada arquivo com base nessa associao.
Procedimento
1. No Server Explorer, clique com o boto direito do mouse no Aplicativo no qual
voc deseja incluir a referncia de aplicativo e clique em Incluir Arquivo no
menu de atalhos.
A caixa de dilogo Incluir Arquivo se abre.
2. Navegue para o diretrio que contm o arquivo e selecione o arquivo que voc
deseja incluir no aplicativo.
3. Selecione uma opo que determina como o TM1 incluir o arquivo no
aplicativo.
Anexar o arquivo como uma referncia - Mantm o arquivo em seu local atual
e insere uma referncia ao arquivo no aplicativo do TM1 .
Quando um arquivo includo como uma referncia, ele exibido como um
cone com uma seta no TM1 . Por exemplo, o cone de um arquivo Excel que
est includo como uma opo de referncia se parece com este
de objetos de aplicativo do TM1 .
na rvore
A principal vantagem desta opo que as edies ou modificaes no arquivo

do Excel ficam imediatamente disponveis no aplicativo. Se selecionar esta
opo, o arquivo do Excel dever residir em uma pasta compartilhada e voc
dever navegar para o arquivo por meio de sua rede para criar um caminho
UNC para o arquivo.
Para manter acesso a um arquivo de Excel anexado sempre que o IBM Cognos
TM1 server estiver sendo executado, o computador onde o arquivo reside deve
estar disponvel na rede.
Copiar o arquivo para o TM1 server - Copia o arquivo para o TM1 server no
qual reside o aplicativo.
Esse tipo de referncia exibido como um cone sem uma seta no TM1 . Por
exemplo, um arquivo de Excel que includo usando o Copiar o arquivo para a
nos aplicativos do TM1 :
opo TM1 server possui o cone a seguir
O TM1 copia os arquivos transferidos por upload para o subdiretrio }Externals
do diretrio de dados do TM1 server . Por exemplo, se incluir um arquivo do
Excel em um aplicativo no servidor sdata que faa parte do banco de dados de
amostra do TM1 , o TM1 salvar o arquivo para
C:\Program Files\Cognos\TM1\Custom\TM1Data\sdata\}Externals.
A vantagem principal dessa opo que o arquivo fica disponvel sempre que
TM1 server estiver em execuo. Entretanto, as alteraes no arquivo de origem
80
original no so refletidas automaticamente no arquivo no TM1 server . O

arquivo deve ser atualizado no servidor para que as mudanas fiquem
disponveis.
v Para obter detalhes na atualizao dos arquivos Excel que foram copiados
para o TM1 , consulte Atualizando Arquivos Excel no TM1 Server na
pgina 82.
v Para obter detalhes na atualizao sobre arquivos no Excel que foram
copiados para o TM1 , consulte Atualizando Arquivos No Excel no TM1
server na pgina 83.
Nota: Se voc selecionar a opo Copiar o Arquivo para TM1 server , o
arquivo que voc deseja transferir por upload no pode estar em uso por outro
programa. Se voc tentar transferir por upload um arquivo aberto, o TM1 exibe
uma mensagem de erro. Certifique-se de o arquivo estar fechado antes de fazer
seu upload para o TM1 .
4. Selecione a opo Pblico ou Particular.
v Pblico - Torna a referncia de arquivo disponvel a outros usurios que
tm acesso ao aplicativo do TM1 .
v Particular - Apenas voc pode acessar a referncia ao arquivo.
5. Dependendo de como o TM1 for configurado, a caixa de seleo Publicar em
TM1 Web pode aparecer na caixa de dilogo Incluir Arquivo.
Quando esta opo est disponvel, o TM1 requer que voc selecione
explicitamente se deseja publicar um arquivo do Excel a partir de um TM1 para
o TM1 Web. Para obter detalhes adicionais, consulte Publicando Arquivos do
Excel no TM1 Web sem Usar o Excel no Servidor TM1 Web na pgina 92.
Se esta opo estiver disponvel e voc desejar publicar o arquivo de Excel
selecionado no TM1 Web, clique na caixa de seleo Publicar em TM1 Web.
Nota: A caixa de seleo Publicar para TM1 Web se torna ativa apenas depois
que voc clicar em um arquivo do Excel.
6. Clique em Abrir.
O arquivo est agora disponvel a partir do aplicativo do TM1 .
Tambm possvel acessar arquivos em aplicativos do TM1 a partir do TM1
Web. Para obter detalhes, consulte as seguintes sees posteriormente nesta
seo:
v Publicando Aplicativos e Referncias do TM1 na pgina 89.
v Publicando Aplicativos do TM1 no TM1 Web na pgina 90.
Entendendo Referncias de Arquivos Pblicas e Particulares

O IBM Cognos TM1 usa os formatos de cones a seguir para identificar
visualmente referncias pblicas e particulares de arquivos em aplicativos do TM1
.
cone
Descrio
Referncia pblica a um arquivo que foi includo no TM1
como uma referncia.
Referncia particular a um arquivo que foi includo no TM1
como referncia.
81
cone
Descrio
Referncia pblica a um arquivo copiado no TM1 server .
Referncia particular a um arquivo copiado no TM1 server .
Comportamento de Arquivos Transferidos por Upload ao TM1

Server
Um arquivo transferido por upload qualquer arquivo que includo em um
aplicativo do IBM Cognos TM1 usando a opo Copiar o arquivo para o TM1
server .
Os arquivos transferidos por upload se comportam diferentemente de arquivos
referenciados porque arquivos transferidos por upload so, na realidade, copiados
e armazenados no IBM Cognos TM1 server .
v O TM1 copia e salva arquivos transferidos por upload para o TM1 server no
diretrio a seguir: diretrio <server_data_dir>\}Externals.
v Quando um arquivo transferido por upload para o TM1 server, o nome do
arquivo anexado com um registro de hora/data.
Por exemplo, se fizer o upload do arquivo US Budget.xls para o TM1 server, o
arquivo ser salvo como US Budget.xls_20040702193054.xls.
v Ao excluir um arquivo transferido por upload de um aplicativo do TM1 , o TM1
exclui a cpia do arquivo transferido por upload do diretrio }Externals. O arquivo
original, fora do TM1 , do qual o arquivo transferido por upload foi copiado,
no excludo.
v Se desejar criar um hyperlink que abre um arquivo transferido por upload a
partir de uma planilha da Web ou de outro arquivo de aplicativo do TM1 no
TM1 Web, o hyperlink dever incluir o nome designado do TM1 para o arquivo
transferido por upload. Para obter detalhes, consulte Criando Hyperlinks para
Arquivos Transferidos por Upload na pgina 93.
Atualizando Arquivos Excel no TM1 Server

O IBM Cognos TM1 fornece um processo dedicado para apenas transferir por
update arquivos de Excel que tenham sido transferido por upload para o IBM
Cognos TM1 server . Para obter detalhes sobre como atualizar arquivos no Excel
(Word, PowerPoint ou outros tipos de arquivos), consulte Atualizando Arquivos
No Excel no TM1 server na pgina 83.
Procedimento
1. Clique duas vezes no arquivo no Server Explorer.
O arquivo aberto no Excel com um nome de arquivo temporrio, como
TM12C5D.xls, exibido na barra de ttulo.
Nota: importante lembrar o nome original do arquivo que est sendo
atualizado (em oposio ao nome do arquivo temporrio). Voc precisar
selecionar o arquivo original posteriormente na etapa 4.
2. Aplique suas edies ao documento do Excel.
82
3. Clique em TM1 , Salvar Pasta de Trabalho no TM1 Server , Atualizar Arquivo

de Aplicativo Existente no TM1 Server .
A caixa de dilogo Selecionar Arquivo Externo do TM1 para Atualizar ser
aberta.
4. Selecione o arquivo original do Excel que voc deseja atualizar.
Certifique-se de selecionar o arquivo original do Excel aberto na Etapa 1. Se
selecionar qualquer outro arquivo, o TM1 sobrescrever esse arquivo
selecionado sem aviso.
5. Clique em OK.
O TM1 atualiza o arquivo no TM1 server . O arquivo do Excel est disponvel a
partir de seu aplicativo pai.
Atualizando Arquivos No Excel no TM1 server

possvel atualizar um arquivo no Excel que tenha sido transferido por upload
para o IBM Cognos TM1 server salvando o arquivo como um arquivo externo e,
ento, incluindo novamente o arquivo manualmente no servidor.
Procedimento
1. Clique duas vezes no arquivo no Server Explorer.
O arquivo aberto no programa associado a um nome de arquivo temporrio,
como TM163.doc, exibido na barra de ttulo.
Por exemplo, um arquivo do Word transferido por upload aberto no
Microsoft Word.
2. Usando o programa associado ao arquivo, faa suas mudanas no arquivo e,
em seguida, use o recurso Salvar como do programa para salvar o arquivo em
um novo local e nome do arquivo.
Nota: Lembre-se do nome e do local do novo arquivo atualizado, para que
possa inclu-lo novamente no TM1 na prxima etapa.
3. No Server Explorer, clique com o boto direito do mouse na verso antiga do
arquivo e clique em Excluir.
O TM1 exibe o dilogo Confirmar Excluso de forma que seja possvel excluir
o arquivo antigo.
4. Inclua novamente o arquivo atualizado usando as etapas descritas em
Incluindo Referncias de Arquivo em um Aplicativo na pgina 80.
Incluindo Referncias de URL em um Aplicativo

possvel incluir um endereo de URL em um aplicativo para qualquer um dos
seguintes protocolos de URL:
v http://
v https://
Ao abrir uma referncia de URL em um aplicativo do IBM Cognos TM1 a partir do
TM1 Server Explorer ou TM1 Web, a origem de destino da URL exibida no
navegador da Web padro do sistema.
Procedimento
1. No Server Explorer, clique com o boto direito do mouse no Aplicativo no qual
voc deseja incluir a referncia de URL e clique em Incluir URL no menu de
atalhos.
83
O dilogo Incluir URL se abre.

2. Insira uma URL completa, incluindo o protocolo http:// ou https://.
Por exemplo: http://www.Empresa.com
3. Insira um nome descritivo para a URL.
Por exemplo: Web site da Empresa
4. Clique em OK para incluir a URL.
O Localizador Uniforme de Recursos includo no aplicativo do TM1 usando o
cone padro do sistema para um link do Localizador Uniforme de Recursos.
Trabalhando com Referncias de Objeto, Arquivo e Localizador

Uniforme de Recursos em Aplicativos do TM1 Applications
possvel clicar duas vezes em uma referncia a um objeto, arquivo ou URL em
um aplicativo do IBM Cognos TM1 para executar a ao padro no objeto.
possvel clicar com o boto direito do mouse em uma referncia do objeto, e
selecionar qualquer ao suportada para o objeto a partir do menu de atalhos.
A seguinte tabela descreve a ao padro de todos os objetos, arquivos e
Localizadores Uniformes de Recursos que podem ser acessados a partir de
aplicativos do TM1 .
Tipo de Referncia
Ao Padro
Cubo
Abre a visualizao padro do cubo no Cube Viewer.
Visualizao de cubo
Abre a visualizao no Cube Viewer.
Dimenso
Abre o subconjunto padro da dimenso no Editor de

Subconjuntos. Se um subconjunto padro no estiver definido,
ser aberta a opo Todo o subconjunto.
Subconjunto
Abre o subconjunto no Editor de Subconjuntos.
Processo
Abre o processo para edio na janela TurboIntegrator.
Tarefa de Organizao de Se a tarefa de organizao de processos estiver inativa, abra-a

Processos
no Assistente de Configurao de Tarefa de Organizao de
Processos. (No possvel abrir uma tarefa de organizao de
processos ativa.)
Arquivo
Abre o arquivo no programa ao qual ele est associado,

conforme definido nas configuraes de tipo de arquivo do
Microsoft Windows . Por exemplo, um arquivo .xls aberto no
Excel.
URL
Abre a URL no navegador da Web padro do sistema.
Nota: Ao acessar objetos do TM1 que esto localizados em outro IBM Cognos TM1
server , o servidor deve ser executado e voc deve ter efetuado login nele.
84
v Se tentar acessar uma referncia a um objeto que reside em um servidor em

execuo, mas ao qual no est atualmente conectado, o TM1 solicitar que
efetue login no servidor.
v Se tentar acessar uma referncia a um objeto que reside em um servidor que no
est em execuo, o TM1 emitir o seguinte aviso: O servidor no qual este objeto
reside no est respondendo. Atualizar exibio do Server Explorer?
Para restaurar o acesso referncia, inicie o servidor no qual o objeto de origem
reside.
Visualizando Propriedades do Aplicativo do TM1

Siga estas etapas para visualizar as propriedades de referncias e sub-aplicativos
no aplicativo do IBM Cognos TM1 .
Procedimento
1. Selecione o aplicativo no Server Explorer.
2. Se a rea de janela Propriedades no estiver visvel no Server Explorer, clique
.
em Exibir, Janela Propriedades
A rea de janela Propriedades exibe informaes sobre todas as referncias e
subaplicativos para os quais voc possui pelo menos o acesso Read. As
referncias e subaplicativos para os quais voc possui acesso None no
aparecem no Server Explorer, portanto, no possvel visualizar as
propriedades destes itens.
Somente subaplicativos imediatos do aplicativo selecionado do TM1 aparecem
na rea de janela Propriedades.
3. Para classificar itens na rea de janela Propriedades em ordem alfabtica por
valor da propriedade, clique no rtulo da coluna ao qual deseja aplicar a
classificao. Por exemplo, para classificar itens por ordem alfabtica por status
atual, clique no rtulo da coluna Status.
Para cada referncia e subaplicativo, so exibidas as seguintes propriedades.
Propriedade
Descrio
Nome
O nome da referncia ou subaplicativo conforme ele aparece no

aplicativo selecionado.
possvel editar nomes de referncias, que no precisam
corresponder diretamente aos nomes de objetos de origem. Por
exemplo, na figura acima, a referncia de Preo refere-se ao cubo de
origem chamado PriceCube.
Nome do Sistema
v Para a maioria das referncias, Nome do Sistema o nome real

do objeto de origem para o qual uma referncia aponta.
v Para arquivos que foram transferidos por upload para o IBM
Cognos TM1 server , o Nome do Sistema o nome designado
para o arquivo no TM1 server . Convenes de nomenclatura para
arquivos transferidos por upload para o TM1 server so descritos
no Comportamento de Arquivos Transferidos por Upload ao
TM1 Server na pgina 82.
v Para arquivos anexados como uma referncia, Nome do Sistema
o caminho UNC para o arquivo.
v A propriedade Nome do Sistema no aplicvel a subaplicativos.
85
Propriedade
Descrio
Servidor
O TM1 server no qual reside o objeto de origem de uma referncia.

Por exemplo, na imagem acima, o cubo de origem para a referncia
Moeda reside no servidor de inventrio.
Particular
Esta propriedade aplicvel apenas a subconjuntos e visualizaes.

A propriedade Particular indica se a origem para uma referncia de
subconjunto ou de visualizao um objeto particular. Um valor da
propriedade de Sim indica que a origem um objeto particular. No
indica um objeto pblico.
Por exemplo, na imagem acima, as origens para a referncia de
subconjunto Moedas Norte-americanas, bem como as visualizaes
Plano de Preo Norte-americano e Modelos Norte-americanos, so
todas objetos particulares.
Status
Segurana
Esta propriedade indica a disponibilidade atual de referncias e

subaplicativos. Existem trs possveis valores de Status:
v
Disponvel - A referncia ou subaplicativo est disponvel para

uso.
No Conectado - Voc no est conectado ao TM1 server no qual

reside o objeto de origem para a referncia. Efetue login no
servidor para restaurar seu acesso referncia.
No Disponvel - O TM1 server no qual reside o objeto de

origem no est em execuo e, portanto, no possvel acessar a
referncia.
Esta propriedade indica seu privilgio de segurana para uma

referncia ou subaplicativo.
Excluindo Referncias de Objeto, Arquivo e Localizador

Uniforme de Recursos de Aplicativos do TM1
Siga estas etapas para excluir uma referncia de objeto a partir de um aplicativo do
IBM Cognos TM1 .
Procedimento
1. Clique com o boto direito do mouse na referncia do objeto no aplicativo.
Nota: Voc deve selecionar a referncia do objeto no aplicativo. Se voc
selecionar o objeto de origem em outro lugar na hierarquia do servidor, no
poder excluir o objeto do aplicativo.
2. Clique em Item do Aplicativo, Excluir.
Para excluir uma referncia de arquivo ou de URL de um aplicativo:
v Clique com o boto direito do mouse no arquivo no aplicativo.
v Clique em Excluir.
86
Renomeando Referncias de Objeto, Arquivo e Localizador

Uniforme de Recursos em Aplicativos do TM1
Uma referncia para um objeto ou arquivo em um aplicativo do IBM Cognos TM1
no precisa usar o nome do arquivo de origem com o qual ele est associado.
possvel renomear uma referncia do objeto ou de arquivo em um aplicativo e
manter a conexo com o arquivo de origem.
Procedimento
1. Clique com o boto direito do mouse na referncia no aplicativo.
2. Selecione a opo Renomear, da seguinte forma:
v Clique em Item do Aplicativo, Renomear para renomear uma referncia do
objeto.
v Clique em Renomear para renomear uma referncia de arquivo ou de URL.
O nome da referncia est selecionado e pronto para ser editado.
3. Digite um novo nome para a referncia.
4. Pressione Enter.
Excluindo Objetos de Origem Referidos por Aplicativos do

TM1
Quando voc excluir um objeto de origem que referenciado por um aplicativo do
IBM Cognos TM1 , o TM1 no exclui a referncia do objeto correspondente do
aplicativo.
Por exemplo, se voc excluir a visualizao Vendas do Canad do servidor de
dados, a referncia visualizao Vendas do Canad permanecer no aplicativo
Vendas Norte-americanas.
Se voc tentar abrir uma referncia de objeto ou arquivo em um aplicativo e a
origem para o objeto ou arquivo tiver sido excludo do IBM Cognos TM1 server , o
TM1 exibe uma mensagem de erro, declarando que o objeto 'US Sales' no servidor
'sdata' no pode ser localizado e avisa-o para excluir a referncia.
Quando a origem para um objeto ou arquivo em um aplicativo tiver sido excluda
do servidor, ser necessrio excluir a referncia correspondente do aplicativo. Para
obter detalhes, consulte Excluindo Referncias de Objeto, Arquivo e Localizador
Uniforme de Recursos de Aplicativos do TM1 na pgina 86.
Administrando a Segurana para Aplicativos do TM1

As sees a seguir descrevem como designar privilgios de segurana para
aplicativos e referncias do IBM Cognos TM1 para grupos de usurio no IBM
Cognos TM1 server, bem como publicar e privatizar aplicativos e referncias do
TM1 .
Designando Privilgios de Segurana a Aplicativos e

Referncias do TM1 a Grupos de Usurios
possvel designar privilgios de segurana para itens pblicos (referncias ou
sub-aplicativos) em aplicativos pblicos do IBM Cognos TM1 para grupos de
usurios no servidor do IBM Cognos TM1 . necessrio ter o privilgio Admin
para um aplicativo para atribuir segurana a itens no aplicativo.
87
No possvel atribuir segurana para aplicativos e referncias particulares; apenas

o usurio que cria um item particular pode acessar o item.
Procedimento
1. No Server Explorer, clique com o boto direito do mouse no aplicativo TM1
que contm os itens para os quais deseja designar segurana.
2. Clique em Segurana, Designaes de Segurana.
A janela Designaes de Segurana ser aberta. A janela lista todos os itens
pblicos (objetos, arquivos, Localizadores Uniformes de Recursos e
subaplicativos do TM1 ) que residem no aplicativo atual.
3. Selecione a clula na interseo do item para o qual voc deseja definir
segurana e o grupo de usurios ao qual voc deseja atribuir segurana.
4. Clique em um dos privilgios de segurana disponveis.
Privilgio de
Segurana
Conforme aplicado em aplicativos do

TM1
Conforme aplicado a
referncias
Nenhum
Os membros do grupo de usurios no

podem ver o aplicativo ou seu
contedo.
Os membros do grupo de
usurios no podem ver a
referncia.
Ler
Os membros do grupo de usurios

podem ver o aplicativo e usar quaisquer usurios podem usar a
referncias no aplicativo para o qual o
referncia.
grupo possui pelo menos o privilgio
Read. Os membros tambm podem criar
referncias particulares no aplicativo.
Administrador
Os membros do grupo de usurios

podem ver o aplicativo, usar referncias
no aplicativo e criar referncias pblicas
e particulares no aplicativo. Eles
tambm podem criar subaplicativos
particulares.
usurios podem usar a
referncia. Eles tambm
podem atualizar ou excluir
a referncia. Eles podem
publicar referncias
particulares e fazer com que
Os membros com privilgio Admin para referncias pblicas se
um aplicativo podem definir privilgios tornem particulares.
de segurana para todas as referncias e
subaplicativos no aplicativo.
5. Repita as etapas 3 e 4 para quaisquer outros itens para os quais voc deseja
definir segurana.
6. Clique em OK.
Resultados
Para qualquer grupo de usurios especificado, possvel atribuir o privilgio
READ ou ADMIN a uma referncia quando o privilgio atribudo ao objeto
associado referncia for NONE. Neste cenrio, os membros do grupo de usurios
no podero ver a referncia em um aplicativo.
Por exemplo, se a um grupo de usurios for atribudo o privilgio NONE para um
cubo, mas o privilgio READ para uma referncia no mesmo cubo, os membros do
grupo de usurios no vero a referncia ao cubo em um aplicativo.
88
Publicando Aplicativos e Referncias do TM1

As sees a seguir descrevem como publicar aplicativos e referncias do IBM
Cognos TM1 . Para determinar os privilgios de segurana necessrios para
executar estes procedimentos, consulte "Consideraes de Segurana para Criar e
Visualizar os Aplicativos".
Publicando Aplicativos Particulares do TM1

Siga estas etapas para publicar um aplicativo particular.
Procedimento
2. Clique em Segurana, Tornar Pblico.
Nota: Ao publicar um aplicativo particular, o IBM Cognos TM1 tambm
publica todas as referncias particulares para objetos pblicos no aplicativo.
Publicando Referncias Particulares a Objetos Pblicos

possvel publicar referncias particulares que residem em aplicativos pblicos
Procedimento
1. Clique com o boto direito do mouse na referncia no Server Explorer.
2. Selecione Item do Aplicativo, Segurana, Tornar Pblico.
Privatizando Aplicativos e Referncias do TM1

possvel privatizar aplicativos e referncias pblicas do IBM Cognos TM1 .
Quando voc torna um aplicativo ou referncia particular, apenas voc pode
acessar o item.
Privatizando um Aplicativo Pblico do TM1

Siga estas etapas para privatizar um aplicativo pblico.
Procedimento
2. Selecione Segurana, Tornar Particular.
Ao privatizar um aplicativo pblico, todas as referncias pblicas no aplicativo
tambm so automaticamente privatizadas.
Se um aplicativo pblico contiver referncias com nomes idnticos a um nico
tipo de objeto, um pblico e um particular, a sequncia _Public ser anexada
referncia pblica quando o aplicativo for privatizado.
Por exemplo, a imagem a seguir mostra o aplicativo Vendas Europeias, que
contm duas referncias s exibies chamadas Vendas do Norte Europeu, uma
pblica e uma particular.
Ao privatizar o aplicativo Vendas Europeias, a referncia pblica convertida

em uma referncia particular e seu nome alterado para Vendas do Norte
89
Europeu_Public, indicando que esta uma referncia particular a um objeto

pblico.
A mudana de nome necessria porque um aplicativo no pode conter duas

referncias particulares com nomes idnticos a um nico tipo de objeto.
Privatizando uma Referncia Pblica

Siga estas etapas para privatizar uma referncia pblica.
Procedimento
1. Clique com o boto direito do mouse na referncia no Server Explorer.
2. Selecione Item do Aplicativo, Segurana, Tornar Particular.
Visualizando Agrupamentos Lgicos em Aplicativos do TM1

Uma das primeiras vantagens de aplicativos IBM Cognos TM1 que eles permitem
visualizar e gerenciar objetos e arquivos em agrupamentos lgicos. Isso simplifica a
tarefa de usar o TM1 , pois possvel identificar e localizar facilmente arquivos e
objetos em aplicativos especficos da tarefa sem ter de varrer grandes listas de
objetos organizados por tipo.
Para simplificar ainda mais o uso do TM1 , possvel suprimir a exibio de
objetos por tipo. Isto produz uma exibio mais limpa, mais facilmente navegvel
no Server Explorer. (Por padro, todos os tipos de objetos so exibidos no Server
Explorer.)
Para suprimir a exibio de um tipo especfico de objeto, clique em Visualizar,
<Tipo de Objeto> no Server Explorer. Isto limpa o visto junto ao tipo de objeto no
menu Visualizar e suprime a exibio do tipo de objeto no Server Explorer. Na
amostra a seguir, todos os objetos so suprimidos, exceto para Aplicativos.
Nota: Ao suprimir a exibio de um determinado tipo de objeto no Server
Explorer, as referncias a objetos desse tipo ainda aparecero nos aplicativos do
TM1 . No entanto, os objetos de controle so suprimidos em aplicativos quando a
exibio de objetos de controle suprimida no Server Explorer.
Publicando Aplicativos do TM1 no TM1 Web

Todas as referncias a cubos, visualizaes, arquivos e URLs em aplicativos do IBM
Cognos TM1 esto automaticamente disponveis no TM1 Web.
Nota: Se sua instalao do TM1 Web estiver configurada para executar sem o
Microsoft Excel no servidor da Web, voc deve publicar explicitamente todos os
arquivos de Excel em aplicativos do TM1 em TM1 Web se desejar que os arquivos
de Excel estejam disponveis como planilhas da Web do TM1 . Para obter detalhes
adicionais, Publicando Arquivos do Excel no TM1 Web sem Usar o Excel no
Servidor TM1 Web na pgina 92.
90
Suponha que Vendas Norte Americanas seja um aplicativo pblico que contm
uma coleo de objetos do TM1 e arquivos do Excel. Quando acessar o sdata IBM
Cognos TM1 server por meio do TM1 Web, estas referncias sero exibidas sob
Aplicativos.
Ao trabalhar no TM1 Web, possvel clicar em uma referncia para abri-la e
exibi-la da seguinte forma:
v Os cubos e as visualizaes Cubes so exibidos diretamente no TM1 Web.
v Os arquivos do Excel so exibidos como planilhas da Web do TM1 diretamente
no TM1 Web.
Nota: Os arquivos do Excel que foram protegidos por meio de comando do
Excel, Ferramentas, Proteo, no podem ser acessados atravs do TM1 Web.
v Os arquivos no Excel so abertos e exibidos em seu programa associado.
Nota: Alguns tipos de arquivos e programas podem no ser visualizveis no
TM1 Web.
v As referncias de URL so abertas e exibidas em um navegador da Web
separado.
Por exemplo, clique em um arquivo do Excel para abri-lo em formato da planilha
da Web do TM1 .
Nota: O TM1 determina as larguras de colunas da planilha da Web com base no
arquivo da Excel a partir do qual a planilha da Web gerada. Se as colunas no
arquivo do Excel no acomodarem a exibio completa de rtulos da linha e da
coluna, os rtulos correspondentes na planilha da Web sero truncados.
possvel acessar aplicativos e referncias pblicos e particulares por meio do
TM1 Web. Somente o usurio que cria um aplicativo ou referncia particular pode
acessar o item por meio do TM1 Web. O acesso a aplicativos e referncias pblicas
no TM1 Web determinado pelos privilgios de segurana definidos para os
aplicativos e referncias de origem no TM1 server . Para obter detalhes sobre como
definir privilgios de segurana, consulte Designando Privilgios de Segurana a
Aplicativos e Referncias do TM1 a Grupos de Usurios na pgina 87.
Configurando Propriedades da Planilha da Web do TM1

As propriedades da planilha da Web so configuradas no Server Explorer para
controlar como um arquivo de Excel aparece e se comporta quando visualizado
como planilha da Web no IBM Cognos TM1 Web.
Procedimento
1. No Server Explorer, abra o aplicativo do TM1 que contm o arquivo do Excel a
partir do qual a planilha da Web do TM1 gerada.
2. Clique com o boto direito do mouse no arquivo do Excel.
3. Clique em Propriedades.
A caixa de dilogo Propriedades do TM1 Web ser aberta.
4. Use as opes nas guias Geral e Propriedades de Exibio para configurar
propriedades para a Planilha da Web do TM1 .
Para obter detalhes sobre as opes do TM1 Web Properties, consulte o Guia do
Usurio do IBM Cognos TM1 .
5. Clique em OK.
91
Publicando Arquivos do Excel no TM1 Web sem Usar o Excel

no Servidor TM1 Web
Se sua instalao do IBM Cognos TM1 Web estiver configurada para executar sem
o Microsoft Excel no servidor da Web, voc deve publicar explicitamente todos os
arquivos de planilha em aplicativos do TM1 para TM1 Web se deseja que os
arquivos de Excel estejam disponveis como planilhas da Web do TM1 . Da mesma
forma, sempre que alterar um arquivo do Excel que foi anteriormente publicado no
TM1 Web, ser necessrio publicar novamente o arquivo para tornar as alteraes
disponveis na planilha da Web.
Para obter detalhes sobre esta configurao, consulte o parmetro
ExcelWebPublishEnabled no Guia de Operaes do IBM Cognos TM1 .
Nota: No possvel publicar arquivos .xlsx do Excel 2007 no TM1 Web quando o
Excel no estiver disponvel no servidor da Web. Estes arquivos devem ser salvos
em formato .xls do Excel 2003, se voc desejar public-los no TM1 Web.
H diversos mtodos para publicar arquivos do Excel no TM1 Web. possvel:
v Incluir simultaneamente um arquivo do Excel em um aplicativo e publicar no
TM1 Web
v Publicar arquivos individuais do Excel que existem em um aplicativo no TM1
Web
v Publicar todos os arquivos do Excel em um aplicativo no TM1 Web
Incluindo Simultaneamente um Arquivo do Excel em um

Aplicativo e Publicando no TM1 Web
Quando voc inserir inicialmente um arquivo de Excel em um aplicativo,
possvel escolher publicar simultaneamente o arquivo no IBM Cognos TM1 Web.
Esta opo fica disponvel quando o parmetro de configurao
ExcelWebPublishEnabled definido como verdadeiro.
Existem duas maneiras de incluir um arquivo do Excel em um aplicativo:
v No Architect/Server Explorer - Clique com o boto direito do mouse em um
aplicativo e escolha Incluir Arquivo.
v Nas Perspectivas do TM1 - Escolha TM1 , Salvar Pasta de Trabalho em TM1
server , Transferir por Upload Novo Arquivo de Aplicativo para TM1 server e,
ento selecione uma pasta de aplicativos.
Independentemente do mtodo usado, o TM1 exibe uma caixa de dilogo com
uma opo para publicar o arquivo no TM1 Web enquanto inclui o arquivo em um
aplicativo.
Nota: A caixa de seleo Publicar para TM1 Web se torna ativa apenas depois que
voc clicar em um arquivo .xls do Excel.
possvel escolher publicar ou no o arquivo do Excel no TM1 Web, da seguinte
forma:
v Selecione a opo Publicar em TM1 Web para publicar o arquivo de Excel no
TM1 Web.
v Limpe a opo Publicar em TM1 Web para incluir o arquivo de Excel no
aplicativo, mas no publique o arquivo no TM1 Web.
92
Excluindo um Arquivo do Excel do TM1 Web

Tambm possvel excluir um arquivo de Excel que foi publicado anteriormente
no IBM Cognos TM1 Web. Ao excluir um arquivo do Excel do TM1 Web, a
planilha da Web no estar mais disponvel no TM1 Web, mas o arquivo de origem
do Excel permanecer no aplicativo do TM1 .
Procedimento
1. Clique com o boto direito do mouse no arquivo.
2. Selecione Remover do TM1 Web.
Atualizando Arquivos do Excel em Aplicativos do TM1

Para atualizar um arquivo de Microsoft Excel que tenha sido publicado
anteriormente, escolha a opo a seguir na barra de ferramentas do Excel: TM1 ,
Salvar Pasta de Trabalho em TM1 server , Atualizar Arquivo de Aplicativo
Existente em TM1 server .
possvel republicar simultaneamente o arquivo de Excel atualizado para TM1
Web selecionando a opo Publicar Arquivo para TM1 Web.
Para obter detalhes adicionais sobre como atualizar arquivos do Excel, consulte
Atualizando Arquivos Excel no TM1 Server na pgina 82.
Nota: Se voc atualizar um arquivo de Excel que foi publicado anteriormente no
IBM Cognos TM1 Web, mas no selecionou a opo Publicar Arquivo em TM1
Web, o arquivo no aplicativo ser diferente do arquivo disponvel no TM1 Web.
No h nenhuma indicao visual no Server Explorer para alert-lo de que o
arquivo foi atualizado em um aplicativo, mas no foi publicado novamente no
TM1 Web.
Criando Hyperlinks para Arquivos Transferidos por Upload

Se desejar que uma planilha da Web contenha um hyperlink para um arquivo
transferido por upload, o hyperlink deve incluir o local e nome que o IBM Cognos
TM1 designa para o arquivo transferido por upload.
Ao incluir um arquivo transferido por upload em um aplicativo do TM1 , uma
cpia do arquivo salva no IBM Cognos TM1 server e o nome do arquivo
anexado com um registro de dados e de data e hora. Por exemplo:
Report_2006.xls_20070123212746.xls
Se no incluir um nome de arquivo designado do TM1 no hyperlink, o link no

funcionar no TM1 Web e um erro ser exibido, por exemplo,
"O arquivo no existe: TM1 ://planning sample/blob/PUBLIC/.\}Externals\
upload_test_2.xls".
Procedimento
1. No Server Explorer, use a rea de janela Propriedades para localizar o Nome
do Sistema, que o nome designado do TM1 para o arquivo do Excel
transferido por upload que ser o destino do hyperlink.
2. Crie o hyperlink para o arquivo do Excel transferido por upload usando o
seguinte formato:
TM1://ServerName/blob/PUBLIC/.\}Externals\
TM1_Filename
em que:
93
ServerName o nome do servidor TM1 em que o arquivo do Excel est

localizado.
v TM1_Filename o nome que o TM1 designou para o arquivo do Excel
transferido por upload.
Por exemplo:
v
TM1://sdata/blob/PUBLIC/.\}Externals\Report_2006.xls_20070123212746.xls
3. No Excel, inclua o hyperlink na planilha onde voc deseja que o link exista.
4. Inclua a planilha em um aplicativo do TM1 e, ento, visualize o arquivo como
uma planilha da Web no TM1 Web.
Exibindo Planilhas da Web que Contm o Caractere

Hexadecimal 0x1A
O IBM Cognos TM1 Web no pode abrir uma planilha da Web que contenha o
caractere hexadecimal 0x1A. Se tentar abrir uma planilha da Web que contm o
caractere hexadecimal 0x1A, o TM1 Web emitir o seguinte erro:
Ocorreu um erro ao converter a pasta de trabalho do MS Excel em formato XML: '',
o valor hexadecimal 0x1A, um caractere invlido. Linha 54, posio 34.
Se remover o caractere hexadecimal 0x1A da planilha da Web, o arquivo ser
aberto no TM1 Web.
Nota: A funo ASCIIOutput do TurboIntegrator coloca o caractere hexadecimal
0x1A no final de todos os arquivos gerados. Se usar o ASCIIOutput para exportar
dados do TM1 para um arquivo ASCII e, ento, tentar abrir o arquivo na planilha
da Web do TM1 , encontrar este erro.
94
Captulo 5. Importando Dados com Planilhas de

Processamento
Esta seo descreve como importar dados em um cubo do IBM Cognos TM1
usando uma planilha de processamento. Uma planilha de processamento uma
planilha modificada do Excel na qual as funes do TM1 so usadas para enviar
valores a um local em um cubo existente.
Nota: As planilhas de processamento, embora sejam um meio vlido de importar
dados, so uma funcionalidade descontinuada na liberao atual do TM1 .
altamente recomendvel usar o TurboIntegrator para importar dados para cubos
do TM1 .
Os seguintes tpicos so descritos nesta seo.
v Viso Geral de Planilhas de Processamento
v Importando Dados Usando Planilhas de Processamento
Viso Geral de Planilhas de Processamento

Uma planilha de processamento uma planilha modificada do Excel na qual as
funes so usadas para enviar valores de entrada a um local em um cubo
existente do TM1 .
As planilhas de processamento podem ser usadas para converter valores de
entrada que no so mapeados diretamente para elementos existentes. Por
exemplo, na tabela a seguir, as duas primeiras colunas contm cdigos que no
correspondem diretamente a elementos no cubo para o qual os valores esto sendo
enviados.
Cenrio
Regio
Modelo
Medida
Jan
Fev
Mar
001
R54
Srie S 1.8 L ...
Preo
25259,93
25830,76
25041,90
002
R54
Srie S 1.8 L ...
Preo
25259,93
25830,76
25041,90
001
R32
Srie S 1.8 L ...
Preo
25259,93
25830,76
25041,90
002
R32
Srie S 1.8 L ...
Preo
25259,93
25830,76
25041,90
001
R1A
Srie S 1.8 L ...
Preo
25259,93
25830,76
25041,90
002
R1A
Srie S 1.8 L ...
Preo
25259,93
25830,76
25041,90
001
R30
Srie S 1.8 L ...
Preo
25259,93
25830,76
25041,90
002
R30
Srie S 1.8 L ...
Preo
25259,93
25830,76
25041,90
Neste exemplo, os cdigos na primeira coluna representam elementos na dimenso

Actvsbud. Usando uma funo SE simples, possvel converter 001 em Real e 002
em Oramento.
95
A segunda coluna contm quatro cdigos de regio, os quais mapeiam para regies
como Argentina, Estados Unidos e Grcia. Se eles fossem os nicos valores, seria
possvel gravar uma frmula SE aninhada para converter os valores em elementos.
medida que aumenta o nmero de valores possveis, a gravao de uma frmula
SE aninhada pode ser uma tarefa incmoda e suscetvel a erros. Como alternativa,
possvel criar um cubo bidimensional que sirva como uma tabela de consulta
para recuperar nomes de elementos.
Importando Dados Usando Planilhas de Processamento
v
v
v
possvel criar uma planilha de processamento para executar as seguintes tarefas:

Importar dados de linhas de entrada que requerem transformaes.
Atualizar cubos, mas no criar cubos nem consolidaes.
Usar como uma rea de migrao de dados para importar dados.
O TM1 l os registros de entrada, um de cada vez, na primeira linha da planilha

de processamento e, em seguida, envia os valores dos dados associados ao registro
para um cubo do TM1 .
Abaixo da primeira linha da planilha, uma planilha de processamento inclui:
v Instrues de converso para valores que so mapeados para nomes de
elementos, mas no correspondem s ortografias de nomes de elementos.
v Clculos de transformao de dados que modificam valores dos dados antes da
importao.
v Frmulas Database Send (DBS) que mapeiam os dados de entrada para clulas
no cubo. Cada frmula envia um valor da primeira linha para um local no cubo
identificado por um elemento em cada dimenso do cubo.
Nota: Voc deve usar as frmulas DBS, no frmulas DBSW, nas planilhas de
processamento. necessrio usar frmulas DBR em vez de frmulas DBRW em
planilhas de processamento.
v Outros valores em cada linha de entrada fornecem nomes de elementos
diretamente ou por meio de instrues de converso.
O processo a seguir resume as etapas necessrias para importar dados:
v Ler o primeiro registro de entrada na planilha de processamento como um
exemplo.
v Comparar a entrada com a estrutura do cubo.
v Mapear os valores de entrada para nomes de elementos, se necessrio.
v Construir uma frmula DBS para cada valor de entrada que preenche uma
clula do cubo.
v Processar todos os registros de entrada.
Lendo a Primeira Linha de Entrada

As planilhas de processamento podem ser usadas para processar dados a partir
das seguintes origens de dados:
v Arquivos ASCII
v Origens de dados ODBC
v Cubos do TM1
As trs sees a seguir fornecem as etapas para leitura de um registro inicial a
partir de cada origem de dados.
96
Procedimento
1. Crie uma nova planilha do Excel e feche as outras.
2. Clique em TM1,Dados do Processo, Exemplo.
A caixa de dilogo Selecionar Cubo, ODBC ou Arquivo Simples se abre.
3. Para escolher uma origem de dados, clique em Cubo, ODBC ou Arquivo
Simples.
A caixa de dilogo de seleo aberta.
4. Selecione o cubo de origem, a origem de dados ou o arquivo de entrada e
clique em OK.
Por exemplo, para um arquivo de entrada, selecione o arquivo price.cma no
diretrio \install_dir\PData. Para uma origem de dados ODBC, altere o Cliente
e a Senha, se necessrio.
Para um arquivo de entrada, o primeiro registro do arquivo de entrada
exibido na primeira linha da planilha de processamento.
5. Para um arquivo de entrada, clique em Editar, Salvar e salve a planilha de
processamento como PriceProcessing.xls.
6. Para uma origem de dados ODBC, selecione uma tabela e clique em OK.
O primeiro registro da origem ODBC exibido na primeira linha da planilha.
7. Para um cubo de origem, clique em Exportar.
O primeiro registro do cubo de origem exibido na primeira linha da planilha.
Comparando Registros de Entrada com Estruturas de um

Cubo
Os exemplos neste manual processam dados no cubo de amostra SalesCube, que
possui a seguinte estrutura.
Dimenso
Elementos de Amostra
Actvsbud
Real, Oramento
Regio
Argentina, Blgica, Estados Unidos
Modelo
Srie S 1.8 L Sed, Srie S 2.0 L Sed
Conta1
Unidades, Vendas, Preo
Ms
Jan, Fev, Mar, Abr
Para preencher o cubo SalesCube, cada registros na origem de dados deve conter o
seguinte detalhe:
v Um ou mais valores de clula.
v Nomes de elementos de diferentes dimenses que identificam o local da clula
para cada valor importado, ou valores de entrada que podem ser mapeados para
nomes de elementos.
As informaes de elementos podem estar incompletas. Por exemplo, quando os
registros de origem contiverem vrios valores para uma nica medida, a medida
ser opcional. A medida ausente pode ser fornecida usando uma frmula DBS.
Considere o seguinte registro, como ele aparece em uma planilha de
processamento. Este registro contm dados de preos mensais para um nico
modelo de carro. O mapeamento destes dados para o cubo SalesCube primeiro
requer a converso de dois valores de entrada em nomes de elementos e o
Captulo 5. Importando Dados com Planilhas de Processamento
97
fornecimento de nomes de elementos ausentes.
Vamos examinar cada valor de entrada:

v A clula A1 contm um cdigo que identifica os dados de preos como valores
reais ou de oramento. O Cdigo 001 representa Real, o Cdigo 002 representa
Oramento, que so dois elementos na dimenso Actvsbud. Usando a funo SE
do Excel, possvel converter estes valores em nomes de elementos.
v A clula B1 fornece um cdigo de regio que corresponde a um nome de
elemento na dimenso Regio. Suponha que a entrada tenha 21 cdigos de
regio que requerem converso. Para converter estes valores, possvel criar um
cubo bidimensional que sirva como uma tabela de consulta.
v A clula C1 fornece nomes de modelos de carros, exatamente conforme
localizados na dimenso Modelo. Nenhuma converso necessria.
v As clulas D1 a I1 fornecem dados mensais. necessrio mapear estes dados
para elementos na dimenso Ms.
Ausente de cada registro de origem est uma clula contendo Preo, que um
elemento na dimenso Conta1. Voc especifica este valor diretamente nas frmulas
DBS que enviam os valores dos dados para o cubo.
Convertendo Usando Frmulas SE

A primeira coluna em price.cma contm um cdigo de cenrio, 001 para real e 002
para oramento. A funo SE do Excel pode ser usada para converter o cdigo no
nome do elemento correspondente da dimenso Actvsbud.
Procedimento
1. Clique na clula A3 da planilha de processamento.
2. Insira a seguinte frmula:
=IF(A1="001","Actual","Budget")
Mapeando Usando Rtulos Fixos

As clulas D1 a O1 contm valores que so mapeados para os 12 elementos na
dimenso Ms (Jan - Dez). Como estas colunas de entrada sempre so mapeadas
para os mesmos meses, possvel inserir os nomes de elementos diretamente na
planilha de processamento.
Os nomes de elementos devem corresponder exatamente s ortografias na
dimenso. possvel evitar nomes com erros de ortografia copiando-os da janela
Editor de Subconjuntos.
98
As etapas a seguir ilustram como copiar nomes de elementos da janela Editor de

Subconjuntos.
Procedimento
2. Clique duas vezes na dimenso Ms.
3. Selecione os doze meses Jan - Dez na rea de janela em rvore.
4. Clique em Editar, Selecionar Elementos, Horizontal.
5. Retorne planilha de processamento.
6. Clique com o boto direito do mouse na clula D3 e clique em Colar.
O TM1 cola os nomes de elemento horizontalmente iniciando na clula D3.
Convertendo Usando um Cubo de Consulta

A coluna B, a segunda coluna de entrada, fornece os cdigos que identificam as 21
regies nas quais os modelos de carros so vendidos. Por exemplo, R54 representa
Argentina. Para converter estes cdigos em nomes de elementos, voc tem duas
opes:
v Criar uma frmula SE aninhada. Conforme a lista de cdigos aumenta, isto se
torna uma opo enfadonha.
v Criar um cubo bidimensional que sirva como um cubo de consulta para os
nomes de regies e, em seguida, recuperar os nomes usando uma frmula DBR.
Criaremos um cubo de consulta chamado Translate, que contm duas dimenses,
CdigosReg e NomeReg.
Importando Nomes Exclusivos

Usando o TurboIntegrator, possvel criar uma dimenso cujos elementos sejam
valores exclusivos de uma coluna de entrada. Neste exemplo, a segunda coluna
price.cma.
Procedimento
2. Na rea de janela em rvore, clique com o boto direito do mouse em
Processos e clique em Criar Novo Processo.
A caixa de dilogo TurboIntegrator se abre.
3. Especifique um tipo de origem de dados ASCII.
4. Clique no boto Navegar do Nome da Origem de Dados e navegue para o
arquivo price.cma no diretrio \install_dir\Pdata.
5. Clique na guia Variveis.
6. Especifique um tipo de Contedo de Ignorar para todas as colunas, exceto
para a que fornece os cdigos que voc deseja importar. Neste exemplo, a
coluna 2 (identificada por um valor de amostra de R54) fornece os cdigos
que voc deseja importar.
7. Clique na guia Mapas.
8. Especifique Nenhuma Ao nas sees Ao de Cubo e Ao de Dados da
subguia Cubos.
9. Clique na subguia Dimenses e faa o seguinte:
v Digite Translate no campo Dimenso.
v Selecione Criar da lista Ao.
99
v Selecione Numrico da lista Tipo de Elemento.

10. Clique em Arquivo, Salvar e salve o processo como
create_RegCodes_dimension.
11. Clique em Arquivo, Executar para criar a dimenso CdigosReg.
Resultados
CdigosReg agora est disponvel como uma dimenso no Server Explorer.
Criando uma Dimenso NomeReg

Siga estas etapas para criar a dimenso NomeReg com um nico elemento de
sequncia.
Procedimento
2. Na rea de janela em rvore, clique com o boto direito do mouse em
Dimenses e clique em Criar Nova Dimenso.
3. Clique em Editar, Inserir Elemento.
4. Digite Nome no campo Nome de Elemento.
5. Selecione Sequncia da lista Tipo de Elemento.
O elemento Nome agora aberto como um elemento de sequncia.
7. Clique em OK.
8. Clique em Editar, Salvar e salve a dimenso como NomeReg.
Criando o Cubo Translate

Siga estas etapas para criar o cubo Translate.
Procedimento
1. Clique com o boto direito do mouse em Cubos no Server Explorer, e clique
em Criar Novo Cubo.
A janela Criando Cubo se abre.
2. Digite Translate no campo Nome do Cubo.
3. Na caixa Dimenses Disponveis, clique duas vezes em CdigosReg.
CdigosReg movido para a caixa Dimenses no novo cubo.
4. Na caixa Dimenses Disponveis, clique duas vezes em NomeReg.
NomeReg movido para a caixa Dimenses no novo cubo.
5. Clique em OK para salvar o cubo bidimensional Translate.
Preenchendo o Cubo Translate

Usando o Cube Viewer, agora possvel inserir os nomes de regies
correspondentes para os cdigos de regies.
As etapas a seguir ilustram como preencher o cubo Translate com nomes de
regies.
Procedimento
1. Na rea de janela em rvore da janela Server Explorer, clique duas vezes em
Translate.
100
O Cube Viewer se abre.

2. Pressione F9 para ver os elementos em cada dimenso do cubo Translate.
3. Insira os nomes de regies que correspondem aos cdigos de regies, usando a
tabela como seu guia.
CdigoReg
Nome
R54
Argentina
R32
Blgica
R55
Brasil
R1B
Canad
R56
Chile
R45
Dinamarca
R33
Frana
R49
Alemanha
R44
Gr-Bretanha
R30
Grcia
R353
Irlanda
R39
Itlia
R352
Luxemburgo
R52
Mxico
R31
Pases Baixos
R47
Noruega
R351
Portugal
R34
Espanha
R46
Sucia
R1A
Estados Unidos
R598
Uruguai
4. Clique em Arquivo, Fechar para retornar ao Server Explorer.

5. No Server Explorer, clique em Arquivo, Salvar Todos os Dados para salvar os
valores de clula.
Criando a Frmula DBR

Agora possvel criar uma frmula DBR que recupera nomes de regies para cada
cdigo de regio lido na planilha de processamento.
Nota: Voc deve usar frmulas DBR, no frmulas DBRW, nas planilhas de
processamento.
Procedimento
1. Na planilha de processamento, clique na clula B3.
2. Clique em TM1,Editar Frmula.
A barra Editar Frmula se abre.
3. Clique em DB Ref.
A caixa de dilogo Selecionar Cubo se abre.
Uma caixa de dilogo diferente Selecionar Cubo se abre.
101
5. Selecione local:Translate e clique em OK.

O TM1 presume corretamente que o elemento da dimenso RegCodes est na
clula B1, mas no pode localizar um elemento para RegName e o mostra como
indefinido.
6. Clique em NomeReg.
7. Selecione o elemento Nome e clique em OK.
O campo nomereg agora exibe Selecionado.
8. Clique em OK na caixa de dilogo Editar Referncia a Translate.
A barra Editar Frmula agora exibe a frmula completa:
=DBR("local:Translate", $B$1, "Name")
Esta frmula retorna o valor do cubo Translate localizado na interseo do

elemento Cdigosreg na clula B1 e do elemento Nome de Nomereg.
9. Clique em OK para inserir a frmula na clula B3.
Resultados
A clula B3 agora exibe Argentina, que a regio correta para o cdigo R54.
Criando Frmulas Database Send (DBS)

possvel criar frmulas DBS que enviam valores de dados numricos para o cubo
porque:
v Voc converteu cdigos que so mapeados para elementos na dimenso
Actvsbud.
v Voc converteu cdigos que so mapeados para elementos na dimenso Regio.
v Voc mapeou vrios valores dos dados para seus meses apropriados.
Insira as frmulas DBS em uma linha abaixo das linhas contendo os dados e
instrues de mapeamento. No as insira na primeira linha, pois elas sero
sobrescritas medida em que o TM1 l registros na planilha de processamento.
Procedimento
1. Clique na clula D4, uma clula vazia que armazenar a primeira frmula
DBS.
2. Clique em TM1, Editar Frmula.
A barra Editar Frmula se abre.
3. Clique em DB Send.
O TM1 solicita que voc selecione o valor a ser enviado para o cubo.
4. Clique duas vezes na clula D1, que contm o valor de clula Jan.
O TM1 solicita que voc selecione o tipo de referncia de clula.
5. Clique em Coluna Rel.
A frmula DBS sempre faz referncia linha 1, mas a referncia de coluna
ser relativa ao local da frmula.
O TM1 solicita que voc indique o tipo de dados na clula.
6. Clique em Numrico.
A caixa de dilogo Selecionar Cubo solicita que voc selecione o cubo a ser
preenchido.
Uma caixa de dilogo diferente Selecionar Cubo se abre.
102
8. Selecione o cubo local:SalesCube e clique em OK.

A caixa de dilogo Editar Referncia ao Cubo exibida com a maioria das
instrues de mapeamento para o valor (clula D1) a ser enviado para o cubo.
A clula A3 fornece um elemento na dimenso Actvsbud.
v A clula B1 fornece um elemento na dimenso Regio.
v A clula C1 fornece um elemento na dimenso Modelo.
v A clula D3 fornece um elemento na dimenso Ms.
Para concluir o mapeamento, necessrio identificar um elemento para a
dimenso Conta1. Price.cma contm valores de preos, portanto, todas as
frmulas DBS devem ser mapeadas para o elemento de preo.
9. Clique em conta1.
10. Selecione Preo e clique em OK.
O campo conta1 da caixa de dilogo Editar Referncia ao Cubo agora exibe
Selecionado.
11. Clique em OK.
A barra Editar Frmula exibe a funo DBS gerada:
DBS(D$1,"local:SalesCube",$A$3,$B$3,$C$1,"Price",D$3)
Para obter uma explicao completa da frmula, consulte Sintaxe de DBS.

12. Clique em OK para colocar esta frmula na planilha de processamento.
13. Copie a frmula em D3 para o intervalo E3:O3.
14. Salve a planilha PriceProcessing.
Sintaxe de DBS
A funo DBS usa a seguinte sintaxe:
DBS (value, server:cube, e1, e2[,...en]):
Argumento
Descrio
valor
Valor numrico enviado para o cubo.
servidor:cubo
O nome do cubo que recebe o valor enviado. O nome do cubo deve

ser prefixado com o nome do servidor no qual o cubo reside, por
exemplo, sdata:SalesCube.
e1,...en
Elementos que identificam o local da clula no cubo que recebe o

valor. Especifique os argumentos do elemento na ordem de
dimenso. Por exemplo, e1 deve ser um elemento da primeira
dimenso do cubo, e2 deve ser um elemento da segunda dimenso
do cubo.
Processando uma Origem de Dados em um Cubo

Depois de criar uma planilha de processamento, possvel processar dados em um
cubo.
Se voc tiver concludo os exerccios nesta seo, saber que a planilha
PriceProcessing processa valores de preos no cubo SalesCube.
No possvel usar uma planilha de processamento para gravar valores em clulas
do cubo que so calculadas por regras, pois voc no pode editar valores de
clulas derivados de regras.
v Primeiro, necessrio verificar se os valores de Preo em SalesCube no so
derivados por regras.
103
v Em seguida, possvel processar uma origem de dados em um cubo.
Procedimento
1.
2.
3.
4.
5.
Abra o Server Explorer.

Clique duas vezes no cubo SalesCube.
Verifique se existe uma regra anexada ao cubo. Se no, passe para a etapa 8.
Se uma regra estiver anexada, abra a regra no Editor de Regras.
Examine a regra para verificar se Preo calculado por regras.
Nota: Observe que a regra inclui a seguinte instruo, que calcula o valor
para Preo nos nveis numrico e consolidado:
[Price]=N:DB(PriceCube,!actvsbud,!region,!model,!month);C:[Sales]\
[Units]*1000;
Esta instruo calcula o valor para Preo nos nveis numrico e consolidado.
6. Insira um sinal numrico (#) no incio das duas instrues para desativar o
clculo de Preo.
#[Price]=N:DB(PriceCube,!actvsbud,!region,!model,!month);#C:[Sales]\
[Units]*1000;
7. Salve a regra.
Agora possvel usar a planilha de processamento para processar o arquivo
de origem Price.cma em SalesCube.
8. Se nenhuma regra for anexada, abra a planilha de processamento que contm
as frmulas DBS e todas as instrues de mapeamento.
Se voc seguiu os exemplos anteriores nesta seo, abra a planilha de
processamento PriceProcessing.
9. Feche as outras planilhas.
10. Clique em TM1,Dados do Processo, Processo.
A caixa de dilogo Selecionar Cubo, ODBC ou Arquivo Simples se abre.
11. Clique em Arquivo Simples.
A caixa de dilogo Selecionar Arquivo de Entrada se abre.
12. Selecione o arquivo fonte Price.cma e clique em OK.
O TM1 processa o arquivo de origem. Durante o processo, exibida uma
barra de progresso.
O TM1 sequencialmente l cada registro do arquivo de origem na primeira
linha da planilha de processamento. A planilha de processamento
recalculada aps a leitura de cada registro, e as frmulas DBS enviam os
valores na primeira linha para a clula apropriada do cubo.
13. Navegue em SaleCube e observe que os valores de Preo foram atualizados
pelos valores em Price.cma.
104
Captulo 6. Controlando o Acesso de Objetos do TM1

Esta seo descreve como possvel limitar acesso a objetos em um IBM Cognos
TM1 server para todas as instalaes do IBM Cognos TM1 , independentemente do
mtodo de autenticao.
Designando Direitos de Segurana a Grupos

possvel designar uma segurana em nvel de objeto para qualquer grupo de
usurios no administrativo no TM1 . Ao designar direitos de segurana a grupos,
possvel controlar um acesso de usurio a objetos do TM1 .
Nota: No possvel designar direitos de segurana para os grupos ADMIN,
DataAdmin ou SecurityAdmin. Os direitos para esses grupos so predefinidos e
aparecem desativados na caixa de dilogo TM1 Designaes de Segurana.
Observe tambm que apenas as verses em ingls das entradas de nvel de
segurana so aceitas. As seguintes palavras-chave devem ser usadas conforme
listadas aqui, ao inserir manualmente nveis de segurana no cubo de controle de
segurana da clula do TM1 .
Os direitos de segurana em nvel de objeto para os grupos do TM1 so:
v Admin - O grupo tem acesso completo a um cubo, elemento, dimenso ou outro
objeto.
v Lock - O grupo pode visualizar e editar um cubo, elemento, dimenso ou outro
objeto e pode bloquear permanentemente objetos para evitar que sejam
atualizados por outros usurios.
v Read - O grupo pode visualizar um cubo, elemento, dimenso, processo ou
tarefa de organizao de processos, mas no pode executar operaes no objeto.
v Reserve - O grupo pode visualizar e editar um cubo, elemento, dimenso ou
outro objeto, e pode reservar temporariamente objetos para evitar que sejam
atualizados por outros usurios.
Write - O grupo pode visualizar e atualizar um cubo, elemento, dimenso,
processo ou tarefa de organizao de processos.
v None - O grupo no pode ver um cubo, elemento, dimenso, processo ou tarefa
de organizao de processos, e no pode executar operaes no objeto.
A tabela a seguir descreve os direitos de segurana que podem ser designados a

grupos.
105
Privilgio
Objeto
Descrio
Admin
Cubo
Os membros do grupo podem ler, gravar, reservar, bloquear

e excluir o cubo. Eles podem salvar visualizaes pblicas do
cubo. Eles tambm podem conceder direitos de segurana a
outros usurios para este objeto.
Elemento
Os membros do grupo podem acessar, atualizar, reservar,

bloquear e excluir o elemento. Eles tambm podem conceder
direitos de segurana a outros usurios para este objeto.
Dimenso
Os membros do grupo podem incluir, remover e reordenar

elementos na dimenso e podem reservar ou bloquear a
dimenso. Eles podem salvar subconjuntos pblicos de
dimenses. Eles tambm podem conceder direitos de
segurana a outros usurios para este objeto.
Aplicativo
Os membros do grupo podem ver o aplicativo, usar

referncias no aplicativo e criar referncias pblicas e
particulares no aplicativo.
Quando um grupo tiver privilgio Admin para um aplicativo,
os membros do grupo podero configurar privilgios de
segurana para todas as referncias e subaplicativos no
aplicativo para outros grupos, mas no para seu prprio
grupo.
Referncia
106
Os membros do grupo podem usar a referncia, bem como

atualizar ou excluir a referncia. Eles podem publicar
referncias particulares e fazer com que referncias pblicas
se tornem particulares.
Privilgio
Objeto
Descrio
Lock
Cubo
Os membros do grupo tm todos os privilgios indicados

pela permisso Write e tambm podem bloquear o cubo.
Quando um cubo bloqueado, ningum pode atualizar seus
dados.
O bloqueio pode ser removido apenas por usurios que tm
direitos Admin para o cubo.
Os bloqueios permanecem no local aps o encerramento do
servidor remoto.
Elemento

pela permisso Write e tambm podem bloquear o elemento.
Quando um elemento bloqueado, ningum pode atualizar
clulas do cubo identificadas pelo elemento
direitos Admin para o elemento.
servidor remoto.
Dimenso

pela permisso Write e tambm podem bloquear a dimenso.
Quando uma dimenso bloqueada, ningum pode editar
sua estrutura.
direitos Admin para a dimenso.
servidor remoto.
107
108
Privilgio
Objeto
Descrio
Read
Cubo
Os membros do grupo podem ver as clulas no cubo, mas

no podem alterar seus dados.
Elemento
Os membros do grupo podem ver as clulas identificadas

pelo elemento, mas no podem alterar seus dados.
Dimenso
Os membros do grupo podem ver os elementos em uma

dimenso, mas no podem incluir, remover ou reordenar os
elementos.
Processo
Os membros do grupo podem ver o processo no Server

Explorer e podem executar manualmente o processo, mas
no podem edit-lo.
Nota: Os privilgios designados a processos so ignorados
quando um processo executado a partir de uma tarefa de
organizao de processos.
Tarefa de
Organizao de
Processos
Os membros do grupo podem ver a tarefa de organizao de

processos no Server Explorer e podem execut-la
manualmente, mas no podem edit-la.
Aplicativo
Os membros do grupo podem ver o aplicativo e usar

referncias pblicas no aplicativo para o qual eles tm pelo
menos o privilgio Read. Eles podem criar referncias
particulares no aplicativo e tambm criar subaplicativos
particulares
Referncia
Os membros do grupo podem abrir a referncia, mas no

podem atualiz-la no aplicativo. No entanto, os membros do
grupo podem executar uma operao "salvar como" para
salvar uma nova verso particular da referncia.
Privilgio
Objeto
Descrio
Reserve
Cubo

pela permisso Write e tambm podem reservar o cubo para
evitar que outros usurios apliquem edies. A reserva pode
ser removida pelo usurio que reservou o cubo ou por
usurios que possuem direitos Admin para o cubo.
Uma reserva expira automaticamente quando o usurio da
reserva desconectado do servidor remoto ou quando o
servidor encerrado.
Elemento

pela permisso Write e tambm podem reservar o elemento
para evitar que outros usurios atualizem as clulas do cubo
identificadas pelo elemento. A reserva pode ser removida
pelo usurio que reservou o elemento ou por usurios que
possuem direitos Admin para o elemento.
servidor encerrado.
Dimenso
Os membros do grupo possuem todos os privilgios

indicados pela permisso Write e tambm podem reservar a
dimenso para evitar que ela seja redefinida por outros
usurios. A reserva pode ser removida pelo usurio que
reservou a dimenso ou por usurios que possuem direitos
Admin para a dimenso.
servidor encerrado.
Write
Cubo
Os membros do grupo podem ler e atualizar clulas. Eles

podem salvar visualizaes de cubo particulares. O privilgio
de acesso Write no aplicvel a clulas identificadas por
elementos consolidados ou a clulas derivadas de regras.
Elemento
Os membros do grupo podem ler e atualizar as clulas

identificadas pelo elemento e editar atributos do elemento.
Dimenso
Os membros do grupo podem editar atributos de elementos,

editar formatos de elementos e criar subconjuntos
particulares para a dimenso. Os membros tambm podem
editar atributos para a prpria dimenso.
109
Privilgio
Objeto
Descrio
None
Cubo
Os membros do grupo no podem ver o cubo no Server

Explorer e, portanto, no podem navegar no cubo.
Elemento
Os membros do grupo no podem ver o elemento no Editor

de Subconjuntos ou no Editor de Dimenso, e no podem
ver as clulas identificadas pelo elemento ao navegar em um
cubo.
Dimenso
Os membros do grupo no podem ver a dimenso no Server

Explorer e no podem navegar em um cubo que contm a
dimenso.
Processo
Os membros do grupo no podem ver o processo no Server

Explorer e, portanto, no podem executar o processo.
Nota: Os privilgios designados a processos so ignorados
quando um processo executado a partir de uma tarefa de
Tarefa de
Organizao de
Processos
Os membros do grupo no podem ver a tarefa de

organizao de processos no Server Explorer e, portanto, no
podem execut-la.
Aplicativo
Os membros do grupo no podem ver o aplicativo ou seu

contedo no Server Explorer.
Referncia
Os membros do grupo no podem ver a referncia no Server

Explorer.
Interao de Diferentes Direitos de Segurana do Objeto

Se aplicar direitos de segurana diferentes aos objetos que identificam uma clula
de dados, o TM1 aplicar o direito de segurana mais restritivo clula.
Cenrio 1
Suponha que voc designe a um usurio o acesso Read ao cubo SalesCube e o
acesso Write aos elementos neste cubo. Neste cenrio, o acesso Read do cubo
substitui o acesso Write dos elementos, e o usurio pode visualizar dados do cubo
mas no pode atualiz-los.
Cenrio 2
O cubo SalesPriorCube contm as seguintes dimenses:
v Actvsbud
v Regio
v Modelo
v Conta1
v Ms
Suponha que um usurio tenha acesso Write ao cubo SalesPriorCube, acesso Read a
todos os elementos na dimenso Actvsbud e acesso Write a todos os elementos nas
110
outras dimenses. Os elementos na dimenso Actvsbud identificam cada clula no

cubo e, portanto, o usurio no pode atualizar dados do cubo.
Cenrio 3
possvel alterar os direitos de segurana para cubos e dimenses. Quando os
grupos tiverem direitos de segurana para um cubo, esses direitos sero aplicveis
a todas as dimenses no cubo, a menos que voc restrinja ainda mais o acesso para
dimenses ou elementos especficos.
Suponha que voc deseje que vrios grupos regionais de usurios leiam todos os
dados no cubo SalesPriorCube. Tambm deseja que cada grupo atualize dados em
sua prpria regio. Por exemplo, voc deseja que a equipe de vendas no grupo
Amrica do Norte atualize dados da Amrica do Norte.
Para implementar este esquema de segurana, voc pode:
v Criar grupos que reflitam regies de vendas.
v Incluir usurios nos grupos apropriados.
v Conceder a cada grupo regional acesso Write ao cubo SalesPriorCube.
v Conceder ao grupo Amrica do Norte acesso Read aos elementos que no
refletem dados para a regio Amrica do Norte.
Os dados de amostra do TM1 refletem esse esquema de segurana. Usr1 est no
grupo Amrica do Norte, que possui acesso Write aos dados associados s reas na
regio da Amrica do Norte, e acesso Read aos dados associados s reas em outras
regies.
Protegendo Cubos
possvel aprimorar ou restringir o acesso de um grupo a cubos individuais. Ao
criar um novo cubo, inicialmente, outros grupos tm acesso None ao novo cubo.
necessrio designar direitos de segurana ao novo cubo para outros grupos.
Designando Direitos de Segurana para Cubos

Siga estas etapas para designar direitos de segurana para um cubo.
Procedimento
2. Selecione o cone Cubos para o servidor com o qual voc est trabalhando.
3. Clique em Cubos, Designaes de Segurana.
A caixa de dilogo Designaes de Segurana do TM1 aberta.
4. Clique na clula na interseo do nome do cubo e do nome do grupo para os
quais voc deseja designar direitos.
possvel designar direitos para vrios cubos ou para vrios grupos,
selecionando um intervalo de clulas. Para selecionar um intervalo de clulas,
clique em uma clula para estabelecer o incio do intervalo, mantenha
pressionada a tecla Shift e clique mais abaixo na coluna ou linha para
estabelecer o final do intervalo.
5. Selecione o nvel de acesso que voc deseja designar.
O nome do privilgio de acesso designado exibido na clula.
6. Clique em OK.
111
Reservando e Liberando Cubos

Quando um usurio reserva um cubo, esse usurio ganha direitos exclusivos para
atualizar os dados no cubo. Outros usurios no podem atualizar os dados do
cubo at que o cubo seja liberado. Um cubo pode ser liberado pelo usurio que o
reservou ou por um usurio que possui direitos Admin para esse cubo.
recomendvel reservar um cubo como uma maneira de congelar
temporariamente seus dados. Uma reserva expira automaticamente quando o
usurio da reserva desconectado do servidor remoto ou quando o servidor
encerrado.
Procedimento
2. Selecione o cubo que voc deseja reservar.
3. Clique em Cubo, Segurana, Reservar.
Para liberar um cubo:
4. Siga as Etapas 1 e 2 para reservar um cubo.
5. Clique em Cubo, Segurana, Liberar.
Bloqueando e Desbloqueando um Cubo

Quando um usurio bloqueia um cubo, apenas os usurios que possuem direitos
Admin para esse cubo podem atualizar seus dados ou desbloquear o cubo. Mesmo o
usurio que bloqueia o cubo no pode atualizar os dados do cubo ou desbloquear
o cubo, a menos que ele tenha direitos Admin para esse cubo.
recomendvel bloquear um cubo como uma maneira de arquivar
permanentemente seus dados. Os bloqueios permanecem no local aps o
encerramento de um servidor.
Procedimento
2. Selecione o cubo que voc deseja bloquear.
3. Clique em Cubo, Segurana, Bloquear.
Para desbloquear um cubo:
4. Siga as Etapas 1 e 2 para bloquear um cubo.
5. Clique em Cubo, Segurana, Desbloquear.
Protegendo Elementos
possvel aprimorar ou restringir o acesso de um grupo a elementos individuais
usando a caixa de dilogo Designaes de Segurana de Elementos.
Designando Direitos de Segurana para Elementos

Siga estas etapas para designar direitos de segurana para elementos.
Procedimento
2. Selecione a dimenso com a qual voc deseja trabalhar.
3. Clique em Dimenso, Segurana, Designaes de Segurana de Elementos.
A caixa de dilogo TM1 Security Assignments ser exibida.
112
4. Clique na clula na interseo do nome de elemento e do nome do grupo.

possvel designar direitos para vrios elementos ou para vrios grupos,
6. Clique em Salvar ou em OK.
Nota: Se voc clicar em Salvar, possvel continuar designando direitos de
segurana a diferentes elementos. possvel acessar elementos em outras
dimenses, selecionando uma dimenso no campo Selecionar Dimenso.
Interao de Direitos de Segurana para Elementos Folha e

Consolidados
possvel configurar diferentes nveis de segurana para um elemento consolidado
e os elementos folha que pertencem consolidao.
Por exemplo, a dimenso Regio nos dados de amostra possui a seguinte
hierarquia de elementos:
Suponha que Usr4 tenha acesso Read ao elemento folha Canad e acesso None ao
elemento consolidado Amrica do Norte. Usr4 pode ver os dados identificados
pelo elemento Canad, mas no pode ver os dados consolidados identificados pelo
elemento Amrica do Norte.
Reservando e Liberando Elementos

Quando um usurio reserva um elemento, esse usurio ganha direitos exclusivos
para atualizar os dados identificados por esse elemento. Outros usurios no
podem atualizar os dados do elemento at que o elemento seja liberado. Um
elemento pode ser liberado pelo usurio que o reservou ou por um usurio que
possui direitos Admin para esse elemento.
recomendvel reservar um elemento como uma maneira de congelar
temporariamente os dados que ele identifica. Uma reserva expira automaticamente
quando o usurio da reserva desconectado do servidor remoto ou quando o
servidor encerrado.
Procedimento
2. Clique duas vezes na dimenso com a qual voc deseja trabalhar.
exibido o Editor de Subconjuntos.
3. Selecione o elemento que voc deseja reservar.
4. Clique em Editar, Segurana, Reservar.
Para liberar um elemento:
113
5. Siga as Etapas 1 a 3 para reservar um elemento.

6. Clique em Editar, Segurana, Liberar.
Bloqueando e Desbloqueando um Elemento

Quando um usurio bloqueia um elemento, apenas os usurios que possuem
direitos Admin para esse elemento podem atualizar os dados que ele identifica.
Mesmo o usurio que bloqueia o elemento no pode atualizar seus dados, a menos
que ele tenha direitos Admin para esse elemento.
recomendvel bloquear um elemento como uma maneira de arquivar
permanentemente os dados que ele identifica. Os bloqueios permanecem no local
aps o encerramento do servidor remoto.
Procedimento
2. Clique duas vezes na dimenso com a qual voc deseja trabalhar.
exibido o Editor de Subconjuntos.
3. Selecione o elemento que voc deseja bloquear.
4. Clique em Editar, Segurana, Bloquear.
Para desbloquear um elemento:
5. Siga as Etapas 1 a 3 para bloquear um elemento.
6. Clique em Editar, Segurana, Desbloquear.
Protegendo Dimenses
possvel aprimorar ou restringir o acesso de um grupo a dimenses individuais.
Por padro, a segurana do TM1 controla dimenses no IBM Cognos TM1 server ,
como a seguir:
v Somente os membros dos grupos ADMIN e DataAdmin podem criar e excluir
dimenses no servidor TM1 .
v Os grupos com acesso Read a uma dimenso podem visualizar atributos de
dimenso e de elemento por meio do Server Explorer, mas no podem editar
valores de atributos.
v Inicialmente, outros grupos possuem acesso None a novas dimenses.
v Quando nenhuma segurana tiver sido designada a um elemento em uma
dimenso, os grupos tero acesso Write aos novos elementos nessa dimenso.
v Ao designar direitos de segurana a pelo menos um elemento em uma dimenso,
os grupos possuem acesso None aos novos elementos nessa dimenso. Os
elementos existentes mantm seu acesso original (Write), a menos que voc
altere esse acesso.
Nota: Se alterar a segurana em uma dimenso e desejar reconfigurar essa
segurana para a configurao padro (os grupos tm Writeacesso a novos
elementos includos na dimenso), encerre o servidor TM1 e exclua manualmente o
arquivo }ElementSecurity<dimname>.cub.
Designando Direitos de Segurana para Dimenses

Siga estas etapas para designar direitos de segurana para uma dimenso.
114
Procedimento
2. Selecione o cone Dimenses para o servidor com o qual voc est trabalhando.
3. Clique em Dimenses, Designaes de Segurana.
A caixa de dilogo TM1 Security Assignments ser exibida.
4. Clique na clula na interseo do nome da dimenso e do nome do grupo.
possvel designar direitos para vrias dimenses ou para vrios grupos,
6. Clique em OK.
Reservando e Liberando Dimenses

Quando um usurio reserva uma dimenso, esse usurio ganha direitos exclusivos
para incluir, remover e reordenar elementos nessa dimenso. Outros usurios no
podem modificar a dimenso, at que ela seja liberada. Uma dimenso pode ser
liberada pelo usurio que a reservou ou por um usurio que possui direitos Admin
para essa dimenso.
recomendvel reservar uma dimenso antes de redefini-la. Uma reserva expira
automaticamente quando o usurio da reserva desconectado do servidor remoto
ou quando o servidor encerrado.
Procedimento
3. Clique em Dimenso, Segurana, Reservar.
Para liberar uma dimenso:
4. Siga as Etapas 1 e 2 para reservar uma dimenso:
5. Clique em Dimenso, Segurana, Liberar.
Bloqueando e Desbloqueando uma Dimenso

Quando um usurio clica em uma dimenso, apenas os usurios que possuem
direitos Admin para essa dimenso podem incluir, remover ou reordenar elementos
nessa dimenso. Mesmo o usurio que bloqueia a dimenso no pode modific-la,
a menos que ele tenha direitos Admin para essa dimenso.
recomendvel bloquear uma dimenso se voc desejar o controle exclusivo de
sua definio.
Procedimento
3. Clique em Dimenso, Segurana, Bloquear no menu pop-up.
Para liberar uma dimenso:
4. Siga as Etapas 1 e 2 para bloquear uma dimenso.
115
5. Clique com o boto direito do mouse e clique em Dimenso, Segurana,

Desbloquear.
Protegendo Processos
possvel aprimorar ou restringir o acesso de um grupo a processos individuais
do TurboIntegrator.
Nota: O TM1 ignora os direitos de segurana designados a processos do Turbo
Integrator ao executar um processo a partir de uma tarefa de organizao de
processos. Os direitos de segurana atribudos tarefa de organizao de processos
determinam a capacidade de um grupo para executar um processo a partir de uma
tarefa de organizao de processos. Por exemplo, se um grupo tiver o acesso None a
Process1, mas o acesso Read a uma tarefa de organizao de processos que inclua
Process1, o grupo poder executar Process1 a partir da tarefa de organizao de
processos.
Atribuindo Direitos de Segurana para Processos

Siga estas etapas para atribuir direitos de segurana para um processo.
Procedimento
2. Selecione o cone Processos para o servidor com o qual voc est trabalhando.
3. Clique em Processos, Designaes de Segurana.
4. Clique na clula na interseo do nome do processo e do nome do grupo.
possvel atribuir direitos para vrios processos ou para vrios grupos,
selecionando vrias clulas.
Para selecionar um intervalo de clulas adjacentes, clique em uma clula para
estabelecer o incio do intervalo, mantenha pressionada a tecla Shift e clique
mais abaixo na coluna ou linha para estabelecer o final do intervalo.
Para selecionar vrias clulas no adjacentes, mantenha pressionada a tecla
CTRL e clique em cada clula.
O nome do privilgio de acesso designado exibido na(s) clula(s).
6. Clique em OK.
Permitindo que Processos Modifiquem Dados de Segurana

A opo TM1 Security Access controla se um processo pode modificar dados de
segurana no script do processo. Apenas membros dos grupos ADMIN e
SecurityAdmin podem configurar esta opo. Esta opo configurada em uma
base processo a processo a partir do menu Processo no Server Explorer.
Quando a opo Acesso Segurana ativada para um processo:
v Os membros do grupo DataAdmin no tm permisso para editar o processo,
visto que ele pode conter scripts que poderiam modificar a segurana do TM1 .
v Apenas membros no grupo completo ADMIN podem editar um processo aps a
ativao da opo Acesso Segurana.
v Membros do grupo SecurityAdmin podem visualizar processos e ativar e
desativar esta opo, mas nunca podem editar o contedo de um processo.
116
v A opo Visualizar no menu Processo torna-se disponvel para permitir que

usurios nos grupos DataAdmin e SecurityAdmin visualizem processos em
modo somente leitura.
Para obter mais detalhes sobre os grupos ADMINISTRADOR, SecurityAdmin e
DataAdmin, consulte o Guia de Operao do IBM Cognos TM1 .
Ativando a Opo Acesso Segurana para um Processo

Por padro, a opo Acesso Segurana desativada para qualquer novo
processo. Se voc desejar permitir que um novo processo modifique a segurana
do TM1 , precisar ativar manualmente a opo Acesso de Segurana para esse
processo.
Procedimento
1. No Server Explorer, selecione um processo.
2. Clique em Processo, Acesso Segurana.
Um visto prximo opo Acesso de Segurana indica que o TM1 permitir
que o processo selecionado modifique os dados de segurana.
Nota: Se voc fez o upgrade para o TM1 9.4 ou posterior a partir de um banco
de dados do TM1 , a opo Acesso de Segurana ser automaticamente ativada
para todos os processos existentes do TM1 . Isto permite que os processos
existentes continuem em execuo, sem ser necessrio que voc configure
individualmente a opo Acesso Segurana para cada processo.
Visualizando um Processo em Modo Somente Leitura

Quando a opo Acesso Segurana for ativada para um processo, os usurios
nos grupos DataAdmin e SecurityAdmin podero visualizar o processo apenas em
modo somente leitura.
Procedimento
1. No Server Explorer, selecione um processo.
2. Clique com o boto direito do mouse no processo e clique em Visualizar.
O processo exibido em modo somente leitura.
Protegendo Tarefas de Organizao de Processos

possvel aprimorar ou restringir o acesso de um grupo a tarefas de organizao
de processos individuais.
Atribuindo Direitos de Segurana para Tarefas de Organizao

de Processos
Siga estas etapas para atribuir direitos de segurana para uma tarefa de
Procedimento
2. Selecione o cone Tarefas de Organizao de Processos para o servidor com o
qual voc est trabalhando.
3. Clique em Tarefas de Organizao de Processos, Designaes de Segurana.
117
4. Clique na clula na interseo do nome da tarefa de organizao de processos e

do nome do grupo.
possvel atribuir direitos para vrias tarefas de organizao de processos ou
para vrios grupos, selecionando vrias clulas.
Para selecionar um intervalo de clulas adjacentes, clique em uma clula para
estabelecer o incio do intervalo, mantenha pressionada a tecla Shift e clique
mais abaixo na coluna ou linha para estabelecer o final do intervalo.
Para selecionar vrias clulas no adjacentes, mantenha pressionada a tecla
CTRL e clique em cada clula.
O nome do privilgio de acesso designado exibido na(s) clula(s).
6. Clique em OK.
Protegendo Aplicativos e Referncias

possvel designar privilgios de segurana para itens pblicos (referncias ou
sub-aplicativos) nos aplicativos pblicos do TM1 para grupos de usurios no IBM
Cognos TM1 server . necessrio ter o privilgio Admin para um aplicativo para
atribuir segurana a itens no aplicativo.
No possvel atribuir segurana para aplicativos e referncias particulares; apenas
o usurio que cria um item particular pode acessar o item.
Procedimento
1. No Server Explorer, clique com o boto direito do mouse no aplicativo que
contm os itens aos quais voc deseja atribuir segurana.
2. Clique em Segurana, Designaes de Segurana.
A janela Designaes de Segurana do TM1 ser aberta. A lista Nome contm
todos os itens pblicos (objetos do TM1, arquivos Excel e subaplicativos) que
residem no aplicativo atual.
3. Selecione a clula na interseo do item para o qual voc deseja definir
segurana e o grupo de usurios ao qual voc deseja atribuir segurana.
4. Clique em um dos privilgios de segurana disponveis.
Para obter detalhes, consulte Designando Direitos de Segurana a Grupos na
pgina 105.
5. Repita as etapas 3 e 4 para quaisquer outros itens para os quais voc deseja
definir segurana.
6. Clique em OK.
Para qualquer grupo de usurios especificado, voc pode designar o privilgio
Read ou Admin a uma referncia ao designar o privilgio None ao objeto de
origem associado referncia. Neste cenrio, os membros do grupo de usurios
no podem ver a referncia em um aplicativo.
Por exemplo, se voc designar o privilgio None a um grupo de usurios para
um cubo, mas designar o privilgio Read para uma referncia ao mesmo cubo,
os membros do grupo de usurios no podero ver a referncia ao cubo em um
aplicativo.
Protegendo Clulas
A segurana em nvel de clula se aplica a uma clula especificada e substitui
todas as outras seguranas do TM1 . A segurana em nvel de clula requer:
118
v Criao de um cubo de controle de segurana de clula que contenha todas as

dimenses do cubo cuja segurana em nvel de clula voc configura.
v Configurao de segurana para as clulas apropriadas no cubo de controle de
segurana ao designar direitos de segurana para grupos de segurana do TM1 .
Nota: Para que a segurana em nvel de elemento seja aplicada a uma clula,
nenhum direito de segurana pode ser designado a nenhum grupo de segurana
do TM1 para a clula. A segurana em nvel de clula substitui a segurana em
nvel de elemento, portanto, a segurana em nvel de clula para a clula deve ser
indefinida.
A segurana em nvel de clula aplicvel a elementos folha e, geralmente, no
aplicvel a consolidaes, embora seja possvel usar os direitos de segurana None e
Read para controlar a exibio ou edio de consolidaes.
Criando um Cubo de Controle de Segurana de Clula

Siga estas etapas para criar um cubo de controle de segurana de clula.
Procedimento
1. No TM1 Architect ou no TM1 Perspectives , clique com o boto direito do
mouse no cubo para o qual voc deseja definir segurana no nvel de clula e,
ento, selecione Segurana, Criar Cubo de Segurana da Clula.
O TM1 cria automaticamente um cubo de controle de segurana usando o
formato de nomenclatura do }CellSecurity_CubeName em que CubeName o
nome do cubo que voc selecionou. Por exemplo, se selecionou o cubo
SalesCube, ento o TM1 criar o cubo de controle de segurana
}CellSecurity_SalesCube.
O TM1 inclui todas as dimenses do cubo original para o cubo de controle de
segurana recm criado, e a dimenso }Grupos includa como a ltima
dimenso no novo cubo.
2. Clique em Visualizar, Exibir Objetos de Controle, se os cubos de controle
ainda no estiverem visveis.
O TM1 exibe o no vo cubo de controle de segurana juntamente com o cubo
original.
119
Para aplicar segurana a clulas no cubo de controle de de segurana, pelo

grupo de segurana do TM1 :
3. Abra o cubo de controle de segurana recm-criado ao clicar duas vezes no
cubo de controle de segurana, por exemplo,
para exibir os grupos de controle de segurana, ou

4. Clique em Recalcular
clique em Opes, Reclculo Automtico.
5. Expanda as linhas para exibir as clulas s quais voc deseja designar direitos
de segurana.
Nota: Lembre-se, a segurana em nvel de clula aplicvel a elementos folha.
6. Insira o nvel de segurana nas clulas do cubo para designar direitos de
segurana por grupo de usurios.
Para obter detalhes, consulte Designando Direitos de Segurana a Grupos na
pgina 105.
Por exemplo, os meses no segundo trimestre para o grupo Inspetores tm a
segurana designada como None.
7. Feche o cubo de controle de segurana.
120
8. Salve a visualizao.
9. Teste os nveis de segurana, efetuando login como um usurio que membro
do grupo de segurana afetado e visualizando o cubo para o qual voc
configurou a segurana.
Usando Regras para Definir a Segurana em Nvel de Clula

No cubo de controle de segurana, possvel usar as regras do TM1 para aplicar
segurana em nvel de clula em vez de inserir direitos de segurana nas clulas
do cubo de controle de segurana. Para obter detalhes, consulte o Guia de
Operaes do IBM Cognos TM1 .
Suponha que deseja criar uma regra para aplicar segurana em nvel de clula no
cubo }CellSecurity_SalesCube. A regra a seguir impede que usurios no grupo
Inspetores visualizem clulas identificadas pelo elemento Grcia.
[Greece,Inspectors] = S:NONE;
Nota: Certifique-se de que os nomes de grupos de segurana sejam exclusivos e

outras dimenses ou elementos no usem o mesmo nome.
Os benefcios de usar regras para implementar segurana so:
v O usurio no insere direitos de segurana em clulas no cubo de controle de
segurana, economizando tempo de entrada de dados.
v Como o TM1 no armazena valores de regra de sequncia em memria nem os
salva em disco, voc economiza em consumo de memria e em armazenamento
em disco.
121
122
Captulo 7. Usando os Botes de Ao do TM1 para Construir

Aplicativos de Planilhas
Esta seo descreve a funcionalidade do boto IBM Cognos TM1 Action que pode
ser usada para executar processos e navegar entre planilhas e planilhas da Web.
Viso Geral
possvel inserir um boto de Ao em uma planilha para que os usurios possam
executar um processo do Turbo Integrator e/ou navegar para outra planilha. Os
usurios podem acessar esses botes ao trabalhar com planilhas no Microsoft Excel
com TM1 ou com planilhas da Web no TM1 Web.
Um boto de Ao pode executar qualquer uma das seguintes tarefas:
v Executar um processo do TurboIntegrator.
v Navegar para outra planilha.
v Executar um processo do TurboIntegrator e, em seguida, navegar para outra
planilha.
v Recalcular uma planilha ou reconstruir o Formulrio Ativo do TM1 em uma
planilha.
A figura a seguir mostra um exemplo de um boto de Ao em uma planilha.
Incluindo um Boto de Ao em uma Planilha

possvel inserir um boto de Ao em qualquer clula vazia em uma planilha
usando as seguintes etapas.
Procedimento
1. No Excel, selecione uma clula vazia em sua planilha, na qual voc deseja
inserir o boto de Ao.
Nota: Um boto de Ao no pode ser inserido em uma clula que contenha
dados.
123
2. Selecione Inserir Boto de Ao no menu TM1 ou clique no boto Inserir Ao

na barra de ferramentas do TM1 .
O boto de Ao inserido na clula selecionada atualmente e aparece a caixa
de dilogo Propriedades do Boto de Ao.
3. Na caixa de dilogo Propriedades do Boto de Ao, clique na lista TM1
Server para selecionar o servidor no qual os dados esto localizados.
Se desejar recuperar dinamicamente nome do IBM Cognos TM1 server a partir
de uma clula ou intervalo nomeado sempre que o boto Action for executado,
clique na caixa de seleo Use Reference e, em seguia, insira uma clula ou
referncia de intervalo nomeado.
v Para selecionar uma referncia de clula, clique no boto Referncia do Excel
e, em seguida, clique na clula na planilha atual na qual o nome do
servidor est localizado.
v Para recuperar o nome do processo fazendo referncia a um intervalo
nomeado no Excel, use o seguinte formato:
=NameOfRange
O intervalo nomeado deve apontar apenas para uma nica clula que
contenha texto para o nome do servidor.
Se no estiver conectado ao servidor que voc deseja usar, clique em Conectar
para efetuar login.
4. Clique na opo Ao que voc deseja que seja executada pelo boto de Ao.
Em seguida, preciso configurar o boto de Ao, dependendo do tipo de ao
selecionada. Para etapas detalhadas, consulte as seguintes sees:
Ao
Consulte
Executar um Processo do TurboIntegrator
Configurando um Boto de Ao para

Executar um Processo
Ir para outra Planilha
Configurando um Boto de Ao para

Navegar para Outra Planilha na pgina 129
Executar um Processo e, em seguida, ir para Configurando um Boto de Ao para

outra Planilha
Executar um Processo e Navegar para uma
Planilha na pgina 131
Recalcular / Reconstruir
Configurando um boto de ao para

recalcular ou reconstruir uma planilha na
pgina 131
5. Configurar as propriedades de aparncia do boto de Ao. Consulte o

Configurando Propriedades de Aparncia de um Boto de Ao na pgina
133.
6. Para concluir o boto de Ao e retornar sua planilha, clique em OK na caixa
Resultados
O boto de Ao atualizado em sua planilha e agora pode ser usado.
Configurando um Boto de Ao para Executar um Processo

As etapas a seguir resumem como configurar um boto de Ao para executar um
processo do TurboIntegrator.
124
Procedimento
1. Na caixa de dilogo Propriedades do Boto de Ao, selecione a opo
Executar um Processo do TurboIntegrator.
A guia Processo exibida.
2. Selecione o processo que voc deseja executar. Consulte o Selecionando o
Processo a Ser Executado.
3. Configure os parmetros do Processo. Consulte o Configurando Parmetros do
Processo na pgina 126.
4. Selecione a opo de clculo que voc deseja que o TM1 aplique antes do boto
de Ao executar o processo. Consulte o Configurando um boto de ao para
recalcular ou reconstruir uma planilha na pgina 131.
5. Selecione a opo de clculo que voc deseja que o TM1 aplique aps o
processo ser concludo. Consulte o Configurando Opes do Processo para
Clculo na pgina 128.
6. Configure as mensagens que deseja que o TM1 mostre antes e aps o processo
ser executado. Consulte o Configurando Opes do Processo para Mostrar
Mensagens na pgina 128.
Selecionando o Processo a Ser Executado

possvel selecionar o processo que voc deseja executar de uma entre duas
maneiras:
v Selecione o nome do processo da lista Processo.
v Recupere dinamicamente o nome do processo usando uma referncia do Excel.
Selecionar o Nome do Processo da Lista Processo

Se desejar selecionar o nome do processo a partir de uma lista de processos
disponveis no IBM Cognos TM1 server atual, execute a etapa a seguir.
Procedimento
Na guia Processo do dilogo Propriedades do Boto de Ao, clique na lista
Processo para selecionar um processo disponvel do TM1 server ao qual est
atualmente conectado.
A grade Parmetros se abre e exibe os parmetros para o processo selecionado.
Resultados
necessrio ento inserir os valores de parmetros para o processo selecionado na
grade Parmetro. Consulte o Inserir Valores de Parmetros na Grade Parmetro
na pgina 126.
Usar uma Referncia do Excel para Recuperar o Nome do

Processo
Se desejar recuperar dinamicamente o nome do processo, fazendo referncia a uma
clula ou intervalo nomeado na planilha atual, execute as seguintes etapas. O
nome do processo ser recuperado quando o boto de Ao for executado.
Procedimento
1. Na caixa de dilogo Propriedades do Boto de Ao, selecione Obter
Informaes do Processo da Planilha, na lista Processo.
, junto caixa Nome do Processo para
2. Clique no boto Referncia do Excel
selecionar uma clula da planilha atual.
Captulo 7. Usando os Botes de Ao do TM1 para Construir Aplicativos de Planilhas
125
A caixa de dilogo Selecionar uma Clula se abre.

3. Clique na clula na planilha atual na qual o nome do processo est localizado.
O local automaticamente inserido na caixa de dilogo Selecionar uma Clula.
4. Clique em OK para fechar a caixa de dilogo Selecionar uma Clula.
A referncia de clula aparece na caixa Nome do Processo.
5. Para recuperar o nome do processo fazendo referncia a um intervalo nomeado
no Excel, use o seguinte formato:
=NameOfRange
O intervalo nomeado deve apontar apenas para uma nica clula que contenha
texto para o nome do processo.
Configurando Parmetros do Processo

Dependendo de como foi selecionado o nome do processo para ser executado,
insira os valores de parmetros de uma entre as duas maneiras a seguir.
v Insira valores de parmetros na grade Parmetro.
v Crie uma referncia do Excel para recuperar os valores de parmetros.
Inserir Valores de Parmetros na Grade Parmetro

Se voc selecionou o nome do processo diretamente da lista Processo, poder
inserir os valores de parmetros na grade Parmetro usando as seguintes etapas.
possvel digitar os valores na grade de cada parmetro, ou usar uma referncia do
Excel para recuperar dinamicamente um valor de parmetro da planilha atual
quando o boto de Ao for clicado.
Procedimento
1. Na guia Processo do dilogo Propriedades do Boto de Ao, insira os valores
de parmetros na grade Parmetros.
Para inserir diretamente os valores de parmetros, digite os valores na grade
para cada parmetro.
2. Para criar uma referncia que recupere dinamicamente um valor de parmetro
.
da planilha atual, selecione a clula Valor e, ento, clique no
A caixa de dilogo Selecionar uma Clula se abre.
3. Use a caixa de dilogo Selecionar uma Clula para selecionar a clula na
planilha na qual o valor de parmetro pode ser localizado.
126
Usar uma Referncia do Excel para Recuperar os Valores de

Parmetros
Se voc selecionou Obter Informaes do Processo da Planilha na lista Processo,
dever criar uma referncia do Excel que recupere dinamicamente os parmetros
do processo de uma planilha.
Procedimento
1. Clique no boto Referncia do Excel
, junto caixa Parmetros, para
selecionar uma referncia da planilha atual.
A caixa de dilogo Selecionar um Intervalo se abre.
2. Selecione o intervalo de clulas na planilha na qual os valores de parmetros
esto localizados. Cada clula deve conter o valor para apenas um parmetro.
Nota: Os parmetros devem ser inseridos na mesma ordem e tipo (sequncia,
numrico) que no processo.
3. Clique em OK para fechar o dilogo Selecionar um Intervalo.
A referncia de clula selecionada aparece na caixa Parmetros.
Se desejar fazer referncia a um intervalo nomeado no Excel, use o seguinte
formato:
=NameOfRange
O intervalo nomeado deve apontar para uma nica clula ou um intervalo de

clulas, dependendo dos parmetros esperados pelo processo.
Se houver mudana nos parmetros para o processo, voc tambm dever
atualizar o nome do processo e as configuraes de parmetros para o boto de
Ao para que o boto possa executar corretamente o processo.
Nota: Devido a um problema no Microsoft Excel, se um boto de Ao que
executa um processo do Turbo Integrator com entradas de parmetro for criado
127
e salvo em uma planilha do Excel 2007, o boto de Ao parar de trabalhar

aps o arquivo ser salvo e, em seguida, reaberto. Como uma soluo
alternativa, ao usar um boto de Ao no Excel 2007 para executar um processo
do TI que requer parmetros, salve o arquivo de planilha no formato .xls.
Configurando Opes do Processo para Clculo

Use a caixa de dilogo Opes do Processo para selecionar a operao de clculo
que ser executada aps o processo ser executado.
Procedimento
1. Clique em Opes para mostrar a caixa de dilogo Opes do Processo.
2. Selecione a operao de clculo que deseja executar aps a execuo do
processo. As opes de clculo disponveis incluem:
v Recalcular Planilha Automaticamente - Recalcula os valores na planilha
atual.
v Reconstruir Planilha - Recarrega o Formulrio Ativo do TM1 de sua
configurao de definio de relatrio original.
v Nenhum - O boto de Ao no executar nenhuma operao de clculo ou
de reconstruo na planilha.
Configurando Opes do Processo para Mostrar Mensagens

Use a caixa de dilogo Opes do Processo para controlar as diferentes caixas de
mensagens que o TM1 pode mostrar antes e depois que o processo for executado.
Procedimento
1. Na guia Processo, clique em Opes para abrir a caixa de dilogo Opes do
Processo.
2. Selecione as mensagens de confirmao e de status que deseja que o TM1
mostre.
v Mostrar Mensagem de xito - Exibe uma mensagem aps o processo ter sido
executado com xito.
v Mostrar Mensagem de Erro - Exibe uma mensagem, se o processo no tiver
sido executado com xito.
v Mostrar Dilogo de Confirmao - Exibe uma mensagem de confirmao
antes da execuo do processo. O usurio pode clicar em Sim ou em No.
3. Insira ou edite o texto para as mensagens selecionadas. Tambm possvel
fazer referncia a uma clula ou intervalo nomeado para recuperar
dinamicamente o texto da mensagem. Por exemplo:
v Para recuperar o texto da mensagem do contedo da clula A1 na planilha
atual, insira =A1 na caixa de texto da mensagem.
v Para fazer referncia a um intervalo nomeado no Excel, use o formato
=NameOfRange.
O intervalo nomeado deve apontar para uma nica clula que contenha o
texto para a mensagem.
Usando a Propriedade de Nome do Servidor do Boto de

Ao
A caixa de dilogo Propriedades do boto de Ao inclui um campo onde
possvel inserir uma clula ou referncia de intervalo nomeado para recuperar
dinamicamente o nome do IBM Cognos TM1 server para um boto de Ao. Para
128
usar este recurso, clique na caixa de seleo Usar Referncia na seo TM1 server
na caixa de dilogo Propriedades do Boto de Ao e, ento, insira uma clula ou
referncia de intervalo nomeado.
Configurando um Boto de Ao para Navegar para Outra Planilha

Um Boto de Ao pode ser usado para navegar para outra planilha na mesma
pasta de trabalho, ou para uma planilha em outra pasta de trabalho.
As etapas a seguir resumem como configurar um boto de Ao para navegar para
outra planilha.
Procedimento
1. Na caixa de dilogo Propriedades do Boto de Ao, clique na opo Ir para
outra Planilha.
A guia Planilha exibida.
2. Selecione a planilha de destino. Consulte o Selecionar uma Planilha de
Destino.
3. Configure a opo Corresponder Elementos de Ttulo. Consulte o Ativar a
Opo Corresponder Elementos de Ttulo na pgina 130.
4. Configure a opo Substituir Pasta de Trabalho Atual. Consulte o
Configurando a Opo Substituir Pasta de Trabalho Atual na pgina 130.
5. Selecione a opo de clculo que voc deseja que o TM1 aplique antes que o
boto de Ao navegue para outra planilha. Consulte o Configurando um
boto de ao para recalcular ou reconstruir uma planilha na pgina 131.
6. Selecione a opo de clculo que voc deseja que o TM1 aplique aps a
navegao ter concludo. Consulte o Configurando Opes de Clculo para
Depois de Navegar para uma Planilha na pgina 131.
Selecionar uma Planilha de Destino

possvel selecionar uma planilha escolhendo-a em uma lista ou digitando
diretamente seu nome.
Procedimento
1. Clique na opo Aplicativos do TM1 e, em seguida, clique em Navegar.
O dilogo Selecionar uma Planilha se abre.
Nota: Para selecionar uma pasta de trabalho de destino, tambm possvel
clicar na opo Arquivos e, em seguida, clicar em Procurar. Em seguida,
selecione um arquivo da planilha a partir do dilogo Abrir e, em seguida,
clique em Abrir. Outro mtodo para selecionar uma pasta de trabalho de
.
destino clicar no boto Excel Reference
2. Selecione uma planilha e, em seguida, clique em OK para retornar ao dilogo
Propriedades do Boto de Ao.
O nome e caminho da pasta Aplicativo da planilha selecionada so exibidos na
caixa Pasta de Trabalho.
3. Para inserir manualmente o caminho da pasta Aplicativo para a pasta de
trabalho, digite o caminho na caixa Pasta de Trabalho:
v Comece com o nome da primeira pasta sob Aplicativos e use uma barra
invertida \ para separar as pastas. No inclua a pasta Aplicativos no
caminho. Por exemplo:
129
Planning
Sample\Bottom Up Input\Budget Input
v Para especificar um local de planilha e de clula para o qual voc deseja

navegar, digite o nome e local da planilha na caixa Planilha usando o
seguinte formato:
=SheetName!ColumnNameRowName
Nota: Se voc inserir um nome de planilha que inclua espaos, dever

colocar o nome entre aspas simples, conforme mostrado no exemplo a seguir.
='Minha Primeira Planilha'!$A$2
Ativar a Opo Corresponder Elementos de Ttulo

A opo Corresponder Elementos do Ttulo corresponde e configura
automaticamente o texto das dimenses do ttulo na planilha de destino quando
um usurio clica no boto Ao para navegar para a planilha de destino.
Quando a opo Corresponder Elementos do Ttulo ativada, as dimenses nas
planilhas de origem e de destino so correspondidas automaticamente pelas
funes SUBNM e DBRW do TM1, da seguinte forma:
v O TM1 corresponde automaticamente dimenses de ttulo nas planilhas de
origem e destino com base na frmula SUBNM em uma clula.
Por exemplo, quando a mesma dimenso existe tanto na planilha de origem
como de destino, o elemento selecionado na planilha de origem configurado
para a mesma dimenso na planilha de destino. Quando uma coluna
selecionada na planilha de origem, ela corresponde coluna com as mesmas
dimenses de ttulo na planilha de destino.
v O TM1 automaticamente corresponde as dimenses de linha e coluna da clula
DBRW atualmente selecionada na planilha de origem para as dimenses de
ttulo correspondentes na planilha de destino, se elas existirem.
Por exemplo, se Despesa Operacional e Fev-2004 forem os elementos de
dimenso da linha e da coluna do elemento atualmente selecionado na planilha
de origem, ao navegar, esses elementos de dimenso sero ento correspondidos
s dimenses do ttulo na planilha de destino. Se a linha Despesa Operacional e
a coluna Fev-2004 forem selecionadas na planilha de origem, a clula DBRW ser
a clula existente na linha Despesa Operacional e na coluna Fev-2004. As
dimenses de linha e coluna da clula DBRW sero, ento, correspondidas s
dimenses de ttulo na planilha de destino.
Configurando a Opo Substituir Pasta de Trabalho Atual

A opo Substituir Pasta de Trabalho Atual determina se a planilha de destino
aberta em uma nova janela ou na mesma janela, substituindo a planilha de origem.
Por exemplo:
v Se Substituir Plasta de Trabalho Atual no estiver selecionado (padro) e voc
estiver trabalhando no TM1 Web, a planilha de origem permanecer aberta e a
planilha de destino ser aberta em uma nova guia.
v Se Substituir Pasta de Trabalho Atual estiver selecionada e voc estiver
trabalhando no TM1 Web, a planilha de origem ser substituda pela planilha de
destino na mesma guia e uma nova guia no ser aberta.
130
Importante: Se voc ativar a opo Substituir Pasta de Trabalho Atual, lembre-se

de salvar sua pasta de trabalho antes de testar no novo boto. Suas mudanas
podero ser perdidas, se voc clicar no boto e causar o fechamento da pasta de
trabalho atual.
Configurando Opes de Clculo para Depois de Navegar

para uma Planilha
Configure as opes de clculo a serem aplicadas planilha de destino aps a
navegao.
Procedimento
Na guia Planilha, selecione as opes de Clculo que deseja usar.
v Recalcular Planilha Automaticamente - Recalcula os valores na planilha atual.
v Nenhum - O boto de Ao no executar nenhuma operao de clculo ou de
reconstruo na planilha.
Configurando um Boto de Ao para Executar um Processo e

Navegar para uma Planilha
Para configurar uma Ao que executa um processo do Turbo Integrator e ento
navega para outra planilha, execute as seguintes etapas.
Procedimento
1. Na caixa de dilogo Propriedades do Boto de Ao, clique na opo Executar
um Processo, em seguida, ir para uma Planilha.
A guia Processo exibida.
2. Selecione o processo que ser executado pelo Boto de Ao. Consulte o
Configurando um Boto de Ao para Executar um Processo na pgina 124.
3. Selecione a planilha para a qual o boto de Ao navegar. Consulte o
Configurando um Boto de Ao para Navegar para Outra Planilha na
pgina 129.
Configurando um boto de ao para recalcular ou reconstruir uma

planilha
Um boto de Ao pode ser usado para executar apenas uma operao de novo
clculo ou de reconstruo, sem executar um processo de TI ou navegar para uma
nova planilha. Isso poder ser til se desejar apenas atualizar a planilha atual ou
recarregar a verso original de um Formulrio Ativo.
Tambm possvel usar a guia Calcular para selecionar a operao de clculo que
deseja que o TM1 execute antes de executar um processo do TI ou de navegar para
outra planilha.
Procedimento
1. Insira um boto de Ao em sua planilha, conforme descrito em Incluindo um
Boto de Ao em uma Planilha na pgina 123.
2. Na caixa de dilogo Propriedades do Boto de Ao, clique na guia Calcular.
3. Na guia Calcular, selecione a opo de clculo que voc deseja usar.
131
v Recalcular Planilha Automaticamente - Recalcula os valores na planilha

atual.
v Nenhum - O boto de Ao no executar nenhuma operao de clculo ou
de reconstruo na planilha.
4. Configure a aparncia do boto, conforme descrito em Configurando
Propriedades de Aparncia de um Boto de Ao na pgina 133.
5. Na caixa de dilogo Propriedades do Boto de Ao, clique em OK para fechar
o dilogo e inserir o boto de Ao em sua planilha.
Compreendendo o Comportamento do Boto de Ao com os

Formulrios Ativos do TM1
Esta seo resume o comportamento e a ordem das operaes ao usar o boto de
Ao com Formulrios Ativos.
Comportamento Bsico do Boto de Ao

Sempre que voc clicar em um boto de Ao, as seguintes etapas so executadas
nesta ordem:
1. A frmula DBRW capturada para a clula atualmente selecionada na planilha
de origem.
A frmula da clula DBRW capturada antes da seguinte operao de Novo
Clculo (F9), porque o novo clculo pode alterar o nmero de linhas do
formulrio ativo devido supresso de zeros e/ou subconjuntos de linhas
baseados em MDX.
2. A operao de Novo Clculo (F9) ou de reconstruo executada na planilha
atual, dependendo da opo de clculo selecionada na guia Calcular da caixa
3. Os valores atualizados so capturados para quaisquer outras clulas referidas
por opes avanadas de mapeamento.
Comportamento Adicional do Boto de Ao

Quando as etapas bsicas acima forem concludas, as seguintes etapas adicionais
sero executadas, caso o boto de Ao esteja executando um processo de TI,
navegando para outra planilha ou ambos.
Ao usar um boto de Ao para executar apenas um processo de TI:
1. O processo de TI executado.
2. A operao de clculo selecionada na caixa de dilogo Opes do Processo do
boto de Ao executada.
Ao usar um boto de Ao apenas para navegar:
1. A ao de navegao iniciada.
2. Os valores de destino so configurados na planilha de destino.
3. A operao de clculo selecionada na guia Planilha da caixa de dilogo
Propriedades do Boto de Ao executada na planilha de destino.
Ao usar um boto de Ao para executar um processo de TI e navegar para uma
planilha:
1. O processo de TI executado.
132
2. A operao de clculo selecionada na caixa de dilogo Opes do Processo do

boto de Ao executada.
3. A ao de navegao iniciada.
4. Os valores de destino so configurados na planilha de destino.
5. A operao de clculo selecionada na guia Planilha da caixa de dilogo
Propriedades do Boto de Ao executada na planilha de destino.
Configurando Propriedades de Aparncia de um Boto de Ao

Use a guia Aparncia para configurar a legenda, figura de plano de fundo ou
outros recursos visuais para o boto de Ao.
Clique na guia Aparncia para ajustar as propriedades de aparncia do boto.
A guia Aparncia possui as seguintes opes:
v Legenda - Configura o texto da legenda exibido no boto.
v Fonte - Exibe um dilogo de fonte padro, no qual possvel alterar o tipo e
tamanho de fonte do texto do boto.
v Mostrar Imagem do Segundo Plano - Permite selecionar um arquivo de imagem
(formato bmp, gif ou jpg) que ser estendido para ajustar-se ao boto.
v Exibir como Hyperlink - Quando ativada, esta opo exibe o boto como um
hyperlink com texto azul, sublinhado, em vez de um boto padro.
v Visualizao - Esta rea mostra um exemplo do boto.
v Cores - Permite configurar as cores do texto e do plano de fundo do boto.
Clique na amostra de cores para exibir um dilogo Cor, no qual possvel
selecionar uma cor padro ou definir uma cor customizada.
Usando Opes Avanadas de Navegao e Mapeamento

Use o dilogo Opes Avanadas para mapear manualmente campos entre a
planilha de origem e a planilha de destino, ao inserir um boto de Ao que
navega de uma planilha para outra. Esta ferramenta ajuda a mapear dimenses,
clulas e valores da planilha de origem para a planilha de destino.
Nota: O mapeamento avanado aplicado aps qualquer mapeamento automtico
ter sido executado pela opo Corresponder Elemento do Ttulo.
Para abrir o dilogo Opes Avanadas, clique em Opes Avanadas na guia
Planilha.
O dilogo Opes Avanadas inclui uma grade, na qual voc define o
mapeamento de campos entre as planilhas de origem e de destino. Use os botes
Incluir e Excluir para gerenciar as linhas na grade.
Configurando o Mapeamento de Origem para Destino

Voc mapeia a planilha de origem para a planilha de destino, configurando valores
para os campos Tipo de Origem, Objeto de Origem, Tipo de Destino e Objeto de
Destino na grade Mapeamento Avanado.
possvel usar a grade para especificar como os elementos nas planilhas de
origem e de destino so correspondidos quando a planilha de destino aberta.
Cada linha na grade define uma configurao de mapeamento.
133
Use as seguintes etapas para configurar o mapeamento avanado:

Etapa
Consulte
Indicar o tipo de objeto a ser mapeado
Configurar o Tipo de Origem
Determinar o valor para o tipo de objeto que Configurar o Objeto de Origem

est sendo usado
Indicar o tipo de clula a ser mapeada
Configurar o Tipo de Destino
Indicar onde o valor do Objeto de Origem

ser inserido
Configurar o Objeto de Destino na pgina

135
Repita estas etapas para criar mais configuraes de mapeamento.
Configurar o Tipo de Origem

O campo Tipo de Origem representa o tipo de objeto para o valor que deseja
mapear.
Selecione o Tipo de Origem, da seguinte forma:
v SUBNM - Indica que voc est mapeando de uma clula que contm uma
dimenso de ttulo na planilha de origem.
v DBRW Selecionado - Indica que voc est mapeando de uma clula que contm
uma frmula DBRW na planilha de origem.
v Valor - Indica que voc inserir um valor de sequncia ou numrico que ser
enviado para o destino.
Configurar o Objeto de Origem

O campo Objeto de Origem usa um valor, ou expresso do Excel, que avaliada
para um valor, dependendo do que foi selecionado no campo Tipo de Origem.
Insira o Objeto de Origem, da seguinte forma:
v Se o Tipo de Origem for configurado como SUBNM, ser necessrio especificar
o nome da dimenso de ttulo existente na planilha de origem.
v Se o Tipo de Origem for configurado como DBRW Selecionado, ser necessrio
especificar o nome de uma dimenso de ttulo de linha ou de coluna existente
na planilha de origem.
v Se o Tipo de Origem for configurado como Valor, ser necessrio inserir um
valor de sequncia ou numrico que ser enviado para a planilha de destino.
Nota: Tambm possvel recuperar estes valores da planilha de origem, usando o
smbolo = para criar uma referncia do Excel.
Configurar o Tipo de Destino

O Tipo de Destino o tipo de clula na planilha de destino no qual o valor do
campo Objeto de Origem ser inserido.
Selecione o Tipo de Destino, da seguinte forma:
v SUBNM - Indica que o destino uma dimenso de ttulo na planilha de destino.
v Intervalo Nomeado - Indica que o destino um intervalo nomeado na planilha
de destino.
v Intervalo - Indica que o local de destino uma clula na planilha de destino.
Nota: Se voc configurar Tipo de Destino para um Intervalo Nomeado ou
Intervalo, quaisquer dados ou frmula preexistentes na clula de destino sero
134
substitudos quando voc usar o boto de Ao para navegar. Se a clula de

destino contiver uma funo DBRW, ento a funo ser perdida e a clula no
ser capaz de se conectar, ler ou gravar no IBM Cognos TM1 server .
Configurar o Objeto de Destino

O Objeto de Destino o local na planilha de destino em que o valor do Objeto de
Origem ser inserido. Este local pode ser o nome de uma dimenso de ttulo, um
local de clula especfico, ou um intervalo nomeado na planilha de destino,
dependendo do que foi selecionado para Tipo de Destino.
Insira o Objeto de Destino, da seguinte forma:
v Se o Tipo de Destino for configurado como SUBNM, especifique o nome da
dimenso de ttulo na planilha de destino. Quando o Tipo de Destino for
configurado como SUBNM, voc dever inserir um valor para os campos
Subconjunto e Alias.
v Se o Tipo de Destino for configurado como Intervalo Nomeado, especifique o
nome do intervalo na planilha de destino.
v Se o Tipo de Destino for configurado como Intervalo, especifique o local da
clula na planilha de destino.
possvel inserir um valor para o Objeto de Destino, inserindo diretamente o
valor do local ou usar uma referncia do Excel para recuperar o local.
v Inserir Valor Diretamente
Para identificar um local na planilha de destino, insira o valor diretamente no
campo Objeto de Destino sem o smbolo =. Por exemplo, insira C3 para
identificar o local do Objeto de Destino como a clula C3 da planilha de
destino.
v Fazer Referncia a uma Clula do Excel
Para fazer referncia a uma clula em uma planilha de origem que contm um
local para o Objeto de Destino, inclua o smbolo =. Por exemplo, a clula A1 na
planilha de origem pode conter o valor C3 para representar o local da clula
para o Objeto de Destino na planilha de destino.
Repita todas as etapas acima para criar mais configuraes de mapeamento.
Exemplo de Mapeamento de um Valor de Origem para uma

Clula de Destino
Este exemplo mostra o mapeamento de um valor codificado permanentemente
para uma clula na planilha de destino.
135
Exemplo de Mapeamento de um SUBNM de Origem para uma

Clula de Destino
possvel especificar uma dimenso de ttulo de SUBNM na planilha de origem
para mapeamento para um SUBNM, intervalo nomeado ou intervalo (clula)
correspondente na planilha de destino.
Por exemplo, a figura a seguir mostra o elemento de ttulo Srie S 2.0 L Wagon
sendo inserido na clula B2 na planilha de destino como uma legenda formatada.
136
Exemplo de Mapeamento do DBRW Selecionado para a

Planilha de Destino
Neste exemplo, as dimenses de ttulo de linha e de coluna para a clula DBRW
selecionada so exibidas na planilha de destino.
Modificando um Boto de Ao Existente

Aps a insero de um boto de Ao, possvel editar suas propriedades,
tamanho e local, conforme descrito nas sees a seguir.
Editando a Legenda, Imagem do Plano de Fundo e

Propriedades de um Boto de Ao Existente
Para editar as propriedades de um boto de Ao, clique com o boto direito do
mouse no boto e selecione uma opo do menu.
O menu de atalho fornece as seguintes opes principais:
v Legenda - Abre o dilogo Legenda do Boto para editar a legenda do boto.
v Imagem do Segundo Plano - Abre um dilogo de seleo de arquivo para que
seja possvel navegar e selecionar uma imagem para ser usada como o segundo
plano do boto.
v Propriedades - Abre o dilogo Propriedades do Boto de Ao, no qual voc
configura as aes que ocorrem quando um usurio clica no boto.
Movendo e Redimensionando um Boto de Ao Existente

Depois de clicar fora de um novo boto de Ao, o boto ativado e no fica mais
no modo de design. Se desejar redimensionar ou mover o boto, voc dever
ativar o modo de design no Excel, da seguinte forma:
137
Procedimento
1. No Excel, clique em Exibir, Barras de Ferramentas, Caixa de Ferramentas de
Controle.
A Caixa de Ferramentas de Controle do Excel se abre.
.
2. Clique no boto Modo de Design
Os rtulos de texto desaparecem nos botes de Ao na planilha atual.
3. Clique no boto de Ao que voc deseja mover ou redimensionar.
Identificadores aparecem no boto indicando que ele pode ser redimensionado
e movido.
v Para redimensionar o boto, clique e arraste qualquer uma dos
identificadores.
v Para mover o boto, clique e arraste o boto para um novo local.
.
4. Saia do modo de design clicando no boto Modo de Design
Os identificadores no boto de Ao desaparecem e o boto retorna ao modo
ativo.
138
Captulo 8. Desenvolvendo Aplicativos da Web Customizados

com a API da URL
Alm de usar o IBM Cognos TM1 Web como um aplicativo independente,
programadores da Web e desenvolvedores de aplicativos do TM1 podem usar a
interface de programao de aplicativos de URL (API) para incorporar objetos do
TM1 Web em aplicativos da Web customizados, portais e painis.
Viso Geral da Interface de Programao de Aplicativos do

Localizador Uniforme
A funcionalidade da Interface de Programao de Aplicativos do Localizador
Uniforme de Recursos fornecida ao criar sequncias de consultas do Localizador
Uniforme de Recursos que exibem e acessam os seguintes objetos do TM1 Web:
v Planilha da Web
v Cubeviewer
v rvore de Navegao
Sintaxe da API da URL Bsica

A API da URL fornecida por meio do arquivo identificador TM1WebMain.aspx.
Uma sequncia de consulta do Localizador Uniforme de Recursos criada ao usar
os parmetros especficos do TM1 e, ento, passar o Localizador Uniforme de
Recursos completo para o servidor TM1 Web. A Interface de Programao de
Aplicativos do Localizador Uniforme de Recursos pode abrir e exibir objetos da
Planilha da Web, do Cubeviewer e da rvore de Navegao. Tambm possvel
usar a API da URL para aplicar vrias aes nestes objetos.
URL Base
Use a seguinte URL base para iniciar a construo de uma chamada de API da
URL:
http://<HostName>/TM1Web/TM1WebMain.aspx
Em que HostName pode ser o nome de domnio ou o endereo IP do site ou

computador que hospeda o servidor TM1 Web.
Por exemplo, se o servidor TM1 Web estiver sendo executado em um computador
remoto denominado mywebserver, use o nome desse sistema para o HostName, da
seguinte forma:
http://mywebserver/TM1Web/TM1WebMain.aspx
139
Parmetros
Os parmetros definem qual objeto voc deseja acessar e o que voc deseja fazer
com esse objeto. Voc constri uma sequncia URL completa incluindo parmetros
na URL base da seguinte forma.
Por exemplo, o seguinte Localizador Uniforme de Recursos abre o objeto

Cubeviewer para o cubo SalesCube e exibe a visualizao denominada Regio.
http://mywebserver/TM1Web/TM1WebMain.
aspx?action=OpenObject&type=Cubeviewer&value=SalesCube$$Region
Parmetro ObjectId
Cada endereo do Localizador Uniforme de Recursos que abre um objeto do TM1
Web retorna um Localizador Uniforme de Recursos com o parmetro ObjectId e o
valor integrado nele como uma referncia exclusiva ao objeto especfico que foi
aberto. O parmetro ObjectId pode ser usado em uma nova URL para executar
aes adicionais no mesmo objeto.
http://mywebserver/TM1Web/TM1WebSheet.aspx?Objectid=
id_value
Para obter detalhes sobre como usar o parmetro ObjectId, consulte Operando em
um Objeto Existente do TM1 Web com o Parmetro ObjectId na pgina 144.
Usando Caracteres de Escape da URL

recomendvel usar caracteres de escape da URL ao criar URLs que contm
espaos ou outros caracteres especiais.
Alguns exemplos comuns de caracteres de escape da URL incluem:
Caractere
Caractere de Escape
Espao
%20
%24
%25
&
%26
Por exemplo, ao incluir um nome de visualizao em sua URL que contenha

espaos, tais como, Minha Visualizao de Vendas, use o seguinte formato:
140
Conceitos Bsicos da API da URL

Esta seo descreve os conceitos bsicos do uso da API da URL:
v Configurando os Parmetros de Nome do Host Administrador e de Nome do
Servidor TM1 Web
v Gerenciando Login e Logout do Usurio
v Usando o Parmetro de Ao
v Usando o Parmetro OpenObject para Abrir um Objeto do TM1 Web
v Operando em um Objeto Existente do TM1 Web com o Parmetro ObjectId
Configurando os Parmetros de Nome do Host Administrador

e de Nome do Servidor TM1 Web
possvel configurar o Host Administrador e o nome do servidor na sequncia de
consulta do Localizador Uniforme de Recursos ao usar os parmetros AdminHost e
TM1Server, da seguinte forma:
&AdminHost=<value>&TM1Server=<value>
Esses valores so opcionais no Localizador Uniforme de Recursos, mas devem ser

fornecidos para o TM1 no arquivo web.config ou na sequncia do Localizador
Uniforme de Recursos. Se esses valores no forem localizados, ento o TM1
solicitar essas informaes ao usurio com uma minijanela pop-up.
O TM1 procura por Host Administrador e nome do servidor na ordem a seguir:
v Se os parmetros AdminHost e TM1Server estiverem definidos na URL, eles
substituiro os valores no arquivo web.config.
v Se esses valores estiverem ausentes na sequncia de consulta do Localizador
Uniforme de Recursos, o TM1 Web tentar determinar se esto configurados no
arquivo web.config.
v Se os parmetros AdminHost e TM1Server estiverem ausentes na sequncia do
Localizador Uniforme de Recursos e tambm no estiverem no arquivo
web.config, ento os campos de entrada do Host Administrador e servidor sero
exibidos para o usurio em um miniformulrio de login.
Gerenciando Login e Logout do Usurio

Os usurios devem efetuar login no IBM Cognos TM1 server quando usarem a
interface de programao de aplicativos de URL para visualizar objetos do TM1
Web. possvel gerenciar o processo de login do usurio de qualquer uma das
seguintes maneiras:
Login Integrado - Use autenticao de rede do Microsoft Windows para acesso
de controle para dados do TM1 . Para obter mais detalhes, consulte o Guia de
Operaes do IBM Cognos TM1 .
v Incluir no Localizador Uniforme de Recursos - Especifique as informaes de
login no Localizador Uniforme de Recursos ao acessar os objetos do TM1 Web.
A URL deve incluir valores para AdminHost, TM1Server, UserName e Password.
A especificao de uma senha na URL no segura.
v Mini Pop-up de Login - Se todas, ou algumas, das informaes de login no
tiverem sido fornecidas de nenhuma outra forma, ento uma minijanela de
pop-up ser exibida para solicitar que o usurio efetue login antes que os objetos
do TM1 Web possam ser exibidos.
Captulo 8. Desenvolvendo Aplicativos da Web Customizados com a API da URL
141
Pgina de Login Customizada - possvel criar sua prpria pgina de login

customizado ao usar o arquivo do manipulador de login do TM1 ,
TM1WebLoginHandler.aspx, para processar solicitaes de login por meio de um
mtodo GET do Localizador Uniforme de Recursos ou POST de formulrio. Para
qualquer um dos mtodos, necessrio fornecer valores para AdminHost,
TM1Server, UserName e Password para o arquivo TM1WebLoginHandler.aspx.
Um exemplo de um login customizado usando o arquivo

TM1WebLoginHandler.aspx e o mtodo Post de formulrio apresentado a seguir:
<form method="post" action="TM1WebLoginHandler.aspx?">
<input name="AdminHost" id="AdminHost" type="text" value="">
<br>
<input name="TM1Server" id="TM1Server" type="text" value="sdata">
<br>
<input name="UserName" id="UserName" type="text" value="admin">
<br>
<input name="Password" id="Password" type="password" value="">
<br>
<input name="SubmitBtn" id="SubmitBtn" type="submit" value="Login"
/>
</form>
Depois de efetuar login, voc pode redirecionar o usurio para uma URL diferente,
incluindo o parmetro de redirecionamento na URL de login, da seguinte forma:
redirect=newUrl
em que newURL pode ser qualquer URL vlida para a qual navegar aps efetuar
login. Por exemplo:
redirect=myStartPage.html
Se ocorrer um erro de login, o TM1 inserir a mensagem de erro no Localizador

Uniforme de Recursos retornado no seguinte formato:
error=error_message
em que error_message descreve o erro ocorrido.
Efetuando Logout
Para efetuar logout, use o seguinte componente da URL:
action=Logout
Se voc incluir o parmetro de redirecionamento, o usurio ser redirecionado para

uma URL especificada aps efetuar logout. Use o seguinte formato para especificar
um valor para o parmetro de redirecionamento:
action=Logout&redirect=newURL
em que newURL pode ser qualquer URL vlida para a qual o usurio ser
redirecionado aps efetuar logout.
Usando o Parmetro de Ao com Objetos do TM1 Web

O parmetro de ao especifica o tipo de ao a ser executada em um objeto do
TM1 Web. Use o parmetro de ao na sequncia de consultas da URL da seguinte
forma:
action=<TypeOfAction>
em que TypeOfAction pode ser um dos seguintes valores:
142
Ao
Descrio
Close
Fecha um objeto existente.

Exemplo:
action=Close
Logout
Efetua o logout do usurio da sesso atual do servidor.

Exemplo:
action=Logout
OpenObject
Abre um objeto do TM1 Web.

Exemplo:
action=OpenObject
Para obter uma viso geral do uso da ao OpenObject, consulte
Usando o Parmetro OpenObject para Abrir um Objeto do TM1
Web na pgina 144.
Rebuild
Recalcula todos os valores e reconstri todos os subconjuntos para

um Formulrio Ativo do TM1 contido em uma Planilha da Web.
Esta ao executa a mesma ao de quando voc clica no boto
Reconstruir na barra de ferramentas do TM1 Web.
Exemplo:
action=Rebuild
Recalc
Recalcula um objeto planilha da Web ou Cubeviewer existente.

Exemplo:
action=Recalc
Reload
Recarrega apenas o objeto Cubeviewer.

Exemplo:
action=Reload
Save
Salva mudanas feitas nos valores dos dados em um objeto planilha

da Web ou Cubeviewer.
Exemplo:
action=Save
Nota: O comando Salvar no salva o layout de dimenso da
visualizao. Somente os valores de dados alterados so salvos no
TM1 . Por exemplo, se voc reorganizar as dimenses na
visualizao e, em seguida, usar a ao Salvar, as novas
configuraes para o layout da visualizao no sero salvas.
143
Usando o Parmetro OpenObject para Abrir um Objeto do

TM1 Web
Para abrir e exibir um objeto do TM1 Web, use o comando action=OpenObject e o
parmetro de Tipo, no seguinte formato geral:
action=OpenObject&type=object_type
em que object_type pode ser Websheet, Cubeviewer ou NavigationTree.

Dependendo do tipo de objeto, sero necessrios opes e parmetros adicionais,
conforme descrito nas prximas sees.
Abrindo Objetos Planilha da Web e Cubeviewer

O comando OpenObject pode ser usado para abrir objetos planilha da Web e
Cubeviewer de qualquer uma das seguintes maneiras:
v TM1 Object Path - Abre um objeto utilizando o nome e localizao do objeto
conforme usado internamente pelo TM1 .
Para obter detalhes, consulte Usando o Caminho do Objeto do TM1 para Abrir
um Objeto de Planilha da Web na pgina 145 e Usando o Caminho de Objeto
do TM1 para Abrir um Objeto Cubeviewer na pgina 149.
v Caminho do Application Organizer - Permite usar o caminho visual na rea de
janela de Navegao do TM1 para especificar a Planilha da Web ou a
visualizao do cubo que deseja abrir.
Para obter detalhes, consulte Usando o Caminho do Organizador de Aplicativo
para Abrir um Objeto Planilha da Web na pgina 146 e Usando o Caminho do
Organizador de Aplicativo para Abrir um Objeto Cubeviewer na pgina 149.
v ID de N da rvore XML - Abre um objeto usando o ID exclusivo do objeto da
verso XML do objeto rvore de Navegao.
Para obter detalhes, consulte Usando IDs de N da rvore XML para Abrir
Objetos Planilha da Web e Cubeviewer na pgina 161.
Tambm possvel definir a seleo de ttulo e outras propriedades de exibio
na mesma URL ao usar o comando OpenObject.
Abrindo o Objeto rvore de Navegao

Para abrir o objeto rvore de Navegao, defina o parmetro de tipo como
NavigationTree.
action=OpenObject&type=NavigationTree
Para obter detalhes adicionais, consulte Acessando o Objeto rvore de

Navegao na pgina 157.
Operando em um Objeto Existente do TM1 Web com o

Parmetro ObjectId
Use o parmetro ObjectId em um novo Localizador Uniforme de Recursos quando
desejar executar aes em um objeto do TM1 Web que j esteja aberto. O
parmetro e valor ObjectId=object_id identificam o objeto no qual a operao
precisa ocorrer.
Aps o objeto do TM1 Web ser aberto usando o comando action=OpenObject, o
ObjectId integrado no Localizador Uniforme de Recursos retornado, no seguinte
formato:
ObjectId=id_value
144
em que id_value um nmero exclusivo que pode ser usado para fazer referncia
ao objeto especfico do TM1 .
Por exemplo, abrir um objeto Cubeviewer retorna o ObjectId em uma URL
semelhante a esta:
http://mywebserver/TM1Web/TM1WebCubeviewer.aspx?ObjectId=83
Depois que o objeto for inicialmente aberto no documento da pgina da Web, ser
possvel obter o valor ObjectId programaticamente, analisando por meio da URL
retornada.
Inclua ObjectId=object_id no novo Localizador Uniforme de Recursos submetido
ao executar uma ao em um objeto especfico do TM1 Web.
Por exemplo, para recalcular este mesmo cubo, crie uma URL que inclua o
ObjectId para o cubo juntamente com a ao recalcular, da seguinte forma:
http://mywebserver/TM1Web/TM1WebMain.aspx?ObjectId=83&action=recalc
Nota: Se o parmetro ObjectId estiver ausente do Localizador Uniforme de

Recursos submetido, o TM1 executar a ao no objeto atualmente ativo.
Acessando o Objeto Planilha da Web

Uma planilha da Web um arquivo de planilha Microsoft Excel com dados do
TM1 que pode ser visualizado em um navegador da Web. A API da URL pode ser
usada para exibir uma planilha da Web, conforme descrito nesta seo.
Abrindo um Objeto Planilha da Web

Use uma das seguintes maneiras para identificar a planilha da Web que voc
deseja abrir.
v Caminho do TM1 Object
v Caminho do TM1 Application Organizer
v ID do N de rvore XML
Usando o Caminho do Objeto do TM1 para Abrir um Objeto de

Planilha da Web
Para abrir um objeto da planilha da Web usando o caminho de objeto do TM1 ,
use um dos formatos a seguir, dependendo da existncia da planilha da Web como
um arquivo de Excel referenciado fora do TM1 ou como um arquivo de Excel
interno que foi transferido por upload para o IBM Cognos TM1 server :
Para abrir uma Planilha da Web que existe como um arquivo do Excel mencionado,
fora do TM1 :
&action=OpenObject&type=Websheet&value=
WebsheetPath
em que WebsheetPath o local e nome do arquivo do Excel externo. Este pode ser
um caminho para um arquivo local, ou um caminho UNC para um arquivo
localizado em uma rede.
Por exemplo:
&action=OpenObject&type=Websheet&value=C:\Samples\classic_slice.xls
ou
145
&action=OpenObject&type=Websheet&value=//MySystem/Samples/classic_slice.xls
Procedimento
1. No Server Explorer, use a rea de janela Propriedades para localizar o Nome
do Sistema, que nome designado do TM1 para o arquivo do Excel transferido
por upload.
2. Defina o parmetro de valor na URL usando o seguinte formato:
&action=OpenObject&type=Websheet&value=
TM1://ServerName/blob/PUBLIC/.\}Externals\TM1_Filename
em que:
v Nome do Servidor o nome do IBM Cognos TM1 server onde o arquivo de
Excel est localizado.
v TM1_Filename o nome que o TM1 designou para o arquivo do Excel
transferido por upload.
Por exemplo:
&action=OpenObject&type=Websheet&value=TM1://sdata/blob/PUBLIC/.\}Externals\
Report_2006.xls_20070123212746.xls
Usando o Caminho do Organizador de Aplicativo para Abrir um

Objeto Planilha da Web
possvel usar o caminho do local para um objeto da planilha da Web no TM1
Application Organizer para abrir o objeto da seguinte maneira.
Procedimento
1. No Server Explorer, expanda a rvore Aplicativo para localizar a planilha da
Web que voc deseja abrir.
2. Construa uma sequncia que represente o caminho para o objeto. Inicie o
caminho com Applications/ e separe as subpastas com o smbolo barra /.
Por exemplo: Applications/My Reports/Report_2005.xls
3. Defina o parmetro de valor em sua URL como o caminho de Aplicativo
montado.
action=OpenObject&type=Websheet&value=Applications/My Reports/Report_2005.xls
Usando um ID do N de rvore XML para Abrir um Objeto

Planilha da Web
Use o comando OpenObject com o valor de ID do N de rvore, obtido da verso
XML do objeto rvore de Navegao, para abrir um objeto planilha da Web, da
seguinte forma:
action=OpenObject&type=Websheet&value=TreeNodeID
Selecionando Elementos de Ttulo para um Objeto Planilha da

Web
possvel definir os elementos de ttulo para um objeto planilha da Web usando o
parmetro title_S#-R#-C# para qualquer clula que contenha uma funo SUBNM.
Inclua o parmetro title_S#-R#-C# em sua URL usando o seguinte formato:
title_S#-R#-C#=element
em que:
146
v O S#-R#-C# define o nmero da planilha, da linha e da coluna para o local da

clula SUBNM na planilha da Web. Substitua os smbolos # por seus valores
para nmero da planilha, da linha e da coluna.
v O element o valor de sequncia para o nome do novo elemento de ttulo que
voc deseja selecionar.
Se desejar selecionar o novo elemento de ttulo por ndice de elemento, em vez de
nome de elemento, inclua o parmetro UseIndex na URL, da seguinte forma:
title_S#-R#-C#=element&UseIndex=yes
ou
title_S#-R#-C#=element&UseIndex=1
Aplicando Aes a um Objeto Planilha da Web

possvel usar o Parmetro de Ao com um Objeto de Planilha da Web.
Consulte o Usando o Parmetro de Ao com Objetos do TM1 Web na pgina
142.
Configurando Propriedades de Exibio para o Objeto

Planilha da Web
possvel configurar as seguintes propriedades de exibio para o objeto planilha
da Web, incluindo qualquer uma destas propriedades em sua URL usando o
formato:
&property=value
Por exemplo, inclua a seguinte linha em sua URL para desativar a exibio da
barra de ferramentas.
&HideToolbar=yes
Propriedade
Descrio
HideToolbar
Ativa ou desativa a barra de ferramentas. O padro

ativado.
Para desativar a barra de ferramentas:
v
HideToolbar=yes
HideToolbar=1
Para ativar a barra de ferramentas:

v
HideToolbar=no
HideToolbar=0
147
Propriedade
Descrio
AutoRecalc
Ativa ou desativa o novo clculo automtico. O padro

desativado.
Para desativar o novo clculo automtico, use uma das
seguintes opes:
v
AutoRecalc=off
AutoRecalc=no
AutoRecalc=0
Para ativar o novo clculo automtico, use uma das

seguintes opes:
HideTabs
AutoRecalc=on
AutoRecalc=yes
AutoRecalc=1
Ativa ou desativa a exibio das guias. Por padro, o TM1

usa a propriedade de sistema para determinar se as guias
sero ou no mostradas.
Para desativar guias:
v
HideTabs=yes
HideTabs=1
Para ativar guias:

v
HideTabs=no
HideTabs=0
Acessando o Objeto Cubeviewer

O objeto Cubeviewer exibe a visualizao do cubo do TM1 em uma pgina da Web
customizada.
148
Abrindo um Objeto Cubeviewer

Use uma das seguintes maneiras para identificar a visualizao de cubo que voc
deseja abrir.
v Caminho do TM1 Object
v Caminho do TM1 Application Organizer
v ID do N de rvore XML
Usando o Caminho de Objeto do TM1 para Abrir um Objeto

Cubeviewer
Use o seguinte formato para abrir um objeto Cubeviewer com o caminho de objeto
do TM1 :
action=OpenObject&type=Cubeviewer&value= CubeName $$ ViewName $$ Status
em que:
v CubeName o nome de cubo ao qual a visualizao pertence.
v
v
ViewName o nome da visualizao de cubo.

Status o status pblico ou partivular da visualizao de cubo.
Nota: Voc deve incluir um valor de PUBLICou PRIVATE em todos os caracteres

maisculos para identificar corretamente a visualizao de cubo especfica que
voc deseja abrir.
Por exemplo:
action=OpenObject&type=Cubeviewer&value=SalesCube$$Price$$PUBLIC
Usando o Caminho do Organizador de Aplicativo para Abrir um

Objeto Cubeviewer
possvel usar o caminho do local para um objeto de visualizao do cubo no
TM1 Application Organizer para abrir o objeto da seguinte maneira.
Procedimento
1. No Server Explorer, expanda a rvore Aplicativo para localizar a visualizao
de cubo que voc deseja abrir.
2. Construa uma sequncia que represente o caminho para o objeto. Inicie o
caminho com Applications/ e separe as subpastas com o smbolo /.
Por exemplo: Applications/MyReports/Price
3. Defina o parmetro de valor em sua URL como o caminho de Aplicativo
montado.
action=OpenObject&type=Websheet&value=Applications/MyReports/Price
Usando um ID do N de rvore XML para Abrir um Objeto

Cubeviewer
Use o comando OpenObject com o valor de ID do N de rvore, obtido da verso
XML do objeto rvore de Navegao, para abrir um objeto Cubeviewer, da
seguinte forma:
action=OpenObject&type=Cubeviewer&value=
TreeNodeID
149
Configurando Propriedades de Exibio para o Objeto

Cubeviewer
possvel configurar as seguintes propriedades de exibio para o objeto
Cubeviewer, incluindo qualquer uma destas propriedades em sua URL usando o
formato:
&property=value
Por exemplo, inclua a seguinte linha em sua URL para desativar a exibio da
barra de ferramentas:
&HideToolbar=yes
Ao
Descrio
HideToolbar
Ativa ou desativa a barra de ferramentas. O padro

ativado.
Para desativar a barra de ferramentas:
v
HideToolbar=yes
HideToolbar=1
Para ativar a barra de ferramentas:
AutoRecalc
HideToolbar=no
HideToolbar=0
Ativa ou desativa o novo clculo automtico. O padro

desativado.
Para desativar o novo clculo automtico:
v
AutoRecalc=off
AutoRecalc=no
AutoRecalc=0
Para ativar o novo clculo automtico:
HideTabs
AutoRecalc=on
AutoRecalc=yes
AutoRecalc=1
Ativa ou desativa a exibio das guias. Por padro, o

TM1 usa a propriedade de sistema para determinar se as
guias sero ou no mostradas.
Para desativar guias:
v
HideTabs=yes
HideTabs=1
Para ativar guias:
150
HideTabs=no
HideTabs=0
Ao
Descrio
HideTitlebar
Ativa ou desativa a barra de ttulo. A configurao

padro ativado.
Para desativar a barra de ttulo:
v
HideTitlebar=yes
HideTitlebar=1
Para ativar a barra de ttulo:

v
HideTitlebar=no
HideTitlebar=0
Nota: Esta configurao aplica-se apenas ao objeto

Cubeviewer.
Selecionando Elementos de Ttulo para o Objeto Cubeviewer

possvel definir os elementos de ttulo em um objeto Cubeviewer, incluindo o
parmetro de ttulo em sua URL, usando o seguinte formato:
&title_DimensionName=
element
em que:
v DimensionName o nome da dimenso de ttulo que voc deseja alterar.
v element o valor de sequncia para o nome do novo elemento de ttulo que voc
deseja selecionar.
Se desejar selecionar o novo elemento de ttulo por ndice de elemento, em vez de
nome de elemento, inclua o parmetro UseIndex na URL, da seguinte forma:
&title_DimensionName=element&UseIndex=yes
Or
&title_DimensionName=element&UseIndex=1
Aplicando Aes a um Objeto Cubeviewer

possvel aplicar o parmetro de ao com o objeto de Cubeviewer.
Consulte o Usando o Parmetro de Ao com Objetos do TM1 Web na pgina
142.
Exibindo Grficos com o Objeto Cubeviewer

Semelhante ao TM1 Web, o objeto Cubeviewer pode exibir os dados do TM1
apenas em grade, apenas em grfico, ou uma combinao de modo de grade e de
grfico. Use os parmetros descritos nesta seo para controlar as opes de
exibio de grfico, tais como, tipo de grfico, cores e tamanho.
151
Definindo Opes Bsicas de Grfico

O objeto Cubeviewer possui as seguintes opes bsicas de grfico:
Opo
Descrio
ChartOnly
Exibe o objeto Cubeviewer apenas em modo de grfico.

Exemplos:
ChartOnly=yes
ChartOnly=1
GridOnly
Exibe o objeto Cubeviewer apenas em modo de grade.

Exemplos:
GridOnly=yes
GridOnly=1
GridAndChart
Exibe o objeto Cubeviewer com uma grade e grfico.

Exemplos:
GridAndChart=yes
GridAndChart=1
ChartSize
Use este parmetro para definir o tamanho de exibio de um

grfico.
Formato: ChartSize= width,height
em que os valores para width e height esto em pixels.
3DView
Ativa e desativa a visualizao em 3D do grfico.

Para ativar a visualizao em 3D:
v
3DView=yes
3DView=1
Para desativar a visualizao em 3D:
ShowLegend
3DView=no
3DView=0
Exibe uma legenda para um grfico.

Para ativar a legenda de grfico:
v
ShowLegend=yes
ShowLegend=1
Para desativar a legenda de grfico:

v
ShowLegend=no
ShowLegend=0
Selecionando o Tipo de Grfico

Defina o tipo de grfico que voc deseja exibir usando o parmetro ChartType no
seguinte formato:
ChartType=x
152
em que x pode ser o valor numrico para um dos seguintes tipos de grficos
definidos:
Valor
Tipo de Grfico
Pontos
Bolhas
Linhas
Spline
Linha de Etapa
Oscilaes
Barras
Barras Empilhadas
Barras Empilhadas 100
Colunas
10
Colunas Empilhadas
11
Colunas Empilhadas 100
12
rea
13
rea de Spline
14
reas Empilhadas
15
reas Empilhadas 100
16
Pizza
17
Rosca
18
Aes
19
Candlestick
20
Intervalo
21
Intervalo de Spline
22
Gantt
23
Coluna de Intervalo
153
Valor
Tipo de Grfico
24
Radar
25
Polar
26
Caixa
27
Funil
28
Pirmide
Configurando a Cor do Grfico

Configure a paleta de cores para um grfico usando o parmetro ColorPalette, da
seguinte forma:
ColorPalette=x
em que x pode ser o valor numrico para uma das seguintes paletas de cores
definidas:
Nmero
Paleta de Cores
Padro
Azul Claro Metlico
Tons Terra
Escala em Tons de Cinza
Semitransparente
Semelhante ao Excel
Bege Claro
Framboesa
Chocolate
10
Fogo
11
Azul esverdeado
Definindo Funes de Retorno de Chamada de Evento para Objetos

Cubeviewer e Planilha da Web
possvel capturar um evento de mudana de elemento de ttulo em um objeto
planilha da Web ou Cubeviewer usando o parmetro TitleChangeCallback na URL
inicial e, em seguida, criando sua prpria funo de retorno de chamada JavaScript
para manipular o evento de retorno de chamada.
v Para uma planilha da Web, possvel capturar o evento de mudana de ttulo
em uma clula SUBNM.
v Para um Cubeviewer, possvel capturar a mudana de uma dimenso de ttulo.
Ativando uma Funo de Retorno de Chamada para Objetos

Planilha da Web e Cubeviewer
As etapas gerais para ativar uma funo de retorno de chamada so:
154
Procedimento
1. Inclua o parmetro TitleChangeCallback na URL inicial que abre o objeto
planilha da Web ou Cubeviewer. Use um dos seguintes formatos gerais:
v Apenas para objetos planilha da Web, defina o retorno de chamada para uma
dimenso de ttulo especfica por local de clula SUBNM.
&TitleChangeCallback_Sheet-Row-Column=JSFunction(jsFunctionSignature)
v Para objetos planilha da Web e Cubeviewer, defina o retorno de chamada

para uma dimenso de ttulo especfica por nome de dimenso.
&TitleChangeCallback_DimensionName=JSFunction(jsFunctionSignature)
v Para objetos planilha da Web e Cubeviewer, defina uma funo de retorno de

chamada global que seja aplicvel a todas as dimenses de ttulo.
&TitleChangeCallback=jsFunctionName(jsFunctionSignature)
2. Crie sua prpria funo de retorno de chamada JavaScript para manipular o

evento de retorno de chamada, usando a mesma assinatura de funo fornecida
na URL. Por exemplo:
function jsFunctionName(jsFunctionSignature)
{ // add code here to handle the callback event}
Definindo uma Funo de Retorno de Chamada para uma

Dimenso de Ttulo Especfica
possvel definir uma funo de retorno de chamada para uma dimenso de ttulo
especfica, especificando o local da clula SUBNM da dimenso ou o nome da
dimenso.
Definindo uma Funo de Retorno de Chamada apenas para

Objetos Planilha da Web
possvel usar o parmetro TitleChangeCallback_S#-R#-C# em sua URL para
definir uma funo de retorno de chamada para uma dimenso especfica, com
base na planilha, linha, coluna da dimenso da clula SUBNM na planilha da Web.
Use o seguinte formato para especificar uma dimenso de ttulo por local de
planilha, linha, coluna em uma planilha da Web:
&TitleChangeCallback_S#-R#-C# =JSFunction(arg1,
$dimName$, $subsetName$,
$elemName$, arg2...)
em que:
v S#-R#-C# so os nmeros de planilha, linha e coluna da clula na planilha da
Web que contm a funo SUBNM. Substitua os smbolos # por seus valores para
nmero da planilha, da linha e da coluna.
v jsFunction o nome de sua funo JavaScript que manipular o evento de
retorno de chamada. Inclua cdigo para esta funo em sua pgina da Web,
usando a mesma assinatura de funo fornecida na URL.
v arg1, arg2 ... representa os outros argumentos definidos pelo usurio em sua
funo de retorno de chamada.
Se voc incluir $dimName$, $subsetName$, $elemName$, na funo de retorno de
chamada, estes argumentos sero substitudos dinamicamente pelo valor de
sequncia da dimenso, subconjunto e elemento selecionados pelo usurio.
v $dimName$ o nome da dimenso de ttulo selecionada pelo usurio.
v $subsetName$ o nome do subconjunto para a dimenso de ttulo.
v $elemName$ o nome de elemento selecionado pelo usurio.
155
Definindo uma Funo de Retorno de Chamada para Objetos

Planilha da Web e Cubeviewer
Use o parmetro TitleChangeCallback_DimensionName para especificar uma funo
de retorno de chamada para uma dimenso de ttulo especfica, com base no nome
da dimenso.
&TitleChangeCallback_DimensionName=J
SFunction(arg1,$dimName$,
$subsetName$, $elemName$,
arg2 ...)
em que:
v DimensionName o nome da dimenso de ttulo no objeto planilha da Web ou
Cubeviewer que acionar o evento de retorno de chamada.
retorno de chamada. Inclua cdigo para esta funo em sua pgina da Web,
usando a mesma assinatura de funo fornecida na URL.
v
arg1, arg2 ... representa os outros argumentos definidos pelo usurio em sua

v $dimName$ o nome da dimenso de ttulo selecionada pelo usurio.
v
v
$subsetName$ o nome do subconjunto para a dimenso de ttulo.

$elemName$ o nome de elemento selecionado pelo usurio.
Definindo uma Funo de Retorno de Chamada Global para

Todas as Dimenses de Ttulo
Para capturar mudanas de eventos para todas as dimenses de ttulo em um
objeto Planilha da Web ou Cubeviewer, use o parmetro TitleChangeCallback sem
especificar uma dimenso de ttulo especfica. Se um local de dimenso de ttulo
ou de clula SUBNM no for especificado na URL, a funo de retorno de
chamada capturar os eventos de mudanas para todas as clulas SUBNM em um
objeto planilha da Web, ou todas as dimenses de ttulo em um objeto Cubeviewer.
Nota: Uma funo de retorno de chamada sem uma dimenso de ttulo de destino
pode ser substituda usando um comando TitleChangeCallback subsequente que
especifica uma dimenso de ttulo. Por exemplo,
TitleChangeCallback_DimensionName ou TitleChangeCallback_Sheet-Row-Column.
Use o seguinte formato de URL para definir uma funo de retorno de chamada
para todas as dimenses de ttulo:
&TitleChangeCallback=JSFunction(arg1,
$dimName$,
$subsetName$, $elemName$, arg2...)
em que:
retorno de chamada.
v arg1, arg2 ... representa os outros argumentos definidos pelo usurio em sua
156

v
v
v
$dimName$ o nome da dimenso de ttulo selecionada pelo usurio.

$subsetName$ o nome do subconjunto para a dimenso de ttulo.
$elemName$ o nome de elemento selecionado pelo usurio.
Inclua cdigo para sua funo de retorno de chamada usando a mesma assinatura
de funo fornecida na URL.
Acessando o Objeto rvore de Navegao

No TM1 Web, a rea de janela de navegao contm uma lista organizada de
aplicativos, planilhas da Web, cubos e visualizaes do TM1 que esto disponveis
para um usurio especfico. possvel incorporar esta mesma lista de navegao
em sua prpria pgina da Web customizada usando o objeto rvore de
Navegao.
O objeto rvore de Navegao pode ser acessado de dois modos diferentes:

v Modo HTML - Exibe o objeto rvore de Navegao conforme visto no TM1
Web. Este o modo padro. Permite que os usurios interajam com a rvore se
voc fornecer suas prprias funes de retorno de chamada.
v
Modo XML - Retorna uma verso apenas de dados do objeto rvore de

Navegao, em formato XML, para que seja possvel usar a hierarquia e dados
conforme necessrio.
Abrindo o Objeto rvore de Navegao

O objeto rvore de Navegao acessado da mesma forma que os objetos
Cubeviewer e planilha da Web por meio do arquivo manipulador
TM1WebMain.aspx usando o parmetro action=OpenObject.
Para abrir o objeto rvore de Navegao, use o seguinte formato:
action=OpenObject&type=NavigationTree
157
O objeto rvore de Navegao aberto no modo HTML padro, mas possvel

especificar um modo HTML ou XML usando o parmetro ContentType.
&ContentType=mode
em que o valor para mode pode ser html ou xml.

Por exemplo:
v Para abrir o objeto rvore de Navegao em modo HTML:
aspx?action=OpenObject&type=NavigationTree&ContentType=html>
v Para abrir o objeto rvore de Navegao em modo XML:

aspx?action=OpenObject&type=NavigationTree&ContentType=xml>
Depois que um usurio efetuar login, o objeto rvore de Navegao tambm

poder ser acessado diretamente por meio dos seguintes manipuladores:
v TM1WebNavigationTree.aspx para modo HTML
v TM1WebNavigationTreeXml.aspx para modo XML
Usando o Objeto rvore de Navegao em Modo HTML

Ao usar o objeto rvore de Navegao no modo HTML, possvel controlar a
exibio da barra de ferramentas e tambm fornecer suas prprias funes de
retorno de chamada para permitir que os usurios interajam com os objetos do
TM1 exibidos na rvore.
Exibindo a Barra de Ferramentas da rvore de Navegao

Ao exibir o objeto rvore de Navegao em modo HTML, possvel exibir ou
ocultar a barra de ferramentas do objeto, definindo o parmetro HideToolbar na
URL base usando o seguinte formato:
&HideToolbar=x
Para ocultar a barra de ttulo do TM1 :

v &HideToolbar=yes
v &HideToolbar=1
Para exibir a barra de ttulo:
v
v
&HideToolbar=no
&HideToolbar=0
Definindo uma Funo de Retorno de Chamada para o Objeto

rvore de Navegao
Se desejar que informaes em ns de objeto individuais sejam expostas quando
um usurio clicar nelas, voc precisar definir uma funo de retorno de chamada
para o objeto rvore de Navegao. possvel usar as informaes retornadas
enviadas para a funo de retorno de chamada para executar aes adicionais no
objeto selecionado. Por exemplo, o ID do N de rvore XML retornado pode ser
usado para abrir o objeto.
Voc ativa um retorno de chamada incluindo o parmetro Callback na URL base e,
em seguida, gravando o cdigo para uma funo de retorno de chamada em sua
pgina da Web.
158
Procedimento
1. Use o seguinte formato para incluir o parmetro Callback e o nome de sua
funo de retorno de chamada na URL base:
&Callback=name_of_callback_function
Por exemplo:
&Callback=MyCallBackFunction
2. Grave sua funo de retorno de chamada na pgina da Web para manipular as

seguintes variveis retornadas:
MyCallBackFunction(id,
type, isPrivate,
name, description,
source)
As variveis retornadas fornecem as seguintes informaes sobre o n de objeto

selecionado:
v id - ID exclusivo do n selecionado
v type - tipo de objeto do objeto selecionado (Planilha da Web ou Cubeviewer)
v isPrivate - se o objeto selecionado um objeto particular ou pblico
v name - nome do objeto selecionado
v description - descrio do objeto selecionado
v source - origem do objeto selecionado, se houver
Por exemplo, as seguintes URL e funo JavaScript mostram uma amostra de
como capturar a interao com o usurio com o objeto rvore de Navegao.
A seguinte URL abre o objeto rvore de Navegao e define o parmetro de
retorno de chamada para uma funo chamada handleNavTreeOpenObject:
http://localhost/TM1Web/TM1WebMain.aspx?
action=OpenObject&AdminHost=&TM1Server=sdata&type=navigationtree&ContentType=
html&Callback=handleNavTreeOpenObject>
A seguinte funo JavaScript manipula o evento de retorno de chamada:

function handleNavTreeOpenObject(id, type, isPrivate,
name, description, source)
{
alert(id= + id + ;type= + type + ;isPrivate= +
isPrivate + ;name= + name + ;description= + description + ;source=
+ source);
}
Quando o usurio clicar em um objeto na rvore de Navegao, a funo de

retorno de chamada exibir uma caixa de mensagens mostrando as informaes
retornadas sobre o objeto selecionado.
Usando o Objeto rvore de Navegao em Modo XML

Em modo XML, o objeto rvore de Navegao retornado como um documento
XML codificado como UTF-8. O documento XML retornado contm a hierarquia
das pastas de Aplicativos, planilhas da Web, cubos e visualizaes armazenadas no
IBM Cognos TM1 server ao qual voc est conectado.
Use o seguinte formato de URL para recuperar o objeto rvore de Navegao
como XML:
http://<HostName>/TM1Web/TM1WebMain.
aspx?action=OpenObject&type=NavigationTree&ContentType=xml
Os dados XML retornados so estruturados no seguinte formato geral:

159
v O n <NavigationTree> o n de nvel superior retornado.

v O n <Application> contm pastas de aplicativos e referncias que podem ser
exibidas no TM1 Web.
v O n <Server> contm cubos e visualizaes que podem ser exibidos no TM1
Web.
Nota: O n <Administration> no usado com a interface de programao de
aplicativos do Localizador Uniforme de Recursos.
N de Aplicativo XML
Por exemplo, um n <Application> expandido semelhante a este:
160
N de Servidor XML
Um exemplo de um n <Server> expandido semelhante a este:
Usando IDs de N da rvore XML para Abrir Objetos Planilha da

Web e Cubeviewer
possvel usar um ID de N da rvore do objeto dos dados XML para abrir um
objeto planilha da Web ou Cubeviewer.
Procedimento
1. Obtenha o ID de N da rvore dos dados XML retornados para o objeto que
voc deseja abrir.
Por exemplo, tn_8 o ID de N da rvore para a visualizao de Preo na
seguinte amostra XML.
161
2. Use o valor de sequncia de ID do N de rvore com o comando OpenObject

em sua URL, da seguinte forma:
action=OpenObject&type=Cubeviewer&value=
TreeNodeID
Por exemplo, defina value=tn_8 para mostrar a visualizao Preo em um

objeto Cubeviewer, da seguinte forma:
action=OpenObject&type=Cubeviewer&value=tn_8
162
Captulo 9. Usando Reservas de Dados

Esta seo descreve todas as tarefas do administrador, modelador, desenvolvedor e
programador relacionadas ativao e implementao do recurso Reserva de
Dados disponvel no IBM Cognos TM1 .
Nota: Por padro, a Reserva de Dados no ativada. Um administrador deve
ativar e configurar o recurso antes de voc poder usar o Turbo Integrator (TI) e as
funes da interface de programao de aplicativos relacionados para gerenciar as
Reservas de Dados.
Viso Geral da Reserva de Dados

A Reserva de Dados (DR) um recurso relacionado ao servidor no TM1 que
permite configurar o acesso de gravao exclusivo s regies de um cubo para
usurios individuais. Quando reservados, os dados nessa regio podem ser
modificados apenas por esse usurio especfico at a reserva ser liberada.
possvel usar DR para suportar processos de negcios especficos ou para
controlar a entrada de dados adquirindo e liberando Reservas de Dados em uma
base dinmica ou conforme necessrio. Por exemplo, a DR fornece uma maneira
alternativa de controlar dinamicamente o acesso de gravao aos dados do cubo
em vez de tentar ajustar dinamicamente a segurana do TM1 para atingir restries
de acesso de gravao semelhantes.
Nota: Todas as DRs devem ser gerenciadas por meio dos aplicativos customizados
que voc desenvolve usando o Turbo Integrator (TI) e as funes de interface de
programao de aplicativos fornecidos. O design do aplicativo feito para obter,
liberar e gerenciar DRs baseado no processo de negcios requerido.
Quando Usar Reservas de Dados

Voc usaria as Reservas de Dados se desejasse gerenciar manual ou dinamicamente
o acesso de gravao do usurio para dados do TM1 de uma maneira que se
relacionasse ao seu processo de negcios. Dependendo de suas necessidades exatas,
possvel aplicar o recurso conforme necessrio ou dinamicamente usando o
TurboIntegrator e as funes de interface de programao de aplicativos.
Por exemplo, voc poder usar a DR para fazer o seguinte:
v Executar manualmente um processo do TurboIntegrator antigo que usa Reservas
de Dados para impedir que todos os usurios faam edies adicionais em
determinados dados aps a concluso de um projeto especfico ou fechamento
de um oramento recente.
v Aplicar Reservas de Dados usando os Botes de ao do TM1 e processos do
TurboIntegrator em uma planilha de Excel ou planilha da Web do TM1 para
controlar dinamicamente acesso de gravao para dados conforme os usurios
interagem com os dados baseado em suas funes e o processo de negcios de
sua companhia.
v Usar as funes de interface de programao de aplicativos do TM1 em um
aplicativo externo customizado para adquirir e liberar Reservas de Dados
dinamicamente.
163
Como Usar Reservas de Dados

Para usar a Reserva de Dados, voc deve primeiro ativar e configurar o recurso
para cubos individuais e grupos de usurios e, ento, use as funes
TurboIntegrator ou API para aplicar e gerenciar programaticamente DRs.
Para ativar a DR, use as seguintes ferramentas do TM1 :
v Cubo de controle }CubeProperties - Ativa e configura a Reserva de Dados para
cubos individuais. Para obter detalhes, consulte Ativando a Reserva de Dados
para Cubos na pgina 168.
v Designaes de Recursos - Determina se os membros de um grupo de usurios
podem gerenciar (adquirir e liberar) Reservas de Dados para eles mesmos e
outros usurios. Para obter detalhes, consulte Ativando Grupos de Usurios
para Gerenciar as Reservas de Dados na pgina 169.
Para aplicar e gerenciar Reservas de Dados, voc deve usar o Turbo Integrator e as
funes da interface de programao de aplicativos do TM1 que permitem obter,
liberar e gerenciar reservas programaticamente. Para obter detalhes, consulte os
seguintes tpicos:
v Gerenciando Reservas de Dados com Funes do Turbo Integrator na pgina
172
v Gerenciando Reservas de Dados com as Funes da Interface de Programao
de Aplicativos do TM1 na pgina 178
Como Fazer as Reservas de Dados Interagirem com Outros

Recursos do TM1 ?
Para obter detalhes sobre interao de Reservas de Dados com outros recursos do
TM1 como difuso de dados, processos de TurboIntegrator e segurana, consulte
Entendendo o Comportamento da Reserva de Dados com Outros Recursos do
TM1.
Ferramentas de Monitoramento da Reserva de Dados

possvel usar o Server Explorer, o utilitrio TM1 Top, o registro TM1 Audit e
certas funes de TurboIntegrator e API para monitorar atividade e/ou atribuies
da Reserva de Dados. Para obter detalhes, consulte Monitorando Reservas de
Dados na pgina 170.
Entendendo o Comportamento da Reserva de Dados com Outros

Recursos do TM1
Esta seo descreve como as Reservas de Dados (DR) interagem com outros
recursos do TM1 tais como segurana, difuso de dados, processos do
TurboIntegrator (TI) e ambientes de simulao.
Reservas de Dados e Segurana

A Reserva de Dados diferente da Segurana do TM1 das seguintes maneiras
v A DR no substitui designaes de segurana do TM1, mas apenas inclui outra
camada de restrio de gravao no topo da segurana padro para objetos do
cubo.
v A DR se aplica aos usurios individuais enquanto a segurana do TM1 se aplica
aos grupos de usurios.
164
v A DR aplica restries apenas nos dados do cubo e usurios individuais. Ela no

controla quaisquer outros objetos do TM1 .
Este comportamento o mesmo para ambos os modos de Reserva de Dados,
NECESSRIO e PERMITIDO.
As Reservas de Dados e a Interface com o Usurio do TM1

A Reserva de Dados afeta a aparncia das clulas em uma visualizao de cubo em
todas as diferentes interfaces com o usurio do TM1, tais como o Server Explorer, o
TM1 Perspectives e o TM1 Web.
Este comportamento diferente, dependendo do modo de Reserva de Dados.
Modo NECESSRIO
Quando um cubo configurado para usar Reserva de Dados no modo
NECESSRIO, todas as clulas aparecem com um plano de fundo cinza e no so
gravveis, exceto para as clulas contidas em sua regio da DR. Apenas as clulas
na DR para o usurio atual sero gravveis e aparecero com um plano de fundo
branco.
Modo PERMITIDO
Quando um cubo configurado para usar Reserva de Dados no modo
PERMITIDO, todas as clulas so gravveis, dependendo da segurana, e aparecem
com um plano de fundo branco, exceto para as clulas contidas nas Reservas de
Dados de outros usurios. As clulas reservadas por outros usurios aparecem com
um plano de fundo cinza e no so gravveis.
Para obter detalhes sobre a verificao se uma clula faz parte de uma DR,
consulte Exibindo o Status da Clula da Reserva de Dados no Server Explorer na
pgina 170.
Reservas de Dados e Difuso de Dados

A difuso de dados se comporta como antes - clulas que no so gravveis, tais
como clulas calculadas ou clulas com uma reteno, so ignoradas durante um
processo de difuso. Quando um usurio possui uma Reserva de Dados e executa
uma operao de difuso de dados, apenas as clulas na regio da DR desse
usurio sero consideradas gravveis e todas as outras clulas sero ignoradas.
Este comportamento o mesmo para ambos os modos de Reserva de Dados,
Reservas de Dados e Processos e Tarefas do Turbo Integrator

Voc deve entender as seguintes consideraes ao usar a Reserva de Dados e
tambm ao executar tarefas/processos interativos (no planejados) e planejados do
Turbo Integrator (TI):
Uma parte deste comportamento diferente dependendo de qual modo de Reserva
de Dados est sendo usado e se a tarefa de organizao de processos executada
interativamente ou planejada.
165
Processos e Tarefas Interativos

Quando um usurio executa interativamente um processo ou uma tarefa de
organizao de processos, por exemplo a partir da interface com o usurio do
TM1, esse(a) processo/tarefa de organizao de processos executado(a) como esse
usurio.
v Para o modo NECESSRIO, isto significa que o(a) processo/tarefa de
organizao de processos pode gravar apenas nos dados definidos nas DRs
suspensas por esse usurio.
v Para o modo PERMITIDO, o processo/tarefa de organizao de tarefas pode
gravar em qualquer clula que esteja tanto contida em um DR para aquele
usurio ou quanto possuir os direitos de segurana apropriados para aquele
usurio, mas o processo/tarefa de organizao de tarefas no pode gravar em
clulas contidas em outro DR do usurio.
O comportamento a seguir o mesmo para ambos os modos de Reserva de Dados,
v Se uma operao de gravao no processo/na tarefa de organizao de processos
Interativos entrar em conflito com a Reserva de Dados de um outro usurio, o
processo/a tarefa de organizao de processos falharo e uma mensagem de erro
ser exibida para o usurio.
v Para executar um processo que adquire e libera DRs, o usurio que executa o
processo deve pertencer a um grupo de usurios que possui o recurso
ManageDataReservation configurado como GRANT.
Tarefas de Organizao de Processos Planejadas

Quando uma tarefa de organizao de processos planejada executada
automaticamente, ela executada como o usurio Administrador. Por causa disso,
a tarefa de organizao de processos pode no conseguir gravar em algumas
clulas se essas clulas estiverem na Reserva de Dados de outro usurio.
Quando uma tarefa de organizao de processos planejada encontra um conflito de
Reserva de Dados, o comportamento diferente, dependendo de qual modo de
Reserva de Dados est sendo usado pelo cubo.
v No modo NECESSRIO, se uma operao de gravao em uma tarefa de
organizao de processos planejada entra em conflito com uma Reserva de
Dados, a tarefa falha.
Para permitir que uma tarefa de organizao de processos planejada grave nas
clulas reservadas ao usar a DR no modo NECESSRIO, voc deve tratar isto
programaticamente em seu processo do TurboIntegrator permitindo que o
usurio Administrador grave nas clulas reservadas. possvel modificar o
processo do TurboIntegrator para adquirir e liberar as DRs necessrias para o
Administrador ou, possivelmente, que o processo ative/desative
temporariamente o recurso da DR para os cubos aplicveis.
v No modo PERMITIDO, se uma operao de gravao em uma tarefa de
organizao de processos planejada entrar em conflito com uma Reserva de
Dados, a tarefa executar um retrocesso de dados e aguardar a reserva ser
liberada. Quando a reserva for liberada, a tarefa de organizao de processos
tentar a operao novamente.
No possvel cancelar uma tarefa de organizao de processos em espera
alterando o modo de Reserva de Dados para NECESSRIO ou DESATIVADO. A
tarefa de organizao de processos continuar aguardando at um dos eventos a
seguir ocorra.
166
Liberar a Reserva de Dados que est bloqueando a tarefa de organizao de

processos para que a tarefa de organizao de processos possa continuar.
Usar o utilitrio TM1 Top para cancelar a tarefa de organizao de processos.
Encerrar o servidor para cancelar a tarefa de organizao de processos.
Desativar a tarefa de organizao de processos planejada.
Reservas de Dados e Ambientes de Simulao

Voc deve entender as consideraes a seguir sobre como obter e liberar Reservas
de Dados em um cubo especfico enquanto tambm insere dados em ambientes de
simulao desse mesmo cubo.
As DRs se aplicam verso base de um cubo e a qualquer ambiente de simulao
criada a partir desse cubo.
O comportamento do ambiente de simulao a seguir se aplica apenas ao modo de
Reserva de Dados NECESSRIO.
v Se o recurso da DR estiver ativado para um cubo, voc dever ter uma DR nesse
cubo para gravar nos dados base ou em qualquer ambiente de simulao desse
cubo.
Por exemplo, se um usurio tiver uma DR para o cubo Vendas, esse usurio
poder gravar apenas nesse mesmo conjunto de clulas em qualquer ambiente
de simulao criada a partir do cubo Vendas.
v Se sua DR para um cubo tiver sido liberada, no ser possvel mais gravar em
nenhum ambiente de simulao desse cubo.
v possvel consolidar um ambiente de simulao para dados base aps uma DR
ser liberada, entretanto, os valores editados para quaisquer clulas que no esto
mais reservadas para voc sero descartados com erros e suas alteraes sero
perdidas. Para consolidar os valores editados com xito para dados base, voc
deve primeiro readquirir as DRs necessrias nesse cubo antes de tentar
consolidar o ambiente de simulao.
Reservas de Dados, Ambientes de Simulao e Fila de Tarefas

Se estiver usando Reservas de Dados com ambientes de simulao e o recurso Fila
de Tarefas, o comportamento a seguir se aplicar ao consolidar dados do ambiente
de simulao para dados base, dependendo de qual modo de Reserva de Dados
est sendo usado pelo cubo.
v No modo NECESSRIO, todas as Reservas de Dados necessrias devem ser
suspensas at a operao enfileirada concluir para que os dados do ambiente de
simulao sejam salvos com xito para dados base. Se as Reservas de Dados
necessrias forem liberadas antes de a Fila de Tarefas salvar os dados ou se um
conflito de Reserva de Dados for encontrado, os valores nas clulas em conflito
no sero salvos.
v No modo PERMITIDO, se uma consolidao de ambiente de simulao na Fila
de Tarefas entrar em conflito com uma Reserva de Dados, a Fila de Tarefas
executar um retrocesso de dados para essa operao e aguardar a reserva
conflitante ser liberada. Todas as tarefas na Fila de Tarefas sero bloqueadas at
a tarefa em espera ter permisso para continuar. A nica maneira de desbloquear
a Fila de Tarefas liberar as Reservas de Dados em conflito.
167
Ativando a Reserva de Dados

Por padro, a Reserva de Dados no ativada. Um administrador deve ativar e
configurar o recurso antes de voc poder usar o Turbo Integrator (TI) e as funes
da interface de programao de aplicativos relacionados para gerenciar as Reservas
de Dados.
Antes de usar as Reservas de Dados, voc deve:
v Ativar o recurso para cubos individuais (configurados no cubo de controle
}CubeProperties).
Para obter detalhes, consulte Ativando a Reserva de Dados para Cubos
v Permitir aos grupos de usurios a capacidade de gerenciar, adquirir e liberar
DRs para eles mesmos e para outros usurios (configurados na janela
Designaes de Recurso).
Para obter detalhes, consulte Ativando Grupos de Usurios para Gerenciar as
Reservas de Dados na pgina 169).
Aps a DR ter sido ativada para um cubo, o recurso se aplica a todos os usurios
desse cubo, mas pode ser gerenciado apenas por membros dos grupos de usurios
que receberam permisso na janela Designaes de Recurso.
Ativando a Reserva de Dados para Cubos

Use a propriedade DataReservationMode no cubo de controle }CubeProperties para
ativar ou desativar a Reserva de Dados para um cubo especfico.
Para obter detalhes adicionais sobre o cubo de controle }CubeProperties, consulte a
seo "Cubos de Controle" no Guia de Operao do IBM Cognos TM1 .
Procedimento
1. No Server Explorer, clique no menu Visualizar e, em seguida, clique para
selecionar Exibir Objetos de Controle.
Todos os cubos de controle do TM1 aparecem no Server Explorer com um
prefixo igual a uma chave direita }. Por exemplo, }CubeProperties.
2. Na rea de janela em rvore do Server Explorer, clique para expandir o n
Cubos e, em seguida, d um clique duplo no cubo de controle
}CubeProperties.
3. Insira um valor para um dos modos de Reserva de Dados disponveis na
interseo do elemento DataReservationMode (propriedade) e o nome do cubo
para ativar o recurso de Reserva de Dados para esse cubo.
Propriedade DataReservationMode
A propriedade DataReservationMode usa os valores a seguir.
Valor
Descrio
DESATIVADA
Desativa o recurso de Reserva de Dados

para o cubo especfico.
O valor-padro OFF.
168
Valor
Descrio
NECESSRIO
Configura o recurso de Reserva de Dados

com o modo REQUIRED para um cubo
especfico.
Este modo desativa o acesso de gravao
para todos os usurios para o cubo inteiro e
requer que voc designe explicitamente as
Reservas de Dados para qualquer usurio
que precisa gravar neste cubo.
Por exemplo, um usurio deve ter uma
Reserva de Dados em uma clula se desejar
gravar nessa clula.
Para obter mais detalhes sobre as diferenas
entre os diferentes modos de Reserva de
Dados, consulte Entendendo o
Comportamento da Reserva de Dados com
Outros Recursos do TM1 na pgina 164.
PERMITIDO
Configura o recurso de Reserva de Dados

com o modo ALLOWED para um cubo
especfico.
Este modo mantm o acesso de gravao,
baseado na segurana, para todos os
usurios no cubo inteiro, mas permite
restringir de maneira seletiva o acesso de
gravao a uma rea do cubo designando
Reservas de Dados aos usurios individuais
conforme necessrio.
Por exemplo, o modo PERMITIDO permite
usar sua Reserva de Dados para separar
uma seo de um cubo para um usurio
especfico enquanto mantm o acesso de
gravao disponvel para todos os outros
usurios no restante do cubo.
Ativando Grupos de Usurios para Gerenciar as Reservas de

Dados
Use os recursos a seguir na janela Designaes de Recurso do TM1 Capability
Assignments para permitir que os membros de um grupo de usurios gerenciem
(adquiram e liberem) Reservas de Dados para eles mesmos e para outros usurios.
Estes recursos so configurados para um grupo de usurios inteiro e no para
usurios individuais. Um usurio deve ser um membro do grupo para que o
recurso seja aplicado.
Nota: Apenas os administradores do TM1 possuem acesso janela Designaes de
Recursos.
Para obter detalhes adicionais sobre as Designaes de Recurso, consulte o Guia de
Operao do IBM Cognos TM1 .
169
Recurso
Descrio
ManageDataReservation
Permite que os membros do grupo adquiram e liberem

Reservas de Dados.
Todo o servidor tem essa capacidade. Os recursos no
podem ser aplicados em cubos ou usurios especficos.
Este recurso sempre configurado como GRANT para os
grupos ADMIN, DataAdmin e SecurityAdmin padro e
no pode ser modificado.
Valores para grupos de no administradores:
DENY - Valor padro para todos os grupos de no
administradores.
GRANT- Ativa esse recurso para um grupo de usurios.
DataReservationOverride
Permite que os membros do grupo liberem reservas

suspensas por outros usurios.
Este recurso sempre configurado como GRANT para os
grupos ADMIN, DataAdmin e SecurityAdmin padro e
no pode ser modificado.
Valores para grupos de no administradores:
DENY - Valor padro para todos os grupos de no
administradores.
GRANT- Ativa esse recurso para um grupo de usurios.
Procedimento
1. No Server Explorer, clique com o boto direito do mouse em um servidor e
selecione Designaes de Recurso.
2. Na janela Designaes de Recurso, insira valores para os recursos
ManageDataReservation e DataReservationOverride na interseo com o
grupo de usurios que deseja configurar.
Monitorando Reservas de Dados

possvel usar as ferramentas a seguir para monitorar a atividade e o status da
Reserva de Dados.
v
v
v
v
Server Explorer
Utilitrio TM1 Top
Log de Auditoria de TM1
Funes do Turbo Integrator e da Interface de Programao de Aplicativos
Exibindo o Status da Clula da Reserva de Dados no Server

Explorer
Voc verifica o status de qualquer clula em uma visualizao de cubo no Server
Explorer conforme a seguir:
170
Procedimento
No Server Explorer, abra uma visualizao de cubo, clique com o boto direito do
mouse em uma clula e, em seguida, clique em Editar Status.
Uma caixa de mensagens aparece indicando se o valor da clula pode ser editado
ou se a clula no est editvel devido a uma Reserva de Dados ou a outra
restrio de acesso a dados.
Usando o TM1 Top para Monitorar Encadeamentos que Esto

Aguardando Reservas de Dados
possvel usar o utilitrio TM1 Top para monitorar encadeamentos que esto
aguardando uma reserva de dados ser liberada. Qualquer encadeamento neste
estado mostrado no TM1 Top com um valor Liberao de Reserva de Dados
(DDR) no campo Estado:
Wait:DRR
Para obter detalhes adicionais sobre estados de espera do TM1 Top, consulte a
seo "Entendendo Estados de Processamento do Encadeamento" no captulo
"Monitoramento do Sistema e de Desempenho" no Guia de Operaes do IBM
Cognos TM1 .
Usando o Log de Auditoria para Monitorar Eventos de

Reserva de Dados
Se a criao de log de auditoria estiver ativada para o servidor TM1, o TM1
registrar eventos de Reserva de Dados. possvel, ento, usar o Log de Auditoria
do TM1 para consultar e visualizar o histrico de designaes de Reserva de
Dados.
Para obter detalhes adicionais sobre como usar o Log de Auditoria do TM1,
consulte o captulo "Monitoramento do Sistema e Desempenho" no Guia de
Operao do IBM Cognos TM1 .
A tabela a seguir lista os cinco eventos do Log de Auditoria que so especficos
para Reservas de Dados.
Evento de Log de Auditoria
Descrio do Evento
Conjunto de Propriedades:
CubeDataReservationEnable
Registrado quando o valor da propriedade

CubeDataReservationEnable para um cubo
foi alterado.
Reserva de Dados: Adquirida
Registrado ao adquirir uma Reserva de

Dados.
Reserva de Dados: Liberada
Registrado ao liberar uma Reserva de

Dados.
Reserva de Dados: Aquisio de Retrocesso Registrado quando o retrocesso de uma

aquisio de reserva ocorre.
Reserva de Dados: Liberao de Retrocesso
Registrado quando o retrocesso de uma

liberao de reserva ocorre.
Notas sobre Eventos de Retrocesso

v O retrocesso de uma operao de aquisio de Reserva de Dados para liberar a
reserva.
171
v O retrocesso de uma operao de liberao de Reserva de dados para

readquirir a reserva.
Consultando Eventos da Reserva de Dados

Todos os eventos de Reserva de Dados so associados ao objeto de cubo do TM1 e
so, portanto, agrupados como eventos do grupo no Log de Auditoria. possvel
consultar estes eventos na janela de Log de Auditoria conforme a seguir.
Procedimento
No Server Explorer, abra a janela de Log de Auditoria.
Na seo Tipo de Evento, selecione a opo Objeto.
Configure o campo Tipo de Objeto como Cubo.
Configure a lista suspensa Evento com um dos tipos de evento de Reserva de
Dados.
5. Execute a consulta.
1.
2.
3.
4.
Usando Funes do Turbo Integrator e da Interface de

Programao de Aplicativos para Monitorar Reservas de
Dados
Como uma soluo customizada, voc poderia usar as funes do Turbo Integrator
e da Interface de Programao de Aplicativos do TM1 a seguir para repetir
programaticamente objetos de cubo e recuperar informaes sobre as Reservas de
Dados relacionadas para cada cubo.
v Turbo Integrator - CubeDataReservationGet na pgina 175.
v Interface de Programao de Aplicativos do TM1 - TM1DataReservationGetAll
na pgina 181.
Gerenciando Reservas de Dados com Funes do Turbo Integrator

possvel usar as funes do Turbo Integrator (TI) a seguir para obter, liberar e
gerenciar programaticamente as Reservas de Dados.
v
v
v
v
v
CubeDataReservationAcquire
CubeDataReservationRelease
CubeDataReservationReleaseAll
CubeDataReservationGet
CubeDataReservationGetConflicts
As Reservas de Dados so definidas por um cubo, um usurio e uma tupla

especficos (uma lista ordenada de elementos).
CubeDataReservationAcquire
Esta uma funo do TM1 TurboIntegrator, vlida somente em processos do Turbo
Integrator.
Adquire uma Reserva de Dados para o cubo, o usurio e a tupla especificados.
172
Sintaxe
CubeDataReservationAcquire(Cube, User, bForce, Address, [AddressDelimiter])
Argumento
Descrio
Cubo
Nome do cubo.
Usurio
Nome do proprietrio para a nova reserva.

O nome de usurio fornecido ser validado para assegurar que ele
um usurio existente.
bForce
Valor booleano que determina o comportamento se a reserva

solicitada entra em conflito com uma reserva existente.
Se configurado como 0 (false), o pedido ser rejeitado se entrar em
conflito com uma reserva existente.
Se estiver configurado como 1 (true) e o usurio executando o
processo do Turbo Integrator tiver o recurso
DataReservationOverride, as reservas conflitantes sero liberadas e
a solicitada ser concedida.
Endereo
Sequncia convertida em token de nomes de elementos que

definem a tupla. A ordem deve corresponder ordem de dimenso
original do cubo.
Todas as clulas no cubo contidas pela tupla constituem a regio
que est sendo reservada. possvel escolher um elemento de cada
dimenso ou usar uma sequncia vazia entre os delimitadores para
selecionar uma dimenso inteira. Dependendo de onde o elemento
est localizado na hierarquia, o pedido reserva uma nica clula,
uma fatia ou o cubo inteiro.
AddressDelimiter
Sequncia de caracteres opcional que usada para separar nomes

de elementos no parmetro Address.
O valor padro '|'.
Valor de Retorno
Booleano - retorna true se a aquisio foi bem-sucedida.
Exemplo
CubeDataReservationAcquire(DRTestCube,User1,0,ElemX|ElemY|ElemZ);
O exemplo a seguir configura o parmetro bForce como 1 para forar o pedido da

DR se um conflito existir e usa um caractere delimitador diferente para o
parmetro AddressDelimiter.
CubeDataReservationAcquire(DRTestCube,User2,1,ElemX*ElemY*ElemZ,*);
CubeDataReservationRelease
Integrator.
173
Libera a Reserva de Dados especificada.

Se o usurio especificado no for o mesmo que o proprietrio da reserva, a
liberao ser bem-sucedida apenas se o usurio especificado tiver o recurso
DataReservationOverride ativado.
Sintaxe
CubeDataReservationRelease(Cube, User, Address,[AddressDelimiter])
Argumento
Descrio
Cubo
Nome do cubo.
Usurio
Nome do proprietrio da reserva.

O nome de usurio fornecido ser validado para assegurar que
ele um usurio existente.
Endereo

definem a tupla. A ordem deve corresponder ordem de
dimenso original do cubo.
AddressDelimiter

O valor padro '|'.
Valor de Retorno
Booleano - retorna true se a liberao foi bem-sucedida.
Exemplo
CubeDataReservationRelease(DRTestCube,User1,ElemX|ElemY|ElemZ);
O exemplo a seguir usa um caractere diferente para o parmetro AddressDelimiter.

CubeDataReservationRelease(DRTestCube,User2,ElemX*ElemY*ElemZ,*);
CubeDataReservationReleaseAll
Integrator.
Libera mltiplas Reservas de Dados existentes.
Todas as reservas totalmente contidas pelo endereo especificado que
correspondem ao filtro do usurio sero liberadas. Um filtro de usurio em branco
significa todos os usurios.
Se o filtro de usurio especificado no for o mesmo que o usurio executando o
processo do Turbo Integrator, o recurso DataReservationOverride dever ser
ativado.
O uso de um filtro de usurio em branco e de todos os curingas no campo de
endereo libera todas as reservas.
174
Sintaxe
CubeDataReservationReleaseAll(Cube, UserFilter, Address, [AddressDelimiter])
Argumento
Descrio
Cubo
Nome do cubo.
UserFilter
Filtro do nome de usurio para corresponder com relao s

reservas existentes.
Endereo

AddressDelimiter

O valor padro '|'.
Valor de Retorno
Booleano - retorna true se no houver nenhum erro.
Exemplo
CubeDataReservationReleaseAll(DRTestCube,User1,ElemX|ElemY|ElemZ);
O exemplo a seguir libera todas as reservas no cubo especificado para todos os

usurios.
CubeDataReservationReleaseAll(DRTestCube,,||);
CubeDataReservationGet
Integrator.
Localiza reservas existentes em um cubo especfico para todos ou para um usurio.
Sintaxe
CubeDataReservationGet(Index, Cube, User, [AddressDelimiter]) returns
Address;
Argumento
Descrio
ndice
Um ndice de loop baseado em um usado para iterar atravs de

reservas no cubo especificado.
Cubo
Nome do cubo a procurar.
175
Argumento
Descrio
Usurio
Nome do proprietrio da reserva para usar como um filtro.

Se deixado em branco, a funo retorna reservas para qualquer
proprietrio.
Se um nome for fornecido, a funo filtrar os resultados para
obter apenas o proprietrio especificado.
AddressDelimiter

de elementos no parmetro Address retornado.
O valor padro '|'.
Valor de Retorno
Address - Data de criao da reserva, nome do proprietrio da reserva e endereo
do Elemento da reserva. A data de criao vem primeiro, seguido pelo delimitador,
seguido pelo ID do usurio, seguido pelo delimitador, seguido pelos IDs dos
Elementos separados pelo delimitador na ordem das dimenses no cubo (ordem
original).
Uma sequncia vazia retornada se no h entrada para o ndice especificado.
O formato do valor de retorno :
[creation time][delimiter][owner
name][delimiter][element1][delimiter][element2][delimiter]...[elementN]
Por exemplo:
"20100622211601|Fred Bloggs|Element1|Element2|Element3"
Nota: As reservas podem ser alteradas enquanto iteram a lista de reservas,
portanto, o uso do ndice no tem garantia de fornecer uma lista completa de
reservas. As reservas podem ser includas ou removidas em qualquer posio na
lista, portanto, as reservas podem ser ignoradas ou repetidas ao fazer loop atravs
dos valores de ndice.
Se o filtro de proprietrio for especificado, o ndice se aplicar apenas aos
membros da lista filtrada. Se a lista de reservas tiver proprietrios conforme a
seguir: User1, User1, User2 e o pedido especificar um proprietrio igual a User2,
um ndice igual a 1 recuperar o terceiro membro da lista.
Exemplo
CubeDataReservationGet(1,DRTestCube,User1,*);
CubeDataReservationGet(1,DRTestCube,);
A amostra a seguir localizar todas as reservas pertencentes ao usurio Fred Bloggs

no cubo Expense Input e far "algo til" com elas:
vIndex = 1;
vCube = Expense Input;
vUserFilter = Fred Bloggs;
vDelim = |;
176
vAddress = CubeDataReservationGet( vIndex, vCube, vUserFilter,vDelim);

WHILE (vAddress @<> );
vSep1 = SCAN( vDelim, vAddress);
vDRUser = SUBST( vAddress, 1, vSep1 - 1);
vDRAddress = SUBST( vAddress, vSep1 + 1, LONG(vDRAddress) - vSep1);
#
do something meaningful with the
user and reservation address here
vIndex = vIndex + 1;
vAddress = CubeDataReservationGet( vIndex, vCube, vUserFilter,vDelim);
END;
CubeDataReservationGetConflicts
Integrator.
Localiza reservas existentes em um cubo especfico que entrariam em conflito com
o usurio, o endereo e a tupla especificados.
Sintaxe
CubeDataReservationGetConflicts(Index, Cube, User,
Address, [AddressDelimiter])returns ConflictAddress;
Argumento
Descrio
ndice
Um ndice de loop baseado em um usado para iterar atravs de

conflitos que satisfazem esta consulta.
Cubo
Nome do cubo a ser procurado
Usurio
A consulta procurar reservas que entraro em conflito com este

usurio.
Endereo

AddressDelimiter

O valor padro '|'.
Valor de Retorno
ConflictAddress - Data de criao da reserva, nome do proprietrio da reserva e
endereo do Elemento da reserva. A data de criao vem primeiro, seguido pelo
delimitador, seguido pelo ID do usurio, seguido pelo delimitador, seguido pelos
IDs de Elementos separados pelo delimitador na ordem das dimenses no cubo
(ordem original).
Uma sequncia vazia retornada se no h entrada para o ndice especificado.
O formato do valor de retorno :
[creation time][delimiter][owner name][delimiter][element1][delimiter]
[element2][delimiter]...[elementN]
177
Por exemplo:
"20100622211601|Fred Bloggs|Element1|Element2|Element3"
Nota: As reservas podem ser alteradas enquanto iteram a lista de reservas em
conflito, portanto, o uso do ndice no tem garantia de fornecer uma lista completa
de reservas. As reservas podem ser includas ou removidas em qualquer posio
na lista, portanto, as reservas podem ser ignoradas ou repetidas ao fazer loop
atravs dos valores de ndice.
Gerenciando Reservas de Dados com as Funes da Interface de

Programao de Aplicativos do TM1
possvel usar as funes de interface de programao de aplicativos do TM1 C a
seguir para obter, liberar e gerenciar programaticamente Reservas de Dados.
v TM1DataReservationAcquire
v TM1DataReservationRelease
v TM1DataReservationReleaseAll
v TM1DataReservationGetAll
v TM1DataReservationGetConflicts
v TM1DataReservationValidate
TM1DataReservationAcquire
Solicita um DR para um cubo TM1 especfico, usurio e tupla.
Se houver uma reserva existente pertencente a um usurio diferente cuja regio
sobrepe a reserva solicitada, o pedido de reserva ser rejeitado, a menos que o
sinalizador bForce seja usado. Se o sinalizador bForce for true e o usurio que
executa a interface de programao de aplicativos tiver a capacidade
DataReservationOverride, quaisquer reservas conflitantes sero liberadas e a nova
reserva ser concedida.
Sintaxe
TM1DataReservationAcquire(TM1P hPool, TM1V hCube, TM1VhClient, TM1V bForce,
TM1V elementArray);
178
Parmetro
Descrio
hPool
Conjunto de memrias padro usado por todos os comandos de

interface de programao de aplicativos.
hCube
Identificador para o cubo que deseja acessar.
hClient
O proprietrio a ser usado para a reserva
Parmetro
Descrio
bForce
Valor booleano que determina o comportamento se a reserva

solicitada entra em conflito com uma reserva existente.
Se configurado como 0 (false), o pedido ser rejeitado se entrar em
conflito com uma reserva existente.
Se configurado como 1 (true), a funo substituir quaisquer
reservas em conflito.
elementArray
Matriz de identificadores de elementos que definem a tupla, a ordem

deve corresponder ordem de dimenso.
Valor de Retorno
Valor booleano igual a true se o pedido foi concedido ou, caso contrrio, false.
Erros Possveis
v TM1ErrorCubeNumberOfKeysInvalid
v TM1ErrorObjectHandleInvalid
v TM1ErrorCubeKeyInvalid
v TM1ErrorObjectSecurityNoReserveRights
TM1DataReservationRelease
Libera uma DR existente para um cubo, um usurio ou uma tupla do TM1
especfico.
O proprietrio usado para hClient deve corresponder ao portador da DR para que
o comando seja bem-sucedido, a menos que o usurio que invoca a interface de
programao de aplicativos tenha a capacidade DataReservationOverride ativada.
Os endereos fornecidos devem ter uma correspondncia exata.
Sintaxe
TM1DataReservationRelease(TM1P hPool, TM1V hCube, TM1V hClient,TM1V
elementArray);
Parmetro
Descrio
hPool

hCube
hClient
O proprietrio da reserva.
elementArray
Matriz de identificadores de elementos que definem a tupla. A ordem

deve corresponder ordem da dimenso.
179
Valor de Retorno
Valor booleano igual a true se o pedido for bem-sucedido ou, caso contrrio, false.
No localizar a reserva uma falha e retorna false. Privilgio insuficiente tratado
como um erro.
Erros Possveis
v
v
v
v
TM1ErrorCubeNumberOfKeysInvalid
TM1ErrorObjectHandleInvalid
TM1ErrorCubeKeyInvalid
TM1ErrorObjectSecurityNoAdminRights
v TM1ErrorObjectSecurityNoReserveRights
TM1DataReservationReleaseAll
Libera diversas Reservas de Dados para o usurio do TM1 especificado.
A tupla de endereo especificada especifica o ponto de incio para a procura. Todas
as reservas pertencentes ao usurio especificado contidas totalmente na regio
definida pelo endereo so liberadas. Qualquer reserva que sobrepe o endereo
mas no est totalmente contida no liberada.
Especificar um cliente NULL remover reservas para todos os usurios. Se o
proprietrio no for o mesmo que o usurio que executa o comando, o usurio
dever ter o recurso DataReservationOverride. Tentativas de executar este
comando para um usurio diferente ou todos os usurios sem o recurso de
substituio sero rejeitadas sem procurar as reservas existentes.
Um administrador pode liberar todas as reservas em um cubo especificando um
cliente e curingas NULOS para cada elemento no endereo.
Sintaxe
TM1DataReservationReleaseAll(TM1P hPool, TM1V hCube, TM1V hClient,TM1V
elementArray);
Parmetro
Descrio
hPool

hCube
hClient
O proprietrio da reserva.
elementArray
Matriz dos identificadores de elementos que definem o ponto de incio

para a operao de liberao. A ordem deve corresponder ordem da
dimenso.
Valor de Retorno
Valor booleano igual a true se no houve erros.
180
Erros Possveis
v
v
v
v
TM1ErrorObjectSecurityNoReserveRights
v TM1ErrorObjectSecurityNoAdminRights
TM1DataReservationGetAll
Determina quais Reservas de Dados esto atualmente contidas em um cubo do
TM1 .
O parmetro do cliente opcional. Se ele no for fornecido (o parmetro
configurado como TM1ObjectNull), todas as DRs no cubo sero retornadas.
Se o parmetro do cliente for fornecido, apenas as DRs mantidas por esse usurio
especfico sero retornadas.
Sintaxe
TM1DataReservationGetAll(TM1P hPool, TM1V hCube, TM1VhClient);
Parmetro
Descrio
hPool

hCube
hClient
Identificador opcional para o usurio pelo qual deseja consultar.
Valor de Retorno
Matriz de dados da DR com o seguinte formato:
v [1] Nome do cubo (TM1ValTypeString)
v [2-n] Matriz de informaes da DR (TM1ValTypeArray)
[1] Data de Criao
[2] Nome de usurio (TM1ValTypeString)
[3-n] Matriz de nomes de elementos que definem a tupla (TM1ValTypeArray)
- [1-n] Nome de elemento (TM1ValTypeString)
Erros Possveis
TM1DataReservationGetConflicts
Determina quais reservas atualmente suspensas em um cubo do TM1 entraro em
conflito com o cliente (usurio) e endereo especificados.
Este comando pode ser usado para reunir as informaes necessrias para
determinar a razo pela qual uma tentativa de adquirir uma reserva falhou,
assumindo que a reserva que causou a negao ainda est l.
181
Sintaxe
TM1DataReservationGetConflicts(TM1P hPool, TM1V hCube, TM1V hClient, TM1V
elementArray)
Parmetro
Descrio
hPool
Conjunto de memrias padro usado por todos os comandos da

interface de programao de aplicativos
hCube
Identificador para o cubo que deseja acessar
hClient
O cliente (usurio) a ser comparado com relao aos proprietrios da

reserva atual.
elementArray
Matriz de identificadores de elementos que definem a tupla com

relao qual comparar. A ordem deve corresponder ordem da
dimenso
Valor de Retorno
Retorna uma matriz de dados de DR com o seguinte formato:
v [1] Nome do cubo (TM1ValTypeString)
v [2-n] Matriz de informaes da DR (TM1ValTypeArray)
[1] Data de Criao
[2] Nome de usurio (TM1ValTypeString)
[3-n] Matriz de nomes de elementos que definem a tupla (TM1ValTypeArray)
- [1-n] Nome de elemento (TM1ValTypeString)
TM1DataReservationValidate
Valida todas as Reservas de Dados em um cubo do TM1 .
Qualquer reserva pertencente a um cliente (usurio) que no existe mais ser
removida.
Sintaxe
TM1DataReservationValidate(TM1P hPool, TM1V hCube);
Parmetro
Descrio
hPool
Conjunto de memrias padro usado por todos os comandos da interface

de programao de aplicativos
hCube
Identificador para o cubo que desejamos acessar
Valor de Retorno
Valor booleano igual a true.
182
Erros Possveis
TM1ErrorObjectNotFound (cubo invlido)
Cdigos de Erro da Interface de Programao de Aplicativos

para Reservas de Dados
A tabela a seguir descreve os possveis cdigos de erro que podem ser retornados
pelas funes de interface de programao de aplicativos do TM1 C para reservas
de dados.
Erro
Descrio
Nmero de elementos que no

correspondem ao nmero de dimenses do
cubo.
O identificador de Cubo, Cliente ou

Elemento no mapeia para um objeto
existente.
O elemento fornecido no corresponde a um

elemento na dimenso nessa posio. O
elemento fornecido um UDC.
TM1ErrorObjectSecurityNoReserveRights
Capacidade para usar a reserva no

concedida.
TM1ErrorObjectSecurityNoAdminRights
Tentativa de liberar uma reserva quando no

o proprietrio e sem a capacidade de
substituio ser concedida.
183
184
Apndice A. Funes do Excel Suportadas - TM1 Web

O IBM Cognos TM1 Web suporta vrias funes de planilha do Excel.
Funes Suportadas
Este apndice lista as funes do Excel suportadas por categoria e em ordem
alfabtica e descreve as diferenas de desempenho entre as funes do Excel e as
funes doTM1 Web.
Funes de Data e Hora

A tabela a seguir lista funes de data e hora.
Funo
Descrio
DATA
Retorna o nmero de srie de uma data

especfica.
DATA.VALOR
Converte uma data no formato de texto em

um nmero de srie.
DIA
Converte um nmero de srie em um dia do

ms.
DIAS360
Calcula o nmero de dias entre duas datas,

com base em um ano de 360 dias.
HORA
Converte um nmero de srie em uma hora.
MINUTO
Converte um nmero de srie em um

minuto.
MS
Converte um nmero de srie em um ms.
AGORA
Retorna o nmero de srie da data e hora

atuais.
SEGUNDO

segundo.
HORA
Retorna o nmero de srie de uma hora

especfica.
VALOR.TEMPO
Converte uma hora no formato de texto em

um nmero de srie.
HOJE
Retorna o nmero de srie da data de hoje.
DIA.DA.SEMANA
Converte um nmero de srie em um dia da

semana.
185
Funo
Descrio
ANO
Converte um nmero de srie em um ano.
Funes Financeiras
A tabela a seguir lista funes financeiras.
186
Funo
Descrio
BD
Retorna a depreciao de um ativo para um

perodo especificado usando o mtodo de
saldo decrescente fixo.
BDD

perodo especificado usando o mtodo de
saldo decrescente duplo ou algum outro
mtodo especificado.
VF
Retorna o valor futuro de um investimento.
IPGTO
Retorna o pagamento de juros para um

investimento por um perodo especificado.
TIR
Retorna a taxa interna de retorno para uma

srie de fluxos de caixa.
PGTO
Calcula os juros pagos durante um perodo

especfico de um investimento.
MTIR
Retorna a taxa interna de retorno onde os

fluxos de caixa positivos e negativos so
financiados a taxas diferentes.
NPER
Retorna o nmero de perodos para um

investimento.
VPL
Retorna o valor presente lquido de um

investimento, com base em uma srie de
fluxos de caixa peridicos e em uma taxa de
desconto.
PGTO
Retorna o pagamento peridico para uma

anuidade.
PPGTO
Retorna o pagamento de capital para um

investimento por um perodo especificado.
VP
Retorna o valor presente de um

investimento.
TAXA
Retorna a taxa de juros por perodo de uma

anuidade.
Funo
Descrio
DPD
Retorna a depreciao linear de um ativo

durante um perodo.
SDA
Retorna a depreciao de dgitos de soma de

anos de um ativo para um perodo
especificado.
Funes de Informao
A tabela a seguir lista funes de informao.
Funo
Descrio
ERRO
Retorna VERDADEIRO se o valor for

qualquer valor de erro, exceto #N/D.
ERROS
Retorna VERDADEIRO se o valor for

qualquer valor de erro.
.NO.DISP
Retorna VERDADEIRO se o valor for o

valor de erro #N/D.
NO.DISP
Retorna o valor de erro #N/D.
Funes Lgicas
A tabela a seguir lista funes lgicas.
Funo
Descrio
Retorna VERDADEIRO se todos os seus

argumentos forem VERDADEIROS.
FALSO
Retorna o valor lgico FALSO.
SE
Especifica um teste lgico a ser executado.
NO
Reverte a lgica de seu argumento.
OU
Retorna VERDADEIRO se algum argumento

for VERDADEIRO.
VERDADEIRO
Retorna o valor lgico VERDADEIRO.
Funes de Consulta e Referncia

A tabela a seguir lista funes de consulta e referncia.
Nota: Algumas funes, como LOOKUP e ROWS, podem aceitar duas matrizes
dimensionais como argumentos. O TM1 Web no suporta duas matrizes
dimensionais. Dependendo dos requisitos e da organizao dos dados, essas
funes at podem obter valores corretos, por exemplo, quando os dados que esto
sendo recuperados carem nas partes iniciais da matriz. Para garantir valores
corretos ao trabalhar com essas funes no TM1Web, necessrio reorganizar os
dados de entrada em funes repetidas usando matrizes dimensionais ou usar
referncias de clula diretas.
187
Funo
Descrio
ENDEREO
Retorna uma referncia como texto a uma

nica clula em uma planilha.
ESCOLHER
Escolhe um valor de uma lista de valores.
COL
Retorna o nmero da coluna de uma

referncia.
COLS
Retorna o nmero de colunas em uma

referncia.
PROCH
Consulta a linha superior de uma matriz e

retorna o valor da clula indicada.
HYPERLINK
Cria um atalho ou salto que abre um

documento armazenado em um servidor de
rede, em uma intranet ou na Internet.
NDICE
Usa um ndice para escolher um valor de

uma referncia ou matriz.
PROC
Consulta valores em um vetor ou matriz.
DESLOC
Retorna um deslocamento de referncia de

uma referncia especificada.
LIN
Retorna o nmero da linha de uma

referncia.
LINS
Retorna o nmero de linhas em uma

referncia.
PROCV
Consulta a primeira coluna de uma matriz e

move-se pela linha para retornar o valor de
uma clula.

A tabela a seguir lista funes matemticas e trigonomtricas.
188
Funo
Descrio
ABS
Retorna o valor absoluto de um nmero.
ACOS
Retorna o arco cosseno de um nmero.
ACOSH
Retorna o cosseno hiperblico inverso de um

nmero.
ASEN
Retorna o arco seno de um nmero.
Funo
Descrio
ASENH
Retorna o seno hiperblico inverso de um

nmero.
ATAN
Retorna o arco tangente de um nmero.
ATAN2
Retorna o arco tangente de coordenadas x e

y.
ATANH
Retorna a tangente hiperblica inversa de

um nmero.
TETO
Arredonda um nmero at o inteiro mais

prximo ou at o mltiplo de significado
mais prximo.
COMBIN
Retorna o nmero de combinaes para um

determinado nmero de objetos.
COS
Retorna o cosseno de um nmero.
COSH
Retorna o cosseno hiperblico de um

nmero.
GRAUS
Converte radianos em graus.
PAR
Arredonda um nmero para cima at o

inteiro par mais prximo.
EXP
Retorna e elevado potncia de um nmero

especificado.
FATORIAL
Retorna o fatorial de um nmero.
ARREDMULTB
Arredonda um nmero para baixo,

aproximando-o de zero.
INT
Arredonda um nmero para baixo at o

inteiro mais prximo.
LN
Retorna o logaritmo natural de um nmero.
LOG
Retorna o logaritmo de um nmero para

uma base especificada.
LOG10
Retorna o logaritmo de base 10 de um

nmero.
Resto
Retorna o resto de uma diviso.
MPAR
Arredonda um nmero para cima at o

inteiro mpar mais prximo.
189
Funo
Descrio
PI
Retorna o valor de pi.
POTNCIA
Retorna o resultado de um nmero elevado

a uma potncia.
MULT
Multiplica seus argumentos.
RADIANOS
Converte graus em radianos.
ALEATRIO
Retorna um nmero aleatrio entre 0 e 1.
ROMANO
Converte um numeral arbico em romano,

como texto.
ARRED
Arredonda um nmero at um nmero

especificado de dgitos.
ARREDONDAR.PARA.BAIXO
Arredonda um nmero para baixo,

aproximando-o de zero.
ARREDONDAR.PARA.CIMA
Arredonda um nmero para cima, distante

de zero.
SINAL
Retorna o sinal de um nmero.
SEN
Retorna o seno do ngulo especificado.
SENH
Retorna o seno hiperblico de um nmero.
RAIZ
Retorna uma raiz quadrada positiva.
SOMA
Inclui seus argumentos.
SOMASE
Inclui as clulas especificadas por critrios

especificados.
TAN
Retorna a tangente de um nmero.
TANH
Retorna a tangente hiperblica de um

nmero.
Funes de Texto e de Dados

A tabela a seguir lista funes de texto e de dados.
190
Funo
Descrio
CARACT
Retorna o caractere especificado pelo

nmero do cdigo.
Funo
Descrio
TIRAR
Remove todos os caracteres no imprimveis

do texto.
CDIGO
Retorna um cdigo numrico para o

primeiro caractere em uma sequncia de
texto.
CONCATENAR
Junta vrios itens de texto em um item de

texto.
MOEDA
Converte um nmero em texto, usando o

formato de moeda $ (cifro).
EXATO
Verifica se dois valores de texto so

idnticos.
PROCURAR
Localiza um valor de texto em outro

(distino entre maisculas e minsculas).
DEF.NM.DEC
Formata um nmero como texto com um

nmero fixo de decimais.
ESQUERDA
Retorna os caracteres da extremidade

esquerda de um valor de texto.
NM.CARACT
Retorna o nmero de caracteres em uma

sequncia de texto.
MINSCULA
Converte texto em minsculas.
EXT.TEXTO
Retorna um nmero especfico de caracteres

de uma sequncia de texto, comeando na
posio especificada.
PRI.MAISCULA
Coloca em maiscula a primeira letra de

cada palavra de um valor de texto.
SUBSTITUIR
Substitui caracteres no texto.
REPT
Repete um texto um determinado nmero

de vezes.
DIREITA
Retorna os caracteres da extremidade direita

de um valor de texto.
PROCURAR
Localiza um valor de texto em outro (sem

distino entre maisculas e minsculas).
SUBSTITUIR
Substitui o novo texto por texto antigo em

uma sequncia de texto.
Converte seus argumentos em texto.
191
Funo
Descrio
TEXTO
Formata um nmero e converte-o em texto.
ARRUMAR
Remove espaos do texto.
MAISCULA
Converte texto em maisculas.
VALOR
Converte um argumento de texto em um

nmero.
Funes Estatsticas
A tabela a seguir lista funes estatsticas.
192
Funo
Descrio
DESV.MDIO
Retorna a mdia dos desvios absolutos de

pontos de dados a partir de sua mdia.
MDIA
Retorna a mdia de seus argumentos.
MDIAA
Retorna a mdia de seus argumentos,

incluindo valores numricos, de texto e
lgicos.
DISTRBINOM
Retorna a probabilidade de distribuio

binomial do termo individual.
INT.CONFIANA
Retorna o intervalo de confiana para uma

mdia da populao.
CORREL
Retorna o coeficiente de correlao entre

dois conjuntos de dados.
CONT.NM
Conta quantos nmeros h na lista de

argumentos.
CONT.VALORES
Conta quantos valores h na lista de

argumentos.
CONT.SE
Conta o nmero de clulas no em branco

em um intervalo que atendem aos critrios
especificados.
COVAR
Retorna a covariao, a mdia dos produtos

de pares de desvios.
DESVQ
Retorna a soma de quadrados de desvios.
DISTEXPON
Retorna a distribuio exponencial.
FISHER
Retorna a transformao Fisher.
Funo
Descrio
FISHERINV
Retorna o inverso da transformao Fisher.
PREVISO
Retorna um valor em uma tendncia linear.
MDIA.GEOMTRICA
Retorna a mdia geomtrica.
CRESCIMENTO
Retorna valores em uma tendncia

exponencial.
MDIA.HARMNICA
Retorna a mdia harmnica.
INTERCEPO
Retorna a interceptao da linha de

regresso linear.
CURT
Retorna a curtose de um conjunto de dados.
MAIOR
Retorna o maior valor k-simo em um

conjunto de dados.
PROJ.LIN
Retorna os parmetros de uma tendncia

linear.
PROJ.LOG
Retorna os parmetros de uma tendncia

exponencial.
MXIMO
Retorna o valor mximo em uma lista de

argumentos.
MXIMOA
Retorna o valor mximo em uma lista de

argumentos, incluindo valores numricos, de
texto e lgicos.
MED
Retorna a mediana dos nmeros

especificados.
MNIMO
Retorna o valor mnimo em uma lista de

argumentos.
MNIMOA
Retorna o menor valor em uma lista de

argumento, incluindo valores numricos, de
texto e lgicos.
MODO
Retorna o valor mais comum em um

conjunto de dados.
DIST.NORM
Retorna a distribuio acumulativa normal.
INV.NORM
Retorna o inverso da distribuio

acumulativa normal.
DIST.NORMP
Retorna a distribuio acumulativa normal

padro.
193
194
Funo
Descrio
INV.NORM

acumulativa normal padro.
PEARSON
Retorna o coeficiente de correlao do

momento do produto Pearson.
PERMUT
Retorna o nmero de permutaes para um

nmero especificado de objetos.
RQUAD
Retorna o quadrado do coeficiente de

correlao do momento do produto Pearson.
DISTORO
Retorna a distoro de uma distribuio.
INCLINAO
Retorna a inclinao da linha de regresso

linear.
MENOR
Retorna o menor valor k-simo em um

conjunto de dados.
PADRONIZAR
Retorna um valor normalizado.
DESVPAD
Estima o desvio padro com base em uma

amostra.
DESVPADA

amostra, incluindo valores numricos, de
texto e lgicos.
DESVPADP
Calcula o desvio padro com base na

populao total.
DESVPADPA

populao total, incluindo valores
numricos, de texto e lgicos.
EPADYX
Retorna o erro padro do valor y previsto

para cada x na regresso.
TENDNCIA
Retorna valores em uma tendncia linear.
VAR
Estima a variao com base em uma

amostra.
VARA
Estima a variao com base em uma

amostra, incluindo valores numricos, de
texto e lgicos.
VARP
Calcula a variao com base na populao

total.
Funo
Descrio
VARPA

total, incluindo valores numricos, de texto e
lgicos.
WEIBULL
Retorna a distribuio Weibull.
195
196
Apndice B. Funes do Excel No Suportadas - TM1 Web

O IBM Cognos TM1 Web suporta vrias funes de planilha do Excel. Este
apndice lista as funes do Excel, por categoria e em ordem alfabtica, que no
so suportadas no TM1 Web.
Funes de Banco de Dados e de Gerenciamento de Listas

Esta tabela lista as funes de gerenciamento que no so suportadas no TM1 Web.
Funo
Descrio
BDMDIA
Retorna a mdia de entradas de banco de

dados selecionadas.
BDCONTAR
Conta as clulas que contm nmeros em

um banco de dados.
BDCONTARA
Conta clulas no em branco em um banco

de dados.
BDEXTRAIR
Extrai de um banco de dados um nico

registro que corresponde aos critrios
especificados.
BDMX
Retorna o valor mximo das entradas de

banco de dados selecionadas.
BDMN
Retorna o valor mnimo das entradas de

banco de dados selecionadas.
BDMULTIPL
Multiplica os valores em um campo

especfico de registros que correspondem aos
critrios em um banco de dados.
BDEST

amostra de entradas de banco de dados
selecionadas.
BDDESVPA

populao total de entradas de banco de
dados selecionadas.
BDSOMA
Inclui os nmeros na coluna de campo de

registros no banco de dados que
correspondem aos critrios.
BDVAREST
Estima a variao com base em uma amostra

de entradas de banco de dados selecionadas.
BDVARP

total de entradas de banco de dados
selecionadas.
197
Funes de Data e Hora

Esta tabela lista as funes de data e hora que no so suportadas pelo TM1 Web.
Funo
Descrio
EDATE
Retorna o nmero de srie da data que o

nmero indicado de meses antes ou depois
da data de incio.
EOMONTH
Retorna o nmero de srie do ltimo dia do

ms antes ou depois de um nmero de
meses especificado.
NETWORKDAYS
Retorna o nmero dos dias teis inteiros

entre duas datas.
WEEKNUM

nmero que representa onde a semana
ocorre numericamente em um ano.
WORKDAY
Retorna o nmero de srie da data antes ou

depois do nmero de dias teis especificado.
YEARFRAC
Retorna a frao de ano que representa o

nmero de dias inteiros entre start_date e
end_date.
Funes Financeiras
Esta tabela lista as funes financeiras que no so suportadas no TM1 Web.
198
Funes
Descrio
JUROSACUM
Retorna a taxa de juros acumulados de um

ttulo que paga uma taxa peridica de juros.
JUROSACUMV
Retorna a taxa de juros acumulados de um

ttulo que paga juros no vencimento.
AMORDEGRC
Retorna a depreciao para cada perodo

contbil usando um coeficiente de
depreciao.
AMORLINC
Retorna a depreciao para cada perodo

contbil.
COUPDAYBS
Retorna o nmero de dias do incio do

perodo de cupom at a data de quitao.
COUPDAYS
Retorna o nmero de dias no perodo de

cupom que contm a data de quitao.
COUPDAYSNC
Retorna o nmero de dias da data de

quitao at a prxima data do cupom.
COUPNCD
Retorna a prxima data de cupom aps a

data de quitao.
COUPNUM
Retorna o nmero de cupons pagveis entre

as datas de quitao e vencimento.
COUPPCD
Retorna a data de cupom anterior data de

quitao.
CUMIPMT
Retorna os juros acumulados pagos entre

dois perodos.
Funes
Descrio
CUMPRINC
Retorna o capital acumulado pago sobre um

emprstimo entre dois perodos.
DISC
Retorna a taxa de desconto de um ttulo.
DOLLARDE
Converte um preo em formato de moeda,

apresentado na forma fracionria, em um
preo em formato de moeda, apresentado na
forma decimal.
DOLLARFR
Converte um preo em formato de moeda,

apresentado na forma decimal, em um preo
em formato de moeda apresentado na forma
fracionria.
DURATION
Retorna a durao anual de um ttulo com

pagamentos de juros peridicos.
EFFECT
Retorna a taxa de juros anual efetiva.
FVSCHEDULE
Retorna o valor futuro de um capital inicial

aps a aplicao de uma srie de taxas de
juros compostas.
INTRATE
Retorna a taxa de juros de um ttulo

totalmente investido.
MDURATION
Retorna a durao de Macauley modificada

para um ttulo com um valor de paridade
equivalente a R$ 100.
NOMINAL
Retorna a taxa de juros nominal anual.
ODDFPRICE
Retorna o preo por R$ 100 de valor

nominal de um ttulo com um primeiro
perodo indefinido.
ODDFYIELD
Retorna o rendimento de um ttulo com um

primeiro perodo indefinido.
ODDLPRICE

nominal de um ttulo com um ltimo
perodo indefinido.
ODDLYIELD
Retorna o rendimento de um ttulo com um

ltimo perodo indefinido.
PREO

nominal de um ttulo que paga juros
peridicos.
PRICEDISC

nominal de um ttulo descontado.
PRICEMAT

nominal de um ttulo que paga juros no
vencimento.
RECEBIDO
Retorna o valor recebido no vencimento de

um ttulo totalmente investido.
TBILLEQ
Retorna o rendimento de um ttulo

equivalente a uma obrigao do Tesouro.
TBILLPRICE

nominal de uma obrigao do Tesouro.
TBILLYIELD
Retorna o rendimento de uma obrigao do

Tesouro.
199
Funes
Descrio
BDV

perodo especificado ou parcial usando um
mtodo de saldo decrescente.
XIRR
Fornece a taxa interna de retorno de uma

programao de fluxos de caixa no
necessariamente peridico.
XNPV
Retorna o valor presente lquido de uma

programao de fluxos de caixa no
necessariamente peridico.
LUCRO
Retorna o rendimento de um ttulo que paga

juros peridicos.
YIELDDISC
Retorna o rendimento anual de um ttulo

descontado, por exemplo, uma obrigao do
Tesouro.
YIELDMAT
Retorna o rendimento anual de um ttulo

que paga juros no vencimento.
Funes de Informao
Esta tabela lista as funes de informao que no so suportadas no TM1 Web.
200
Funo
Descrio
CL
Retorna informaes sobre a formatao,

local ou contedo de uma clula.
TIPO.ERRO
Retorna um nmero correspondente a um

tipo de erro.
INFORMAO
Retorna informaes sobre o ambiente

operacional atual.
CL.VAZIA
Retorna VERDADEIRO se o valor estiver em

branco.
ISEVEN
Retorna VERDADEIRO se o nmero for par.
LGICO
Retorna VERDADEIRO se o valor for um

valor lgico.
.NO.TEXTO
Retorna VERDADEIRO se o valor no for

texto.
NM
Retorna VERDADEIRO se o valor for um

nmero.
ISODD
Retorna VERDADEIRO se o nmero for

mpar.
REF
Retorna VERDADEIRO se o valor for uma

referncia.
TEXTO
Retorna VERDADEIRO se o valor for texto.
Retorna um valor convertido em um

nmero.
TIPO
Retorna um nmero que indica o tipo de

dado de um valor.
Funes de Consulta e Referncia

Esta tabela lista as funes de consulta e referncia que no so suportadas no
TM1 Web.
Funo
Descrio
REAS
Retorna o nmero de reas em uma

referncia.
INDIRETO
Retorna uma referncia indicada por um

valor de texto.
CORRESP
Consulta valores em uma referncia ou

matriz.
RTD
Recupera dados em tempo real de um

programa que suporta automao COM.
TRANSPOR
Retorna a transposio de uma matriz.

Esta tabela lista as funes matemticas e trigonomtricas que no so suportadas
no TM1 Web.
Funo
Descrio
FACTDOUBLE
Retorna o fatorial duplo de um nmero.
GCD
Retorna o mximo divisor comum.
LCM
Retorna o mnimo mltiplo comum.
MATRIZ.DETERM
Retorna o determinante de matriz de uma

matriz.
MATRIZ.INVERSO
Retorna a matriz inversa de uma matriz.
MATRIZ.MULT
Retorna o produto matricial de duas

matrizes.
MROUND
Retorna um nmero arredondado para o

mltiplo desejado.
MULTINOMIAL
Retorna o multinomial de um conjunto de

nmeros.
QUOTIENT
Retorna a parte do nmero inteiro de uma

diviso.
RANDBETWEEN
Retorna um nmero aleatrio entre os

nmeros especificados.
SERIESSUM
Retorna a soma de uma srie de potncias

com base na frmula.
SQRTPI
Retorna a raiz quadrada de (nmero * pi).
SUBTOTAL
Retorna um subtotal em uma lista ou banco

de dados.
SOMARPRODUTO
Retorna a soma dos produtos de

componentes de matriz correspondentes.
SOMAQUAD
Retorna a soma dos quadrados dos

argumentos.
201
Funo
Descrio
SOMAX2DY2
Retorna a soma das diferenas de quadrados

de valores correspondentes em duas
matrizes.
SOMAX2SY2
Retorna a soma da soma de quadrados de

valores correspondentes em duas matrizes.
SOMAXMY2
Retorna a soma de quadrados de diferenas

de valores correspondentes em duas
matrizes.
TRUNCAR
Trunca um nmero para um nmero inteiro.
Funes Estatsticas
Esta tabela lista as funes estatsticas que no so suportadas no TM1 Web.
202
Funo
Descrio
DISTBETA
Retorna a funo de distribuio

acumulativa beta.
BETA.ACUM.INV
Retorna o inverso da funo de distribuio

acumulativa para uma distribuio beta
especificada.
DIST.QUI
Retorna a probabilidade unicaudal da

distribuio qui-quadrada.
INV.QUI
Retorna o inverso da probabilidade

unicaudal da distribuio qui-quadrada.
TESTE.QUI
Retorna o teste para independncia.
CONTAR.VAZIO
Conta o nmero de clulas em branco em

um intervalo.
CRIT.BINOM
Retorna o menor valor para o qual a

distribuio binomial acumulativa menor
ou igual a um valor de critrio.
DISTF
Retorna a distribuio de probabilidade F.
INVF
Retorna o inverso da distribuio de

probabilidade F.
FREQUNCIA
Retorna a distribuio de frequncia como

uma matriz vertical.
TESTEF
Retorna o resultado de um teste F.
DISTGAMA
Retorna a distribuio gama.
INVGAMA

acumulativa gama.
LNGAMA
Retorna o logaritmo natural da funo gama,

G(x).
DIST.HIPERGEOM
Retorna a distribuio hipergeomtrica.
INVLOG
Retorna o inverso da distribuio lognormal.
DIST.LOGNORMAL
Retorna a distribuio acumulativa

lognormal.
DIST.BIN.NEG
Retorna a distribuio binomial negativa.
Funo
Descrio
PERCENTIL
Retorna o k-simo percentil de valores em

um intervalo.
ORDEM.PORCENTUAL
Retorna a classificao percentual de um

valor em um conjunto de dados.
POISSON
Retorna a distribuio Poisson.
PROB
Retorna a probabilidade de valores em um

intervalo estarem entre dois limites.
QUARTIL
Retorna o quartil de um conjunto de dados.
CLASSIFICAO
Retorna a classificao de um nmero em

uma lista de nmeros.
DISTT
Retorna a distribuio t de Student.
INVT
Retorna o inverso da distribuio t de

Student.
MDIA.INTERNA
Retorna a mdia do interior de um conjunto

de dados.
TESTET
Retorna a probabilidade associada a um

teste t de Student.
TESTEZ
Retorna o valor de probabilidade unicaudal

de um teste z.
Funes de Texto e de Dados

Esta tabela lista as funes de texto e de dados que no so suportadas no TM1
Web.
Funo
Descrio
ASC
Altera letras em ingls ou katakana de

largura total (byte duplo) em uma sequncia
de caracteres para caracteres de meia largura
(byte nico).
BAHTTEXT
Converte um nmero em texto, usando o

formato da moeda (baht).
JIS
Altera letras em ingls ou katakana de meia

largura (byte nico) em uma sequncia de
caracteres para caracteres de largura total
(byte duplo).
FONTICA
Extrai os caracteres fonticos (furigana) de

uma sequncia de texto.
AutoShapes
O TM1 Web no suporta o Microsoft Office

Autoshapes.
203
204
Avisos
Estas informaes foram desenvolvidas para produtos e servios oferecidos em
todo o mundo.
possvel que a IBM no oferea os produtos, servios ou recursos discutidos
nesta publicao em outros pases. Consulte um representante IBM local para obter
informaes sobre produtos e servios disponveis atualmente em sua rea.
Qualquer referncia a produtos, programas ou servios IBM no significa que
apenas produtos, programas ou servios IBM possam ser utilizados. Qualquer
produto, programa ou servio funcionalmente equivalente, que no infrinja
nenhum direito de propriedade intelectual da IBM poder ser utilizado em
substituio a este produto, programa ou servio. Entretanto, a avaliao e
verificao da operao de qualquer produto, programa ou servio no IBM so de
responsabilidade do Cliente.
A IBM pode ter patentes ou solicitaes de patentes pendentes relativas a assuntos
tratados nesta publicao. O fornecimento desta publicao no lhe garante direito
algum sobre tais patentes. Consultas sobre licena devem ser enviadas, por escrito,
para:
Gerncia de Relaes Comerciais e Industriais da IBM Brasil
Av. Pasteur, 138-146
Botafogo
Rio de Janeiro, RJ
CEP 22290-240
Para consultas sobre licena relacionadas a informaes de DBCS (Conjunto de
Caracteres de Byte Duplo), entre em contato com o Departamento de Propriedade
Intelectual da IBM em seu pas ou envie pedidos de licena, por escrito, para:
IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106,
Japan
O pargrafo a seguir no se aplica ao Reino Unido e a nenhum pas em que tais
disposies no estejam de acordo com a legislao local: A INTERNATIONAL
BUSINESS MACHINES CORPORATION FORNECE ESTA PUBLICAO "NO
ESTADO EM QUE SE ENCONTRA", SEM GARANTIA DE NENHUM TIPO, SEJA
EXPRESSA OU IMPLCITA, INCLUINDO, MAS A ELAS NO SE LIMITANDO,
AS GARANTIAS IMPLCITAS DE NO INFRAO, COMERCIALIZAO OU
ADEQUAO A UM DETERMINADO PROPSITO. Alguns pases no permitem
a excluso de garantias expressas ou implcitas em certas transaes; portanto, essa
disposio pode no se aplicar ao Cliente.
Essas informaes podem incluir imprecises tcnicas ou erros tipogrficos. So
feitas alteraes peridicas nas informaes aqui contidas; tais alteraes sero
incorporadas em futuras edies desta publicao. A IBM pode, a qualquer
momento, aperfeioar e/ou alterar os produtos e/ou programas descritos nesta
publicao, sem aviso prvio.
205
Quaisquer referncias nestas informaes a Web sites no IBM so fornecidas

apenas para convenincia e no funcionam, de maneira nenhuma, como um
endosso desses Web sites. Os materiais nesses Web sites no fazem parte dos
materiais para este produto IBM e o uso desses Web sites de inteira
responsabilidade do Cliente.
A IBM pode utilizar ou distribuir as informaes fornecidas da forma que julgar
apropriada sem incorrer em qualquer obrigao para com o Cliente.
Licenciados deste programa que desejam obter informaes sobre este assunto com
objetivo de permitir: (i) a troca de informaes entre programas criados
independentemente e outros programas (incluindo este) e (ii) a utilizao mtua
das informaes trocadas, devem entrar em contato com:
Gerncia de Relaes Comerciais e Industriais da IBM Brasil
Av. Pasteur, 138-146
Botafogo
Rio de Janeiro
RJ
Tais informaes podem estar disponveis, sujeitas aos termos e condies
apropriados, incluindo, em alguns casos, o pagamento de uma taxa.
O programa licenciado descrito nesta publicao e todo o material licenciado
disponvel a ele so fornecidos pela IBM sob os termos do IBM Customer
Agreement, do Contrato de Licena do Programa Internacional da IBM ou de
qualquer contrato equivalente entre as partes.
Os dados de desempenho aqui contidos foram determinados em um ambiente
controlado. Portanto, os resultados obtidos em outros ambientes operacionais
podem variar significativamente. Foram tomadas algumas medidas nos sistemas de
nvel de desenvolvimento e no h nenhuma garantia de que estas medidas sejam
as mesmas nos sistemas geralmente disponveis. Alm disso, algumas medidas
podem ter sido estimadas por meio de extrapolao. Os resultados reais podem
variar. Os usurios desta publicao devem verificar os dados aplicveis ao seu
ambiente especfico.
As informaes relativas a produtos no IBM foram obtidas dos fornecedores
desses produtos, dos anncios publicados ou de outras fontes publicamente
disponveis. A IBM no testou esses produtos e no pode confirmar a exatido do
desempenho, da compatibilidade ou de outras solicitaes relacionadas a produtos
no IBM. Questes sobre os recursos de produtos no IBM devem ser endereadas
aos fornecedores desses produtos.
Todas as instrues relativas a futuras orientaes ou intenes da IBM esto
sujeitas a alterao ou retirada sem aviso prvio e apenas representam metas e
objetivos.
Estas informaes contm exemplos de dados e relatrios usados em operaes de
negcios dirias. Para ilustr-las da maneira mais completa possvel, os exemplos
incluem os nomes de indivduos, empresas, marcas e produtos. Todos esses nomes
so fictcios e qualquer semelhana com nomes e endereos usados por uma
empresa real totalmente coincidncia.
Se estiver visualizando estas informaes em formato eletrnico, as fotografias e
ilustraes coloridas podero no aparecer.
206
Marcas Registradas
IBM, o logotipo da IBM, ibm.com, TM1 e Cognos so marcas ou marcas registradas
da International Business Machines Corp., registradas em vrios pases no mundo
todo. Outros nomes de produtos e servios podem ser marcas registradas da IBM
ou de outras empresas. Uma lista atualizada de marcas registradas IBM est
disponvel na Web em Copyright and trademark information em
www.ibm.com/legal/copytrade.shtml.
Os termos a seguir so marcas registradas de outras empresas:
v Microsoft, Windows, Windows NT e o logotipo Windows so marcas registradas
da Microsoft Corporation nos Estados Unidos e/ou em outros pases.
v Java e todas as marcas registradas e logotipos baseados em Java so marcas ou
marcas registradas da Oracle e/ou suas afiliadas.
Avisos
207
208
ndice Remissivo
Caracteres Especiais
\\ (barra invertida) em regras 44
% (sinal de porcentagem) em regras
/ (barra) em regras 44
& (e comercial) em regras 45
~ (til) em regras 45
| (barra vertical) em regras 45
45
A
aliases
amostras 13
atributos de elemento 12
Editor de Dimenso 24
aplicativo
nenhum privilgio de acesso 110
privilgio de acesso de administrador 106
privilgio de acesso de leitura 108
privilgios de segurana 118
aplicativos
convertendo de particular para pblico 89
convertendo de pblico para particular 89
criando e gerenciando 75
criando nvel secundrio 76
excluindo referncias 86
incluindo referncias de arquivo 80
incluindo referncias do objeto 77
local no servidor 73
nvel superior 75
particular 89
privatizando aplicativos pblicos 89
privatizando pblico 90
privilgios de segurana 73, 88
publicao 75, 89
publicando as referncias particulares 89
publicando no Web client 91
pblico 89
referncias para subconjuntos particulares 78
referncias para visualizaes particulares 78
renomeando referncias 87
trabalhando com referncias 85
viso geral 71
visualizando agrupamentos lgicos 90
rea (destino da regra) 42
atributos
atributos versus 15
exemplos 12
formatar 14
viso geral 12
atributos de elemento
Lista de seleo 36
B
Boto de Ao
executando um processo e navegando at uma
planilha 131
incluindo em uma planilha 123
modificando 137
movendo e redimensionando 138
Boto de Ao (continuao)
navegando para outra planilha 129
opes avanadas de mapeamento e navegao
propriedades da aparncia 133
viso geral 123
133
C
caixas de dilogo
Criando o Cubo 32
calculando mdias
instrues de regras 58
caracteres reservados
nomes do objeto 3
carregando os cubos on demand 34
classificao de elementos
alfabeticamente no Editor de Dimenso 23
por hierarquia no Editor de Dimenso 24
por ndice na Dimenso 24
compartilhando dados entre os cubos 55
consolidaes
criando com fatores de peso 10
diversos caminhos em uma nica dimenso 11
regras versus 12
constantes
frmulas de regras 43
convenes de nomenclatura
Objetos do TM1 3
CubeDataReservationAcquire 172
CubeDataReservationGet 175
CubeDataReservationGetConflicts 177
CubeDataReservationRelease 174
CubeDataReservationReleaseAll 174
cubo
bloqueando 112
caixa de dilogo criando cubo 32
carregando on demand 34
como tabelas de consulta 99
criando 32
criando com origens de dados externos 31
criando sem dados 31
desbloqueando 112
designando privilgios de acesso 111
espelho 40
exemplos 7, 9
fonte 40
formatos do valor de exibio 14
funo de regras do DB para compartilhar dados 55
liberando 112
otimizando 33
privilgio de acesso de bloqueio 107
privilgio de acesso de gravao 109
privilgio de acesso de reserva 109
propriedades 32
recuperando os valores usando as frmulas DBR 101
referncias de frmulas de regras 46
reservando 112
209
cubo (continuao)
segurana 114
selecionando as dimenses 8
solicitando dimenses 31
valores de frmulas DBS 102
vinculando assimtrico 59
cubo de controle de segurana 119
cubos assimtricos
vinculando 59
cubos de controle
}Lista de Seleo 37
cubos de origem 40
cubos espelhados 40
D
da coluna
alterando a posio na hierarquia 18
atributos versus 15
bloqueando 114
classificando no Editor de Dimenso 23
configurando a ordem do Server Explorer 22
configurando a ordem nas dimenses 20, 22
consolidado 12, 113
desbloqueando 114
designando privilgios de acesso 112
excluindo consolidado 19
excluindo da dimenso 19
fatores de peso 10
incluindo irmos 18
incluindo na dimenso 17, 18
liberando 113
numrico 12
ordem nas dimenses 20
reservando 113
segurana 114
selecionando no Editor de Dimenso 23
selecionar todos os elementos visveis 18
sequncia 12
tipos 12
dados
rolando 10
depurando regras
rastreando clculos 67
rastreando FEEDERS 70
verificando FEEDERS 70
viso geral 67
designando direitos de segurana 105
dimenses
bloqueando 115
configurando a ordem dos elementos 20, 22
consolidaes 12, 50
criando 16
criando com Editor de Dimenso 17
densas 31
desbloqueando 115
designando privilgios de acesso 115, 116, 117
edio 17
esparsas 31
excluindo elementos 19
grupo de administradores 114
210
dimenses (continuao)
hierarquias 10, 28
incluindo elementos 18
incluindo irmos 18
liberando 115
mtodos para criao 16
nveis nomeados 29
planilhas 26, 29
reservando 115
selecionando em um cubo 8
solicitando nos cubos 31
dimenses densas 31
dimenses esparsas 31
diversos caminhos de consolidao 11
E
Editor de Dimenso
classificao de elementos 23, 24
selecionando elementos 23
usando aliases 24
elementos consolidados 113
definidos 12
definindo com planilhas de dimenses 28
excluindo elementos 19
incluindo filhos 18
elementos de sequncia
definidos 12
Excel
funes da planilha 185
funes da planilha no suportadas 197
referncias do arquivo 85, 86, 87
subdiretrio }Externals 80
excluindo
elementos das dimenses 19
referncias de aplicativos 86
F
fatores de peso
consolidaes 10
fazer drill
abaixo 10
atravs de processos 60, 62, 63, 64
filho
incluindo nos elementos consolidados
formatos de exibio
configurao 15
valores do cubo 14
frmulas DBS
criando 102
viso geral 96
frmulas de regras
comparando expresses 45
constantes numricas 43
lgica condicional 44
operadores aritmticos 44
operadores de comparao 45
operadores lgicos 45
18
frmulas de regras (continuao)

referncias de cubo externo 46
referncias de cubo internas 46
referncias do cubo 46
sintaxe 43
funo de regras do DB 46
funo de regras STET 48
funo IF
funes
BD 46, 55
consulta e referncia 187
data e hora 185
estatstica 192
financeiro 186
informaes 187
lgica 187
matemtica e trigonomtrico 188
no suportado 197, 198, 200, 201, 202, 203
planilha suportada do Excel 185
SE 44
STET 48
texto e dados 190
Funes de Interface de Programao de Aplicativos de
Reserva de Dados
cdigos de erro 183
TM1DataReservationAcquire 178
TM1DataReservationGetAll 181
TM1DataReservationGetConflicts 181
TM1DataReservationRelease 179
TM1DataReservationReleaseAll 180
TM1DataReservationValidate 182
funes de Reserva de Dados do Turbo Integrator
CubeDataReservationAcquire 172
CubeDataReservationGet 175
CubeDataReservationGetConflicts 177
CubeDataReservationRelease 174
CubeDataReservationReleaseAll 174
funes no suportadas do Excel
AMORDEGRC 198
AMORLINC 198
REAS 201
ASC 203
BAHTTEXT 203
BDCONTAR 197
BDCONTARA 197
BDDESVPA 197
BDEST 197
BDEXTRAIR 197
BDMX 197
BDMDIA 197
BDMN 197
BDMULTIPL 197
BDSOMA 197
BDV 200
BDVAREST 197
BDVARP 197
BETA.ACUM.INV 202
CL 200
CLASSIFICAO 203
CONTAR.VAZIO 202
CORRESP 201
COUPDAYBS 198
COUPDAYS 198
COUPDAYSNC 198
COUPNCD 198
COUPNUM 198
funes no suportadas do Excel (continuao)

COUPPCD 198
CRIT.BINOM 202
CUMIPMT 198
CUMPRINC 199
DISC 199
DIST.BIN.NEG 202
DIST.HIPERGEOM 202
DIST.LOGNORMAL 202
DIST.QUI 202
DISTBETA 202
DISTF 202
DISTGAMA 202
DISTT 203
DOLLARDE 199
DOLLARFR 199
DURATION 199
.NO.TEXTO 200
CL.VAZIA 200
EDATE 198
EFFECT 199
LGICO 200
NM 200
EOMONTH 198
REF 200
TEXTO 200
FACTDOUBLE 201
FONTICA 203
FREQUNCIA 202
FVSCHEDULE 199
GCD 201
INDIRETO 201
INFORMAO 200
INTRATE 199
INV.QUI 202
INVF 202
INVGAMA 202
INVLOG 202
INVT 203
ISEVEN 200
ISODD 200
JIS 203
JUROSACUM 198
JUROSACUMV 198
LCM 201
LNGAMA 202
LUCRO 200
MATRIZ.DETERM 201
MATRIZ.INVERSO 201
MATRIZ.MULT 201
MDURATION 199
MDIA.INTERNA 203
MROUND 201
MULTINOMIAL 201
N 200
NETWORKDAYS 198
NOMINAL 199
ODDFPRICE 199
ODDFYIELD 199
ODDLPRICE 199
ODDLYIELD 199
ORDEM.PORCENTUAL 203
PERCENTIL 203
POISSON 203
PREO 199
PRICEDISC 199
PRICEMAT 199
ndice Remissivo
211
funes no suportadas do Excel (continuao)

PROB 203
QUARTIL 203
QUOTIENT 201
RANDBETWEEN 201
RECEBIDO 199
RTD 201
SERIESSUM 201
SOMAQUAD 201
SOMARPRODUTO 201
SOMAX2DY2 202
SOMAX2SY2 202
SOMAXMY2 202
SQRTPI 201
SUBTOTAL 201
TBILLEQ 199
TBILLPRICE 199
TBILLYIELD 199
TESTE.QUI 202
TESTEF 202
TESTET 203
TESTEZ 203
TIPO 200
TIPO.ERRO 200
TRANSPOR 201
TRUNCAR 202
WEEKNUM 198
WORKDAY 198
XIRR 200
XNPV 200
YEARFRAC 198
YIELDDISC 200
YIELDMAT 200
funes suportadas do Excel
ABS 188
ACOS 188
ACOSH 188
AGORA 185
ALEATRIO 190
ANO 186
ARRED 190
ARREDMULTB 189
ARREDONDAR.PARA.BAIXO 190
ARREDONDAR.PARA.CIMA 190
ARRUMAR 192
ASEN 188
ASENH 189
ATAN 189
ATAN2 189
ATANH 189
BD 186
BDD 186
CARACT 190
CDIGO 191
COL 188
COLS 188
COMBIN 189
CONCATENAR 191
CONT.NM 192
CONT.SE 192
CONT.VALORES 192
CORREL 192
COS 189
COSH 189
COVAR 192
CRESCIMENTO 193
CURT 193
212
funes suportadas do Excel (continuao)

DATA 185
DATA.VALOR 185
DEF.NM.DEC 191
DESLOC 188
DESV.MDIO 192
DESVPAD 194
DESVPADA 194
DESVPADP 194
DESVPADPA 194
DESVQ 192
DIA 185
DIA.DA.SEMANA 185
DIAS360 185
DIREITA 191
DIST.NORM 193
DIST.NORMP 193
DISTEXPON 192
DISTORO 194
DISTRBINOM 192
DPD 187
E 187
.NO.DISP 187
ERRO 187
ERROS 187
ENDEREO 188
EPADYX 194
PGTO 186
ESCOLHER 188
ESQUERDA 191
EXATO 191
EXP 189
EXT.TEXTO 191
FALSO 187
FATORIAL 189
FISHER 192
FISHERINV 193
GRAU 189
HOJE 185
HORA 185
HYPERLINK 188
MPAR 189
INCLINAO 194
NDICE 188
INT 189
INT.CONFIANA 192
INTERCEPO 193
INV.NORM 194
IPGTO 186
LIN 188
LINS 188
LN 189
LOG 189
LOG10 189
MAIOR 193
MAISCULA 192
MXIMO 193
MXIMOA 193
MED 193
MDIA 192
MDIA.GEOMTRICA 193
MDIA.HARMNICA 193
MDIAA 192
MENOR 194
MS 185
MNIMO 193
MNIMOA 193
funes suportadas do Excel (continuao)

MINSCULA 191
MINUTO 185
MODO 193
MOEDA 191
MORMINV 193
MTIR 186
MULT 190
NO 187
NO.DISP 187
NPER 186
NM.CARACT 191
OU 187
PADRONIZAR 194
PAR 189
PEARSON 194
PERMUT 194
PGTO 186
PI 190
POTNCIA 190
PPGTO 186
PREVISO 193
PRI.MAISCULA 191
PROC 188
PROCH 188
PROCURAR 191
PROCV 188
PROJ.LIN 193
PROJ.LOG 193
RADIAN 190
RAIZ 190
REPT 191
Resto 189
ROMANO 190
RQUAD 194
SDA 187
SE 187
SEGUNDO 185
SEN 190
SENH 190
SINAL 190
SOMA 190
SOMASE 190
SUBSTITUIR 191
T 191
TAN 190
TANH 190
TAXA 186
TENDNCIA 194
TETO 189
TEXTO 192
TIR 186
TIRAR 191
VALOR 192
VALOR.TEMPO 185
VAR 194
VARA 194
VARP 194
VARPA 195
VERDADEIRO 187
VF 186
VP 186
VPL 186
WEIBULL 195
G
grupos
designando direitos de segurana
dimenso 119
105
H
hiperlinks
abrindo os arquivos de aplicativo transferidos por
upload 93
I
ignorando instrues de regras 48
importando dados
planilhas de processamento 96
instrues de regras
amostra 54
aplicativos de amostra 52
rea 42
calculando mdias 58
calculando propores 52
diretrizes 42
elementos consolidados e numricos 47
especificando o destino 42
Frmula 42
funo DB 55
funo de regras do DB para compartilhar dados do
cubo 55
funo STET 48
ignorando 48
ordem do clculo 50
organizando 47
precedncia sobre consolidaes de dimenso 50
referncias circulares 52
restringindo o escopo 48
restringindo para valores simples 57
sintaxe 42, 54
substituindo consolidaes de dimenso 50
vinculando cubos assimtricos 59
Interface de Programao de Aplicativos do Localizador
Uniforme de Recursos
acessando o objeto da rvore de navegao 157
acessando objetos da planilha da Web 145
acessando os objetos do cubeviewer 148
caracteres de escape do Localizador Uniforme de
Recursos 140
conceitos bsicos 141
login e logout do usurio 141
Parmetro AdminHost 141
parmetro de Ao 142
parmetro ObjectId 140
parmetro OpenObject 144
parmetros 140, 141, 142, 144
sintaxe 139
URL base 139
usando as funes de retorno de chamada de evento 154
viso geral 139
irmos
incluindo nas dimenses 18
L
listas de seleo
criando 35
ndice Remissivo
213
listas de seleo (continuao)

criando com atributos de elemento 36
criando com cubos de controle 37
definindo com regras 38
dimenso 36
esttico 35
ordem de precedncia 39
subconjunto 36
tipos 35
lgica condicional
M
multidimensionalidade
diagrama 2
exemplo 1
viso geral 1
N
nveis de hierarquia nomeados 29
nvel 0 (hierarquia da dimenso) 10
numrico
constante em frmulas de regras 43
definir elementos 12
O
objetos
exibio no Server Explorer 90
objetos da rvore de navegao
abrindo 157
acessando com a Interface de Programao de Aplicativos
do Localizador Uniforme de Recursos 157
configurando uma funo de retorno de chamada 159
IDs de n da rvore XML 161
n de servidor XML 161
n do aplicativo XML 160
usando no modo HTML 158
usando no modo XML 159
Objetos da planilha da Web
abrindo 145
aplicando aes 147
configurando funes de retorno de chamada de
evento 154
configurando propriedades de exibio 147
configurando uma funo de retorno de chamada
global 156
hyperlinks para arquivos de aplicativos transferidos por
upload 93
selecionando os elementos de ttulo 146
objetos do Cubeviewer
abrindo 149
aplicando aes 151
configurando funes de retorno de chamada de
evento 154
configurando propriedades de exibio 150
configurando uma funo de retorno de chamada
global 156
exibindo grficos 152
214
objetos do Cubeviewer (continuao)

selecionando os elementos de ttulo
OLAP 34
OLE DB 34
opo Acesso de Segurana 116
operadores (regras)
aritmticos 44
comparao 45
lgica 45
operadores de comparao
operadores lgicos
otimizando cubos 33
151
P
particular
aplicativos 89
referncias nos aplicativos 89
Planilhas da Web
configurando propriedades 91
planilhas de regras
criando 49
nomes do arquivo 49
salvando 50
usando 49
viso geral 49
preenchendo os cubos
frmulas DBS 102
privilgio de acesso de bloqueio 107, 109
privilgio de acesso de leitura 108, 110
privilgios de acesso
administrador 105
bloqueio 107, 109
designando aos cubos 111
designando aos elementos 112
designando aos processos 116
designando s dimenses 115
designando s tarefas de organizao de processos
direitos de replicao 40
gravar 109
interaes 110
ler 108, 110
nenhum 110
reservar 109
processo
modificando os dados de segurana 116
segurana 116
propores
calculando uso de regras 52
publicando aplicativos no Web client 91
pblico
aplicativos 89
referncias nos aplicativos 89
R
Rastreador de Regras
exemplo complexo 68
exemplo simples 67
117
Rastreador de Regras (continuao)

rastreando clculos 67
rastreando FEEDERS 70
verificando FEEDERS 70
viso geral 67
referncias
convertendo de particular para pblico 89
convertendo de pblico para particular 90
particular 89, 90
pblico 89, 90
referncias circulares (regras) 52
referncias do objeto
aes padro 85
excluindo de aplicativos 86
renomeando 87
regras
consolidaes versus 12
depurando 67
derivando valores 41
listas de seleo 38
nomes do arquivo 41
Rastreador de Regras 67
viso geral 41
renomeando referncias do aplicativo 87
replicaes
cubo de origem 40
cubo espelhado 40
direitos de acesso necessrios 40
relacionamentos de servidor 40
relacionamentos do cubo 40
servidor de destino 40
servidor de origem 40
vantagens 40
Reserva de Dados
ativao 168
ativando para cubos 168
ativando para grupos de usurios 170
como usar 163
comportamento com outros recursos 164
exibindo status da clula 171
monitorando 170
monitorando com o utilitrio do TM1 Top 171
quando usar 163
usando as funes para monitor 172
usando com funes da interface de programao de
aplicativos 178
usando com funes TurboIntegrator 172
viso geral 163
visualizando os eventos de log de Auditoria 171
rolando 10
90
T
tarefa de organizao de processos
segurana 117
TM1
convenes de nomenclatura para objetos
TM1DataReservationAcquire 178
TM1DataReservationGetAll 181
TM1DataReservationGetConflicts 181
TM1DataReservationRelease 179
TM1DataReservationReleaseAll 180
TM1DataReservationValidate 182
V
valores
derivando com regras 41
vinculando cubos assimtricos 59
viso geral de nvel de hierarquia 10
S
segurana
aplicando privilgios nos aplicativos
segurana (continuao)
aplicativos 118
direitos do grupo 105
grupo 114
interao de direitos 110
nvel de clula 119
nvel de cubo 111, 114
nvel de dimenso 114
nvel do elemento 112, 114
privilgios de acesso 105
processos 116
referncias 118
tarefas de organizao de processos 117
segurana em nvel de clula
consolidaes 119
cubo de controle de segurana 119
elementos folha 119
Server Explorer
configurando a ordem do elemento 22
suprimindo a exibio de objetos selecionados
servidor
fonte 40
meta 40
servidor de destino 40
servidor de origem 40
sintaxe
subdiretrio }Externals
arquivos do Excel 80
88, 118
Windows
Criando o Cubo 32
ndice Remissivo
215

Cognos Cube

Enviado por

Dados do documento

Título original

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

Cognos Cube

Enviado por

Direitos autorais:

Formatos disponíveis

IBM Cognos TM1

Guia para Desenvolvedores

Captulo 2. Criando Cubos e Dimenses . . . . . . . . . . . . . . . . . . . . . . 7

Captulo 3. Clculos Avanados para Dados de Negcios . . . . . . . . . . . . . . 41

Captulo 4. Organizando Objetos em Aplicativos do TM1 . . . . . . . . . . . . . . 71

Captulo 5. Importando Dados com Planilhas de Processamento. . . . . . . . . . . 95

IBM Cognos TM1 Verso 10.1.0: Guia para Desenvolvedores

Viso Geral de Planilhas de Processamento . . . . . . . . . . . . . . . . . . . . . . . . . 95

Captulo 6. Controlando o Acesso de Objetos do TM1 . . . . . . . . . . . . . . . 105

Captulo 7. Usando os Botes de Ao do TM1 para Construir Aplicativos de

Modificando um Boto de Ao Existente . . . . . . . . . . . . . . . . . . . . .

Captulo 8. Desenvolvendo Aplicativos da Web Customizados com a API da URL . . . 139

Captulo 9. Usando Reservas de Dados . . . . . . . . . . . . . . . . . . . . . 163

IBM Cognos TM1 Verso 10.1.0: Guia para Desenvolvedores

Gerenciando Reservas de Dados com as Funes da Interface de Programao de Aplicativos do TM1

Apndice A. Funes do Excel Suportadas - TM1 Web . . . . . . . . . . . . . . 185

Apndice B. Funes do Excel No Suportadas - TM1 Web . . . . . . . . . . . . 197

de Banco de Dados e de Gerenciamento de Listas .

IBM Cognos TM1 Verso 10.1.0: Guia para Desenvolvedores

Termo de responsabilidade das amostras

Copyright IBM Corp. 2007, 2012

IBM Cognos TM1 Verso 10.1.0: Guia para Desenvolvedores

Captulo 1. Introduo ao TM1 Development

Copyright IBM Corp. 2007, 2012

Suponha que voc seja o vice-presidente de vendas e precise comparar

Reorganizando a visualizao, possvel comparar vendas em dlares para o

IBM Cognos TM1 Verso 10.1.0: Guia para Desenvolvedores

Sua Funo como Desenvolvedor

Compreendendo as Convenes de Nomenclatura de Objeto do TM1

Captulo 1. Introduo ao TM1 Development

Ao gravar regras com construes "!dimension-name", no use nenhum dos

Excees de Nomenclatura de Objeto

IBM Cognos TM1 Verso 10.1.0: Guia para Desenvolvedores

Comprimento Mximo de Sequncia para Diretrios de Dados e

Distino entre Maisculas e Minsculas

Captulo 1. Introduo ao TM1 Development

Espaos em Nomes de Objetos

IBM Cognos TM1 Verso 10.1.0: Guia para Desenvolvedores

Captulo 2. Criando Cubos e Dimenses

Copyright IBM Corp. 2007, 2012

Selecionando o Nmero de Dimenses

Esta diferena em dimensionalidade sugere dois cubos:

Cubo de Cinco Dimenses

IBM Cognos TM1 Verso 10.1.0: Guia para Desenvolvedores

Cubo de Quatro Dimenses

Consolidando Detalhe Usando Hierarquias da Dimenso

Captulo 2. Criando Cubos e Dimenses

Usando hierarquias da dimenso, possvel agregar facilmente dados numricos em

Navegando em uma Hierarquia da Dimenso

Usando Pesos para Express ar Consolidaes

IBM Cognos TM1 Verso 10.1.0: Guia para Desenvolvedores

Criando Vrias Rolagens em uma Dimenso

Captulo 2. Criando Cubos e Dimenses

Criando Clculos Complexos

Identificar o detalhe de nvel mais baixo em uma dimenso. Em um

Agregaes de detalhe de nvel mais baixo. Por exemplo, voc pode

Armazena sequncias de texto em clulas. Para incluir uma sequncia

IBM Cognos TM1 Verso 10.1.0: Guia para Desenvolvedores

v Listar recursos de elementos. Por exemplo, a metragem de uma loja e o tamanho

Atributos de Formato de Exibio

Os nmeros aparecem com um nmero

Os nmeros aparecem como porcentagens, com

Captulo 2. Criando Cubos e Dimenses