Elemento Property (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 Property in CSDLBI è un tipo complesso che fornisce le aggiunte all'elemento Property di CSDL, a supporto dei modelli di dati di Business Intelligence.

Elementi e attributi

Nella tabella seguente vengono elencati gli attributi e gli elementi che definiscono l'elemento Property di CSDLBI.

Nome	Obbligatorio	Descrizione
Contenuto	No	Stringa che contiene l'identificatore delle impostazioni locali (LCID) della richiesta.
DefaultAggregationFunction	Sì	Stringa che specifica la funzione di aggregazione che deve essere utilizzata se i calcoli vengono eseguiti sull'attributo e nessun'altra funzione è stata specificata. Se omessa, viene utilizzata l'aggregazione predefinita per il modello, di solito SUM.
GroupingBehavior	No	Valore che specifica come vengono raggruppati i risultati della query. Il contenuto dell'attributo è definito dal tipo semplice TGroupingBehavior (vedere la tabella di seguito).
OrderBy	No	Riferimento a un'altra proprietà all'interno del modello che definisce l'ordinamento per i valori di questa proprietà. I valori per le due proprietà DOVONO avere un mapping da 1 a 1. In caso contrario, il comportamento dell'ordinamento è indefinito. Se questo elemento viene omesso, le proprietà vengono ordinate in base ai relativi valori.
Stability	No	Attributo che specifica la stabilità dei valori di proprietà tra le operazioni di aggiornamento. Questo attributo non viene impostato dagli utenti, ma viene generato dall'ambiente di progettazione solo per valori instabili. Viene sempre applicato alle colonne contenenti un numero di righe e alle colonne contenenti formule che generano risultati indeterminati, ad esempio NOW() o RAND(). I valori per questo attributo sono elencati nella tabella seguente in cui viene descritto il tipo Stabilitysimple.

GroupingBehavior

Nella tabella seguente vengono elencati i valori del tipo semplice GroupingBehavior.

Valore	Descrizione
GroupOnValue	Raggruppare in base al valore dell'attributo.
GroupOnEntityKey	Raggruppare in base alla chiave di entità.

Nell'esempio seguente viene illustrato l'utilizzo di questi due valori. Si supponga che la query sia stata progettata per restituire le deduzioni delle retribuzioni per un determinato utente che viene specificato in base al nome. Se il database contiene due utenti con lo stesso nome ma con identificatori di database diversi, i risultati della query sono diversi a seconda del valore dell'attributo applicato alla colonna:

GroupOnValue: i risultati della query includono le detrazioni delle retribuzioni di entrambi gli utenti, totali.
GroupOnEntityKey: i risultati della query includono le detrazioni relative alle retribuzioni per ogni utente, ma elencate singolarmente.

Stability

Nella tabella seguente sono elencati i valori del tipo semplice Stability .

Valore	Descrizione
Stable	La proprietà rimane costante tra le operazioni di aggiornamento.
RowNumber	La proprietà contiene un numero di riga.
Volatile	La proprietà potrebbe non rimanere costante tra le operazioni di aggiornamento.

Esempio tabulare

Nell'XML seguente vengono rappresentate, in CSDLBI versione 1.1, alcune proprietà nel modello tabulare di esempio di AdventureWorks.

  
<EntityType   
   Name="DimEmployee">  
   <Key>  
      <PropertyRef   
      Name="RowNumber" />  
   </Key>  
  
   <Property   
      Name="RowNumber"   
      Type="Int64"   
      Nullable="false">  
   <bi:Property   
      Hidden="true"   
      Contents="RowNumber"   
      Stability="RowNumber" />  
   </Property>  
  
   <Property   
      Name="EmployeeKey"   
      Type="Int64">  
   <bi:Property />  
   </Property>  
….  
</bi:EntityType>  
</EntityType>

Esempio multidimensionale

Nell'esempio seguente, in CSDLBI versione 1.1, vengono mostrate alcune proprietà per le colonne del modello di dati che rappresenta il cubo Operations di Contoso. Si noti che le annotazioni Business Intelligence non vengono richieste o applicate alla maggior parte delle colonne, ma solo a quelle che richiedono una gestione speciale nel livello di presentazione.

  
<EntityType   
   Name="Bike">  
  
   <Key>  
      <PropertyRef Name="RowNumber" />  
   </Key>  
  
   <Property   
      Name="RowNumber"   
      Type="Int64"   
      Nullable="false">  
   <bi:Property   
      Hidden="true"   
      Contents="RowNumber"   
      Stability="RowNumber"   
   />  
   </Property>  
  
   <Property   
      Name="ProductAlternateKey"   
      Type="String"   
      MaxLength="Max"   
      Unicode="true"   
      FixedLength="false">  
   <bi:Property />  
   </Property>

Condividi tramite