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