EntityType, elemento (CSDLBI)
Importante: Este documento está archivado. Para obtener la información más reciente, vea la especificación abierta [MS-CSDLBI]: formato de archivo de definición de esquemas conceptuales con anotaciones de inteligencia empresarial.
El elemento EntityType es un tipo complejo que representa la estructura de una entidad de nivel superior, como un cliente o un pedido, en un modelo de datos. El elemento bi:EntityType extiende la definición del EntityType utilizado en Entity Data Framework.
Se debe especificar un elemento EntityType para cada una de las entidades incluidas en el modelo de datos. Los subelementos de EntityType describen las columnas y medidas de la tabla. Las relaciones entre las tablas se incluyen en el elemento EntityContainer.
Atributos y elementos
En la tabla siguiente se enumeran los elementos y atributos que definen el elemento EntityType . Vea también los atributos aplicables al elemento EntityType .
| Nombre | Es obligatorio | Descripción |
|---|---|---|
| Contenido | No | Cadena que contiene los posibles tipos de datos de una columna. El valor se deriva del valor de DimensionAttributeTypeEnumType en el modelo de datos. Si el valor de DimensionAttributeTypeEnumType es “ExtendedType”, el valor de Contents se deriva del elemento ExtendedType de DimensionAttribute. No es necesario que el cliente responda a estos valores. |
| DefaultDetails | No | Lista de referencias de propiedad que representan el conjunto de columnas de la tabla. Vea Elemento DefaultDetails (CSDLBI). |
| DefaultImage | No | Referencia a una columna que contiene la imagen que ilustra la entidad. En los modelos multidimensionales, este elemento corresponde a un atributo binario en el atributo de dimensión. Si este atributo está presente, el elemento debe contener exactamente un elemento MemberRef. Vea Elemento MemberRef (CSDLBI). |
| DefaultMeasure | No | Referencia a una medida de la entidad que se debe utilizar como valor predeterminado al realizar cálculos en dicha entidad. Si no se especifica, el valor predeterminado es SUM. Vea Elemento MemberRef (CSDLBI). |
| DisplayKey | No | Lista de referencias a columnas o a extremos de rol que constituye un identificador seguro que identifica de forma exclusiva una instancia de entidad. Vea Elemento DisplayKey (CSDLBI). |
| Hierarchy | No | Lista de jerarquías del modelo. Vea Elemento Hierarchy (CSDLBI). |
| ReferenceName | Sí | Identificador que se puede utilizar para hacer referencia a esta entidad en una consulta de expresiones de análisis de datos (DAX). Si este atributo no está presente, se utiliza el nombre de campo completo de la entidad. |
| SortMembers | No | Lista de propiedades según las que se ordena. El atributo SortDirection indica si el orden es ascendente o descendente. |
Elemento Contents
El elemento Contents es un tipo simple que describe el tipo de datos de la entidad.
El contenido de la entidad (columna) pueden ser cualquiera de los valores siguientes:
| Valor | Descripción |
|---|---|
| Normal | No se define de otro modo. |
| Time | Los atributos representan periodos de tiempo, como años, semestres, trimestres, meses o días. |
| Geography | Los atributos representan información geográfica, como ciudades o códigos postales. |
| Organización | Los atributos representan información organizativa, como empleados o subsidiarias. |
| Lista de materiales | Los atributos representan información de inventario o de fabricación, como listas de piezas para productos. |
| Cuentas | Los atributos representan un gráfico de cuentas para informes financieros. |
| Clientes | Los atributos representan información de clientes o de contacto. |
| Productos | Los atributos representan información de productos. |
| Escenario | Los atributos representan información de planeación o análisis estratégico. |
| Cuantitativo | Los atributos representan información cuantitativa. |
| Utilidad | Los atributos representan información diversa. |
| Moneda | Contiene datos y metadatos de moneda. |
| Tarifas | Los atributos representan información de tasa de cambio. |
| Canal | Los atributos representan información de canal. |
| Promoción | Los atributos representan información de promociones de marketing. |
Tabular de ejemplo
En el ejemplo siguiente se muestra parte de la representación de la versión 1.1 de CSDLBI de la tabla Geography utilizada en el modelo tabular AdventureWorks. La columna RowNumber es una columna oculta generada automáticamente como identificador de fila en los modelos tabulares, por lo que tiene el atributo Contents, RowNumber.
<EntityType
Name="DimGeography">
<Key>
<PropertyRef Name="RowNumber" />
</Key>
<Property
Name="RowNumber"
Type="Int64" Nullable="false">
<bi:Property
Hidden="true"
Contents="RowNumber"
Stability="RowNumber" />
</Property>
....
Ejemplo multidimensional
En el ejemplo siguiente se muestran los elementos EntityType de la versión 1.1 de CSDLBI que representan una parte de una dimensión de tiempo del cubo de operaciones de Contoso.
<EntityType
Name="CalendarQuarter">
<Key>
<PropertyRef Name="RowNumber" />
</Key>
<Property Name="RowNumber"
Type="Int64"
Nullable="false">
<bi:Property
Hidden="true"
Contents="RowNumber"
Stability="RowNumber"
/>
</Property>
<Property Name="CalendarQuarter2"
Type="String"
MaxLength="Max"
Unicode="true"
FixedLength="false"
Nullable="false">
<bi:Property
Caption="CalendarQuarter"
ReferenceName="CalendarQuarter"
/>
</Property>
<bi:EntityType />
</EntityType>