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

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 Attribute Loader lets you map metadata about attributes from the staging area into Adaptive Insights. Use the attribute loader to import attributes in bulk from an external system and synchronize them, instead of creating attributes one at a time in the attributes 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 32s

Create a Planning Attribute Loader
 

基本ステップ

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

が始める前に

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

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

そこに着く方法

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

データ ソース設定の入力

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

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

Planning Level Loader Data Settings 

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

列マッピングの設定

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

Planning Level Loader - Column Mapping

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

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

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

  • すべてすべての列を表示します。特性はカテゴリーを使用しません。

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

列をマップ

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

  • ステータスチェックマーク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と同じである。その場合、列はそれ自体をその親として参照しています。
  • 既存のノードが新しいノードの下に移動し、[新規作成] フラグが無効になります。ローダが新しい特性値を作成しないように設定されている場合、既存の特性は新しいノードに移動します。
  • データの階層に周期的参照がある。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分の待機時間を置きます。より大きなインポートは同期するのにより長い時間がかかります。待機時間はモデルサイズやその他の要因によって異なります。

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

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

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

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

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

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

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

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

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