Pré-valide o outline do Essbase para garantir a compatibilidade do seu aplicativo com uma versão do Essbase Híbrido.
Como parte do objetivo de atualizar todos os ambientes para uma versão do Oracle Essbase que ofereça suporte a cubos com Opção de Armazenamento em Blocos (BSO) Híbrido, a Oracle adicionou um processo que pré-valida os outlines do Essbase e garante uma transição tranquila ao atualizar o ambiente 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.
A fim de garantir a compatibilidade do seu aplicativo com uma versão do Essbase Híbrido, implementamos um novo utilitário que verifica as fórmulas de membros no ambiente e fornece um relatório para a correção dos eventuais erros.
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 o utilitário manualmente, 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 depois que o utilitário concluir a verificação das fórmulas de membros, você poderá visualizar o Relatório de Pré-validação de 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: Executa 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 do Outline do Essbase é exibida somente quando o ambiente está 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 do Outline do Essbase não estará 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 A versão do Essbase oferece suporte a Armazenamento em Bloco Híbrido no Relatório de 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 os erros encontrados em fórmulas do membro:
Na página Inicial, clique em Aplicativo e em Visão Geral.
Clique em Ações, selecione Validação do Outline do Essbase e depois selecione uma das seguintes opções:
Para executar a validação, selecione Pré-validar Outline.
Para exibir e fazer download do relatório dos 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.
Para atualizar o banco de dados, consulte Atualização dos Bancos de Dados de Aplicativo.
Se forem descobertos erros na fórmula do membro durante o processo de validação, você verá um aviso informando que precisa revisar o relatório e corrigir 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: