Usar las propiedades de campo extendidas para un cubo de Hyperion Essbase
La extensión de procesamiento de datos de Hyperion Essbase admite propiedades de campo extendidas. Las propiedades de campo extendidas son propiedades adicionales a las propiedades de campo admitidas por Reporting Services, Value e IsMissing, que están disponibles en el origen de datos y que son admitidas por la extensión de procesamiento de datos. Las propiedades extendidas no aparecen en el panel Datos de informe como parte de la colección de campos para un conjunto de datos de informe. Para incluir valores de propiedades de campo extendidas en el informe, escriba expresiones que usen la colección Fields integrada, que las especifica por su nombre.
Las propiedades extendidas pueden ser propiedades predefinidas o personalizadas. Las propiedades predefinidas son propiedades comunes a varios orígenes de datos que se asignan a los nombres de propiedad de campo específicos. Se puede tener acceso a ellas por su nombre mediante la colección Fields integrada. Las propiedades personalizadas se definen para cada proveedor de datos y se puede tener acceso a ellas mediante la colección Fields integrada, pero solo mediante la sintaxis que usa el nombre de la propiedad extendida como una cadena.
Para hacer referencia a propiedades extendidas predefinidas en una expresión, se utiliza una de las sintaxis siguientes:
Fields!nombreDeCampo.nombreDePropiedad
Fields!nombreDeCampo("nombreDePropiedad")
Trabajar con propiedades de campo
Las propiedades de campo extendidas se recuperan al mismo tiempo que los campos de conjuntos de datos de informe al ejecutar una consulta MDX con el proveedor de datos de Microsoft.NET Framework para Hyperion Essbase. Los campos y las propiedades de celda y dimensión especificados en la consulta MDX se recuperan desde el origen de datos.
Las propiedades de campo se dividen en las categorías siguientes:
Propiedades de campo admitidas generalmente por varios proveedores de datos y asignadas a propiedades de campo de conjuntos de datos de informe predefinidas. Por ejemplo, la propiedad Value de conjunto de datos de informe predefinida representa la propiedad predeterminada para el valor de un medida o dimensión del origen de datos. El valor predeterminado para un medida es un valor numérico. El valor predeterminado para una dimensión es un título fácil de usar. Para incluir el valor predeterminado en un cuadro de texto, use la expresión =Fields!<FieldName>.Value.
Propiedades de campo predefinidas admitidas generalmente por varios proveedores de datos y que aparecen en la consulta MDX subyacente para un conjunto de datos de informe. Por ejemplo, la propiedad de dimensión MDX MEMBER_UNIQUE_NAME se asigna a la propiedad de campo de conjunto de datos de informe predefinida UniqueName. Para incluir el valor de nombre único en un cuadro de texto, use la expresión =Fields!<FieldName>.UniqueName.
Propiedades de campo personalizadas admitidas por un proveedor de datos y que aparecen en la consulta MDX subyacente para un conjunto de datos de informe, pero no aparecen en el panel de conjuntos de datos de informe como campos del conjunto de datos. Por ejemplo, Long Names es una propiedad de miembro definida para un nivel de dimensión. Para incluir el valor en un cuadro de texto, use la expresión =Fields!<FieldName>("Long Names"). En los nombres de campos de la expresión se distinguen mayúsculas de minúsculas.
El nombre de la propiedad de campo extendida aparecerá en la información sobre herramientas al situar el puntero del mouse sobre un campo del panel Metadatos del diseñador de consultas. Para obtener más información acerca del diseñador de consultas que se puede usar para explorar los datos subyacentes, vea Interfaz de usuario del Diseñador de consultas de Hyperion Essbase.
Para obtener más información acerca de la forma de usar campos y propiedades de campo en una expresión, vea Usar las colecciones integradas en expresiones (Reporting Services).
[!NOTA]
Sólo existirán valores para las propiedades de campo extendidas si se incluyen en la expresión MDX y si el origen de datos ofrece estos valores cuando el informe se ejecuta y recupera los datos para sus conjuntos de datos. En ese caso, podrá hacer referencia a esos valores de la propiedad Field desde cualquier expresión mediante la sintaxis descrita en la sección siguiente. No obstante, dado que estos campos son específicos de este proveedor de datos y no son parte del lenguaje RDL (Report Definition Language), los cambios que se realicen en estos valores no se guardarán con la definición del informe.
Propiedades de campo predefinidas
En la tabla siguiente, se ofrece una lista de las propiedades de campo predefinidas que se pueden usar para un origen de datos de Hyperion Essbase.
Propiedad |
Tipo |
Descripción o valor esperado |
|---|---|---|
Value |
Object |
Especifica el valor de los datos del campo. Para una propiedad de dimensión, se asigna a MEMBER_CAPTION. Para una medida, se asigna al valor de datos. |
IsMissing |
Boolean |
Indica si se ha encontrado el campo en el conjunto de datos resultante. |
FormattedValue |
String |
Devuelve un valor con formato para una cifra clave. Se asigna desde FORMATTED_VALUE en la expresión MDX. |
BackgroundColor |
String |
Devuelve el color de fondo del campo, definido en la base de datos. Se asigna desde BACK_COLOR en la expresión MDX. |
Color |
String |
Devuelve el color de primer plano del elemento, definido en la base de datos. Se asigna desde FORE_COLOR en la expresión MDX. |
UniqueName |
String |
Devuelve el nombre completo de un nivel. Se asigna desde MEMBER_UNIQUE_NAME en la expresión MDX. |
Propiedades personalizadas
Para hacer referencia a propiedades extendidas personalizadas en una expresión, se utiliza la sintaxis siguiente:
- Fields!nombreDeCampo("nombreDePropiedad")
En la tabla siguiente, se muestra la propiedad de campo personalizada que se puede usar para un origen de datos de Hyperion Essbase.
Propiedad |
Tipo |
Descripción o valor esperado |
|---|---|---|
FORMAT_STRING |
String |
Se define en una medida y es FormattedValue, disponible como un tipo String. |
Vea también