EntityType 元素 (CSDLBI)

發行項
10/31/2023

重要： 這份檔已封存。如需最新資訊，請參閱 Open 規格 [CSDLBI]：概念結構定義檔案格式與商業智慧批註。

EntityType元素是複雜類型，代表資料模型中高層級實體的結構，例如客戶或訂單。 Bi： EntityType元素會擴充實體資料架構中使用之EntityType的定義。

系統必須針對資料模型中包含的每個實體指定 EntityType 元素。 EntityType 的子元素會描述資料表中的資料行和量值。資料表之間的關聯性包含在 EntityContainer中。

元素和屬性

下表列出定義 EntityType 元素的元素和屬性。另請參閱適用于 EntityType 元素的屬性。

名稱	必要	描述
目錄	否	字串，其中包含資料行中可能的資料類型。此值衍生自資料模型中的 DimensionAttributeTypeEnumType 值。如果 DimensionAttributeTypeEnumType 的值為 "ExtendedType"，則 Contents 的值會衍生自 DimensionAttribute 的 ExtendedType 元素。用戶端不需要回應這些值。
DefaultDetails	否	屬性參考的清單，代表資料表中的資料行集。請參閱 DefaultDetails 元素 (CSDLBI) 。
DefaultImage	否	包含說明實體之影像的資料行參考。在多維度模型中，此元素對應維度屬性上的二進位屬性。如果此屬性存在，則元素必須只包含單獨一個 MemberRef 元素。請參閱 MemberRef 元素 (CSDLBI) 。
DefaultMeasure	否	實體中量值的參考，應在對實體進行計算時用做預設值。如果未指定，則預設值為 SUM。請參閱 MemberRef 元素 (CSDLBI) 。
DisplayKey	否	資料行或角色端的參考清單，此清單構成可唯一識別實體執行個體的強式識別碼。請參閱 DisplayKey 元素 (CSDLBI) 。
階層	否	模型中階層的清單。請參閱階層元素 (CSDLBI) 。
ReferenceName	是	可用於在 Data Analysis Expressions (DAX) 查詢中參考此實體的識別碼。如果此屬性不存在，則會使用實體的完整欄位名稱。
SortMembers	否	要排序的屬性清單。 SortDirection 屬性會指出次序為遞增或遞減。

Contents 元素

Content-type 元素是 描述實體中資料類型的簡單類型。

實體 (資料行) 的內容可以是下列任何值：

值	描述
定期	未另行定義。
時間	代表時間週期的屬性，例如年數、半年數、季數、月數或日數。
[地理位置]	代表地理資訊的屬性，例如城市或郵遞區號。
組織	代表組織資訊的屬性，例如員工或分公司。
BillOfMaterials	代表存貨或製造資訊的屬性，例如產品的組件清單。
帳戶	屬性代表財務報表的帳戶圖表。
客戶	代表客戶或連絡資訊的屬性。
產品	代表產品資訊的屬性。
案例	代表計畫或策略分析資訊的屬性。
數量	代表數量資訊的屬性。
公用程式	代表其他資訊的屬性。
貨幣	包含貨幣資料和中繼資料。
匯率	代表貨幣匯率資訊的屬性。
通路	代表通路資訊的屬性。
促銷	代表行銷促銷資訊的屬性。

表格式範例

下列範例顯示 AdventureWorks 表格式模型中所使用 CSDLBI 1.1 版 Geography 資料表的一部分。 RowNumber 資料行是隱藏的資料行，會自動產生為表格式模型中的資料列識別碼，因此具有 [內容] 屬性（ 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>  
....

多維度範例

下列範例顯示 CSDLBI 1.1 版中的 EntityType 元素，代表 Contoso Operations Cube 中時間維度的一部分。

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

共用方式為