Usar Variáveis de Substituição

Use variáveis de substituição nos scripts de cálculo do Essbase para armazenar valores que podem ser alterados. Use variáveis de substituição de runtime quando precisar de usuários diferentes para especificar valores diferentes para o mesmo script.

Por exemplo, se uma variedade de scripts de cálculo, fórmulas, filtros, scripts de relatório e scripts MDX precisarem consultar o mês atual, você não vai querer pesquisar e substituir o mês aproximadamente a cada 30 dias em toda a sua biblioteca de artefatos de cubos. Em vez disso, é possível definir uma variável de substituição chamada CurrMonth e alterar seu valor designado todo mês para o mês apropriado. Todos os artefatos de cubo que fizerem referência à variável o farão ao mês apropriado.

Este é um exemplo de variável de substituição simples para representar o mês atual:

Nome da variável: CurrMonth

Valor: Jan

Os valores de variáveis de substituição se aplicam a todos os usuários que executam um script de cálculo contendo a variável. Por exemplo, se CurrMonth tiver o valor Jan, todos os scripts que contiverem &CurrMonth serão executados para Jan. O escopo de uma variável de substituição pode ser:

  • global (para todos os aplicativos e cubos no servidor)
  • aplicativo (para todos os cubos no aplicativo)
  • cubo (para um único cubo)

Para definir ou atualizar uma variável de substituição para um cubo específico,

  1. Na página Aplicativos, abra o aplicativo e, em seguida, abra o banco de dados (cubo).
  2. Clique em Personalização e em Variáveis.
  3. Para criar uma nova variável, clique em Criar, digite o nome e o valor da variável e clique em SalvarImagem do ícone Salvar (marca de verificação) na caixa de diálogo Variáveis..
  4. Se você estiver editando o valor de uma variável existente, clique duas vezes no valor (ou clique em Editar), digite o valor atualizado e pressione Enter (ou clique em Salvar).
  1. Na interface web do Essbase, na página Aplicativos, expanda o aplicativo para mostrar o cubo que você deseja modificar.
  2. No menu Ações à direita do cubo, inicie o inspetor.
  3. Selecione a guia Variáveis.
  4. Para criar uma nova variável, clique em AdicionarImagem do ícone Adicionar., digite o nome e o valor da variável e clique em Salvar.
  5. Se você estiver editando o valor de uma variável existente, clique duas vezes no campo Valor, digite o valor atualizado e pressione Enter.
  6. Clique em Fechar.

Para definir ou atualizar uma variável de substituição para um aplicativo específico,

  1. Na página Aplicativos, abra o aplicativo.
  2. Clique em Personalização e em Variáveis.
  3. Para criar uma nova variável, clique em Criar, informe o nome e o valor da variável e clique em SalvarImagem do ícone Salvar (marca de verificação) na caixa de diálogo Variáveis..
  4. Se você estiver editando o valor de uma variável existente, clique duas vezes no valor (ou clique em Editar), digite o valor atualizado e pressione Enter (ou clique em Salvar).
  1. Na página Aplicativos, no menu Ações à direita do aplicativo, inicie o inspetor.
  2. Selecione a guia Variáveis.
  3. Para criar uma nova variável, clique em AdicionarImagem do ícone Adicionar., informe o nome e o valor da variável e clique em Salvar.
  4. Se você estiver editando o valor de uma variável existente, clique duas vezes no campo Valor, digite o valor atualizado e pressione Enter.
  5. Clique em Fechar.

Para definir ou atualizar uma variável de substituição globalmente,

  1. Na página Aplicativos, clique em Console.
  2. Clique no mosaico Variáveis.
  3. Para criar uma nova variável, clique em Criar, digite o nome e o valor da variável e clique em SalvarImagem do ícone Salvar (marca de verificação) na caixa de diálogo Variáveis..
  4. Se você estiver editando o valor de uma variável existente, clique duas vezes no valor (ou clique em Editar), digite o valor atualizado e pressione Enter (ou clique em Salvar).
  1. Na interface web do Interface Web do Essbase, clique em Console.
  2. Clique na guia Variáveis.
  3. Para criar uma nova variável, clique em Adicionar, digite o nome e o valor da variável e clique em Salvar.
  4. Se você estiver editando o valor de uma variável existente, clique duas vezes no campo Valor, digite o valor atualizado e pressione Enter.

Uma vez definida sua variável de substituição, você poderá usá-la em scripts de cálculo, fórmulas, filtros, scripts MDX, regras de carregamento e relatórios. Para referenciar a variável, prefixe-as com o símbolo &.

Este é um exemplo de script de cálculo que faz referência a uma variável de substituição:

FIX(&CurrMonth)
   CALC DIM (Measures, Product);
ENDFIX

Este é um exemplo de fórmula que faz referência a uma variável de substituição:

@ISMBR(&CurrMonth)

Variáveis de substituição de runtime permitem que você declare variáveis e seus valores no contexto de uma ação de runtime, como um script de cálculo, um script MaxL ou uma consulta MDX. As variáveis de substituição de runtime podem ser designadas para ter valores numéricos ou fazer referência a nomes de membros. Um valor padrão pode ser designado no caso de um usuário não alterar um valor de entrada. Além disso, para scripts de cálculo, o valor da variável pode ser preenchido no runtime com base nos membros de uma dimensão apresentada em uma grade do Smart View. Para scripts de cálculo com valores de variáveis que são preenchidos no runtime, inicie o script de cálculo no Smart View, já que a variável não tem definição fora do contexto da grade.

As variáveis de substituição do runtime podem ser definidas no script de cálculo usando pares de chave/valor:

SET RUNTIMESUBVARS
{
   myMarket = "New York";
   salesNum = 100;
   pointD = "Actual"->"Final";
}

Ou, para definir variáveis de substituição de runtime com valores que mudam dinamicamente dependendo do POV, designe a definição para POV e use a sintaxe XML para ativar prompts contextuais do Smart View.

Para obter mais informações, consulte