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

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

Planning レベル ローダの作成

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

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

The Planning Level Loader lets you map metadata about organizational hierarchies from the staging area into Adaptive Insights.Use the planning level loader to import levels in bulk, instead of creating them one at a time in the levels 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 Level Loader
 

基本ステップ

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

が始める前に

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

必要な権限: インテグレーションオペレーターおよびデータ デザイナー

そこに着く方法

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

データ ソース設定の入力

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

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

Planning Level Loader Data Settings 

  1. コンポーネントライブラリのローダセクションで [新しいローダを作成] をクリックします。
  2. ローダタイプとして [Planning レベル ローダ] を選択します。ローダの名前を入力します。
  3. [作成] をクリックします。
  4. 以下の通り、Planning レベル ローダの全般プロパティ情報を入力します。
  • ソース テーブル:ドロップダウンリストからソース テーブルを選択します。リスト内のソーステーブルは、アクセス権を持つステージング領域内で利用できるすべてのテーブルです。
  • Planningで見つからない場合は組織を作成します。ソースシステムで見つかったものの、[モデリング] > [モデル管理] > [組織] では見つからなかった新しい組織を自動的に作成するようチェックマークを入れます。[モデル内の既存の組織のみを更新] のチェックマークを外します。
  • 該当する組織の更新を子に適用します。変更がプロパティのカスケードに関連する場合、[子組織を更新]にチェックマークを入れます。このチェックマークが外されている場合、明示的に更新された組織のみが変更されます。    
  • ワークフローを無効にするときは、ワークフロー項目を削除します。ワークフローを無効にする場合は、[ワークフロー内の項目を削除] にチェックマーク入れます。このチェックマークが外されている場合、ワークフローを無効化してもワークフロー項目が削除されません。 
  • 組織の使用可否を更新するときは、アクセスできない実績を削除します。実績をアクセス不可にするために組織の実績の開始日または終了日が変更された場合は、アクセスできない実績データを削除します。
  • 保留中の管理作業の公開の変更を公開:[管理作業の公開] に保留中のワークフローの変更がある場合、[変更を公開] にチェックマークを入れます。
  • ログ レベル:ローダを実行するときにキャプチャする詳細のタイプを選択します。
    • OFF: エラーは記録されていません。
    • エラー:重大なエラーのみを記録します。
    • 情報: ローダが更新された場合など、基本情報を記録します。
    • 冗長:すべての段階と操作に関する詳細な情報。主にデバッグまたは監査用に使用されます。

列マッピングの設定

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

Planning Level Loader - Column Mapping

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

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

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

  • 組織詳細:[短縮名]、[通貨]、[ワークフローに含まれる]、など、組織の詳細に関連する列を表示します。[ワークフローに含まれる] は、trueの場合は1、またはfalseの場合は0のブール値である必要があります。
  • 相殺消去設定:相殺消去組織、相殺消去取引先など、相殺消去設定に関連する列を表示します。これらのブール値は、trueの場合は1、falseの場合は0である必要があります。
  • バージョンの設定: 実績の開始、実績の終了など、バージョン設定に関連する列を表示します。これらの値は、01/01/2010のような日付形式である必要があります。
  • 組織の特性: 組織の特性に関連する列を表示します。
  • 組織属性: 組織の属性に関連する列を表示します。

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

列をマップ

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

  • ステータスチェックマークMapped Columnは、マップされた列を示します。感嘆符Unmapped Columnは、マップされていない列を示します。
  • プランニング列シートにマッピングできるプランニング列をすべて表示します。Planning 列のリストには、必須の Planning 列と、それに続く他のすべての Planning 列が含まれています。[必須のプランニング] 列は、アスタリスクを使用した太字のテキストで示され、値列を含みます。必須ではない列には、短縮名と通貨が含まれます。
  • ソースID列[データ ソース設定] で選択したステージング テーブル内の列を表示します。
  • ソース表示名列:マッピング処理を簡略化する表示名を示します。 
  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がその子を親として参照している。
  • 組織は相殺消去取引先として設定され、その子組織の1つが相殺消去組織として設定されます。相殺消去取引先として設定された組織は、相殺消去組織である子を持つことはできません。

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

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

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

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

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

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

Planning Dimension Loader - Preview Loader Output - XML Download

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

Preview Loader Output - XML of Metadata

ローダの実行

必要な設定でPlanning レベル ローダを保存した後、ローダを手動で実行するか、スケジュールされた統合タスクとして実行します。

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

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

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

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

統合タスクにPlanning レベル ローダを追加

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

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

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

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

メッセージと警告のトラブルシューティング

ロード中に記録されたメッセージに関する説明については、「Planning レベル ローダのログ メッセージ」を参照してください。

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