Elemento CellInfo (XMLA)

Representa los metadatos de celda contenidos en el elemento OlapInfo primario.

Sintaxis

  
<OlapInfo>  
   ...  
   <CellInfo>  
      <!-- One or more cell property definitions -->  
   </CellInfo>  
   ...  
</OlapInfo>  

Características de los elementos

Característica	Descripción
Tipo y longitud de los datos	Ninguno
Valor predeterminado	Ninguno
Cardinalidad	1-1: Elemento necesario que se produce una vez y solo una vez.

Relaciones de elementos

Relación	Elemento
Elementos primarios	OlapInfo
Elementos secundarios	Una o más definiciones de propiedades de la celda

Comentarios

El elemento CellInfo contiene una colección de propiedades de celda para las celdas incluidas en el conjunto de datos multidimensional devuelto por un elemento raíz mediante el tipo de datos MDDataSet. Cada propiedad de celda del elemento CellInfo se define mediante un elemento XML independiente, cada uno con un atributo name y un atributo type . El atributo name de la propiedad de celda corresponde al nombre del OLE DB para la propiedad de celda OLAP representada por el elemento XML, y el atributo type representa el tipo de datos XML de la propiedad de celda. El nombre del elemento XML se usa para identificar el valor de la propiedad de celda para las celdas contenidas en el elemento CellData del elemento raíz.

La sintaxis siguiente describe la definición de una propiedad de celda:

<CellPropertyDefinition name="string" type"string" />  

Las propiedades disponibles y sus valores se pueden obtener utilizando el tipo de solicitud DISCOVER_PROPERTIES con el método Discover . No existe ningún requerimiento acerca del orden de las propiedades que aparecen listadas en el elemento PropertyList .

Opcionalmente, un proveedor puede especificar valores predeterminados para propiedades individuales de miembro o celda en la sección AxisInfoo CellInfo . Los valores predeterminados pueden proporcionar menos resultados si la propiedad tiene siempre o casi siempre el mismo valor. Para indicar un valor predeterminado para una propiedad, el elementoDefault se puede especificar opcionalmente como un elemento secundario de uno de los elementos de definición de propiedad de celda. Por consiguiente, la ausencia de un miembro o de una propiedad de la celda en el resultado indica que el valor predeterminado expresado es el valor para la propiedad de la celda.

Ejemplo

En el ejemplo siguiente se muestra cómo se representan las propiedades de celda VALUE, FORMATTED_VALUE y FORMAT_STRING en el elemento CellInfo .

<OlapInfo>  
   ...  
      <CellInfo>  
         <Value name="VALUE"></Value>  
         <FmtValue name="FORMATTED_VALUE"></FmtValue>  
         <FormatString name="FORMAT_STRING"></FormatString>  
      </CellInfo>  
</OlapInfo>