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