Sintaxe de fórmula para regras de cálculo personalizadas

Este tópico descreve a sintaxe a ser usada na criação de regras de cálculo personalizadas.

A sintaxe é resumida da seguinte forma:

  • O formato básico da fórmula é Resultado igual à Fórmula, onde Resultado e Fórmula são separados por: =. Portanto Resultado := Fórmula.

  • O lado esquerdo da equação é o Resultado; uma tupla determina onde os resultados calculados personalizados são gravados.

    Note:

    Uma tupla é uma lista de membros separados por vírgula incluídos entre parênteses.

    A tupla é uma especificação MDX de um ou mais membros onde não há dois membros na mesma direção. Só são aceitos nomes de membros na expressão da tupla. Funções de membros não são suportadas para cálculos personalizados. Os membros dinâmicos e de atributo não são permitidos no Resultado. O Resultado deve incluir um único membro da dimensão de Resultado. Ele deve ser de Nível 0 e pode fazer parte de uma tupla de Nível 0, como ([STA1120],[Feb]). A dimensão Resultado é definida na guia Destino da página Regra Personalizada.

    Note:

    MDX é uma especificação de união do XML para membros de fundação da Análise. Para obter mais informações sobre a sintaxe MDX permitida, consulte o Capítulo 7, "MDX" do Oracle Essbase Technical Reference.

  • O lado direito da equação é a Fórmula, uma expressão de valor numérico MDX simples. Ele inclui os outros membros, tuplas ou constantes em qualquer nível e a expressão matemática a ser executada. Ela deve conter pelo menos um membro da dimensão de Resultado e pode ser de Nível 0, nível superior ou uma tupla.

    Note:

    Os membros nos dois lados da equação devem estar incluídos entre colchetes, [ ].

    As tuplas devem estar incluídas entre parênteses, ( ).

    A expressão da Fórmula deve terminar com um ponto-e-vírgula, ;.

    A Fórmula pode usar o seguinte:

    • Constantes: [STAT1120]:=1;

      Note:

      Uma constante pode ser uma constante numérica como 7. Ela pode ser uma expressão que faça referência a valores de outros membros na dimensão de resultado e pode fazer referência a valores expressos como tuplas de membros.

    • Uma operação matemática: [STAT1114]:=([STAT1305],[Rule])*([STAT1307],[Rule]);

      Note:

      As operações matemáticas devem sempre incluir um membro de dimensão de Regra.

  • As regras de cálculo personalizado aceitam os seguintes formatos de sintaxe para nomes de membro:

    • Sem qualificação: somente o nome do membro é fornecido.

      Exemplo: [MemberName]

    • Qualificação total: o nome totalmente qualificado (FQN) do membro.

      Exemplo: [Dimension].[Gen2].[Gen3].[Gen4]...[MemberName]

  • Regras de cálculo personalizadas são compatíveis com a seguinte sintaxe para variáveis de substituição:
    • O nome da variável de substituição deve ser escrito entre colchetes ([]) e começar com um & (E comercial) na fórmula.

      Exemplo de Fórmula: ([Rule1],[PCM_Adjustment In]) := ([PCM_Input],[PCM_Rule], [&Prior_Year]) *.10;

    • Não use colchetes para incluir a variável de substituição.

      Valor correto de variável: 2022

      Valor incorreto de variável: [2022]

Note:

Para obter informações sobre como otimizar o desempenho ao definir regras de cálculo personalizado, consulte Como Ignorar Tuplas para Otimizar Cálculos Personalizados.