Substituição de variável de parâmetro

As variáveis de parâmetro são usadas em comandos para representar o contexto específico ou os elementos que são substituídos no tempo de execução por um valor específico do contexto e das configurações atuais. As variáveis de parâmetro são validadas no tempo de execução, portanto todas as variáveis são permitidas ao criar macros, serviços de interface e regras de cálculo ou parâmetros de planilha. Para regras de cálculo, as variáveis são substituídas antes de criar essas regras (para o período de ciclo) no Infor BI OLAP na criação inicial ou ao retomar uma regra usando a opção Atualizar.

Nota:

As variáveis não diferenciam maiúsculas e minúsculas
Apenas uma variável pode ser permitida por parâmetro quando usada para a funcionalidade de macro
O formato usado para variáveis de aplicativo é app_var_VarName
As variáveis de aplicativo são declaradas em um nível de sistema e podem ser substituídas em um nível de ciclo
As variáveis de aplicativo são variáveis de tempo de execução e podem ser substituídas pela versão do ciclo atual.

Para ver os detalhes do parâmetro, consulte Variável de parâmetro.

Os parâmetros de contexto (%itemcontext%, %locationcontext%, %periodcontext%) têm estas propriedades quando mapeadas nos comandos de macro:

As variáveis selecionam os valores de contexto atuais quando você executa uma macro de uma planilha.
Nota:
- Se a macro for executada usando a opção Executar macro na barra de ferramentas da planilha principal, o contexto de dados do módulo atual será usado.
- Se a macro for executada usando uma opção Macro na planilha atual, o contexto de dados da planilha atual para essa dimensão será usado.
Ao executar uma macro que não seja a partir das planilhas, por exemplo a partir da página Detalhes do período de ciclo ou Detalhes do cenário, não é possível substituir nenhum valor e a macro falha.

O parâmetro de contexto (%measurecontext%) tem estas propriedades quando mapeadas nos comandos de macro:

A variável seleciona os valores de contexto atuais quando você executa uma macro de uma planilha.
Nota:
- Se a macro for executada usando a opção Executar macro na barra de ferramentas da planilha principal ou se nenhum contexto de medida tiver sido transmitido para uma planilha, não será possível substituir nenhum valor e a macro poderá falhar.
- Se a macro for executada usando uma opção Macro no painel de destino de uma planilha com vários painéis, o contexto da medida da planilha atual será usado.
Ao executar uma macro que não seja a partir das planilhas, por exemplo, a partir da página Detalhes do período de ciclo ou Detalhes do cenário, não é possível substituir nenhum valor e a macro falha.

Quando os parâmetros de contexto (%cyclecontext%, %cycleperiodcontext%, %scenariocontext% e %modelcontext%) são convertidos a partir do contexto de macro:

Uma macro CyclePeriod tem cyclecontext e cycleperiodcontext.
Uma macro de período de ciclo contendo o comando RunScenarioMacro pode usar o scenariocontext quando executado a partir de uma planilha.
Nota:
- Se a macro for executada usando a opção Executar macro na barra de ferramentas da planilha principal, o contexto de dados do módulo atual/predominante será usado.
- Se a macro for executada usando uma opção Macro na planilha atual, será usado o contexto de dados da planilha atual/predominante (% scenariocontext%). Por exemplo, o contexto transmitido a partir de um link de painel (se aplicável) ou o contexto de dados do módulo.
Uma macro de Cenário possui cyclecontext, cycleperiodcontext e scenariocontext. O scenariocontext depende do processo de inicialização da macro:
- Se uma macro de cenário for executada a partir da página Detalhes do período de ciclo ou Detalhes do cenário, o contexto de cenário atual será usado.
- Se a macro for executada a partir da opção Executar macro na barra de ferramentas da planilha principal, o contexto de dados do módulo atual será usado.
- Se a macro for executada a partir de uma opção Macro na planilha atual, o contexto da planilha atual (%scenariocontext%) será usado.
Uma macro do sistema contendo o comando RunCyclePeriodMacro pode usar o cyclecontext, cycleperiodcontext, quando executado a partir de uma planilha.
Uma macro do sistema contendo o comando RunScenarioMacro pode usar o cyclecontext, cycleperiodcontext e scenariocontext quando executado a partir de uma planilha.
- Se a macro for executada a partir da opção Macro na planilha atual, o contexto da planilha atual (%scenariocontext%) será usado. Por exemplo, o contexto transmitido a partir de um link de painel (se aplicável) ou o contexto de dados do módulo.
Uma macro do sistema contendo o comando RunASMacro pode utilizar o modelcontext quando executado a partir dos detalhes do Modelo de programação avançado.
Outros comandos de macro do sistema não contêm um contexto. Portanto, não é possível substituir nenhum valor e a macro falha.

Para os parâmetros %previouscycleperiod-Startdate% e %previouscycleperiod-Enddate%, se não houver um período de ciclo anterior, será usado o %horizon-start% (o primeiro período disponível).

Os parâmetros inválidos para a função em execução resultam no encerramento do programa e uma mensagem de erro é exibida.