データエンティティの概要

[アーティクル]
04/28/2023

この記事は、データエンティティを定義し、その概要について説明します。これには、データエンティティの機能、サポートされるシナリオ、およびそれらに使用されるカテゴリ、作成するメソッドに関する情報が含まれています。

概要

データエンティティはデータベーステーブルの物理的な実装から抽象化したものです。たとえば、正規化テーブルでは、各顧客の大量データが顧客テーブルに格納されており、残りは小さな一連の関連テーブル間で拡大している可能性があります。この場合、顧客概念のデータエンティティは非正規化ビューとして表示され、各行に顧客テーブルと関連するテーブルからのすべてのデータが含まれています。データエンティティは、開発と統合を簡単にする形式に、ビジネスコンセプトをカプセル化します。データエンティティには、抽象化された性質があるため、アプリケーションの開発とカスタマイズを簡略化できます。その後、抽象化によってアプリケーションコードもバージョン間の物理テーブルの避けられないチャーンから隔離されます。 集計する: データエンティティは重要なデータの概念および機能を表すための基礎となるテーブルスキーマの抽象化およびカプセル化 (非正規化ビュー) の概念を提供します。

処理能力

データエンティティには次の機能があります。

AXD、データのインポート/エクスポートフレームワーク (DIXF) エンティティ、1 つの概念を持つ集計クエリの分岐して細分化された概念を置き換えます。
ビジネスロジックをキャプチャして、インポート/エクスポート、統合、およびプログラマビリティなどのシナリオを有効にする 1 つのスタックを提供します。
これは、Application Lifecycle Management (ALM) およびデモデータシナリオに関するデータパッケージのエクスポートおよびインポートの主要なメカニズムとなります。
OData サービスとして公開して、表スタイルの同期統合シナリオと Microsoft Office 統合で使用できます。

エンティティの例

コンシューマーは、顧客オブジェクトに関連付けられているデータにアクセスしようとしていますが、このデータは DirParty、CustTable、LogisticPostalAddress、LogisticElectronicAddress などの複数の正規化テーブルに分散されています。したがって、顧客データを読み書きするプロセスは非常に手間がかかります。代わりに、次の顧客エンティティは、1 つの非正規化ビューに基になる物理スキーマ全体をカプセル化するように設計できます。これにより、より簡単な読み取り/書き込み操作が可能になり、テーブル間の内部相互作用の抽象化も可能になります。

サポートされているシナリオ

データエンティティは、以下のすべてのシナリオをサポートします。 Dynamics 365 実装プロジェクトの構成データとデータ移行で詳細をご覧ください。

統合シナリオ

同期サービス (OData)

データエンティティは、エンティティ上の公開アプリケーションプログラミングインターフェイス (API) を公開して、同期サービスを可能にします。同期サービスは、次の目的で使用されます。

Office 統合
サードパーティモバイルアプリケーション

非同期の統合

データエンティティは、データ管理パイプラインを介した非同期統合もサポートしています。これにより、非同期かつ高性能のデータ挿入および抽出シナリオが可能になります。次にいくつか例を挙げます。

対話型ファイルベースのインポート/エクスポート
定期的な統合 (ファイル、キューなど)

ビジネスインテリジェンス

集計データ
標準化された主要業績評価指標 (KPI)

アプリケーションライフサイクル管理

統合およびビジネスインテリジェンス (BI) のシナリオの他に、データエンティティも最初は 2 つの重要な ALM シナリオをサポートしています。 ALM シナリオの次の 2 つのプログレッシブレベルは、データエンティティによるカバレッジの範囲を示しています。

コンフィギュレーションデータのプロビジョニング

システムの実装担当者は、ガイド付きデータ収集ウィザードとバルクデータ入力メカニズムの両方を使用して、Microsoft Dynamics Lifecycle Services (LCS) を介して、構成データで初期展開 (またはモジュール) をブートします。コンフィギュレーションは、主に次のエンティティカテゴリを対象としています。

すべてのパラメーター
参照
システムパラメーター
整理番号
通貨

レガシシステムまたは外部システムからのデータ移行

最初の配置が立ち上がって動作した後、システム実装担当者は、アプリケーション、特に以下の資産に対して顧客の既存データ資産の移行を実行します。

マスターデータ (たとえば、顧客および仕入先)
ドキュメント (たとえば、販売注文) のサブセット

組み込みエンティティ

データエンティティを使用すると、データ移行やデータ統合のシナリオなど、Dynamics 365 プロジェクトでデータをインポートできます。次の一覧は、Dynamics 365 ソリューションで最も頻繁に使用されるエンティティの一部を示しています。

エンティティのカテゴリ

エンティティは、それらの機能およびそれらが提供するデータのタイプに基づいて分類されます。以下は、データエンティティの 5 つのカテゴリです。

パラメーター

機能的または行動のパラメーター。
特定のビルドまたは顧客の展開またはモジュールを設定するために必要です。
産業またはビジネスに固有のデータを含めることができます。データは、より広範な顧客にも適用されます。
列の設定の値になっている、1 つだけのレコードが含まれているテーブル。このようなテーブルの例としては、買掛金勘定 (AP)、一般会計 (GL)、クライアントパフォーマンスオプション、ワークフローなどが存在します。

参照

業務プロセスを操作するために必要な少量の簡易参照データです。
産業または業務プロセスに固有のデータ。
例には、単位、分析コード、および税コードが含まれます。

マスター

ビジネスのデータ資産。一般に、これらはビジネスの「名詞」で、通常ユーザー、場所、および概念などのカテゴリに分類されます。
大量の複雑な参照データ。例には、顧客、仕入先、およびプロジェクトが含まれます。

書類

後でトランザクションに変換されるワークシートデータ。
各ヘッダーレコードに対する複数の明細行品目のような複雑な構造体をもつドキュメント。例には、販売注文、発注書、オープン残高、および仕訳帳が含まれます。
ビジネスの運用データ。

取引

ビジネスの運用トランザクションデータ。
転記済トランザクション。これらは、転記済請求書や残高などの非冪等項目です。通常、これらの項目は、コピーまたは移行されるデータ量を削減するために、データセット全体のコピー時に除外されます。完了したトランザクションを移行すると、新しいシステムで関連データの参照整合性を維持しようとするなかで、複雑性が増す可能性もあります。一般に、完了した業務プロセスからのトランザクションは、詳細ではなく要約して移行されます。
例には保留中の請求書を含まれます。

エンティティの作成

エンティティを作成するには複数の方法があります。たとえば、ウィザードを使用する、またはテーブルからのエンティティを構築できます。

ウィザードを使用したエンティティの構築

エンティティをビルドする最も簡単な方法は、ウィザードを使用することです。このウィザードでは、ルートデータソースを選択して他の関連するデータソースに展開し、エンティティのフィールドを選択できます。ウィザードを開始するには、データエンティティ タイプの新しい項目をプロジェクトに追加します。ウィザードを使用してエンティティを構築する手順については、データエンティティの構築と使用を参照してください。次のテーブルに、ウィザードでエンティティに設定したプロパティに関する情報を示します。

プロパティ	説明
プライマリデータソース	エンティティを根ストラクトするために使用されるルートデータソース (テーブルまたはビュー)。このルートデータソースに基づき、さらに関連データソースを追加することができます。
データエンティティ名	エンティティの名前。
エンティティカテゴリ	エンティティのタイプ。エンティティのカテゴリは、テーブルのテーブルグループに類似しています。使用可能なカテゴリには、パラメーター、参照、マスター、ドキュメント、およびトランザクションがあります。
パブリックエンティティ名	エンティティのパブリックリソース名。
パブリックコレクション名	パブリックリソースは名前を設定します。
パブリック API の有効化	OData サービスのエンティティを有効にするには、このオプションを選択します。
データ管理能力の有効化	データのインポート/エクスポートおよびコネクタの統合など、エンティティで非同期統合を有効にするには、このオプションを使用します。
ステージングテーブル	エンティティに対して生成されるステージングテーブルの名前。ステージングテーブルは、非同期の統合および大規模なシナリオで使用されます。

データソースの追加

エンティティを作成するときは、ルートデータソースから開始します。ただし、他のデータソースを追加することができます。手動で新しいデータソースを追加するか、ルートデータソースで代理外部キーフィールドを選択して必要なデータソースを自動的に展開することができます。

出力

ウィザードを完了したら、次の項目が生成されます。

データエンティティ
ステージングテーブル (データの管理が有効であった場合は省略可能)

テーブルからエンティティを作成する

テーブルからエンティティを素早く作成して、プロパティ、データソース、およびフィールドを後でカスタマイズすることができます。テーブルを右クリックし、アドイン>データエンティティの作成を選択します。

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

環境のエンティティは、次のガイドラインを使用して更新する必要があります。

新しい環境が展開され、ユーザーがデータ管理ワークスペースに移動すると、エンティティリストの更新が自動的に開始されます。
データ管理が既に使用されている環境にコードパッケージが展開されるとき、データ管理 > フレームワークパラメーター > エンティティ設定 > エンティティリストの更新 からエンティティリストの更新はから手動で開始する必要があります。
コンフィギュレーションキーが変更されるとき、データ管理 > フレームワークパラメーター > エンティティ設定 > 更新エンティティリスト からエンティティリストを手動で更新する必要があります。

エンティティリストを更新すると、環境ですべてのエンティティを使用できるようになり、エンティティのメタデータが最新になります。

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

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

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

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

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

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

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

データエンティティでコンフィギュレーションキーを設定する	テーブルでコンフィギュレーションキーを設定する	テーブルフィールドでコンフィギュレーションキーを設定する	データエンティティフィールドのコンフィギュレーションキー	予想される動作
無効	未評価	未評価	未評価	データエンティティのコンフィギュレーションキーが無効である場合、データエンティティは機能しなくなります。基になるテーブルやフィールド内でコンフィギュレーションキーが有効または無効かどうかは重要ではありません。
有効	無効	未評価	未評価	データエンティティのコンフィギュレーションキーが有効である場合、データ管理フレームワークは基になるテーブルごとのコンフィギュレーションキーを確認します。テーブルのコンフィギュレーションキーが無効である場合、テーブルは機能を使用するデータエンティティで使用できなくなります。テーブルのコンフィギュレーションキーが無効である場合、テーブルおよびデータエンティティのコンフィギュレーションキー設定は評価されません。エンティティの主テーブルでそのコンフィギュレーションキーが無効になっている場合、エンティティのコンフィギュレーションキーが無効にされたのと同じように、システムは実行されます。
有効	有効	無効	未評価	データエンティティのコンフィギュレーションキーが有効で、基になるテーブルのコンフィギュレーションキーが有効である場合、データ管理フレームワークはコンフィギュレーションキーをテーブルのフィールドで確認します。フィールドのコンフィギュレーションキーが無効である場合、対応するデータエンティティフィールドが有効なコンフィギュレーションキーを持っている場合でも、そのフィールドは使用する機能に対するデータエンティティを使用できません。
有効	有効	有効	無効	他のすべてのレベルでコンフィギュレーションキーが有効であっても、そのエンティティフィールドのコンフィギュレーションキーが有効でない場合、フィールドはデータエンティティで使用不可能です。

メモ

エンティティが、データソースとして別のエンティティを持っている場合、上記のセマンティクスが再帰的な方法で適用されます。

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

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

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

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

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

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

エンティティリストのページ。

ターゲットフィールド

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

ターゲットフィールド。

子エンティティ

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

子エンティティ。

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

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

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

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

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

コンフィギュレーションキー。

データエンティティの概要

概要