コンフィギュレーション キーおよびデータ エンティティ

データ エンティティを使用してデータをインポートまたはエクスポートする前に、使用を計画しているデータ エンティティでコンフィギュレーション キーの影響を最初に判断することをお勧めします。

コンフィギュレーション キーの詳細については、ライセンス コードとコンフィギュレーション キーのレポート を参照してください。

コンフィギュレーション キーの割り当て

コンフィギュレーション キーは、次のアーティファクトの 1 つまたはすべてに割り当てられます。

• データ エンティティ
• データ ソースとして使用されるテーブル
• テーブル フィールド
• データ エンティティ フィールド

次のテーブルは、オブジェクトの基になるさまざまなアーティファクトで、コンフィギュレーション キーの値がオブジェクトの予想される動作を変更する方法を集計したものです。

エンティティ リストの更新

エンティティ リストが更新されると、データ管理フレームワークは、ランタイムに使用するコンフィギュレーション キー メタデータを構築します。 このメタデータは上記で説明されたロジックを使用して構築されます。 データ管理フレームワークのジョブおよびエンティティを使用する前に、エンティティ リストの更新の完了を待機することを強くお勧めします。 待機しない場合、コンフィギュレーション キー メタデータは最新でない場合があり、予期しない結果になる場合があります。 エンティティ リストが更新される場合、エンティティ リストのページに、次のメッセージが表示されます。

データ エンティティ リストのページ

データ管理ワークスペースのデータ エンティティ リストのページは、エンティティのコンフィギュレーション キー設定を示します。 データ エンティティのコンフィギュレーション キーからの影響を理解するには、このページから開始します。

エンティティの更新中に構築されるメタデータを使用して、この情報が表示されます。 コンフィギュレーション キーの列で、データ エンティティに関連付けられているコンフィギュレーション キーの名前が表示されます。 この列が空白の場合は、データ エンティティに関連付けられているコンフィギュレーション キーがないことを意味します。 コンフィギュレーション キーの状態列は、コンフィギュレーション キーの状態を表示します。 チェックマークがある場合、キーが有効になっていることを意味します。 空白の場合、キーが無効であるか、または関連付けられているキーが存在しないかのいずれかであることを意味します。

ターゲット フィールド

次の手順は、テーブルおよびフィールドのコンフィギュレーション キーの影響を確認するため、データ エンティティにドリルダウンすることです。 データ エンティティのターゲット フィールド フォームは、データ エンティティで関連するテーブルおよびフィールドに対して、コンフィギュレーション キーおよびキーの状態情報を示します。 データ エンティティ自体そのコンフィギュレーション キーが無効になっている場合、このエンティティに対するターゲット フィールド フォームで、テーブルおよびフィールドがコンフィギュレーション キーの状態に関係なく全く使用できないことを通知する、警告メッセージが表示されます。

子エンティティ

特定のエンティティはデータ ソースとして他のエンティティを持っているか、複合データ エンティティです: 子エンティティ フォームでこれらのエンティティに対するコンフィギュレーション キー情報が表示されます。 上記のエンティティ リスト ページと同じ方法で、このフォームを使用します。 子エンティティのターゲット フィールド フォームも、上記のように機能します。

データ エンティティの使用

完全な影響を理解した後に、データ エンティティで使用したいコンフィギュレーション キーがある場合、データ プロジェクトに追加することでデータ エンティティの使用に進むことができます。

コンフィギュレーション キーの実行時間の検証

エンティティ更新リストの中で検構築されたコンフィギュレーション キー メタデータを使用して、次の使用ケースで実行時間の検証が実行されます。

• データ エンティティがジョブに追加される場合
• エンティティ リストでユーザーが '検証' をクリックした場合
• ユーザーがデータ プロジェクトにデータ パッケージを読み込む場合
• ユーザーがデータ プロジェクトにテンプレートを読み込む場合
• 既存のデータ プロジェクトが読み込まれる場合
• テンプレートがデータ プロジェクトに読み込まれる場合
• エクスポート / インポート ジョブが実行される前 (バッチ、非バッチ、反復、OData)。
• ユーザーがマッピングを生成する場合
• ユーザーがマッピング UI のフィールドをマップする場合
• ユーザーが 'インポート可能フィールド' を追加する場合

コンフィギュレーション キー変更の管理

エンティティ、テーブルまたはフィールド レベルでコンフィギュレーション キーを更新する時はいつでも、データ管理フレームワークのエンティティ リストは更新されている必要があります。 このプロセスでは、フレームワークが、最新のコンフィギュレーション キー設定をピックアップすることが保証されます。 エンティティ リストが更新されるまで、エンティティ リストのページに、次の警告メッセージが表示されます。 更新されたコンフィギュレーション キーの変更は、エンティティ リストが更新されたすぐ後に、有効になります。 コンフィギュレーション キーの変更が有効になった後、期待どおりに動作するかどうかを確認するため、既存のデータ プロジェクトおよびジョブを検証することをお勧めします。