Variables de SAP BW

Las variables de SAP BW son parámetros de una consulta SAP BW que se configuran durante la definición de la consulta. Cuando se ejecuta la consulta, las variables de SAP BW se rellenan con los valores. Funcionan como marcadores y se pueden procesar de modos diferentes. En tiempo de ejecución, quedan expuestos automáticamente como solicitudes.

Se incluye la información de variables de SAP BW en una propiedad personalizada compuesta denominada Variables de SAP BW que solamente existe si un origen de datos tiene una o varias variables asociadas. La propiedad Variables de SAP BW contiene una o varias propiedades compuestas y a cada una de ellas se les debe asignar un nombre exclusivo. Cada propiedad representa una descripción de una sola variable de SAP BW. Dado que la información de las variables se especifica en una propiedad personalizada, Framework Manager no valida estas propiedades.

La información de las variables de SAP BW se obtiene utilizando la BAPI de SAP BW MDDataProviderBW::GetVariables.

Framework Manager da soporte a estos tipos de variables de SAP BW:

  • Característica

    Existen dos tipos de variables de características: el valor de la característica y el nodo de la jerarquía. Las variables de valores de características seleccionan valores de características. Las variables de nodo de jerarquía seleccionan los valores de cualquier posición de una jerarquía de presentación.

  • Jerarquía.

    Al usuario no se le solicita un valor debido a que el software de IBM® Cognos lo rellena automáticamente en tiempo de ejecución, basándose en la jerarquía seleccionada. Las variables para la función de jerarquías actúan como marcadores para la jerarquía de una característica. Todos los valores de las variables de jerarquías son de sólo lectura.

  • Fórmula

    El usuario escribe un valor numérico en tiempo de ejecución. Utilice las variables de fórmula si se debe especificar un componente de fórmula solamente cuando se ejecuta una consulta. Por ejemplo, se puede utilizar una variable de fórmula para que se procese la tasa impositiva actual del impuesto sobre el valor añadido en tiempo de ejecución.

  • Autorización

    Las variables de autorización son como las otras variables, pero el software de IBM Cognos automáticamente rellena los valores de las variables con las credenciales de usuario. SAP BW utiliza estas credenciales para suministrar la información que necesita una consulta SAP BW a la que se le ha aplicado la seguridad.

Las variables para jerarquías funcionan como marcadores para la jerarquía de una característica. Todos los valores de las variables de jerarquías son de sólo lectura.

Propiedad Nombre

Esta propiedad es un valor de cadena.

Equivalente de SAP BW: VARIABLE_NAME

Restricciones: Sólo lectura.

Propiedad Título

El valor de esta propiedad es un valor de cadena compuesto y que depende del entorno local. Represente cada entorno local del modelo mediante una propiedad personalizada cuyo valor sea el nombre del entorno local. Por ejemplo, si en el modelo existen los entornos locales en-ca y fr-fr, defina dos propiedades personalizadas con el nombre en-ca y fr-fr.

El valor predeterminado se obtiene de SAP BW.

Propiedad Tipo de selección

Los valores posibles son value, interval, complex y multiValued.

Tabla 1. Equivalentes de propiedad Tipo de selección

Valor

Equivalente de SAP BW

value

SAP_VAR_SEL_TYPE_VALUE

interval

SAP_VAR_SEL_TYPE_INTERVAL

complex

SAP_VAR_SEL_TYPE_COMPLEX

multiValued

SAP_VAR_SEL_TYPE_COMPLEX

Restricciones: Sólo lectura.

Propiedad Tipo de entrada

El valor predeterminado se obtiene de SAP BW.

Tabla 2. Equivalentes de propiedad Tipo de entrada

Valor

Equivalente de SAP BW

opcional

SAP_VAR_INPUT_TYPE_OPTIONAL

obligatorio

SAP_VAR_INPUT_TYPE_MANDATORY

mandatoryNotInitial

SAP_VAR_INPUT_TYPE_MANDATORY_NOT_INITIAL

Restricciones: Sólo lectura.

Propiedades Valor bajo predeterminado y Valor elevado predeterminado

Cada una de estas propiedades especifica un rango de valores.

El valor predeterminado se obtiene de SAP BW.

Restricciones: La propiedad Valor elevado predeterminado se puede aplicar únicamente a las variables cuyo Tipo de selección sea interval.

Propiedad Descripción

Esta propiedad es un valor de cadena.

Propiedad Tipo de variable de SAP BW

Los valores posibles son numeric, characteristic, hierarchy o hierarchicalNode.

El valor predeterminado se obtiene de SAP BW.

Restricciones: Sólo lectura.

Propiedad Tipo de solicitud

El valor predeterminado depende del tipo de variable. Si el valor de esta propiedad no es uno de los valores predefinidos, se utiliza el valor hierarchyPickList. Los valores predefinidos para la propiedad de tipo de solicitud son los siguientes.

Tabla 3. Equivalentes de propiedad Tipo de solicitud

Valor

Restricciones

typeIn

Obligatorio para las variables numéricas y opcional para los valores de características.

pickList

Opcional para variables de características.

calendar

Sólo para variables de características basadas en 0CALDAY.

hierarchyPickList

Opcional para todas las jerarquías de presentación.

notApplicable

Necesario para variables de jerarquías.

Utilice esta propiedad para especificar el tipo de solicitud.

Puede mejorar el rendimiento de las solicitudes de variables que utilizan una lista de selección o una lista de selección jerárquica. Utilice las propiedades Restricción de nivel, Número inicial de valores de lista de selección y Utilizar valor predeterminado para controlar el rendimiento de esos tipos de solicitudes de variables.

Si se cambia una solicitud de lista de selección o de lista de selección jerárquica a una solicitud de introducir se puede mejorar de forma drástica el rendimiento ya que no es necesario que el servidor de aplicaciones rellene una lista de selección con valores. No obstante, requiere que los usuarios puedan entrar con exactitud los valores de las características.

Restricciones: De sólo lectura para algunos tipos de variables, como de características y de fórmula.

Propiedad Restricción de nivel

Esta propiedad es un valor numérico.

El valor predeterminado es 1.

Utilice esta propiedad para disminuir el número de valores de características que rellenan una lista de selección jerárquica. Existe un número limitado de niveles de una jerarquía de los que se pueden obtener valores.

Si el valor es cero (0), que es el valor predeterminado, entonces los valores de características de todos los niveles de una jerarquía (si es aplicable al tipo de solicitud) rellenan la lista de selección. De lo contrario, la propiedad especifica un rango de niveles separado por un signo de dos puntos de donde se obtienen los valores (el nivel raíz es cero).

Para una jerarquía irregular, debe especificar todos los niveles que es posible que desee utilizar incluso si algunas sucursales no tienen dicho nivel.

Restricciones: Sólo es aplicable a las variables de nodo jerárquicas cuyo Tipo de solicitud sea hierarchyPickList.

Propiedad Utilizar valor predeterminado

Esta propiedad es una propiedad booleana que determina si se utilizan los valores predeterminados. Si esta propiedad se define como true, no se solicita a los usuarios la variable asociada sino que siempre se utiliza el valor predeterminado.

Utilice esta propiedad para establecer la variable en un único valor. A los usuarios no se les solicita el valor de una variable y, por lo tanto, el servidor de IBM Cognos Analytics no rellena una lista de selección con valores. No obstante, los usuarios ya no pueden cambiar el valor de una variable.

El valor predeterminado es false.

Propiedad Mostrar clave y título

Para mostrar las claves y los títulos de las variables de SAP BW, defina esta propiedad en true. Esta propiedad sólo se puede aplicar a las solicitudes de lista de selección y a las solicitudes de nodo jerárquico.

El valor predeterminado es false.

Propiedad Número inicial de valores de lista de selección

Esta propiedad especifica el número inicial de valores que se utilizan para rellenar una lista de selección, una lista de selección jerárquica o una solicitud.

El valor predeterminado es cero (0), lo que significa todos.