Planning 組織ローダの作成
メタデータ ローダは、ソース システムからプランニング モデルの階層に階層情報を同期させます。同期させる前に、ソース システムにすでに階層が存在している必要があります。
Planning 組織ローダでは、ステージング領域の組織階層に関するメタデータを にマッピングできます。
Adaptive Planning
。組織管理画面で 1 つずつ組織を作成するのではなく、Planning 組織ローダを使用して組織を一括インポートします。ローダを作成したら、手動で実行、またはローダの一部として実行するようスケジュールを設定できます。 インテグレーション
タスク。ビデオを見る:
1 分 36 秒基本ステップ
- データ ソース設定の入力
- 列マッピングの設定
- ビジネス ルールの作成
- ローダ出力のプレビュー
- ローダの実行またはスケジュール設定
前提条件
Planning 組織ローダには、既存のデータ ソースのインポートからのステージング データが必要です。どのデータ ソースを使用するかを書き留めます。
前提条件
必要な権限: "インテグレーション オペレーター"、"データ デザイナー"
ナビゲーション
ナビゲーション メニューから、 へ移動します。 データ ソース設定の入力
データ ソース設定では、インテグレーション ステージング データから使用するソース テーブルを選択し、新しい組織を自動的に作成するかどうかを指定することができます。
ベスト プラクティス: ローダを作成および編集する際は頻繁に保存します。"アクション" パネルで
"保存"
をクリックします。保存されていない変更を廃棄するには、"閉じる"
をクリックし、続いて "いいえ"
をクリックします。- コンポーネント ライブラリの "ローダ" セクションで"新しいローダの作成"をクリックします。
- ローダ タイプとして"Planning 組織ローダ"を選択します。ローダの名前を入力します。
- "作成"をクリックします。
- 以下の通り、Planning 組織ローダ一般プロパティ情報を入力します。
- ソース テーブル: ドロップダウン リストからソース テーブルを選択します。リスト内のソース テーブルは、アクセス権を持つステージング領域内で利用できるすべてのテーブルです。
- Planning に見つからない場合は組織を作成する: ソース システムで見つかったものの、では見つからなかった新しい組織を自動的に作成する場合にオンにします。オフにすると、モデル内の既存の組織のみが更新されます。
- 該当する組織の更新を子にも適用します:オンすると、変更がプロパティのカスケードに関連する場合に子組織が更新されます。オフになっている場合、明示的に更新された組織のみが変更されます。
- ワークフローを無効にするときは、ワークフロー アイテムを削除します:ワークフローを無効にする場合は、オンにするとワークフロー内のアイテムが削除されます。オフになっている場合、ワークフローを無効化してもワークフロー アイテムが削除されません。
- 組織の使用可否を更新するときは、アクセスできない実績データを削除します: 実績をアクセス不可にするために組織の実績の開始日または終了日が変更された場合は、アクセスできない実績データを削除します。
- 保留中の管理パブリッシュでの変更をパブリッシュする: 概念: 管理パブリッシュ 保留中のワークフローの変更がある場合、その変更を公開する場合にオンにします。
- Maintain existing order in Planning: Adaptive Planning ですでに使用されている既存の組織の並び順を維持する場合に選択します。
- 警告のまま続行: 警告メッセージが表示されてもロードを続行する場合に選択します。
- ログ レベル: ローダを実行するときにキャプチャする詳細のタイプを選択します。
- オフ: エラーは記録されていません。
- エラー: 重大なエラーのみを記録します。
- 情報: ローダが更新された場合など、基本情報を記録します。
- 詳細: すべての段階と操作に関する詳細な情報。主にデバッグまたは監査用に使用されます。
列マッピングの設定
"列マッピング" を使用すると、データ ソースの列を で選択可能にマッピングできます。列のマッピングを解除すると、ロードしたくないステージング データを無視できます。また、ローダの実行後に列のマッピングを 1 つずつ解除して、ログにエラーを生成する列をトラブルシューティングすることもできます。
既存の組織 ID のリストを取得する唯一の方法は、exportLevelsAPI を使用することです。組織 ID は、アプリケーション UI のどこにも表示されません。組織のソース ID 列は、ロードすると組織 ID になります。
マッピングする列が複数ある場合、
"表示"
フィルタを使用して、以下を選択します。
- すべて: Planning 列をすべて表示します。
- 必須: "親 ID" と "組織" など、必要な Planning 列をすべて表示します。
- マッピング解除済: マッピングが解除された Planning 列をすべて表示します。
- マッピング済: マッピング済みの Planning 列をすべて表示します。
"カテゴリ"
を使用して、以下を選択します。
- 組織の詳細: "短縮名"、"通貨"、"ワークフロー内"、など、組織の詳細に関連する列を表示します。"ワークフロー内" は、true の場合は 1、または false の場合は 0 のブール値である必要があります。
- 相殺消去設定: 相殺消去組織、相殺消去取引先など、相殺消去設定に関連する列を表示します。これらのブール値は、true の場合は 1、false の場合は 0 である必要があります。
- バージョン設定: 実績の開始、実績の終了など、バージョン設定に関連する列を表示します。これらの値は、01/01/2010 のような日付形式である必要があります。
- 組織特性: 組織の特性に関連する列を表示します。
- 組織属性: 組織の属性に関連する列を表示します。
"検索"
フィールドを使用して列を見つけることができます。完全な名前または部分的な名前を入力して検索し、虫眼鏡をクリックします。検索に一致するステージング列は、結果に表示されます。- 列をマッピング
- "列マッピング"をクリックします。
- ドロップダウンからマッピングされていない列を選択します。マッピングに使用できる列がリスト内に表示されます。列をマッピングすると、ステータス インジケータが感嘆符
からチェック マーク 
に変わります。
"列マッピング" タブには、次の列があります。- ステータス:チェックマーク
マッピングされた列を示します。感嘆符 
マッピングされていない列を示します。 - Planning 列:シートにマッピングできる Planning 列をすべて表示します。Planning 列のリストには、必須の Planning 列と、それに続く他のすべての Planning 列が含まれています。必須の Planning 列は、アスタリスクを使用した太字のテキストで示され、値列を含みます。必須ではない列には、短縮名と通貨が含まれます。
- ソース列:"データ ソース設定" で選択したステージング テーブル内の列を表示します。
"データのインポートにより自動的に属性値を作成する"が有効になっている場合は、コードごとに属性をマッピングできます。この場合、属性名が自動的にコードになります。- 組織の親をマッピング
- "親 ID" 列は、組織の親の ID を示します。階層内の最高の組織にロードするには、ソース データの親 ID 値を空にする必要があります。親 ID は、最上位組織の下に子組織を作成する場合にも空にする必要があります。組織とその親を Planning にマッピングする方法については、 例: スプレッドシートのデータ ソースからの組織のロードを 参照してください。
- 列のマッピングを解除
- 列のマッピングを解除するには、"マッピング解除"をクリックして、以下を選択します。
- すべてマッピング解除: 列のマッピングをすべて解除します。
- 選択項目をマッピング解除: 選択した列のみマッピングを解除します。
列のマッピングを解除すると、ステータス アイコンが感嘆符に変わります。ベスト プラクティス: エラーのトラブルシューティングのためのマッピング解除と列の無視とともに、マッピング解除を変更管理に役立てることができます。データ ソースに新しい列が導入されると、古い列をマッピング解除して新しい列をマッピングできます。
マッピングのダウンロードおよびアップロード
ローダのマッピングをダウンロードして変更し、アップロードすることで、マッピングのエラーを迅速に解決できます。アップロードを実行すると、すべてが置換されます。アップロード時に処理できるファイルのマッピング シートは 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 と同じである場合、列はそれ自体をその親として参照しています。
- サブ組織をインポートする場合、サブ組織のルートは、 の既存のノードにマッピングされます。Adaptive Planning。parentID は に導入された新しいノードのソース データに存在しません。Adaptive Planning。
- 既存のノードが新しいノードの下に移動し、"新規作成" フラグが無効になります。ローダが新しい組織を作成しないように設定されている場合、既存の組織は新しいノードに移動します。
- データの階層に周期的参照があります。ParentId がその子を親として参照しています。
- 組織は相殺消去取引先として設定され、その子組織の 1 つが相殺消去組織として設定されます。相殺消去の取引先として設定された組織は、相殺消去組織である子を持つことはできません。
プレビュー出力を XML ファイルとしてダウンロードして、ロードする前に要件に対してデータ ソースから組織を手動で確認することもできます。
- "アクション" パネルで"ローダ出力のプレビュー"をクリックします。
- (任意) "ローダ出力のプレビュー" 設定を入力します。入力できる情報は、この Planning 組織ローダで選択したデータ ソースによって異なります。ここで設定を変更すると、ステージング テーブルおよび列に新しいデータがインポートされます。
- "ローダ出力のプレビュー"をクリックします。
すべての移行およびビジネス ルールを含め、ローダが実行されます。ステータス ポップアップは、ローダが実行するステップを表示します。ロード可能な組織がある場合、ローダは XML ファイルを作成し、それを Zip 形式にした XML 添付ファイルを含む E メール通知を送信します。組織がロードされない場合、ZIP フォルダにはロードされたものがないことを示すメッセージが含まれます。
ローダが成功した後、追加のポップアップで、"ローダ出力のプレビュー" を Zip された XML ファイルとしてダウンロードできます。ダウンロードのポップアップは、組織の数とファイルのサイズに応じて、表示されるまでにしばらく時間がかかることがあります。
ローダの実行
必要な設定で Planning 組織ローダを保存した後、ローダを手動で実行するか、スケジュールされたインテグレーション タスクとして実行します。
次のように、各 Planning 組織ローダの実行の間には、約 15 ～ 30 分の待機時間を置きます。
Adaptive Planning
はインポートと同期する時間を確保します。より大きなインポートは同期するのにより長い時間がかかります。待機時間はモデル サイズやその他の要因によって異なります。ローダを手動で実行するには、"アクション" パネルで
"手動で実行"
をクリックします。ソース システムから組織を直接ロードすることも、すでにインポートされたステージング値を使用してローダを実行することもできます。ローダの実行時に、これらの動作のどれを使用するかを選択します。既存のステージング テーブルをロードに使用するには、
"データ インポートを省略"
を選択します。データ ソースとしてスプレッドシートを使用する場合は、"データ インポートを省略" は使用できません。実行プロセスの一部として、ローダは、ステージング テーブルのデータが正しくマッピングされていることを確認します。ロード中に複数の検証が適用されます。ロード中に発生するエラーは、正常なインポートのために何を解決する必要があるかを示します。
- インテグレーション タスクに Planning 組織ローダを追加
- インテグレーション タスクには、1 つ以上のローダを組み込むことができます。タスクには、スクリプト化されたローダなど、他のインテグレーション タスクを含めることができます。ベスト プラクティス: 各ローダに個別のインテグレーション タスクを持たせます。タスクに複数のローダが含まれている場合は、タスクの実行時に各ローダのパラメータがプロンプトに表示されます。タスク内のローダに共通または共有パラメータがある場合、タスクがパラメータの入力を求めるのは 1 回だけです。パラメータ プロンプトのオーバーライドを選択できます。計画実行されるタスクの場合、ローダ用のパラメータのデフォルト値が使用されます。
- メッセージと警告のトラブルシューティング
- 参照 参考: Planning 組織ローダのログ メッセージ ロード中に記録されたメッセージの説明。