NamingTemplate 要素 (ASSL)

Dimensionattribute親要素から構築された親子階層内のレベルの名前付け方法を定義します。

構文

  
<DimensionAttribute>  
   ...  
      <NamingTemplate>...</NamingTemplate>  
   ...  
</DimensionAttribute>  

要素の特性

特徴	説明
データ型と長さ	String
既定値	なし
カーディナリティ	0-1 : 省略可能な要素で、出現する場合は 1 回だけの出現が可能です

要素の関係

リレーションシップ	要素
親要素	DimensionAttribute
子要素	なし

解説

Namingtemplate要素の値は、親属性によってのみ使用されます (つまり、 dimensionattribute親要素のUsage要素の値がparentに設定されます)。

親属性を使用して階層を構築する際、階層のレベルは親属性に含まれるメンバー間の親子関係により決まります。 したがって、他のディメンションとは異なり、階層に使用されている属性名からレベル名を得ることはできません。

その代わりに、名前付けテンプレートを使用して親子階層のレベル名を生成します。 親属性で定義されている Namingtemplate 要素には、レベル名を定義するための文字列式が含まれています。 親属性の名前付けテンプレートを定義するには、 名前付けパターンを作成するか、名前の一覧を指定します。

名前付けパターンには、カウンターのプレースホルダー文字としてアスタリスク ( * ) が含まれています。これは、それぞれの新しいレベルと深いレベルの名前にインクリメントされ、挿入されます。 たとえば、(All) レベルが定義されていない場合、を使用する Level * と、レベル名 Level 01Level 02Level 03 、、、などが返されます。 名前付けパターンにプレースホルダー文字が使用されていない場合、最初のレベルにはパターンがそのまま使用され、以降のレベルはパターンの末尾にスペースと番号を追加した名前になります。 たとえば、を使用する Level と、レベル名 LevelLevel 01Level 02 、、などが返されます。

特定の名前のセットを名前付けに使用するには、 Namingtemplate 要素の値にレベル名のセミコロン区切りのリストを設定します。 一覧に含まれるそれぞれの名前が、以降のレベル名に使用されます。 一覧の名前の数よりもレベルの数が多い場合、超過分のレベル名には一覧の最後の名前がテンプレートとして使用されます。その場合、先に説明したように、最後の名前の末尾にスペースと番号を追加した名前が使用されます。 たとえば、を使用する Division;Group;Unit と、レベル名 DivisionUnit 01GroupUnitUnit 02 、、、、などが返されます。 これに対し、を使用する Division;Group;Unit * と、レベル名 Unit 03DivisionGroupUnit 04 、、、などが返されます。

一覧に含まれる名前は、レベル名の一意性を確保するためのテンプレートとして扱われます。 たとえば、を使用する Manager;Team Lead;Manager;Team Lead;Worker * と、レベル名 ManagerTeam LeadTeam Lead 01Manager 01Worker 05 、、、、、 Worker 06 が返されます。

名前付けテンプレートで指定するレベル名にアスタリスク (*) を含めるには、アスタリスクを 2 つ (**) 使用します。

分析管理オブジェクト (AMO) オブジェクトモデルの Namingtemplate の親に対応する要素は DimensionAttribute です。

参照

NamingTemplateTranslations 要素 (ASSL)
DimensionAttribute データ型 (ASSL)
プロパティ (ASSL)