Uso de Variables

Las variables ayudan a garantizar que la misma información y texto se presenten de forma precisa en diferentes lugares.

Puede hacer referencia a variables en diversas áreas de Oracle BI Enterprise Edition, incluyendo análisis, paneles de control, KPI, acciones, agentes y condiciones. Por ejemplo, suponga que desea crear un análisis cuyo título muestre el nombre del usuario actual. Para hacerlo tendrá que hacer referencia a una variable.

Hay cinco tipos de variables que puede usar:

  • Sesión

  • Repositorio

  • Presentación

  • Solicitud

  • Global

Definición de Variables de Sesión

Una variable de sesión es una variable que se inicializa en el momento de conexión de cada usuario.

Cuando un usuario inicia una sesión, Oracle BI Server crea una instancia nueva de una variable de sesión y la inicializa.

Hay tantas instancias de una variable de sesión como sesiones activas en el Oracle BI Server. Cada instancia de una variable de sesión se puede inicializar con un valor diferente.

Las variables de sesión se completan mediante una consulta especificada en un bloque de inicialización (INIT BLOCK). Estos bloques de inicialización de sesión normalmente se ejecutan una única vez en el momento del inicio. No obstante, si el bloque de inicialización se marca como diferido, se puede ejecutar más tarde cuando se haga referencia a variables relevantes.

Los bloques de inicialización de sesión se asocian generalmente a una sentencia de consulta, pero también se pueden asociar a un objeto LDAP. Para obtener más información sobre los bloques de inicialización, consulte "Trabajar con Bloques de Inicialización" en Guía de Metadata Repository Builder para Oracle Business Intelligence Enterprise Edition.

Hay dos tipos de variables de sesión:

  • Sistema: variable de sesión que utilizan Oracle BI Server y Oracle BI Presentation Services con fines específicos.

    Las variables de sesión del sistema tienen nombres reservados que no pueden utilizar para otros tipos de variables (como las variables de repositorio estáticas o dinámicas y las variables de sesión que no son del sistema).

  • No del Sistema: variable del sistema que crea y denomina el administrador. Por ejemplo, el administrador podría crear una variable que no es del sistema SalesRegion que inicializa el nombre de la región de ventas de un usuario.

El administrador crea variables de sesión que no son del sistema mediante la herramienta de administración de Oracle BI.

Nota:

Ciertas variables de sesión del sistema (como USERGUID o ROLES) no se pueden sustituir por variables de solicitud. Otras variables de sesión del sistema, como DATA_TZ y DATA_DISPLAY_TZ (zona horaria), se pueden sustituir si se han configurado en la Herramienta de Administración de Oracle BI.

Para obtener más información, consulte "Trabajar con Variables de Repositorio" en Guía de Metadata Repository Builder para Oracle Business Intelligence Enterprise Edition.

Para obtener más información, consulte Acerca de las Variables de Sesión en Guía de Metadata Repository Builder para Oracle Business Intelligence Enterprise Edition.

Definición de Variables de Repositorio

Una variable de repositorio es una variable que tiene un único valor en cualquier punto del tiempo.

Hay dos tipos de variables de repositorio:

  • Estática: variables de repositorio cuyo valor persiste y no cambian hasta que el administrador decide cambiarlas.

  • Dinámica: variables de repositorio cuyos valores se completan mediante una consulta especificada en un bloque de inicialización. Puede especificar el intervalo de refrescamiento del bloque de inicialización. Un bloque de inicialización dinámico refresca automáticamente los valores de sus variables en el intervalo especificado.

    Los bloques de inicialización dinámicos solo se pueden asociar a una consulta (es decir, mediante una sentencia de SQL, una consulta de ADF u otro origen de datos soportado). Para obtener más información sobre los bloques de inicialización, consulte "Trabajar con Bloques de Inicialización" en Guía de Metadata Repository Builder para Oracle Business Intelligence Enterprise Edition.

El administrador crea variables de repositorio mediante la herramienta de administración de Oracle BI.

Para obtener más información, consulte Acerca de las Variables de Repositorio en la Guía de Metadata Repository Builder para Oracle Business Intelligence Enterprise Edition.

Definición de Variables de Presentación

Las variables de presentación se crean y utilizan con las peticiones de datos del panel de control.

Una variable de presentación es una variable que puede crear como parte del proceso para crear uno de los siguientes tipos de peticiones de datos de panel de control:

  • Petición de Datos de Columna: se asocia una variable de presentación creada como parte de una petición de datos de columna a una columna y los valores que contiene proceden de los valores de columna.

    Para crear una variable de presentación como parte de una petición de datos de columna, en el cuadro de diálogo Nueva Petición de Datos (o el cuadro de diálogo Editar Petición de Datos), tiene que seleccionar Variable de Presentación en el campo Definir una variable y, a continuación, introduzca un nombre para la variable en el campo Nombre de la Variable.

    Para obtener más información sobre el trabajo con peticiones de datos de columna, consulte Creación de Peticiones de Datos de Columna.

  • Petición de Datos de Variable: ninguna variable de presentación creada como parte de una petición de datos de variable se asocia a ninguna columna y se definen los valores que puede contener.

    Para crear una variable de presentación como parte de una petición de datos de variable, en el cuadro de diálogo Nueva Petición de Datos (o el cuadro de diálogo Editar Petición de Datos), tiene que seleccionar Variable de Presentación en el campo Petición para y, a continuación, introduzca un nombre para la variable en el campo Nombre de la Variable.

    Para obtener más información sobre el trabajo con peticiones de datos de variable, consulte Creación de Peticiones de Datos de Variable.

El valor de una variable de presentación se rellena con la petición de datos de columna o de variable con la que se ha creado. Es decir, cada vez que un usuario seleccione uno o más valores en la petición de datos de columna o de variable, el valor de la variable de presentación se definirá con el valor o valores que seleccione el usuario.

Definición de Variables de Solicitud

La solicitud temporal de variables sobrescribe las solicitudes de base de datos de petición de datos.

Una variable de solicitud le permite sustituir el valor de una variable de sesión pero solo durante la duración de una solicitud de base de datos que se ha iniciado desde una petición de datos de columna o de variable.

Nota:

Ciertas variables de sesión del sistema (como USERGUID o ROLES) no se pueden sustituir por variables de solicitud. Otras variables de sesión del sistema, como DATA_TZ y DATA_DISPLAY_TZ (zona horaria), se pueden sustituir si se han configurado en la Herramienta de Administración de Oracle BI.

Para obtener más información, consulte "Trabajar con Variables de Repositorio" en Guía de Metadata Repository Builder para Oracle Business Intelligence Enterprise Edition.

Puede crear una variable de solicitud como parte del proceso de creación de uno de los siguientes tipos de peticiones de datos de panel de control:

  • Petición de Datos de Columna: se asocia a una columna una variable de solicitud creada como parte de una petición de datos de columna y los valores que puede contener proceden de los valores de columna.

    Para crear una variable de solicitud como parte de una petición de datos de columna, en el cuadro de diálogo Nueva Petición de Datos (o el cuadro de diálogo Editar Petición de Datos), tiene que seleccionar Variable de Solicitud en el campo Definir una variable y, a continuación, introducir el nombre de la variable de sesión para la sustitución en el campo Nombre de la Variable.

    Para obtener más información sobre el trabajo con peticiones de datos de columna, consulte Creación de Peticiones de Datos de Columna.

  • Petición de Datos de Variable: no se asocia a ninguna columna ninguna variable de solicitud creada como parte de una petición de datos de variable y se definen los valores que puede contener.

    Para crear una variable de solicitud como parte de una petición de datos de variable, en el cuadro de diálogo Nueva Petición de Datos (o el cuadro de diálogo Editar Petición de Datos), tiene que seleccionar Variable de Solicitud en el campo Petición para y, a continuación, introducir el nombre de la variable de sesión que quiere sustituir en el campo Nombre de la Variable.

    Para obtener más información sobre el trabajo con peticiones de datos de variable, consulte Creación de Peticiones de Datos de Variable.

El valor de una variable de solicitud se rellena con la petición de datos de columna o de variable con la que se ha creado. Es decir, cada vez que un usuario seleccione un valor en la petición de datos o de variable, el valor de la variable de solicitud se definirá en el valor que selecciona el usuario. Sin embargo, el valor sólo tendrá efecto desde el momento en que el usuario pulsa el botón Ir de la petición de datos hasta que se devuelven los resultados del análisis en el panel de control.

Nota:

Sólo las variables de solicitud numérica o de cadena soportan varios valores. Todos los demás tipos de dato sólo transfieren el primer valor.

¿Qué Son las Variables Globales?

Una variable global es una columna creada mediante la combinación de un determinado tipo de dato con un valor.

El valor puede ser una cadena, número, fecha, hora, expresión, fórmula, etc. Puede crear un valor global durante el proceso de creación de un análisis mediante el cuadro de diálogo Editar Fórmula de Columna. La variable global se guarda a continuación en el catálogo y queda disponible para todos los demás análisis en un sistema de inquilino específico.

Puede crear una variable global como parte del proceso de creación de un análisis.

Las variables globales pueden ser de los tipos siguientes:

  • Fecha

  • Fecha y Hora

  • Número

  • Texto

  • Hora

Para crear una variable global:

  1. En el panel Columnas Seleccionadas del separador Criterios, haga clic en el botón Opciones junto a la columna cuya fórmula desea editar y seleccione Editar Fórmula. Aparece el separador Fórmula de Columna del cuadro de diálogo Editar Fórmula de Columna. Puede crear una cabecera personalizada para la variable global con este separador.
  2. Haga clic en el botón Variable y, a continuación, seleccione Global. Aparece el cuadro de diálogo Insertar Variable Global.
  3. Haga clic en el botón Agregar Nueva Variable Global. Aparece el cuadro de diálogo Nueva Variable Global.
  4. Introduzca un nombre único.
  5. Seleccione un tipo de dato.
  6. Introduzca un valor.

    Nota:

    Si selecciona "Fecha y Hora" como el tipo de dato, introduzca el valor, como en el siguiente ejemplo: 03/25/2004 12:00:00 AM

    Si introduce una expresión o un cálculo como valor, debe utilizar el tipo de dato de texto, como en el siguiente ejemplo: "Base Facts"."1- Revenue"*3.1415

  7. Haga clic en Aceptar. La nueva variable global se agrega al cuadro de diálogo Insertar Variable Global.
  8. Seleccione la nueva variable global que acaba de crear y, a continuación, haga clic en Aceptar. El cuadro de diálogo Editar Fórmula de Columna se muestra con la variable global insertada en el panel Fórmula de Columna.

    La casilla de control Cabeceras Personalizadas se activa automáticamente. Introduzca un nombre nuevo para la columna a la que ha asignado una variable global para reflejar de forma más precisa la variable.

  9. Haga clic en Aceptar.

La variable global se evalúa en el momento en que se ejecuta el análisis, y el valor de la variable global se sustituye de forma adecuada. Sólo los usuarios con privilegios adecuados pueden gestionar (agregar, editar y suprimir) las variables globales.