Elemento EntityType (CSDLBI)
Importante: Questo documento è archiviato. Per le informazioni più recenti, vedere Open Specification [MS-CSDLBI]: Conceptual Schema Definition File Format with Business Intelligence Annotations.
L'elemento EntityType è un tipo complesso che rappresenta la struttura di un'entità di alto livello, ad esempio un cliente o un ordine, in un modello di dati. L'elemento bi:EntityType estende la definizione di EntityType usata in Entity Data Framework.
Un elemento EntityType deve essere specificato per ognuna delle entità incluse nel modello di dati. I sottoelementi di EntityType descrivono le colonne e le misure nella tabella. Le relazioni tra tabelle sono incluse in EntityContainer.
Elementi e attributi
Nella tabella seguente sono elencati gli elementi e gli attributi che definiscono l'elemento EntityType. Vedere anche gli attributi applicabili all'elemento EntityType.
| Nome | Obbligatorio | Descrizione |
|---|---|---|
| Contenuto | No | Stringa contenente i possibili tipi di dati in una colonna. Il valore è derivato dal valore di DimensionAttributeTypeEnumType nel modello di dati. Se il valore di DimensionAttributeTypeEnumType è "ExtendedType", il valore del contenuto è derivato dall'elemento ExtendedType di DimensionAttribute. Il client non è necessario per rispondere a tali valori. |
| DefaultDetails | No | Elenco di riferimenti a proprietà che rappresentano il set di colonne nella tabella. Vedere Elemento DefaultDetails (CSDLBI). |
| DefaultImage | No | Riferimento a una colonna contenente l'immagine che illustra l'entità. Nei modelli multidimensionali, questo elemento corrisponde a un attributo binario dell'attributo della dimensione. Se questo attributo è presente, l'elemento deve contenere un solo elemento MemberRef. Vedere Elemento MemberRef (CSDLBI). |
| DefaultMeasure | No | Riferimento a una misura dell'entità che deve essere utilizzato come impostazione predefinita durante l'esecuzione dei calcoli dell'entità. Se omesso, il valore predefinito è SUM. Vedere Elemento MemberRef (CSDLBI). |
| DisplayKey | No | Elenco di riferimenti a colonne o estremità del ruolo che costituiscono un identificatore sicuro che identifica in modo univoco un'istanza di entità. Vedere Elemento DisplayKey (CSDLBI). |
| Gerarchia | No | Elenco delle gerarchie nel modello. Vedere Elemento Hierarchy (CSDLBI). |
| ReferenceName | Sì | Identificatore che può essere utilizzato per fare riferimento a questa entità in una query DAX (Data Analysis Expressions). Se tale attributo non è presente, viene utilizzato il nome completo del campo dell'entità. |
| SortMembers | No | Elenco di proprietà utilizzato per l'ordinamento. L'attributo SortDirection indica se l'ordinamento è crescente o decrescente. |
Elemento Contents
L'elemento Contents è un tipo semplice che descrive il tipo di dati nell'entità.
Il contenuto dell'entità (colonna) può essere uno dei valori seguenti:
| Valore | Descrizione |
|---|---|
| Normale | Non altrimenti definito. |
| Ora | Attributi che rappresentano periodi di tempo, ad esempio anni, semestri, trimestri, mesi o giorni. |
| Area geografica | Attributi che rappresentano informazioni geografiche, ad esempio città o CAP. |
| Organization | Attributi che rappresentano informazioni sull'organizzazione, ad esempio dipendenti o filiali. |
| BillOfMaterials | Attributi che rappresentano informazioni relative alle scorte o alla produzione, ad esempio elenchi di parti di prodotti. |
| Account | Attributi che rappresentano un grafico dei conti per la creazione di rapporti finanziari. |
| Clienti | Attributi che rappresentano informazioni sui clienti o sui contatti. |
| Prodotti | Attributi che rappresentano informazioni sui prodotti. |
| Scenario | Attributi che rappresentano informazioni di pianificazione o di analisi strategica. |
| Quantitative | Attributi che rappresentano informazioni sulle quantità. |
| Utilità | Attributi che rappresentano informazioni di vario tipo. |
| Valuta | Contiene i dati e i metadati della valuta. |
| Rates | Attributi che rappresentano informazioni sui tassi valutari. |
| Channel | Attributi che rappresentano informazioni sui canali. |
| Promotion | Attributi che rappresentano informazioni sulle promozioni marketing. |
Esempio tabulare
Nel seguente esempio viene illustrata una parte della rappresentazione CSDLBI versione 1.1 della tabella Geography utilizzata nel modello tabulare AdventureWorks. La colonna RowNumber è una colonna nascosta che viene generata automaticamente come identificatore di riga nei modelli tabulari e ha quindi l'attributo 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>
....
Esempio multidimensionale
Nell'esempio seguente vengono illustrati gli elementi EntityType di CSDLBI versione 1.1 che rappresentano una parte della dimensione temporale del cubo Operations di 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>