Sintaxis para Hacer Referencia a Variables

Puede hacer referencia a variables en análisis y paneles de control.

El modo en que haga referencia a una variable depende de la tarea que está ejecutando. Para tareas en las que se le presenten campos en un cuadro de diálogo, debe especificar únicamente el tipo y nombre de la variable (no su sintaxis completa), por ejemplo al hacer referencia a una variable en una definición de filtro.

Para otras tareas, como cuando haga referencia a una variable en una vista de título, tendrá que especificar la sintaxis de la variable. La sintaxis que utilice dependerá del tipo de variable, como se describe en la siguiente tabla.

Tipo Sintaxis Ejemplo

Sesión

@{biServer.variables['NQ_SESSION.variablename']}

donde variablename es el nombre de la variable de sesión, por ejemplo DISPLAYNAME.

@{biServer.variables['NQ_SESSION.SalesRegion']}

Modelo semántico (repositorio)

@{biServer.variables.variablename}

o bien

@{biServer.variables['variablename']}

donde variablename es el nombre de la variable, por ejemplo, prime_begin

@{biServer.variables.prime_begin}

o bien

@{biServer.variables['prime_begin']}

Presentación o solicitud

@{variables.variablename}[format]{defaultvalue}

o bien

@{scope.variables['variablename']}

donde:

variablename es el nombre de la variable de presentación o solicitud, por ejemplo, MyFavoriteRegion.

(opcional) format es una máscara de formato que depende del tipo de datos de la variable, por ejemplo, #,##0, MM/DD/YY hh:mm:ss. (Tenga en cuenta que el formato no se aplica al valor por defecto).

(opcional) defaultvalue es una referencia de variable o constante que indica un valor que se utilizará si no se rellena la variable a la que se hace referencia mediante variablename.

scope identifica los cualificadores de la variable. Debe especificar el ámbito cuando se utilice una variable en varios niveles (análisis, páginas de panel de control y paneles de control) y desee acceder a un valor específico. (Si no especifica el ámbito, el orden de prioridad es análisis, páginas de panel de control y paneles de control).

Cuando se utiliza una petición de datos de panel de control con una variable de presentación que puede tener múltiples valores, la sintaxis es diferente según el tipo de columna. Varios valores se formatean en valores separados por comas y, por lo tanto, cualquier cláusula de formato se aplica a cada valor antes de que se une mediante comas.

@{variables.MyFavoriteRegion}{EASTERN REGION}

o bien

@{dashboard.MyFavoriteRegion}{EASTERN REGION}

o bien

@{dashboard.variables['MyFavoriteRegion']}

o bien

(@{myNumVar}[#,##0]{1000})

o bien

(@{variables.MyOwnTimestamp}[YY-MM-DD hh:mm:ss]{)

o bien

(@{myTextVar}{A, B, C})

Global

@{global.variables.variablename}

donde variablename es el nombre de la variable global, por ejemplo, gv_region. Cuando se hace referencia a una variable global, debe utilizar el nombre totalmente cualificado como se indica en el ejemplo.

La regla de nomenclatura para las variables globales debe cumplir las especificaciones de idioma de ECMA Script para JavaScript. El nombre no debe exceder los 200 caracteres ni contener espacios embebidos, palabras reservadas y caracteres especiales. Si no está familiarizado con los requisitos de idioma de JavaScript, consulte una referencia de terceros

@{global.variables.gv_date_n_time}

También puede hacer referencia a variables en expresiones. Las directrices para hacer referencia a variables en expresiones se describen en los temas siguientes:

Variables de sesión

Puede utilizar las directrices siguientes para hacer referencia a las variables de sesión en expresiones.

  • Incluir la variable de sesión como argumento de la función VALUEOF.
  • Incluir el nombre de la variable entre comillas.
  • Preceder la variable de sesión con NQ_SESSION y un punto.
  • Incluir NQ_SESSION entre comillas.
  • Incluir la parte NQ_SESSION y el nombre de la variable de sesión entre paréntesis.

Por ejemplo:

"Market"."Region"=VALUEOF("NQ_SESSION"."SalesRegion")

Variables de presentación

Puede utilizar las siguientes directrices para hacer referencia a las variables de presentación en expresiones.

Cuando haga referencia a una variable de presentación, utilice esta sintaxis:

@{variablename}{defaultvalue}

donde variablename es el nombre de la variable de presentación y defaultvalue (opcional) es una referencia de variable o constante que indica un valor que se utilizará si la variable a la que se hace referencia con variablename no está rellena.

Para realizar una conversión de tipo (es decir, convertir) de la variable en una cadena o incluir varias variables, incluya toda la variable entre comillas sencillas, por ejemplo:

'@{user.displayName}'

Si el signo @ no va seguido de un {, se considerará como un signo @. Cuando se utiliza una variable de presentación que puede tener varios valores, la sintaxis es diferente según el tipo de columna.

Utilice la siguiente sintaxis en SQL para el tipo de columna especificado para poder generar sentencias SQL válidas:

  • Texto: (@{variablename}['@']{'defaultvalue'})

  • Numérico: (@{variablename}{defaultvalue})

  • Fecha y hora: (@{variablename}{timestamp 'defaultvalue'})

  • Fecha (solo la fecha): (@{variablename}{date 'defaultvalue'})

  • Hora (solo la hora): (@{variablename}{time 'defaultvalue'})

Por ejemplo:

'@{user.displayName}'

Variables (de repositorio) de modelo semántico

Puede utilizar las siguientes directrices para hacer referencia a las variables (de repositorio) de modelo semántico en las expresiones.

  • Incluir la variable como argumento de la función VALUEOF.
  • Incluir el nombre de la variable entre comillas.
  • Hacer referencia a una variable (de repositorio) estática de modelo semántico por nombre.
  • Hacer referencia a una variable (de repositorio) dinámica de modelo semántico por su nombre completo.

Por ejemplo:

CASE WHEN "Hora" >= VALUEOF("inicio_franja_principal")AND "Hora" < VALUEOF("fin_franja_principal") THEN 'Prime Time' WHEN ... ELSE...END