Implementar Variáveis para Alterar Informações

Você pode usar variáveis de substituição do Essbase como espaços reservados para alterar informações regularmente. Como as alterações em um valor de variável são refletidas em todos os lugares em que a variável é usada, a necessidade de fazer atualizações manuais é minimizada.

Por exemplo, muitos relatórios dependem de períodos de relatório; se você gerar um relatório com base no mês atual, deverá atualizar o script de relatório manualmente a cada mês. Com uma variável de substituição, como CurMnth, definida no Essbase Server, você pode alterar o valor atribuído a cada mês para o período apropriado. Quando você usa o nome da variável em um script de relatório, as informações são atualizadas dinamicamente quando você executa o relatório final.

Você pode usar variáveis de substituição com aplicativos de armazenamento agregado (ASO) e armazenamento em blocos (BSO) (a menos que indicado de outra forma) nas seguintes áreas:

  • Agregar fórmulas de resumo de armazenamento

  • Fórmulas de outline de armazenamento em blocos

  • Scripts de cálculo (somente bancos de dados de armazenamento em blocos)

    As variáveis de substituição e as variáveis de substituição de runtime são suportadas nos scripts de cálculo.

  • Definições de cabeçalho do arquivo de regras de carregamento de dados e definições de campo. Você pode informar nomes de variáveis para nomes de dimensão e membro.

  • Especificações do nome da origem de dados (DSN) em arquivos de regras para origens de dados SQL

  • Cláusulas SELECT, FROM ou WHERE em arquivos de regras para origens de dados SQL

  • Filtros de segurança

  • consultas MDX

  • Smart View

  • Scripts de relatório

É possível definir variáveis de substituição nestes níveis:

  • Globalmente: Fornece acesso à variável de todos os aplicativos e bancos de dados no Essbase Server.

  • Aplicativo: Fornece acesso à variável de todos os bancos de dados dentro do aplicativo.

  • Banco de Dados: Fornece acesso à variável dentro do banco de dados especificado.

Nomes e Valores de Variáveis de Substituição Permitidos

Quando você usa variáveis de substituição no Essbase, siga as diretrizes relativas aos caracteres e tipos de dados que você pode usar em nomes e valores de variáveis de substituição.

As seguintes restrições se aplicam a nomes e valores de variáveis de substituição:

Caracteres permitidos no nome da variável

Caracteres alfanuméricos e sublinhados são permitidos, mas não caracteres especiais ou espaços. Limite de caracteres: consulte Limites.

Caracteres permitidos no valor de variável

Qualquer caractere é permitido, exceto um E comercial à esquerda (&). Limite de caracteres: consulte Limites.

Nomes de membro do Essbase usados como valores de variável

Inclua nomes de membros que comecem com um número ou contenham qualquer caractere especial entre aspas (" ") para bancos de dados de armazenamento em blocos e entre parênteses ([ ]) para bancos de dados de armazenamento agregado. Para obter mais detalhes, consulte Convenções de Nomeação em Scripts de Cálculo, Scripts de Relatório, Fórmulas, Filtros e Valores da Variável de Substituição e Ambiente.

Para definir um valor de variável de substituição como um nome de membro duplicado, use o nome de membro qualificado entre aspas duplas; por exemplo, um valor para &Period pode ser "[2022].[Qtr1]".

Não use um nome de variável de substituição como parte de um nome de membro qualificado. Por exemplo, é inválido especificar "[2022].[&CurrentQtr]".

Números usados como valores variáveis

Coloque os valores numéricos entre aspas (" ") para bancos de dados de armazenamento em blocos (BSO) e entre parênteses ([ ]) para bancos de dados de armazenamento agregado (ASO).

Por exemplo, se o nome da variável for Mês e seu valor for 01, para armazenamento em blocos, defina o valor como "01". Para armazenamento agregado, defina o valor como [01].

Várias variáveis com o mesmo nome

As variáveis podem ter o mesmo nome desde que sejam definidas em diferentes escopos. A precedência da resolução de variáveis funciona da seguinte forma: a variável do banco de dados é resolvida antes da variável do aplicativo. A variável do aplicativo é resolvida antes da variável global.

Criar ou Definir Variáveis de Substituição

Antes de definir uma variável de substituição, consulte Nomes e Valores de Variáveis de Substituição Permitidos.

Você pode criar ou definir variáveis de substituição no nível do Essbase Server, do aplicativo ou do banco de dados.

Para garantir que um novo valor de variável de substituição esteja disponível em fórmulas, definições de partição e filtros de segurança, interrompa e reinicie o aplicativo. Todos os outros usos de variáveis de substituição são resolvidos dinamicamente quando usados.

Quando você adiciona ou atualiza variáveis de substituição, elas são enviadas ao aplicativo e resolvidas dinamicamente.

Para definir uma variável de substituição usando a interface Web do Essbase, consulte Usar Variáveis de Substituição. Você também pode usar uma pasta de trabalho do aplicativo para definir variáveis no nível do aplicativo ou usar as seguintes instruções MaxL:

Remover Variáveis de Substituição

Talvez você queira excluir uma variável de substituição do Essbase que não seja mais necessária.

Para excluir uma variável de substituição, você pode removê-la da pasta de trabalho do aplicativo e criar o cubo, excluí-la usando a interface Web do Essbase ou usar estas instruções MaxL:

Atualizar Variáveis de Substituição

Como as variáveis de substituição são placeholders para alterar informações, talvez seja necessário atualizar os valores com frequência. É possível modificar variáveis de substituição existentes usando MaxL ou a interface Web do Essbase.

Para atualizar uma variável de substituição, você pode usar uma destas instruções MaxL (a qual delas usar depende do contexto da sua variável):

Se você preferir usar a interface Web do Essbase para atualizar uma variável, consulte Usar Variáveis de Substituição para obter instruções.