概念: 表示名に対する組織コード、属性コード、特性コード
Workday Adaptive Planning で表示名を有効にすると、複数の組織、カスタム属性値、または特性値に同じラベルを使用できます。この機能をオンにすると、以下のようになります。
- Workday 財務管理、Workday ヒューマン キャピタル マネジメント、またはその他の外部システムからの構造のロードが簡素化される。
- Adaptive Planning でラベルを一意にするために、Workday またはその他のインポートにおけるラベルと参照 ID を連結する必要がなくなる。
- ラベルが一致する場合に、簡略化されたメタデータのロード プロセスが提供される。
表示名の有効化
各組織、カスタム属性値、特性値には一意のコードが付与されます。
このコードはキーとして機能します。
組織、属性値、特性値を含む数式の場合
code
に置き換えられる name
不明確にならないようにするため。インテグレーション ローダはそのまま動作し、自動的にコードを列マッピングに使用します。表示名を有効にすると、異常検出の閾値が 40% にリセットされます。
メタデータのコード
表示名が導入される前は、組織、カスタム属性、または特性内の名前に一意性が求められていました。
既存のインスタンスの場合、すでに作成した名前を再利用してコードが自動生成されます。
Workday Adaptive Planning において、コードは常にかっこ内に表示されるため、簡単に識別できます。例: [westeu01]。
表示名と表示名の形式
表示名を有効にすると、組織、属性値、特性値に読み取り専用の
"表示名"
フィールドが導入されます。表示名は、Workday Adaptive Planning 全体でメタデータ要素 (以前は名前フィールド) に表示されるラベルとして機能します。メタデータ要素を選択したり、表示したりすると、表示名が表示されます。既存の Workday Adaptive Planing インスタンスの場合、表示名の形式として
"名前"
が自動入力されます。組織、属性、特性の管理ページでは、表示名の形式として以下のいずれかを選択できます。
- 名前
- コード
- 名前 [コード]
- [コード] 名前
表示名の形式は、属性ルートで、属性ごとに設定できます。値ごとに対応するコードが表示されます。
表示名とコードは、それぞれ 2,048 文字、組み合わせた場合は 4,096 文字を使用できます。
表示名のコンポーネントを変更すると、
"並べ替えを維持"
が有効になっている場合でも、属性管理または特性管理で要素のソート順が変わる可能性があります。構造インポートの表示名
組織、カスタム属性、特性の構造をインポートする際は、コードがサポートされており、インポート テンプレートに表示名の形式、値のコード、値の名前の列が必要となります。名前列が値のコード列と値の名前列に置き換わります。
常に新しいインポート テンプレートをダウンロードし、最初のシートの指示に従ってください。表示名を有効にすると、テンプレートの必須列と列名が変更されます。古いテンプレートや、表示名が有効になっていないインスタンスのテンプレートを再利用しないでください。
組織の名前やコードを変更する目的でインポートを使用しないでください。これらの変更は、アプリケーションで手動で行う必要があります。
階層の場合は、親のコードを参照して親の値を指定します。
構造インポートでは、表示名をサポートするために以下の列が必要です。
組織のインポート
- 組織の表示名の形式
- 組織 コード
- 特性値コード
- 特性値の名前
属性のインポート
- 属性の表示名の形式
- 属性値のコード
- 属性値の名前
- 特性値コード
- 特性値の名前
特性のインポート
- 特性の表示名の形式
- 特性値コード
- 特性値の名前
科目のインポート
- 特性値コード
- 特性値の名前
組織、属性、特性の印刷対応ビューにはすべて、表示名、値のコード、値の名前の列が含まれています。
インテグレーションにおける表示名の要素
Workday Adaptive Planning インテグレーションにメタデータ コードを導入することで、以下に役立ちます。
- マッピング: ユーザーが外部メタデータ要素と Workday Adaptive Planning の内部要素を関連付けられるようになります。
- 情報の表示: インテグレーション ユーザーが重複するラベルを区別できるようになります。
- 検索: ユーザーがメタデータ コードに基づいて特定の要素を見つけられるようになります。
マッピング、表示、検索は、データ ソース、データ ローダ、メタデータ ローダの作成中およびメンテナンス中に行われます。
Planning データ ソースにおける表示名の要素
Planning データ ソースで共有パラメータを作成すると、以下が可能になります。
- 組織、属性値、特性値の表示名とコードを確認する。
- 表示名またはコードで共有パラメータを検索する。
管理対象ソースに対してコードを含めるかどうかを設定
既存のインスタンスで表示名を有効にして、
"ソースの管理"
をクリックすると、以下のソースの "コードを含める"
をオンにできます。これにより、組織、属性、特性を追加したり、組織、属性、特性でフィルタリングしたりできるようになります。
- カスタム:
- キューブ シート
- モデル シート
"コードを含める"
をオンにすると、無効にすることはできません。表示名を有効にすると、作成した新規の管理対象ソースでは、デフォルトで
"コードを含める"
が自動的にオンになります。インテグレーション ローダにおける表示名の要素
表示名を有効にすると、属性、特性、組織のローダが列マッピングのコードに自動マッピングされます。列を自動マッピングする必要がある場合は、コード別または名前別に自動マッピングするように選択できます。
Planning データ ローダの列マッピング
データを送信すると、データは名前別ではなくコード別にロードされます。
"列マッピング"
タブを使用して列をマッピングする場合は、ソース ID 列をコードにマッピングします。ソース表示名列を名前にマッピングします。Planning データ ローダのデータ マッピング
"データ マッピング"
タブをクリックすると、以下の列別にすべての列または選択した列を自動マッピングできます。
- ソース ID 列
- ソース表示名列
"データ マッピング"
タブからマッピングをダウンロードする場合、テンプレートではソース ID 列のコードが使用されます。マッピングをアップロードする場合、テンプレートではソース ID 列のコードが必要になります。Planning データ ローダのデータ ソース設定
Planning データ ローダの "データ ソース設定" タブには、自動マッピングのセクションが含まれています。このセクションでは、ローダの実行時に、新しい科目、組織、または属性値を任意で自動マッピングできます。"組織を自動マッピング" と "属性を自動マッピング" ではコードがサポートされており、以下のオプションがあります。
- ソース ID をコードに自動マッピング
- ソース表示名をコードに自動マッピング
API における表示名の要素
表示名を有効にした API でメタデータをサポートできるようになりました
code
条件:
- 呼び出しに API v30 以上を使用している。
- 以下を含めます。displayNameEnabled=1パラメータdimensions要素attributes要素およびlevels要素
displayNameEnabled=0
ある要素に対する はその要素の表示名を無効にし、 を使用できなくなります。 code
および用途 name
代わりに。これらのバルク API によるサポート
code
表示名を有効にして、すべて ID をキーとして使用している場合は、以下のようになります。
- updateAttributes
- updateDimensions
- updateLevels
- importDimensionMapping
これらのデータ API によるサポート
code
表示名を有効にした場合、以下のようになります。
- eraseData
- exportConfigurableModelData
- exportData
- importConfigurableModeleData
- importStandardData
- importCubeData
- importTransactions
リクエストおよびレスポンスにおける表示名の要素の使用に関する詳細については、API の各ドキュメント ページを参照してください。
メタデータ バルク API による特性のタグ付け (API v32 および v33)
これらのバルク API によるサポート
valueCode
および valueName
表示名と使用状況が導入された API v32 および API v33 displayNameEnabled=1
:
- updateLevels上位目標valueCodeおよびvalueName次の中dimensionおよびattribute要素
- updateAccounts上位目標valueCodeおよびvalueName次の中attribute要素
- updateDimensions上位目標valueCodeおよびvalueName次の中attribute要素
- exportLevels上位目標valueCodeおよびvalueName次の中dimensionおよびattribute要素
- exportAccounts上位目標valueCodeおよびvalueName次の中attribute要素
- exportDimensions上位目標valueCodeおよびvalueName次の中attribute要素
name
特性要素内の単一メタデータ API
以下の単一メタデータ API では、表示名はサポートされていません。
- updateDimension
- updateDimensionValue
- updateLevel
- createDimension
- createDimensionValue
- createLevel
数式における表示名の要素
表示名を有効にすると、数式で組織、カスタム属性値、または特性値を参照するときに、コードを使用する必要があります。以前に名前が表示されていたフォーミュラ アシスタントの任意の場所に、表示名が表示されます。
フォーミュラ アシスタントの要素ピッカーは、表示名とコードの両方に基づいて検索結果を生成します。数式の一部になるのは要素のコードのみです。
プロパティにおける表示名要素と数式のドット表記
表示名を有効にすると、
code
プロパティにおける数式のドット表記プロパティにドット表記を使用して数式を作成すると、 によって組織、カスタム属性値、特性値を参照できます。 code
。ドット表記では、既存の項目を手動で変更する必要があります。
.name
への参照 .code
(表示名が有効になっている場合)表示名をドット表記にすると、計算時に一意性を確保できないため、使用できません。
レポートでカスタム計算の数式を使用した後に、表示名の形式を変更する場合は、数式を見直して正しく表示されるようにしてください。
シートにおける表示名の要素
表示名を有効にした場合、モデル シートのデータをダウンロードするには以下の 2 つのオプションがあります。
- ダウンロード: シート上の組織、属性値、特性値のコードをエクスポートします。モデル シートにデータをインポートして戻す場合は、このオプションを使用します。
- 印刷対応ビュー: 組織、属性値、特性値の設定済み表示名をエクスポートします。スプレッドシートを現在の"表示オプション"と一致させる場合は、このオプションを使用します。このバージョンのスプレッドシートをインポートすることはできません。
これらのオプションのいずれかを選択するには、以下を実行します。
- "シートの概要" からモデル シートを開く場合は、"ダウンロード"ボタンの横にある矢印をクリックします。
- ダッシュボードからモデル シートを開く場合は、詳細アイコンをクリックします。
標準シートとキューブ シートでは、
"ダウンロード"
オプションを使用すると、組織、属性値、特性値の表示名が引き続きエクスポートされます。また、シートで定義した "表示オプション"
と引き続き一致しています。レポートにおける表示名の要素
レポート ビルダーでは、選択した表示名の形式を使用して、以下のレポートで表示名別にメタデータ要素が表示されます。
- マトリクス レポート
- モデル レポート
レポートを表示する際、要素は表示名でロードされます。要素をビルダーにドラッグしてレポートを作成すると、表示名のみが表示されます。
マトリクス レポートのフォーミュラ アシスタントでは、ピッカーの要素が表示名別に表示されます。カスタム計算の数式では、選択した要素のコードが常に使用されます。
モデル レポートのフィルタでは、表示名が使用されます。
リンク組織のリフレッシュでの表示名要素
マルチインスタンス環境で親インスタンスと子インスタンスの表示名を有効にすると、リンク組織のリフレッシュによって名前が表示名に置き換えられます。
OfficeConnect の表示名
すべての OfficeConnect レポート要素について、ラベル定義におけるラベルのタイプ値として "表示名" を使用できます。このラベルのタイプ値は、Adaptive Planning での重複メタデータ名をサポートします。
テンプレートのインポート
内のインポート テンプレートの形式と手順が示すように、以下のインポートでは一意の識別子としてコードが必要になります。
- 標準データのインポート
- モデル シート データのインポート
- キューブ シート データのインポート
- トランザクション データのインポート
属性列が 2 列に分割されている場合:
- 属性 コード
- 属性 名前
"属性 名前" 列は任意です。この列が存在しない場合は、"属性 コード" が "属性 名前" になります。属性コードが異なる場合、属性名の値が重複する可能性があります。
"組織" 列ヘッダーは以下を示します。
- 組織 コード
"科目" 列ヘッダーは、ラベルとして以下のいずれかをサポートします。
- 科目コード
- 科目
"表示名に "コード" 列と "名前" 列を含めずにインポート"
を選択して、"コード" フィールドと "名前" フィールドに列のないテンプレートをインポートできます。このオプションを使用して、表示名が導入される前に作成された古いテンプレートからインポートすることもできます。 "一般設定"
で "表示名の単一列データのインポート/エクスポートの有効化"
をオンにすると、アプリケーション全体で "表示名に "コード" 列と "名前" 列を含めずにインポート"
が適用され、"インポート" ページのオプションが非表示になります。