NamingTemplate 元素 (ASSL)
定義在從 DimensionAttribute 父元素建構的父子式階層中如何命名層級。
語法
<DimensionAttribute>
...
<NamingTemplate>...</NamingTemplate>
...
</DimensionAttribute>
元素特性
特性 |
說明 |
---|---|
資料類型和長度 |
字串 |
預設值 |
無 |
基數 |
0-1:只能出現一次的選擇性元素。 |
元素關聯性
關聯性 |
元素 |
---|---|
父元素 |
|
子元素 |
無 |
備註
NamingTemplate 元素僅的值僅供父屬性使用 (換言之,DimensionAttribute 父元素之 Usage 元素的值會設定為 Parent)。
當父屬性用於建構階層時,階層的層級就會由父屬性所包含之成員之間的父子式關聯性決定。 因此,與其他維度不同的是,您無法從用於階層的屬性名稱中提取層級名稱。
不過,系統會使用命名範本來產生父子式階層的層級名稱。 定義於父屬性中的 NamingTemplate 元素包含用來定義層級名稱的字串運算式。 目前有兩種方式可定義父屬性的命名範本。 您可以設計命名模式,也可以指定一份名稱的清單。
命名模式會包含星號 (*) 當做計數器的預留位置字元,而此計數器會遞增並插入每個全新且更深層級的名稱。 例如,如果沒有定義任何 (全部) 層級,使用 Level * 就會產生 Level 01、Level 02、Level 03 等層級名稱。 如果命名模式沒有包含預留位置字元,系統會先依原狀使用它,接著後續層級名稱的構成方式是在模式的結尾附加一個空格和一個數字。 例如,使用 Level 就會產生 Level、Level 01、Level 02 等層級名稱。
若要使用特定名稱集合來命名,NamingTemplate 元素的值會設定為層級名稱的分號分隔清單。 清單中的每個名稱都會用於後續層級名稱。 如果層級的數目超過清單中名稱的數目,系統就會使用清單中的最後一個名稱當做任何其他層級名稱的範本,並且如先前所述,在最後一個名稱後面附加一個空格和一個序數。 例如,使用 Division;Group;Unit 就會產生 Division、Group、Unit、Unit 01、Unit 02 等層級名稱。 反之,使用 Division;Group;Unit * 則會產生Division、Group、Unit 03、Unit 04 等層級名稱。
清單中的每個名稱都會被視為範本,以便確保層級名稱的唯一性。 例如,使用 Manager;Team Lead;Manager;Team Lead;Worker * 就會產生 Manager、Team Lead、Manager 01、Team Lead 01、Worker 05、Worker 06 等層級名稱。
若要在層級名稱中加入星號 (*) 字元當做命名範本的一部分,請使用兩個星號 (**)。
在「分析管理物件」(AMO) 物件模型中對應至 NamingTemplate 父系的元素是 DimensionAttribute。
請參閱
參考
NamingTemplateTranslations 元素 (ASSL)