Elemento EntityType (CSDLBI)

Articolo
10/31/2023

Importante: Questo documento viene archiviato. Per le informazioni più recenti, vedere Open Specification [MS-CSDLBI]: Conceptual Schema Definition File Format with Business Intelligence Annotations (Specifica aperta [MS-CSDLBI]: Formato del file di definizione dello schema concettuale con annotazioni di Business Intelligence).

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 deriva 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>

Condividi tramite