Variables de sustitución de tiempo de ejecución en scripts de cálculo ejecutados en Smart View

Variables de sustitución del tiempo en ejecución en scripts de cálculo ejecutadas en Smart View

Puede utilizar variables de sustitución de tiempo de ejecución (RTSV) en scripts de cálculo de Essbase que diseñe para su ejecución en Smart View. Los RTSV permiten que la región de enfoque del cálculo sea dinámica, según el contexto de cuadrícula activo (PDV).

Para utilizar un script de cálculo que incluya variables de sustitución de tiempo de ejecución en Smart View, la declaración de variable de sustitución de tiempo de ejecución en el comando de cálculo SET RUNTIMESUBVARS debe incluir la etiqueta <RTSV_HINT>. Además, la etiqueta <RTSV_HINT> debe incluir la etiqueta <svLaunch>. Normalmente, la etiqueta <svLaunch> incluye etiquetas XML adicionales que proporcionan metadatos para ejecutar el script de cálculo en Smart View.

Utilice la siguiente sintaxis para definir una definición de variable de sustitución de tiempo de ejecución para su uso en Smart View:

SET RUNTIMESUBVARS
{
   rtsvName = POV
   <RTSV_HINT>
      <svLaunch>
         <description>rtsv_description</description>
         <type>member | string | number</type>
         <dimension>dimName</dimension>
         <choice>single | multiple</choice>
         <allowMissing>true | false</allowMissing>
      </svLaunch>
   </RTSV_HINT>
};

En la definición anterior, el nombre de variable de sustitución de tiempo de ejecución es rtsvName, pero puede utilizar cualquier nombre. El valor de la variable se debe definir en POV, para indicar que solo se debe calcular el segmento de datos actual presente en la cuadrícula de la hoja de cálculo.

El elemento <RTSV_HINT> también debe formar parte de la declaración de variable. Sus contenidos incluyen:

<description>: descriptor que ayuda a los usuarios de Smart View a comprender la selección de miembros
<type>: especificación de si la variable es para un miembro, cadena o número
<allowMissing>: true si faltan datos, false de lo contrario
<dimension>: nombre de la dimensión desde la que esta variable extrae información
<choice>: single si solo se puede transferir una selección a la variable de sustitución de tiempo de ejecución; de lo contrario, multiple.

Para obtener una descripción completa de las etiquetas XML enumeradas anteriormente, consulte Referencia de etiquetas XML: scripts de cálculo con variables de sustitución en tiempo de ejecución para Smart View.

En Smart View, al seleccionar un script de cálculo que incluya variables de sustitución de tiempo de ejecución en el cuadro de diálogo Scripts de Cálculo, el área Peticiones de Datos de Tiempo de Ejecución se rellena con campos basados en cómo se definen las variables de sustitución de tiempo de ejecución en el comando de cálculo SET RUNTIMESUBVARS. Puede ejecutar el script de cálculo según lo definido o puede utilizar las peticiones de datos en tiempo de ejecución para introducir información de variable diferente según el tipo de dato.

Note:

En Smart View, no puede ejecutar un script de cálculo que incluya variables de sustitución de tiempo de ejecución si el comando SET RUNTIMESUBVARS no incluye las etiquetas <RTSV_HINT><svLaunch>...</svLaunch></RTSV_HINT>.

Ejemplo: juego de variables de sustitución en tiempo de ejecución en PDV

Para establecer la variable de sustitución de tiempo de ejecución de un script de cálculo de Essbase en el contexto de cuadrícula activa (PDV) de Smart View, el valor de la variable de sustitución de tiempo de ejecución se debe definir en POV y el tipo de dato se debe definir en member, como se muestra en este ejemplo.

Por defecto, el script de cálculo utiliza el miembro activo en el PDV en tiempo de ejecución, a menos que el usuario de Smart View especifique otro miembro en la petición de datos en tiempo de ejecución.

En este ejemplo, supongamos que la base de datos tiene las siguientes dimensiones: Account, Entity, Period y Scenario. Se definen tres variables de sustitución de tiempo de ejecución (denominadas rtsvEntity, rtsvScenario y rtsvPeriod), y el valor de cada variable se establece en PDV. En la sentencia FIX se hace referencia a las variables de sustitución de tiempo de ejecución como &rtsvEntity, &rtsvScenario y &rtsvPeriod.

SET RUNTIMESUBVARS {
   rtsvEntity = POV
      <RTSV_HINT>
         <svLaunch>
            <description>Entities to Copy</description>
            <type>member</type>
            <dimension>Entity</dimension>
            <allowMissing>false</allowMissing>
            <choice>multiple</choice>
         </svLaunch>
      </RTSV_HINT>;
   rtsvScenario = POV
      <RTSV_HINT>
         <svLaunch>
            <description>Scenarios to Copy</description>
            <type>member</type> 
            <allowMissing>false</allowMissing>
            <dimension>Scenario</dimension>
            <choice>multiple</choice>
         </svLaunch>
      </RTSV_HINT>;
   rtsvPeriod   = POV
      <RTSV_HINT>
         <svLaunch>
            <description>Period to Copy</description>
            <type>member</type>
            <allowMissing>false</allowMissing>
            <dimension>Period</dimension>
            <choice>single</choice>
         </svLaunch>
      </RTSV_HINT>;
}
FIX(&rtsvEntity, &rtsvScenario, &rtsvPeriod)
"Opening Balance" (
@PREV("Closing Balance");
)

Debajo de las declaraciones de variables hay un bloque FIX, que selecciona la región de enfoque del cálculo y ejecuta un comando para definir el saldo inicial del período. Las variables de sustitución de tiempo de ejecución se transfieren al bloque FIX mediante esta sintaxis: &varname. Por lo tanto, la región de enfoque del cálculo es dinámica, según el PDV de Smart View.

Note:

Al utilizar la interfaz de puestos de trabajo de Essbase, la sentencia MaxL execute Calculation o las API (como el punto final Execute Jobs de la API de REST), no puede ejecutar un script de cálculo que incluya una variable de sustitución de tiempo de ejecución definida en PDV. Puesto que dependen del contexto de cuadrícula de Smart View actual, se deben ejecutar desde Smart View.

Referencia de etiquetas XML: scripts de cálculo con variables de sustitución en tiempo de ejecución para Smart View

Al diseñar scripts de cálculo de Essbase con variables de sustitución de tiempo de ejecución diseñadas para ejecutarse en función del contexto de cuadrícula/ PDV de Smart View, debe utilizar algunas etiquetas XML que se explican aquí.

<RTSV_HINT>

Etiqueta necesaria para definir variables de sustitución de tiempo de ejecución para su uso en Smart View.
<svLaunch>

Etiqueta necesaria que indica que la variable de sustitución de tiempo de ejecución está definida para su uso en Smart View.

Esta etiqueta es la etiqueta principal para estas etiquetas: <description>, <type>, <dimension>, <choice> y <allowMissing>.
<description>rtsv_description</description>

rtsv_description es una cadena que describe la variable de sustitución de tiempo de ejecución. La cadena no se utiliza en el cálculo.
<type>value</type>

Los valores de tipo de dato válidos son:
- miembro: el valor de la variable de sustitución en tiempo de ejecución se debe definir como miembro (un único nombre de miembro o una lista separada por comas de nombres de miembros) o PDV.
  
  Note:
  
  Los nombres de miembros deben estar entre comillas; por ejemplo, "New York" (miembro único) o "New York","Florida" (una lista separada por comas de nombres de miembros).
  
  Si el valor de la variable de sustitución de tiempo de ejecución se define en PDV, el valor <type> debe ser miembro. Consulte también la etiqueta <choice>.
  
  Con los trabajos de Essbase o MaxL, no puede ejecutar un script de cálculo que incluya una variable de sustitución de tiempo de ejecución definida en el PDV. Estos scripts de cálculo se deben ejecutar desde Smart View, ya que el PDV depende del contexto de cuadrícula actual para determinar el segmento.
- string: el valor de la variable de sustitución de tiempo de ejecución se puede definir como un único nombre de miembro, una lista separada por comas de nombres de miembros (por ejemplo, "Nueva York","Florida") o una fecha.
  
  Al utilizar el tipo de datos de cadena, el cuadro de diálogo Selección de miembros no está disponible; por lo tanto, el usuario de Smart View debe asegurarse de utilizar la sintaxis correcta (que incluye un nombre de miembro entre comillas). Separar varios nombres de miembros con una coma o, para una fecha, hacer coincidir el formato de la cadena de fecha con el formato definido en el script de cálculo (mm-dd-yyyy o dd-mm-yyyy).
- number: el valor de la variable de sustitución de tiempo de ejecución se debe definir como un número
<dimension>dimName</dimension>

Nombre de la dimensión.

Note:

Esta etiqueta XML solo está soportada si el valor <type> es miembro.
<choice>value</choice>

Los valores de opción válidos son:
- single:
  - Si hay un único miembro en la cuadrícula o en el PDV, se utiliza ese miembro.
  - Si una dimensión está en el PDV, se utiliza el miembro activo.
  - Si una dimensión está en el PDV y hay varios miembros, se produce un error.
- multiple: se utilizan todos los miembros de dimensión de la cuadrícula o del PDV.
Note:

Esta etiqueta XML solo está soportada si el valor <type> es miembro.
<allowMissing>boolean</allowMissing>

Especifica si se permiten o suprimen las celdas de datos para las que no existen datos en la base de datos.

Valores válidos: true y false.