Pré-valide o outline do Essbase para garantir que o seu aplicativo seja compatível com uma versão do Essbase Híbrido.
Como parte de uma iniciativa para fazer upgrade de todos os ambientes para uma versão do Oracle Essbase com suporte para cubos BSO (Opção de Armazenamento em Blocos), a Oracle acrescentou um processo para pré-validar outlines do Essbase para garantir uma transição otimizada quando o seu ambiente for atualizado para uma versão do Essbase Híbrido.
Note:
Para obter informações sobre versões do Essbase, consulte Sobre o Essbase no Cloud EPM no Guia de Princípios Básicos para Administradores.
Para garantir que o seu aplicativo seja compatível com uma versão do Essbase Híbrido, implementamos um novo utilitário que verifica as fórmulas do membro no seu ambiente e fornece um relatório para que você possa corrigir quaisquer problemas.
O utilitário pode ser iniciado manualmente e será executado automaticamente durante a atualização do banco de dados:
Para obter informações sobre como iniciar manualmente o utilitário, consulte Inicialização Manual do Processo de Pré-validação.
Para obter informações sobre a inicialização automática durante a atualização do banco de dados, consulte Pré-validação Automática Durante Atualização do Banco de Dados.
Se forem encontrados erros após o utilitário concluir a verificação das fórmulas do membro, você poderá ver o Relatório de Pré-validação do Outline e corrigir os erros encontrados. Se nenhum erro for encontrado, nenhuma ação adicional será necessária.
Para obter uma lista de erros de pré-validação de exemplo e resoluções recomendadas, consulte as seções abaixo:
Inicialização Manual do Processo de Pré-validação
Para iniciar manualmente o processo de pré-validação, selecione as seguintes opções na opção de menu Validação de Outline do Essbase no menu Ações na página Visão Geral do aplicativo:
Pré-validar Outline: Efetua uma validação do seu aplicativo
Relatório de Pré-validação de Outline: Exibe uma lista de fórmulas do membro que precisam ser corrigidas para serem compatíveis com a versão do Essbase Híbrido
Note:
A opção de menu Validação de Outline do Essbase é exibida apenas se o seu ambiente estiver em uma versão do Essbase não Híbrido. Se o seu ambiente estiver em uma versão do Essbase Híbrido, a opção de menu Validação de Outline do Essbase não estará mais disponível.
Outra forma de verificar se o seu ambiente está em uma versão do Essbase Híbrido ou não Híbrido é exibir o valor de Versão do Essbase oferece suporte para a Opção de Armazenamento em Blocos Híbridos no Relatório da Atividade. Se o valor for Sim, isso significa que o seu ambiente está em uma versão do Essbase Híbrido. Se o valor for Não, isso significa que o seu ambiente está em uma versão do Essbase não Híbrido.
Para validar o outline do Essbase no seu ambiente e corrigir erros encontrados em fórmulas do membro:
Na página Inicial, clique em Aplicativo e em Visão Geral.
Clique em Ações, selecione a Validação do Outline do Essbase e selecione entre as seguintes opções:
Selecione Pré-validar Outline para efetuar a validação.
Para exibir e fazer download de um relatório de erros encontrados durante a validação, selecione Relatório de Pré-validação do Outline.
Após corrigir as fórmulas do membro, você pode usar a opção Pré-validar Outline novamente para confirmar que todos os problemas foram resolvidos.
Note:
Depois de corrigir as fórmulas do membro, certifique-se de atualizar o banco de dados antes de exibir o relatório de pré-validação novamente, caso contrário, o relatório não mostrará que todos os erros foram resolvidos.
Pré-validação Automática Durante Atualização do Banco de Dados
Se o sistema detectar que seu ambiente usa uma versão não híbrida do Oracle Essbase e precisar ser atualizado para o Essbase híbrido, o utilitário de validação será iniciado automaticamente no final do processo Atualizar Banco de Dados.
Se forem descobertos erros na fórmula do membro durante o processo de validação, você verá um aviso solicitando a revisão do relatório e a correção de todos os erros. Clique em Exibir Relatório de Pré-validação do Outline para ver o relatório completo e resolver os erros.
Como Tratar Erros de Validação
A validação do outline pode revelar erros como os listados abaixo. Trate esses problemas usando as recomendações fornecidas e execute novamente o processo de validação até que todos os erros sejam resolvidos.
| Categoria do Erro | Recomendações |
|---|---|
| ELSE ou ENDIF sem IF | A fórmula do membro utiliza if, elseif, else, e endif cria, mas há mais tokens de endif que tokens de if ou o else e os tokens de if não são correspondentes. O número de tokens de if deve corresponder ao número de tokens de endif or else, garantindo o agrupamento adequado. Corrija a fórmula tratando os problemas de sintaxe. |
| Tipo de Dados Inválido ou tipo esperado NUMBER encontrado STRING | A fórmula do membro refere-se a um membro não existente. Revise a fórmula e remova o membro inexistente dela. |
| Tipo de Retorno da Expressão Inválido | A fórmula do membro refere-se a um membro não existente. Revise a fórmula e remova o membro inexistente dela. |
| Detectadas Aspas Não Correspondentes | A fórmula contém aspas não correspondentes. Certifique-se de que o número de aspas de abertura e fechamento sejam iguais e agrupadas corretamente. Corrija a fórmula resolvendo erros de sintaxe. |
| Nada a ser feito | A fórmula do membro é comentada usando /* e */. Como o membro é dinâmico, ele deve ter uma fórmula válida. Insira uma fórmula de membro válida para o membro ou altere a propriedade do membro. |
| Erro de Parênteses | A fórmula tem parênteses não correspondentes. Certifique-se de que o número de parênteses de abertura e fechamento esteja equilibrado e agrupado corretamente. Corrija a fórmula resolvendo erros de sintaxe. |
| A Variável de Substituição não existe | A fórmula do membro faz referência a uma Variável de Substituição inexistente. Crie a Variável de Substituição com um valor apropriado para garantir a validação bem-sucedida da fórmula. |
| Erro de Sintaxe na Consulta MDX | Para corrigir erros de sintaxe, consulte Sintaxe de MDX e Regras Gramaticais. |
| Faltando Ponto e vírgula
ou Fim da Expressão Inesperado |
A fórmula do membro não termina com ponto e vírgula.
A fórmula pode retornar um valor, porém a ausência de um ponto e vírgula final é um erro de sintaxe. Revise e corrija a fórmula. |
| Nome de Membro Desconhecido usado na função | A fórmula do membro faz referência a um membro não existente. Revise e atualize a fórmula para remover quaisquer referências a membros que não existam. |
| A Variável de Ambiente não existe | A fórmula refere-se a uma variável de ambiente. Não é possível criar uma variável de ambiente nos aplicativos Oracle Fusion Cloud Enterprise Performance Management. Crie uma variável de substituição com o mesmo nome e valor da variável de ambiente e use-a na fórmula. |
| Erro de Análise da Fórmula | A fórmula do membro faz referência a um nome de membro que não está entre aspas ou a fórmula não termina com ponto e vírgula. Além disso, o nome do membro pode incluir palavras-chave ou nomes de funções, como para, ano e soma que não são permitidos na fórmula.
Certifique-se de que o nome do membro esteja corretamente entre aspas e que a fórmula termine com ponto e vírgula. Verifique também se existe um membro com esse nome no sistema. |
| Membro Desconhecido Usado na Consulta | Para um cubo ASO, a fórmula do membro se refere a um membro inexistente na consulta de MDX. Além disso, certifique-se de que os nomes das dimensões, membros e dimensões de atributos não contenham o caractere / (barra). |
| Nome do Membro Duplicado | A fórmula do membro refere-se a um membro não existente. Revise a fórmula e remova os membros inexistentes dela. |
| Atribuição Inválida | Atribuição inválida: O valor no lado esquerdo do sinal de igual deve ser um membro ou variável.
Na fórmula do membro, o lado esquerdo da operação de atribuição usando o sinal de igual (=) deve ser o nome de um membro existente. Certifique-se de que o lado esquerdo da atribuição seja um nome de membro válido. |
| Erro do Operador | A fórmula do membro contém if, aninhados incorretamente elseif ou construções de endif, resultando resultando em aninhamento incorreto e desbalanceado. Revise e corrija a fórmula para tratar estes problemas de sintaxe. |
| Erro de Função | A fórmula do membro usa funções, mas parâmetros extras foram informados. Se a função envolver variáveis de substituição do Planning, certifique-se de que essas variáveis estejam disponíveis e tenham valores, que não devem começar com o caractere (&). Além disso, revise a fórmula para remover quaisquer símbolos & extras antes das variáveis de substituição. Certifique-se de que cada variável de substituição na fórmula tenha um único & antes de seu nome para uma resolução adequada. |
| Expressão Ausente | Revise e corrija a fórmula para remover os erros de sintaxe relacionados às expressões. |
Exemplo de Erros de Validação
Nestes exemplos, [MEMBER_NAME] indica o nome do membro que causou falha na validação.
Exemplos de erros de verificação de fórmula: nome do membro, membro desconhecido, ponto e vírgula ausente, fim de expressão, etc.:
Exemplo de erros de verificação de fórmula: exemplo de variáveis de substituição:
Falha na verificação da fórmula do membro [MEMBER_NAME]. A variável de substituição [[MEMBER_NAME]] não existe
Exemplo de erro de verificação da fórmula: parêntesis:Falha na verificação da fórmula do membro [MEMBER_NAME]. Erro ao compilar a fórmula para [] (linha 1): [)] sem [(]
Exemplo de erro de verificação da fórmula: tipo de dados inválido, tipo de retorno e atribuição: