エンティティ メタデータとメタデータ ブラウザーの概要
このトピックは、Dynamics 365 Customer Engagement (on-premises) に適用されます。 このトピックの Power Apps バージョンについては、以下を参照してください。 Dataverse におけるエンティティとメタデータ
このトピックでは、メタデータと、メタデータを使用して Dynamics 365 Customer Engagement (on-premises) アプリを作成するか、または既存の Dynamics 365 for Customer Engagement アプリをカスタマイズする方法を表示します。
カスタマイズで使用されるメタデータ
メタデータ はデータに関するデータを意味します。 Dynamics 365 Customer Engagement (on-premises) は、環境で使用するデータの定義の編集がかなり容易になるので、ユーザーに柔軟なプラットフォームを提供します。 Dynamics 365 Customer Engagement (on-premises) では、メタデータではエンティティのコレクションです。 エンティティは、データベースに保存されているデータの種類について説明します。 各エンティティはデータベース テーブルに対応して、エンティティ内の各フィールド (属性) はテーブル内の列を表します。 エンティティ メタデータは、作成できるレコードの種類と、それらのレコードに対して実行できるアクションの種類を制御するものです。 開発者は、エンティティ メタデータと Web サービスを使用するだけで、自分の環境のデータでアクションを実行するコードを記述できます。 このメタデータをカスタマイズ ツールで編集して、エンティティ、フィールド、エンティティの関連付けを作成または編集できます。
自分の環境内のデータとやり取りするために使用する Web アプリケーションまたはさまざまなクライアントはエンティティ メタデータによって異なり、エンティティ メタデータの変更に応じて変化します。 しかし、これらのクライアントも他のデータに依存して、表示するビジュアル要素、適用するユーザー定義ロジック、およびセキュリティの適用方法を制御します。 このシステム データもエンティティ内に格納されますが、エンティティ自体はカスタマイズに使用できません。
メタデータ ブラウザーの使用
ソリューション エクスプローラーは、カスタマイズ可能なすべてのエンティティへのアクセスを提供しますが、これは、システムで使用されるメタデータを定義するすべてのエンティティのわずか一部分にしか過ぎません。 ほとんどの基本的なカスタマイズ作業の場合、ソリューション エクスプローラーで提供される情報は、ユーザーが必要とするすべてです。 開発者は、詳細な情報と、メタデータを表示する簡単な方法を必要とすることがよくあります。 メタデータに関して開発者と徹底的な検討をする必要がある場合、またはメタデータについて深い理解が必要な場合は、メタデータ ブラウザー ソリューションのインストールを試みてください。 メタデータ ブラウザーは、インストール可能な HTML Web リソースのみ収容できる管理ソリューションです。このソリューションは、すべてのメタデータを表示し、エンティティとフィールドをフィルター処理して、メタデータに含まれている内容をいっそうよく理解することができます。
メタデータ ブラウザーのダウンロードとインストール
メタデータ ブラウザー ソリューションを下記の該当するリンクからダウンロードして、インストールします。
| Version | ダウンロード |
|---|---|
| Dynamics 365 for Customer Engagement アプリ バージョン 9.0 (v9.0) | Microsoft ダウンロード: MetadataBrowser_3_0_0_5_managed.zip |
| Dynamics 365 (v8.2) Dynamics CRM Online 2016 Update 1 と Dynamics CRM 2016 Service Pack 1 設置型 (v8.1) | Microsoft ダウンロード: MetadataBrowser_3_0_0_4_managed.zip |
| Dynamics CRM Online 2016 更新プログラムおよび CRM 2016 (v8.0) | Microsoft ダウンロード: MetadataBrowser_3_0_0_2_managed.zip |
ソリューションのインストール
ソリューションをダウンロードした後、インストールする必要があります。 管理ソリューションをインストールする方法については、「ソリューションのインポート、更新およびエクスポート」をご覧ください。
アプリとして開く
Dynamics 365 for Customer Engagement アプリ バージョン 9.0 (v9.0) バージョンはアプリとして構成されています。 エンティティ メタデータ ブラウザーソリューションをインストールした後、メタデータ ツールアプリケーションを見つけて開きます。 既定のビューはエンティティです。 ツールのナビゲーション領域からエンティティ メタデータを選択して個別のエンティティを検査します。
ソリューション構成ページから開く
以前のバージョンでは次の手順を使用する必要がありますが、最新のバージョンにも対応しています。
エンティティ メタデータ ブラウザーソリューションをインストールした後、ソリューション リストの行をダブルクリックしてマネージド ソリューションを開いて構成ページを表示すると、エンティティ メタデータ ブラウザーに関する情報と、2 種類のビューを起動するためのボタンが表示されます。
- メタデータ ブラウザはアプリのエンティティビューと同じです。
- エンティティ メタデータ ブラウザはアプリのエンティティ メタデータビューと同じです。
エンティティ ビュー
次のアクションを実行できます。
- ビューの詳細の表示: エンティティ メタデータビューを使用して表示するエンティティを選択します。
- エンティティの編集: サポートされている場合は、既定の組織で選択されたエンティティ フォームを開きます。
- テキスト検索: 次のエンティティのプロパティを使用して、表示したエンティティをフィルター処理します。
SchemaName、LogicalName、DisplayName、ObjectTypeCode、およびMetadataId。 - エンティティのフィルター処理: エンティティのサブセットを表示するために簡単な条件を設定します。 すべての条件は AND ロジックによって評価されます。
- プロパティのフィルター処理: 選択したエンティティに対して表示されるプロパティをフィルター処理します。 一覧には 100 近くのプロパティがあります。 これを使用して該当するものだけを選択します。
エンティティ メタデータ ビュー
単一のエンティティで次のアクションを実行できます。
エンティティ: 表示するエンティティを変更します。
プロパティ: エンティティのすべてのプロパティを表示し、表示されるプロパティをフィルター処理します。
- エンティティの編集: サポートされている場合は、既定の組織で選択されたエンティティ編集フォームを開きます。
- プロパティのフィルター処理: 選択したエンティティに対して表示されるプロパティをフィルター処理します。 一覧には 100 近くのプロパティがあります。 これを使用すると、必要なものだけを選択できます。
属性: マスター/詳細ビューにエンティティの属性を表示します。 このビューでは、次のことができます。
- 属性の編集: サポートされている場合は、既定の組織で選択された属性のフォームを開きます。
- テキスト検索: 次の属性のプロパティを使用して、表示した属性をフィルター処理します。
SchemaName、LogicalName、DisplayName、およびMetadataId。 - フィルター属性: 属性のプロパティ値によって属性をフィルターします。
- プロパティのフィルター処理: 選択した属性に対して表示されるプロパティをフィルター処理します。
キー: 代替キーがエンティティに対して有効な場合、どのように構成されているか確認できます。 詳細: 代替キーの定義
関連付け: 一対多、多対一、多対多の 3 つの種類のエンティティの関連づけを表示できます。 これらのビューでは、次の操作を実行できます。
- 関連付けの編集: サポートされている場合は、既定の組織で選択された関連付けのフォームを開きます。
- テキスト検索: テキスト検索を実行し、関連付けの種類に関連する値を使用して、表示される関連付けをフィルター処理します。
- プロパティのフィルター処理: 関連付けプロパティの値で関連付けをフィルター処理します。
特権: エンティティ特権を表示します。 このビューでは、次のことができます。
PrivilegeIdを使用して表示した特権をフィルター処理します。
Note
エンティティの詳細プロパティを表示すると、多数の複雑なプロパティが展開可能な状態になります。 最も頻繁に使用する値はリンク付きで表示され、リンクを使用して詳細な表示に切り替えることができます。 データをプログラムから取得した場合は、データの構造が詳細ビューに反映されます。 詳細ビューには、同じ領域で取得できるその他の関連データも表示されます (たとえば、表示名プロパティに対してローカライズされたラベルが存在する場合)。
チップ
ページからテキストをコピーするには、テキストを選択し、Ctrl+C キーボード ショートカットまたはコンテキスト メニューのコピーのコマンドを使用します。
メタデータの新規作成、または既存のメタデータの使用
Dynamics 365 Customer Engagement (on-premises) には、コアの業務アプリケーション機能をサポートする多くのシステム エンティティが用意されています。 たとえば、顧客と潜在顧客に関するデータは、取引先企業または取引先担当者エンティティを使用して保存されるようになっています。 潜在顧客エンティティは、潜在顧客または潜在営業案件に関する情報が保管される場所です。 営業案件エンティティは、売り上げをもたらす可能性のあるイベントを追跡するために使用することがその目的です。
これらの各エンティティには、 システムが各エンティティについて保存が必要と考える共通データを表す複数のフィールドも含まれています。
ほとんどの組織の場合、提供された目的に合わせて、システム エンティティおよび属性を使用する方が利点があります。 新しいユーザー定義エンティティを作成できますが、システム エンティティは、コードの記述なしには簡単には複製できない特殊な機能を備えている場合があります。
たとえば、
潜在顧客エンティティ レコードを評価できます。 この見込み評価アクションは潜在顧客を非アクティブ化し、新しい営業案件と取引先企業レコードまたは取引先担当者レコードを作成して、ビジネス プロセスを前進させることができます。
サポート案件エンティティ レコードは契約エンティティと特殊な関係があり、顧客サービスの権利の定義を容易にします。
ソリューションをインストールすると、ソリューション開発者がシステム エンティティや属性を活用することが期待できます。 システム エンティティまたは属性に取って代わる新しいユーザー定義エンティティを作成することで、使用可能なソリューションが組織に対して機能しない可能性があります。
このような理由から、提供するシステム エンティティおよびフィールドは、お客様の組織にとって意味のあるとき、使用することをお勧めします。 これらが意味を成さず、またニーズに合うように編集できない場合は、新しいエンティティの作成が必須かどうかを評価する必要があります。 組織で使用する用語に一致するように表示名を変更できることに留意してください。 たとえば、ユーザーが、取引先企業エンティティの表示名を "企業" に、または取引先担当者エンティティの表示名を "個人" に変更することはよくあることです。 これは、エンティティの動作を変更することなく、エンティティまたは属性に対して実行できます。 エンティティの名前変更の詳細については、「エンティティの名前の変更」を参照してください。
システム エンティティまたはフィールドは削除できません。 これらはシステム ソリューションの一部とみなされ、すべての組織でその使用が予定されています。 システム エンティティを非表示にする場合は、組織のセキュリティ ロール特権を変更して、そのエンティティの読み取り特権を削除します。 これにより、アプリケーションのほとんどからそのエンティティが削除されます。 不要なシステム フィールドがある場合は、使用するフォームやビューからそのフィールドを削除します。 フィールド定義の検索可能値を変更して、高度な検索で表示されないようにします。 詳細: フィールドの作成と編集
メタデータ アイテムの作成の制限
作成できるエンティティの数に制限があります。 使用中のリソースのページに、その最大数に関する情報があります。 ユーザー定義エンティティがさらに必要な場合は、Dynamics 365 Customer Engagement (on-premises) テクニカル サポートまでお問い合わせください。 この上限は調整できます。
各エンティティには、作成できるフィールドの数に上限があります。 この制限は、データベース テーブルの行に保存できるデータの量に対する技術的な制約に基づいています。 それぞれの種類のフィールドが使用できる容量は異なるので、特定の数を提供することは困難です。 上限は、エンティティのすべてのフィールドで使用される合計容量に基づいて決まります。
ほとんどのユーザーは制限に到達するほどユーザー定義フィールドを作成しませんが、エンティティに数百ものユーザー定義フィールドを追加するようになった場合は、これが最善の設計であるかどうかを検討する必要があります。 追加予定のすべてのフィールドが、そのエンティティのレコードのプロパティを記述していますか。 組織を使用しているユーザーが、そのような多数のフィールドのあるフォームを扱うことができる本当にお考えですか。 フォームに追加するフィールドの数によって、レコードが編集されるたびに転送する必要のあるデータの量が増加し、システムのパフォーマンスに影響を与えます。 エンティティにユーザー定義フィールドを追加する際は、これらの要因を考慮してください。
オプション セット フィールドは、フォームのドロップダウン コントロール、または高度な検索使用時の候補リスト コントロールに表示される、オプション セットを提供します。 お客様の環境はオプション セット内で数千のオプションをサポートできますが、これを上限と考えない方がいいでしょう。 使いやすさの調査から、ドロップダウン コントロールが多数のオプションを提供するシステムの使用で、ユーザーが困難に遭遇していることが示されています。 データのカテゴリの定義には、オプション セット フィールドを使用してください。 データの個別のアイテムを実際に表すカテゴリを選択するために、オプション セット フィールドを使用しないでください。 たとえば、備品の種類の数百の製造元のそれぞれを格納するオプション セット フィールドを維持するのではなく、各製造元への参照を格納するエンティティの作成を検討し、オプション セットの代わりに検索フィールドを使用してください。
ビューは 1 ビューあたり 1000 の属性までに制限されています。 この制限を超えるエンティティにビューが作成された場合、利用可能な属性のサブセットをビューで使用しなくてはなりません。 1000 の制限を超える属性を追加すると、属性の最大数を超えたことを示すエラーメッセージが表示されます。