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:
Para definir ou atualizar uma variável de substituição para um cubo específico,
Para definir ou atualizar uma variável de substituição para um aplicativo específico,
Para definir ou atualizar uma variável de substituição globalmente,
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
> Gallery > Technical > Calc
.