Implementación de variables para modificar la información

Puede utilizar variables de sustitución de Essbase como marcadores de posición para cambiar la información regularmente. Debido a que los cambios en un valor de variable se reflejan en cualquier lugar donde se utilice la variable, se minimiza la necesidad de realizar actualizaciones manuales.

Por ejemplo, muchos informes dependen de los periodos de generación de informes; si genera un informe basado en el mes actual, debe actualizar el script de informe manualmente cada mes. Con una variable de sustitución, como CurMnth, establecida en el servidor de Essbase, puede cambiar el valor asignado cada mes al periodo de tiempo adecuado. Cuando se utiliza el nombre de variable en un script de informe, la información se actualiza dinámicamente cuando se ejecuta el informe final.

Puede utilizar variables de sustitución con aplicaciones de almacenamiento agregado (ASO) y de almacenamiento de bloques (BSO) (a menos que se indique lo contrario) en las siguientes áreas:

  • Fórmulas de Esquema de Almacenamiento Agregado

  • Fórmulas de esquema de almacenamiento de bloques

  • Scripts de cálculo (solo bases de datos de almacenamiento de bloques)

    Las variables de sustitución y las variables de sustitución en tiempo de ejecución están soportadas en los scripts de cálculo.

  • Definiciones de cabecera de archivo de reglas de carga de datos y definiciones de campo. Puede introducir nombres de variables para nombres de dimensiones y miembros.

  • Especificaciones de nombre de origen de datos (DSN) en archivos de reglas para orígenes de datos SQL

  • Cláusulas SELECT, FROM o WHERE en archivos de reglas para orígenes de datos SQL

  • Filtros de seguridad

  • consultas MDX

  • Smart View

  • Scripts de informe

Las variables de sustitución se pueden definir en estos niveles:

  • Globalmente: proporciona acceso a la variable desde todas las aplicaciones y bases de datos del servidor de Essbase.

  • Aplicación: Proporciona acceso a la variable desde todas las bases de datos de la aplicación.

  • Base de datos: proporciona acceso a la variable dentro de la base de datos especificada.

Nombres y valores de variable de sustitución permitidos

Cuando utilice variables de sustitución en Essbase, siga las directrices relativas a los caracteres y tipos de dato que puede utilizar en los nombres y valores de variables de sustitución.

Las siguientes restricciones se aplican a los nombres y valores de variables de sustitución:

Caracteres permitidos en el nombre de variable

Se permiten caracteres alfanuméricos y guiones bajos, pero no caracteres especiales ni espacios. Límite de caracteres: consulte Límites.

Caracteres permitidos en el valor de variable

Se permite cualquier carácter excepto un ampersand inicial (&). Límite de caracteres: consulte Límites.

Nombres de miembros de Essbase utilizados como valores de variables

Delimite los nombres de miembros que empiecen por un número o que contengan cualquier carácter especial entre comillas (" ") para las bases de datos de almacenamiento de bloques y entre corchetes ([ ]) para las bases de datos de almacenamiento agregado. Consulte Convenciones de nomenclatura en scripts de cálculo, scripts de informes, fórmulas, filtros, valores de variables de sustitución y de entorno para obtener más información.

Para definir un valor de variable de sustitución como un nombre de miembro duplicado, utilice el nombre de miembro cualificado entre comillas dobles; por ejemplo, un valor para &Period puede ser "[2022].[Qtr1]".

No utilice un nombre de variable de sustitución como parte de un nombre de miembro cualificado. Por ejemplo, no es válido especificar "[2022].[&CurrentQtr]".

Números utilizados como valores de variables

Incluya valores numéricos entre comillas (" ") para las bases de datos de almacenamiento de bloques (BSO) y entre corchetes ([ ]) para las bases de datos de almacenamiento agregado (ASO).

Por ejemplo, si el nombre de la variable es Mes y su valor es 01, para el almacenamiento de bloques, defina el valor como "01". Para el almacenamiento agregado, defina el valor como [01].

Varias variables con el mismo nombre

Las variables pueden tener el mismo nombre siempre que se definan en ámbitos diferentes. La prioridad de resolución de variables funciona de la siguiente forma: la variable de base de datos se resuelve antes que la variable de aplicación. La variable de aplicación se resuelve antes que la variable global.

Creación o Definición de Variables de Sustitución

Antes de definir una variable de sustitución, consulte Nombres y valores de variables de sustitución permitidos.

Puede crear o establecer variables de sustitución en el nivel de servidor de Essbase, aplicación o base de datos.

Para asegurarse de que un nuevo valor de variable de sustitución está disponible en fórmulas, definiciones de partición y filtros de seguridad, detenga y reinicie la aplicación. Todos los demás usos de las variables de sustitución se resuelven dinámicamente cuando se utilizan.

Cuando se agregan o actualizan variables de sustitución, se envían a la aplicación y se resuelven dinámicamente.

Para establecer una variable de sustitución mediante la interfaz web de Essbase, consulte Uso de variables de sustitución. También puede utilizar un libro de trabajo de aplicación para definir variables en el nivel de aplicación o utilizar las siguientes sentencias MaxL:

Eliminar variables de sustitución

Puede que desee suprimir una variable de sustitución de Essbase que ya no sea necesaria.

Para suprimir una variable de sustitución, puede eliminarla del libro de trabajo de la aplicación y crear el cubo, suprimirla mediante la interfaz web de Essbase o utilizar estas sentencias MaxL:

Actualizar variables de sustitución

Puesto que las variables de sustitución son marcadores de posición para cambiar la información, puede que necesite actualizar sus valores con frecuencia. Puede modificar las variables de sustitución existentes mediante MaxL o la interfaz web de Essbase.

Para actualizar una variable de sustitución, puede utilizar una de estas sentencias MaxL (la que se debe utilizar depende del contexto de la variable):

Si prefiere utilizar la interfaz web de Essbase para actualizar una variable, consulte Uso de variables de sustitución para obtener instrucciones.