メモ
コミュニティの関心グループが Yammer から Microsoft Viva Engage に移行されました。 Viva Engage コミュニティに参加し、最新のディスカッションに参加するには、「 Finance and Operations Viva Engage Community へのアクセスを要求する 」フォームに入力し、参加するコミュニティを選択します。
データ エンティティを使用してデータをインポートまたはエクスポートする前に、使用する予定のデータ エンティティに対する構成キーの影響を判断します。
コンフィギュレーション キーの詳細については、ライセンス コードとコンフィギュレーション キーのレポート を参照してください。
コンフィギュレーション キーの割り当て
構成キーは、次の成果物の 1 つ以上に割り当てることができます。
- データ エンティティ
- データ ソースとして使用されるテーブル
- テーブル フィールド
- データ エンティティ フィールド
次のテーブルは、オブジェクトの基になるさまざまなアーティファクトで、コンフィギュレーション キーの値がオブジェクトの予想される動作を変更する方法を集計したものです。
| データ エンティティでコンフィギュレーション キーを設定する | テーブルでコンフィギュレーション キーを設定する | テーブル フィールドでコンフィギュレーション キーを設定する | データ エンティティ フィールドのコンフィギュレーション キー | 予想される動作 |
|---|---|---|---|---|
| 無効 | 未評価 | 未評価 | 未評価 | データ エンティティの構成キーが無効になっている場合、データ エンティティは機能しません。 基になるテーブルやフィールド内でコンフィギュレーション キーが有効または無効かどうかは重要ではありません。 |
| 有効 | 無効 | 未評価 | 未評価 | データ エンティティのコンフィギュレーション キーが有効である場合、データ管理フレームワークは基になるテーブルごとのコンフィギュレーション キーを確認します。 テーブルの構成キーが無効になっている場合、そのテーブルは機能のためにデータ エンティティで使用できません。 テーブルの構成キーが無効になっている場合、システムはテーブルとデータ エンティティの構成キーの設定を評価しません。 エンティティの主テーブルの構成キーが無効になっている場合、システムはエンティティの構成キーが無効になっているかのように機能します。 |
| 有効 | 有効 | 無効 | 未評価 | データ エンティティのコンフィギュレーション キーが有効で、基になるテーブルのコンフィギュレーション キーが有効である場合、データ管理フレームワークはコンフィギュレーション キーをテーブルのフィールドで確認します。 フィールドの構成キーが無効になっている場合、対応するデータ エンティティ フィールドで構成キーが有効になっている場合でも、そのフィールドは機能目的でデータ エンティティで使用できません。 |
| 有効 | 有効 | 有効 | 無効 | 構成キーが他のすべてのレベルで有効になっているが、エンティティ フィールドの構成キーが有効になっていない場合、フィールドはデータ エンティティで使用できません。 |
メモ
エンティティにデータ ソースとして別のエンティティがある場合、システムは前述のセマンティクスを再帰的に適用します。
エンティティ リストの更新
エンティティ一覧を更新すると、データ管理フレームワークによって、ランタイムで使用するための構成キー メタデータがビルドされます。 このメタデータは、前に説明したロジックを使用して構築されます。 データ管理フレームワークでジョブとエンティティを使用する前に、エンティティ リストの更新が完了するまで待ちます。 待機しないと、構成キーのメタデータが最新ではなく、予期しない結果になる可能性があります。 エンティティ リストが更新されると、エンティティ リスト ページに次のメッセージが表示されます。
データ エンティティ リストのページ
データ管理ワークスペースのデータ エンティティ リストのページは、エンティティのコンフィギュレーション キー設定を示します。 データ エンティティのコンフィギュレーション キーの影響を理解するには、このページから開始します。
この情報は、エンティティの更新中に作成されたメタデータを使用して表示されます。 構成キー列には、データ エンティティに関連付けられている構成キーの名前が表示されます。 この列が空白の場合は、データ エンティティに関連付けられている構成キーがないことを意味します。 コンフィギュレーション キーの状態列は、コンフィギュレーション キーの状態を表示します。 チェックマークがある場合、キーが有効になっていることを意味します。 空白の場合は、キーが無効になっているか、キーが関連付けられていないことを意味します。
ターゲット フィールド
次の手順は、テーブルおよびフィールドのコンフィギュレーション キーの影響を確認するため、データ エンティティにドリルダウンすることです。 データ エンティティのターゲット フィールド フォームは、データ エンティティで関連するテーブルおよびフィールドに対して、コンフィギュレーション キーおよびキーの状態情報を示します。 データ エンティティ自体の構成キーが無効になっている場合は、このエンティティのターゲット フィールド フォームのテーブルとフィールドが、構成キーの状態に関係なく使用できないことを通知する警告メッセージが表示されます。
子エンティティ
特定のエンティティには、データ ソースとして他のエンティティが含まれるか、複合データ エンティティがあります。 [子エンティティ] フォームには、これらのエンティティの構成キー情報が表示されます。 前に説明したエンティティ リスト ページと同様の方法で、このフォームを使用します。 子エンティティのターゲット フィールド フォームも、前述のように動作します。
データ エンティティの使用
使用するデータ エンティティに対する構成キーの影響をすべて理解したら、データ エンティティをデータ プロジェクトに追加できます。
コンフィギュレーション キーの実行時間の検証
エンティティ更新リストの中で検構築されたコンフィギュレーション キー メタデータを使用して、次の使用ケースで実行時間の検証が実行されます。
- データ エンティティがジョブに追加される場合
- ユーザーがエンティティ一覧で [検証] を選択した場合
- ユーザーがデータ プロジェクトにデータ パッケージを読み込む場合
- ユーザーがデータ プロジェクトにテンプレートを読み込む場合
- 既存のデータ プロジェクトが読み込まれる場合
- テンプレートがデータ プロジェクトに読み込まれる場合
- エクスポート/インポート ジョブが実行される前 (バッチ、バッチ以外、定期的、OData)
- ユーザーがマッピングを生成する場合
- ユーザーがマッピング UI のフィールドをマップする場合
- ユーザーが 'インポート可能フィールド' を追加する場合
コンフィギュレーション キー変更の管理
エンティティ、テーブルまたはフィールド レベルでコンフィギュレーション キーを更新する時はいつでも、データ管理フレームワークのエンティティ リストは更新されている必要があります。 このプロセスでは、フレームワークが、最新のコンフィギュレーション キー設定をピックアップすることが保証されます。 エンティティ リストが更新されるまで、エンティティ リストのページに、次の警告メッセージが表示されます。 更新されたコンフィギュレーション キーの変更は、エンティティ リストが更新されたすぐ後に、有効になります。 コンフィギュレーション キーの変更が有効になった後、期待どおりに動作するかどうかを確認するため、既存のデータ プロジェクトおよびジョブを検証することをお勧めします。