Planning 属性ローダの作成
メタデータ ローダは、ソース システムからプランニング モデルの階層に階層情報を同期させます。同期させる前に、ソース システムにすでに階層が存在している必要があります。
Planning 属性ローダの更新リクエストでは、階層属性の場合最大 10,000、またはフラット属性の場合 40,000 と属性値の数が制限されています。これらの制限は、ローダ リクエスト内の新しい属性値の作成には適用されません。
Planning 属性ローダでは、ステージング領域の属性値に関するメタデータを にマッピングできます。
Adaptive Planning
。Planning 属性ローダの主な利点は、"モデリング" > "モデル管理" > "属性" で 1 つずつ属性値を作成するのではなく、属性値を一括インポートできる点です。ローダを作成したら、手動で実行、またはインテグレーション タスクの一部として実行するようスケジュールを設定できます。Planning 属性ローダを作成するには、次の手順に従います。
- データ ソース設定の入力
- 列マッピングの設定
- ビジネス ルールの作成
- ローダ出力のプレビュー
- ローダの実行またはスケジュール設定
始める前に
Planning 属性ローダには、既存の データ ソースのインポートからのステージング データが必要です。
データ ソース設定の入力
データ ソース設定では、ステージング データから使用するソース テーブルを選択し、ロードする Planning 属性を選択し、新しい属性値を自動的に作成するかどうかを選択できます。
- "インテグレーション" > "インテグレーション設定"へ移動します。
- コンポーネント ライブラリのローダ領域で"新しいローダを作成"をクリックします。
- ローダ タイプとして"Planning 属性ローダ"を選択します。ローダの名前を入力します。
- "作成"をクリックします。
ベスト プラクティス: ローダを作成および編集する際は、"アクション" パネルで
"保存"
をクリックして頻繁に保存します。"閉じる"
をクリックしてから "いいえ"
をクリックすると、保存していない変更を廃棄できます。 以下の通り、Planning 属性ローダの一般プロパティ情報を入力します。
- ソース テーブル:ドロップダウン リストからソース テーブルを選択します。リスト内のソース テーブルは、アクセス権を持つステージング領域内で利用できるすべてのテーブルです。
- Planning 属性:ロードするソースのすべての属性から属性を 1 つ選択します。リストされている属性は、"モデリング" > "モデル管理" > "属性" から取得されます。
- Planning に見つからない場合は属性値を作成する: ソース システムで見つかったものの、"モデリング" > "モデル管理" > "属性" では見つからなかった新しい属性値を自動的に作成する場合にオンにします。このオプションをオフにすると、既存の属性値の更新のみが実行され、新しい属性は作成されません。
- ロードする属性について、 "モデリング" > "モデル管理" > "属性" の "データのインポートにより自動的に属性値を作成する" が有効になっていない場合、ローダは次の警告を表示します。
- ログ レベル:ローダを実行するときに記録する詳細のタイプを選択します。
- エラー:重大なエラーのみを記録します。
- 情報:ローダが更新された場合など、基本情報を記録します。
- 詳細:すべての段階と操作に関する詳細な情報を提供します。このレベルは、主にデバッグや監査に使用されます。一般的な用途よりも多くのログ情報を生成する可能性があります。
列マッピングの設定
列マッピングを使用すると、データ ソースの列を "モデリング" > "モデル管理" > "属性" で選択可能な属性値にマッピングできます。
マッピングする列が複数ある場合、
"フィルタの表示"
を使用して、以下を選択できます。
- すべて: Planning 列をすべて表示します。
- 必須: 必要な Planning 列をすべて表示します。
- マッピング解除済: マッピングが解除された Planning 列をすべて表示します。
- マッピング済: マッピング済みの Planning 列をすべて表示します。
"検索"
フィールドを使用して列を見つけることができます。完全な名前または部分的な名前を入力して検索し、虫眼鏡をクリックします。検索に一致するステージング列は、結果に表示されます。- 列をマッピング
- "列マッピング"をクリックします。"列マッピング" タブには下記が含まれます。
- ステータス:Planning 列がマッピング済みかどうかを示します。チェックマーク
マッピングされた列を示します。感嘆符
マッピングされていない列を示します。 - Planning 列:シートにマッピングできる Planning 列をすべて表示します。Planning 列のリストには、必須の Planning 列と、それに続く他のすべての Planning 列が含まれています。必須の Planning 列は、アスタリスクを使用した太字のテキストで示され、値列を含みます。必須ではない列には、短縮名と説明が含まれます。
- ソース列:"データ ソース設定" で選択したステージング テーブル内の列を表示します。
- マッピング解除済の列を選択し、ドロップダウンをクリックします。マッピングできる列のリストがドロップダウン リストに表示されます。列をマッピングすると、ステータス インジケータが赤の
から緑の
に変わります。
"データのインポートにより自動的に属性値を作成する"が有効になっている場合は、コードごとに属性をマッピングできます。この場合、属性名が自動的にコードになります。属性値とその親を Planning にマッピングする方法については 、例: スプレッドシートのデータ ソースからの属性値のロードを 参照してください。- ロード時の Planning 属性値の名前の変更
- ロード時に Planning 属性値の名前を変更するには、以下の手順に従います。
- ソース内の属性値を一意的に識別する "ソース列" を選択します。
- ID 列を属性値 ID にマッピングします。
- 名前を属性値名にマッピングします。
- 列のマッピングを解除
- 列のマッピングを解除するには、"マッピング解除"をクリックして、以下を選択します。
- すべてマッピング解除:列のマッピングをすべて解除します。
- 選択項目をマッピング解除:選択した列のみマッピングを解除します。
列のマッピングを解除すると、ステータス アイコンが赤の
に変わります。 - リスト属性に関連付けられたマッピング特性
- データ ソースのインポートから列をマッピングすることにより、特性をリスト属性に関連付けることができます。特性と属性の関連付けは、リスト属性についてのみ可能です。特性を階層属性に関連付けることはできません。以内Adaptive Planning"モデル管理" >"属性"にアクセスし、属性をクリックして詳細を表示し、それがリスト属性であるかどうかを確認できます。データ ソース設定で、Planning 属性としてリスト属性を選択します。この属性はリスト属性であるため、特性は列マッピング内の列として使用可能になります。リスト属性は階層ではないため、parentId は "ソース列" のオプションではありません。
マッピングのダウンロードおよびアップロード
ローダのマッピングをダウンロードして変更し、アップロードすることで、マッピングのエラーを迅速に解決できます。アップロードを実行すると、すべてが置換されます。アップロード時に処理できるファイルのマッピング シートは 1 枚のみです。マッピング シートが複数あるとエラーになり、アップロードがキャンセルされます。
- "アクション"ペインで"メンバー マッピングをダウンロード"をクリックします。
- .XLSX ファイルをダウンロードします。また、マッピング ファイルのダウンロード リンクが記載された E メールまたは Workday 通知が届きます。
- ファイルを開いて、エラーの原因となっているマッピング シートのステージング テーブルの値を調べます。"Planning のコード"列または"Planning の名前"列で "(無効)" とマークされたセルは、このコードが Workday Adaptive Planning に存在しないことを示しています。
- エラーを修正し、"メンバー マッピングのアップロード"をクリックしてファイルをロードします。"読み取り専用"列はアップロードされません。
- ローダを再度実行します。
導入パートナーまたは Workday Adaptive Planning サポートによる指示がない限り、
"メンバー マッピングをクリア"
はクリックしないでください。ビジネス ルールの作成
ビジネス ルール
を使用して、ステージングのどのデータをロードに使用できるかを制限する SQL 式を作成できます。フィルタ基準を満たすレコードのみがロードされます。
SQL フィルタを作成するには、次のようにします。
- "ビジネス ルール"タブで"SQL フィルタ"を選択します。"編集"をクリックします。
- SQL 式を入力します。"使用できる列" リストでアイテムをクリックすると、タイピングせずに、その列を SQL 式に持ってくることができます。
- "適用"をクリックして、SQL 構文を確認します。構文のエラーが発生すると、式を囲む線が赤に変わります。SQL エディタの上にマウスを合わせて、構文エラー情報を確認します。SQL 構文の詳細なヘルプについては、"SQL フィルタを編集" の "メモ" セクションの"オンライン ヘルプ"をクリックします。また、"SQL 式参照"にアクセスすることもできます。
- 構文のエラーを修正し、"適用"をクリックします。ローダを実行すると、SQL 式に一致するステージング行のみがインポートされます。
ローダ出力のプレビュー
完全ロードを実行する前にローダ出力をプレビューして、マッピングが必要とする仕様であることを確認できます。その出力を XML ファイルとしてダウンロードして、データ ソースからの属性値をロードする前に、その値が要件に合っていることを手動で確認することもできます。
- "アクション" パネルで"ローダ出力のプレビュー"をクリックします。
- (任意) "ローダ出力のプレビュー" 設定を入力します。入力できる情報は、この Planning 属性ローダで選択したデータ ソースによって異なります。ここで設定を変更すると、ステージング テーブルおよび列に新しいデータがインポートされます。
- "ローダ出力のプレビュー"をクリックします。
ローダが実行され、すべての変換とビジネス ルールが実行の一部として適用されます。ステータス ポップアップは、ローダが実行したステップを表示します。ロードする属性値がある場合、ローダは XML ファイルを作成し、それを Zip された XML 添付ファイルとしてローダの出力を含む E メール通知を送信します。
ローダが成功した後、追加のポップアップで、"ローダ出力のプレビュー" を Zip された XML ファイルとしてダウンロードできます。ダウンロードのポップアップは、属性値の数とファイルのサイズに応じて、表示されるまでにしばらく時間がかかることがあります。
- 検証エラーの修正
- 属性値がロードされると、ソース データは次のエラーに対して検証されます。
- データにおいて属性値のソース ID 値が欠落しています (空欄)。
- データにおいて、ソース ID が重複しています。ソース ID は一意である必要があります。
- データに属性値名がありません (空欄)。
- データに重複した属性値名があります。
- ParentId がデータのソース ID と同じである場合、列はそれ自体をその親として参照しています。
- サブツリーをインポートする場合、サブツリーのルートは、Planning の既存のノードにマッピングされます。この場合、parentID は Planning に導入される新しいノードのソース データに含まれません。
- 既存のノードが新しいノードの下に移動し、"新規作成" フラグが無効になります。この場合、新しい属性値を作成しないようにローダに明示的に指示しておくと、既存の属性値は新しいノードに移動します。
- データの階層に周期的参照があります。この場合、ParentId はその子を親として参照しています。
ローダの実行
必要なすべての構成設定とともに Planning 属性ローダを保存すると、ローダを手動で実行するか、スケジュールされたインテグレーション タスクとして実行できます。
各 Planning 属性ローダの実行の間には、約 15 ~ 30 分の待機時間をおきます。
Adaptive Planning
はインポートと同期する時間を確保します。より大きなインポートは同期するのにより長い時間がかかります。待機時間はモデル サイズやその他の要因によって異なります。ソース システムから直接インポートすることも、すでにインポートされたステージング値を使用してローダを実行することもできます。ローダの実行時に、これらの動作のどれを使用するかを選択します。既存のステージング テーブルをロードに使用するには、
"データ インポートを省略"
を選択します。データ ソースとしてスプレッドシートを使用する場合は、"データ インポートを省略" は使用できません。実行プロセスの一部として、ローダは、ステージング テーブルのデータが正しくマッピングされていることを確認します。ロード中に複数の検証が適用されます。ロード中に発生するエラーは、正常なインポートのために何を解決する必要があるかを示します。
- インテグレーション タスクに Planning 属性ローダを追加
- インテグレーション タスク には、1 つまたは複数のローダを含めることができます。タスクには、Discovery メトリック ローダとスクリプト化されたローダのほか、他のインテグレーション タスクも含めることができます。ベスト プラクティス: 各ローダに個別のインテグレーション タスクを持たせます。1 つのタスクに複数のローダが含まれている場合は、タスクの実行時に各ローダのパラメータが表示されます。タスク内のローダで共通/共有パラメータが使用されている場合、タスクがパラメータの入力を求めるのは 1 回だけです。パラメータ プロンプトのオーバーライドを選択できます。計画実行されるタスクの場合、ローダが作成された際に保存されたパラメータのデフォルト値が使用されます。
- メッセージと警告のトラブルシューティング
- ロード中に記録されたメッセージに関する説明については、を参照してください。 参考: Planning 属性ローダのログ メッセージ。
ソース属性値の変更のロード
ソース属性値へのマッピングが既に確立されている場合、Planning 属性ローダは、ロード時に属性値の名前を変更できます。
この表は、ローダによってすでに確立済みのマッピングを示しています。ソース属性値 "USA" は、ソース ID 列 "1001" にマッピングされます。
Planning 属性値 | ソース ID 列 | ソース属性値 |
|---|---|---|
USA | 1001 | USA
|
カナダ | 1002 | Canada |
ソースシステムで、"USA" が "United States" に変更された場合、ローダはソース ID 列 "1001" と属性値 "USA" の Planning の内部 ID との間のマッピングを維持するため、Planning 属性ローダはロード時にこの変更を適用できます。
Planning 属性値 | ソース ID 列 | ソース属性値 |
|---|---|---|
USA | 1001 | アメリカ合衆国
|
カナダ | 1002 | Canada |
ローダを実行すると、Planning の 属性値が "USA" から "United States" に変更されます。