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

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 Dimension Loader requests are limited to updating a maximum of 10000 dimension values in a hierarchical dimension, or 40000 dimension values in a flat dimension. These limits do not apply to creation of new dimension values within a loader request.

The Planning Dimension Loader lets you map metadata about dimension values from the staging area into Adaptive Planning. The primary benefit of the Planning Dimension Loader is that it allows you to import dimensions values in bulk, instead of creating them one at a time within Modeling > Model Management > Dimensions. Once you create a loader, you can run it manually or schedule it to run as part of an integration task.

Planning Dimension Loader
 

Planning 属性ローダを作成するには、次のフローに従います。

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

始める前に

Planning 属性ローダには、既存のデータ ソースのインポートからのステージングデータが必要です。 

データ ソース設定の入力

データ ソース設定では、ステージングデータから使用するソーステーブルを選択し、ロードするプランニング属性を選択し、新しい属性値を自動的に作成するかどうかを選択できます。 

  1. [統合] > [デザイナー統合] に移動します。
  2. コンポーネントライブラリのローダ領域で [新しいローダを作成] をクリックします。
  3. ローダタイプとして [Planning 属性ローダ] を選択します。ローダの名前を入力します。
  4. [作成] をクリックします。

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

以下の通り、Planning 属性ローダの全般プロパティ情報を入力します。

Planning Dimension Loader - Data Source Settings 

  • ソース テーブル:ドロップダウンリストからソース テーブルを選択します。リスト内のソーステーブルは、アクセス権を持つステージング領域内で利用できるすべてのテーブルです。
  • プランニング属性: ロードするソースのすべての属性から属性を1つ選択します。リストされている属性は、[ モデリング] > [モデル管理] > [属性] から取得されます。
  • Planningで見つからない場合は、属性値を作成します。ソースシステムにはあるが [モデリング] > [モデル管理] > [属性] にはない新しい属性値を自動的に作成するには、チェックボックスにマークを入れます。このオプションのチェックマークを外すと、既存の属性値の更新のみが実行され、新しい属性は作成されません。
    • ロードする属性について、 [モデリング] > [モデル管理] > [属性] の [データインポートによって自動的に属性値を作成] が有効になっていない場合、ローダは次の警告を表示します。
      Planning Dimension Loader - Data import automatically creates dimension values warning
  • ログ レベル:ローダを実行するときに記録する詳細のタイプを選択します。
    • エラー: 重大なエラーのみを記録します。
    • 情報: ローダが更新された場合など、基本情報を記録します。
    • 冗長:すべての段階と操作に関する詳細な情報を入力します。このレベルは、主にデバッグや監査に使用されます。一般的な用途よりも多くのログ情報を生成する可能性があります。

列マッピングの設定

列マッピングを使用すると、データソースの列を [モデリング] > [モデル管理] > [属性] で使用可能な属性値にマップできます。

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

  • すべて:Planning列をすべて表示します。
  • 必須:必要なPlanning列をすべて表示します。
  • マップ解除済み:マップが解除されたPlanning列をすべて表示します。
  • マップ済み:マップ済みのPlanning列をすべて表示します。

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

列をマップ

  1. [列マッピング] をクリックします。

Planning Dimension Loader - Column Mapping

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

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

属性値とその親をPlanningにマップする方法の例については、「スプレッドシートデータソースからの属性値のロード」を参照してください。

ロード時のプランニング属性値の名前の変更

ロード時にプランニング属性値の名前を変更する方法:

  1. ソース内の属性値を一意に識別するソースID列を選択します。
  2. ソース表示名列で属性値名を含むソースから列を選択します。

列のマップを解除

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

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

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

リスト属性に関連付けられたマップ特性

データ ソースのインポートから列をマッピングすることにより、特性をリスト属性に関連付けることができます。

リスト属性は全体的に階層構造を持たない属性を意味します。サブ属性や属性値の階層構造を持たず、値の一様なリストのみが存在します。

特性と属性の関連付けは、リスト属性についてのみ可能です。特性を階層属性に関連付けることはできません。

Adaptive Insights内で、[モデル管理] > [属性]にアクセスし、属性をクリックして詳細を表示し、それがリスト属性であるかどうかを確認できます。

 Dimension Detail - List Dimension

データ ソースの設定内で、プランニング属性としてリスト属性を選択します。

Planning Dimension Loader - Data Source Setting - List Dimension

この属性はリスト属性であるため、特性は列マッピング内の列として使用可能になります。

リスト属性は階層ではないため、parentIdはソースID列のオプションではありません。

[ソース表示名] 列は、属性列を定義する際の必須フィールドです。次の例では、ソースID列として ["ID"] にマップされ、ソース表示名列として ["名前"] にマップされた製品属性が示されています。他の行については、ソース表示名はオプションです。

Planning Dimension Loader - Map Attributes Associated with List Dimensions

ビジネスルールの作成

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

Planning Dimension Loader - Business Rules

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

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

Planning Dimension Loader - BusinessRules - SQL Editor

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

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

Planning Dimension Loader - SQL Syntax Error

SQL構文の詳細なヘルプについては、[SQLフィルターの編集] の [注記] セクションで「オンライン ヘルプ」をクリックできます。また、SQL式参照にアクセスすることもできます。

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

ローダ出力のプレビュー

完全ロードを実行する前にローダ出力をプレビューして、マッピングが必要とする仕様であることを確認できます。その出力をXMLファイルとしてダウンロードして、データ ソースからの属性値をロードする前に、その値が要件に合っていることを手動で確認することもできます。

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

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

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

ローダが実行され、すべての変換とビジネスルールが実行の一部として適用されます。ステータスポップアップは、ローダが実行したステップを表示します。ロードする属性値がある場合、ローダはXMLファイルを作成し、それをZipされたXML添付ファイルとしてローダの出力を含むEメール通知を送信します。

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

Planning Dimension Loader - Preview Loader Output - XML Download

Preview Loader Output - XML of Metadata

検証エラーの修正

属性値がロードされると、ソース データは次のエラーに対して検証されます。

  • データにおいて属性値のソースID値が欠落している(空欄)。
  • データにおいて、ソースIDが重複している。ソースIDは一意である必要があります。
  • データに属性値名がない(空白)。
  • データに重複した属性値名がある。
  • ParentIdがデータのソースID と同じである。この場合、列はそれ自体をその親として参照しています。
  • サブツリーをインポートする場合、サブツリーのルートは、Planningの既存のノードにマップされます。この場合、parentIDはPlanningに導入される新しいノードのソースデータに含まれません。
  • 既存のノードが新しいノードの下に移動し、[新規作成] フラグが無効になります。この場合、新しい属性値を作成しないようにローダに明示的に指示しておくと、既存の属性値は新しいノードに移動します。
  • データの階層に周期的参照がある。この場合、ParentId はその子を親として参照しています。

ローダの実行

必要なすべての構成設定とともにPlanning 属性ローダを保存すると、ローダを手動で実行するか、スケジュールされた統合タスクとして実行できます。

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

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

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

統合タスクにPlanning 属性ローダを追加

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

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

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

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

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

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

ソース属性値の変更のロード

ソース属性値へのマッピングが既に確立されている場合、Planning 属性ローダは、ロード時に属性値の名前を変更できます。

この表は、ローダによってすでに確立済みのマッピングを示しています。ソース属性値「USA」は、ソースID列「1001」にマップされます。

プランニング属性値 ソースID列 ソース属性値
米国 1001 USA
カナダ 1002 カナダ

ソースシステムで、「USA」が「United States」に変更された場合、ローダはソースID列「1001」と属性値「USA」のPlanningの内部IDとの間のマッピングを維持するため、Planning 属性ローダはロード時にこの変更を適用できます。

プランニング属性値 ソースID列 ソース属性値
米国 1001 United States
カナダ 1002 カナダ

ローダを実行すると、Planningの属性値が「USA」から「United States」に変更されます。

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