Sustitución de variables de parámetro

Las variables de parámetro se utilizan en comandos para representar el contexto o los elementos específicos que se sustituyen en tiempo de ejecución por un valor específico del contexto y la configuración actuales. Las variables de parámetro se validan en tiempo de ejecución, por lo tanto, se permiten todas las variables al crear macros, servicios de interfaz y reglas de cálculo o parámetros de hoja de trabajo. En el caso de las reglas de cálculo, las variables se sustituyen antes de crear estas reglas (para el período de ciclo) en Infor BI OLAP en la creación inicial o al reanudar una regla mediante la opción Actualizar.
Nota: 
  • Las variables no distinguen entre mayúsculas y minúsculas.
  • Solo se puede permitir una variable por parámetro cuando se usa en la funcionalidad de la macro.
  • El formato utilizado para las variables de aplicación es app_var_VarName.
  • Las variables de aplicación se declaran a nivel de sistema y se pueden anular a nivel de ciclo.
  • Las variables de aplicación son variables en tiempo de ejecución y se pueden sustituir por la versión del ciclo actual.

Para obtener detalles sobre los parámetros, consulte Variables de parámetro.

Los parámetros de contexto (%itemcontext%, %locationcontext%, %periodcontext%) tienen estas propiedades cuando se asignan en los comandos de macro:

  • Las variables recogen los valores de contexto actuales cuando se ejecuta una macro desde una hoja de trabajo.
    Nota: 
    • Si la macro se ejecuta mediante la opción Ejecutar macro de la barra de herramientas de la hoja de trabajo principal, se utiliza el contexto de datos del módulo actual.
    • Si la macro se ejecuta mediante la opción Macro en la hoja de trabajo actual, se utiliza el contexto de datos de la hoja de trabajo actual para esa dimensión.
  • Si una macro no se ejecuta desde las hojas de trabajo, sino desde las páginas Detalles de período de ciclo o Detalles de escenario, por ejemplo, no se puede sustituir ningún valor y la macro falla.

El parámetro de contexto (%measurecontext%) tiene las siguientes propiedades cuando se asignan en comandos de macro:

  • La variable recoge los valores de contexto actuales cuando se ejecuta una macro desde una hoja de trabajo.
    Nota: 
    • Si la macro se ejecuta mediante la opción Ejecutar macro de la barra de herramientas de la hoja de trabajo principal o si no se ha pasado ningún contexto de medida a una hoja de trabajo, no se puede sustituir ningún valor y la macro falla.
    • Si la macro se ejecuta mediante la opción Macro en el panel de destino de una hoja de trabajo multipanel, se utiliza el contexto de medida de la hoja de trabajo actual.
  • Si una macro no se ejecuta desde las hojas de trabajo, sino desde las páginas Detalles de período de ciclo o Detalles de escenario, por ejemplo, no se puede sustituir ningún valor y la macro falla.

Cuando los parámetros de contexto (%cyclecontext%, %cycleperiodcontext%, %scenariocontext% and %modelcontext%) salen del contexto de la macro:

  • Una macro CyclePeriod cuenta con cyclecontext y cycleperiodcontext.
  • Una macro de período de ciclo que contiene el comando RunScenarioMacro puede utilizar el valor scenariocontext cuando se ejecuta desde una hoja de trabajo.
    Nota: 
    • Si la macro se ejecuta mediante la opción Ejecutar macro de la barra de herramientas de la hoja de trabajo principal, se utiliza el contexto de datos del módulo actual/anterior.
    • Si la macro se ejecuta mediante la opción Macro en la hoja de trabajo actual, se utiliza el contexto de datos (%scenariocontext%) de la hoja de trabajo actual/anterior. Por ejemplo, contexto pasado desde un vínculo de panel (si procede) o el contexto de datos del módulo.
  • Una macro de escenario cuenta con cyclecontext, cycleperiodcontext y scenariocontext. El valor scenariocontext depende del proceso de inicio de la macro:
    • Si se ejecuta una macro de escenario desde las páginas Detalles de período de ciclo o Detalles de escenario, se utiliza el contexto de escenario actual.
    • Si la macro se ejecuta desde la opción Ejecutar macro de la barra de herramientas de la hoja de trabajo principal, se utiliza el contexto de datos del módulo actual.
    • Si la macro se ejecuta desde la opción Macro en la hoja de trabajo actual, se utiliza el contexto de la hoja de trabajo actual (%scenariocontext%).
  • Una macro de sistema que contiene el comando RunCyclePeriodMacro puede utilizar cyclecontext o cycleperiodcontext, cuando se ejecuta desde una hoja de trabajo.
  • Una macro de sistema que contiene el comando RunScenarioMacro puede utilizar cyclecontext, cycleperiodcontext y scenariocontext, cuando se ejecuta desde una hoja de trabajo.
    • Si la macro se ejecuta desde la opción Macro en la hoja de trabajo actual, se utiliza el contexto de la hoja de trabajo actual (%scenariocontext%). Por ejemplo, contexto pasado desde un vínculo de panel (si procede) o el contexto de datos del módulo.
  • Una macro de sistema que contiene el comando RunASMacro puede utilizar modelcontext cuando se ejecuta desde los detalles del modelo de programación avanzado.
  • Otros comandos de macros de sistema no contienen contexto. Por lo tanto, no se puede sustituir ningún valor y la macro falla.

En el caso de los parámetros %previouscycleperiod-Startdate% y %previouscycleperiod-Enddate%, si no hay ningún período de ciclo anterior, se utiliza el valor %horizon-start% (el primer período disponible).

Los parámetros que no son válidos para la función que se está ejecutando dan lugar a la terminación del programa y se muestra un mensaje de error.