メインコンテンツまでスキップ

logoCorrectSize.png

Looks like this logo isn't being used anymore since we started using the new CSS to make our documentation look like our product UI.

Knowledge @ Adaptive Insights LLC, a Workday Company

プランニング科目ローダの作成

データ ソース設定の構成方法、列マッピング、ビジネスルールなど、科目をインポートするためのプランニング科目ローダの作成方法について説明します。

メタデータローダは、ソースシステムからの階層情報を同期させてAdaptive Insightsの階層に投入します。Adaptive Insightsへ同期させる前に、ソースシステムに既に階層が存在しなければなりません。

The Planning Account Loader lets you map metadata about general ledger accounts from the staging area into Adaptive Insights.Use the account loader to import accounts in bulk from an external system and synchronize them, instead of creating accounts one at a time in the accounts admin. Once you create a loader, you can run it manually or schedule it to run as part of an Integration task.

Watch the video: 1m 36s

Create a Planning Account Loader
 

基本ステップ

  • データ ソース設定の入力
  • 列マッピングの設定
  • ビジネスルールの作成
  • ローダ出力のプレビュー
  • ローダの実行またはスケジュール設定

が始める前に

プランニング科目ローダには、既存のデータ ソースのインポートからのステージングデータが必要です。どのデータ ソースを使用するかを書き留めます。

必要な権限: モデル、インテグレーションオペレーター、データ デザイナー

そこに着く方法

Compass.png ナビゲーションメニュー navicon.gif > [統合] > [デザイン統合] に進みます。

データ ソース設定の入力

データ ソース設定では、統合ステージング データから使用するソース テーブルを選択し、新しい科目を自動的に作成するかどうかを指定することができます。

ベスト プラクティス: ローダを作成および編集する際は頻繁に保存します。[操作] パネルで [保存] をクリックします。保存されていない変更を廃棄するには、[閉じる] をクリックし、続いて [いいえ] をクリックします。

Planning Level Loader Data Settings 

  1. コンポーネントライブラリの [ローダ] セクションで [新しいローダを作成] を選択します。
  2. ローダタイプとして [プランニング科目ローダ] を選択します。ローダの名前を入力します。
  3. [作成] を選択します。
  4. 以下のとおり、科目ローダの全般プロパティ情報を入力します。
  • ソース テーブル:ドロップダウンリストからソース テーブルを選択します。リストには、ステージング領域で使用できるアクセス可能なすべてのテーブルが含まれています。
  • プランニング科目:子科目をロードす GL科目を選択します。GL科目ツリー全体をロードするには、[科目] ドロップダウンで GL科目を選択します。GL科目ツリー全体をロードするには、Adaptive Insightsで定義されているすべてのGLルートノードがデータソースに含まれている必要があります。
  • 保留中の管理作業の公開の変更を公開:[管理作業の公開] に保留中のワークフローの変更がある場合、ローダを実行するときにそれらの変更を公開することを選択します。
  • プランニングで見つからない場合の科目の作成:ソース システムで見つかったものの、[モデリング] > [モデル管理] > [科目] では見つからなかった新しい科目を自動的に作成する場合に選択します。この選択を解除すると、モデル内の既存のGL科目のみが更新されます。
  • 警告のまま続行:科目をリペアレンティングし、特性値を親科目の特性と互換性があるようにする場合に選択します。選択されていない場合、ペイロードに親科目の特性と互換性がない子科目特性の値が含まれていると、ローダエラーが発生します。
  • ログ レベル:ローダを実行するときにキャプチャする詳細のタイプを選択します。
    • OFF: エラーは記録されていません。
    • エラー:重大なエラーのみを記録します。
    • 情報: ローダが更新された場合など、基本情報を記録します。
    • 冗長:すべての段階と操作に関する詳細な情報。主にデバッグまたは監査用に使用されます。

列マッピングの設定

列マッピングでは、データ ソースからの列を、[モデリング] > [モデル管理] > [科目] で使用できる科目プロパティにマッピングできます。列のマップを解除すると、ロードしたくないステージング データを無視できます。また、ローダの実行後に列のマップを1つずつ解除して、ログにエラーを生成する列をトラブルシューティングすることもできます。  

Planning Level Loader - Column Mapping

マッピングする列が複数ある場合、[フィルターの表示] を使用して、以下を選択します。

  • すべてプランニング列をすべて表示します。
  • 必須[親ID] と [科目]など、必要なプランニング列をすべて表示します。
  • マップ解除済みマップが解除されたプランニング列をすべて表示します。
  • マップ済みマップ済みのプランニング列をすべて表示します。

[カテゴリー] を使用して、以下を選択します。

  • 科目詳細[科目コード]、[短縮名]、[ロールアップ先]、[説明]、[タイプ]、[加重]、[表示テキスト]、[計画値]、[実績]、[実績のオーバーレイ]、[残高タイプ]、および[ワークフローに含まれる]など、科目の詳細に関連する列を表示します。[ワークフローに含まれる] は、trueの場合は1、またはfalseの場合は0のブール値である必要があります。
  • データタイプ: [科目の時間層]、[表示形式]、[マスター数式]、[加重平均換算]、[残高リセット]、[リセット時に残高を移転]、[小数点以下桁数]、[為替レート]など、科目データのタイプの設定に関連する列を表示します。
  • シート: [シート上で表示しない]、[展開して開始]、[データの入力シートタイプ]など、科目がシートに表示される方法に関連する列を表示します。
  • アカウント属性科目に関連付けられているすべての科目特性のリストなど、科目特性に関連する列を表示します。
  • データのプライバシー: [給与の詳細を含む] など、科目のデータの公開または非公開に関連する列を表示します。
  • 連結:[会社間]、[相殺消去取引パートナー]、[子会社] の設定など、連結設定に関連する列を表示します。連結が有効になっているインスタンスでのみ使用できます。

[検索] フィールドを使用して列を見つけることができます。完全な名前または部分的な名前を入力して検索し、虫眼鏡をクリックします。検索に一致するステージング列は、結果に表示されます。

列をマップ

[列マッピング] タブには、次の列があります。

  • ステータスチェックマークMapped Columnは、マップされた列を示します。感嘆符Unmapped Columnは、マップされていない列を示します。
  • プランニング列マッピングできるプランニング列をすべて表示します。Planning 列のリストには、必須の Planning 列と、それに続く他のすべての Planning 列が含まれています。[必須のプランニング] 列は、アスタリスクを使用した太字のテキストで示され、値列を含みます。必須ではない列には、短縮名と説明が含まれます。
  • ソースID列[データ ソース設定] で選択したステージング テーブル内の列を表示します。
  • ソース科目コード列マッピング プロセスを簡素化する科目コード列を示します。Adaptive Insightsのすべての科目には、科目コードが必要です。
  1. [列マッピング] をクリックします。
  1. ドロップダウンからマップされていない列を選択します。マッピングに使用できる列がリスト内に表示されます。列をマップすると、ステータスインジケータが感嘆符IntegrationMappingUnmapped.pngからチェックマークIntegrationMappingMapped.pngに変わります。 
科目の親のマッピング

[親ID] 列は、科目の親のIDを示します。階層内の最高の科目にロードするには、ソースデータの親ID値を空にする必要があります。親IDは、全社の下に子科目を作成する場合にも空にする必要があります。

列のマップを解除

列のマップを解除するには、マッピング解除をクリックして、以下を選択します。

  • すべてマップ解除: 列のマップをすべて解除します。
  • 選択項目をマップ解除: 選択した列のみマップを解除します。

列のマップを解除すると、ステータスアイコンが感嘆符IntegrationMappingUnmapped.pngに変わります。

ベスト プラクティス: エラーのトラブルシューティングのためのマップ解除と列の無視とともに、マップ解除を変更管理に役立てることができます。データ ソースに新しい列が導入されると、古い列をマップ解除して新しい列をマップできます。

ビジネスルールの作成

ビジネスルールを使用して、ロードに使用できるステージングデータを制限するSQL式を作成できます。フィルター基準を満たすレコードのみがロードされます。

[ビジネスルール] タブには、SQLを入力するためのテキスト領域が含まれています。

Planning Level Loader - Business Rules

SQLフィルターを作成する方法:

  1. [ビジネスルール] タブで [SQLフィルター] を選択します。[編集] をクリックします。

Planning Level Loader - Business Rules - SQL Editor

  1. SQL式を入力します。[使用可能な列] リストで項目をクリックすると、タイピングせずに、その列をSQL式に持ってくることができます。

  2. [適用] をクリックして、SQL構文を確認します。構文のエラーが発生すると、式を囲む線が赤に変わります。SQLエディターの上にカーソルを合わせて、構文エラー情報を確認します。

Planning Dimension Loader - SQL Syntax Error

SQL構文の詳細なヘルプについては、[SQLフィルターの編集] の [注記] セクションの「オンライン ヘルプ」をクリックします。詳しくはSQL式参照を参照してください。

  1. 構文内のエラーを修正し、[適用] をクリックします。ローダを実行するときに、SQL式に一致するステージング行のみがインポートされます。

ローダ出力のプレビュー

ローダを実行する前に、ローダの出力をプレビューしてマッピングを確認し、検証エラーを修正できます。

ローダ出力のプレビュー時または手動によるロード実行時に、ソースデータのエラーが検証されます。検証の例には、次の場合のチェックが含まれます。

  • サブ科目が親科目を示すことなしに作成されている。
  • 科目特性に見つからない特性値が割り当てられている。 
  • データにおいて科目のソースID値が欠落している(空欄)。
  • データにおいて、ソースIDまたは科目名が重複している。ソースIDは一意である必要があります。
  • ParentIdがデータのソースIDと同じである。その場合、列はそれ自体をその親として参照しています。
  • サブ科目をインポートする場合、サブ科目のルートは、Adaptive Insightsの既存のノードにマップされます。parentID がAdaptive Insightsに導入された新しいノードのソースデータに存在しない。
  • 既存のノードが新しいノードの下に移動し、[新規作成] フラグが無効になります。ローダが新しい科目を作成しないように設定されている場合、既存の科目は新しいノードに移動します。
  • データの階層に周期的参照がある。ParentIdがその子を親として参照している。

プレビュー出力をXMLファイルとしてダウンロードし、ロードする前に要件に対してデータ ソースから科目を手動で確認することもできます。

  1. [操作] パネルで [ローダ出力のプレビュー] をクリックします。

  2. (オプション)[ローダ出力のプレビュー] 設定を入力します。入力できる情報は、このプランニング科目ローダで選択したデータ ソースによって異なります。ここで設定を変更すると、ステージング テーブルおよび列に新しいデータがインポートされます。

  3. [ローダ出力のプレビュー] をクリックします。

すべての移行およびビジネスルールを含め、ローダが実行されます。ステータス ポップアップは、ローダが実行するステップを表示します。ロード可能な科目がある場合、ローダはXMLファイルを作成し、それをZip形式にしたXML添付ファイルを含むEメール通知を送信します。科目がロードされない場合、ZIPフォルダーにはロードされたものがないことを示すメッセージが含まれます。

ローダが成功した後、追加のポップアップで、[ローダ出力のプレビュー] をZipされたXMLファイルとしてダウンロードできます。ダウンロードのポップアップは、科目の数とファイルのサイズに応じて、表示されるまでにしばらく時間がかかることがあります。

Planning Dimension Loader - Preview Loader Output - XML Download

これは、ダウンロードされた解凍済みのXMLファイルの一例です。

Preview Loader Output - XML of Metadata

ローダの実行

必要な設定でプランニング科目ローダを保存した後、ローダを手動で実行するか、スケジュールされた統合タスクとして実行します。

Adaptive Insightsがインポートと同期する時間を確保できるように、各プランニング科目ローダの実行の間には、約15~30分の待機時間を置きます。より大きなインポートは同期するのにより長い時間がかかります。待機時間はモデルサイズやその他の要因によって異なります。

ローダを手動で実行するには、[操作] パネルで [手動で実行] をクリックします。

ソースシステムから科目を直接ロードすることも、すでにインポートされたステージング値を使用してローダを実行することもできます。ローダの実行時に、これらの動作のどれを使用するかを選択します。既存のステージング テーブルをロードに使用するには、[データインポートのバイパス] を選択します。データ ソースとしてスプレッドシートを使用する場合は、[データインポートのバイパス] は使用できません。

実行プロセスの一部として、ローダは、ステージング テーブルのデータが正しくマップされていることを確認します。ロード中に複数の検証が適用されます。ロード中に発生するエラーは、正常なインポートのために何を解決する必要があるかを示します。

統合タスクにプランニング科目ローダを追加

統合タスクには、1 つまたは複数のローダを含めることができます。タスクには、Planning データ ローダやスクリプト化されたローダなど、他の統合タスクが含まれる場合があります。

ベスト プラクティス: 各ローダに個別の統合タスクを持たせます。

タスクに複数のローダが含まれている場合は、タスクの実行時にプロンプトに各ローダのパラメーターが表示されます。タスク内のローダに共通または共有パラメーターがある場合、タスクがパラメーターの入力を求めるのは1回だけです。パラメータープロンプトは上書きするよう選ぶことができます。 

計画実行されるタスクの場合、ローダ用のパラメーターのデフォルト値が使用されます。

  • この記事は役に立ちましたか?