このトピックは、Dynamics 365 Customer Engagement (on-premises) に適用されます。 このトピックの Power Apps バージョンについては、以下を参照してください。ユーザー定義エンティティを作成する
ユーザー定義エンティティを作成する前に、既存のエンティティを使用することが要件を満たすかどうかを評価します。 詳細: 新しいメタデータを作成するか、既存のメタデータを使用する
作成するユーザー定義エンティティの名前の一部は、カスタマイズ接頭辞です。 これは、作業中のソリューションの発行者に基づいて設定されます。 カスタマイズ接頭辞に関心がある場合は、アンマネージド ソリューション、またはカスタマイズ接頭辞がこのエンティティに必要な既定のソリューションで作業していることを確認してください。 カスタマイズの接頭辞を変更する方法については、「 ソリューション発行者の接頭辞を変更する」を参照してください。
エンティティの作成の概要
ユーザー定義エンティティを作成するために最低限必要なフィールドは次のとおりです。
| フィールド | 説明 |
|---|---|
| 表示名 | これは、アプリに表示されるエンティティの単数形の名前です。 |
| 複数名 | これは、アプリに表示されるエンティティの複数形の名前です。 |
| 名前 | このフィールドは、入力した表示名に基づいて事前に入力されています。 これには、ソリューション発行者のカスタマイズ接頭辞が含まれます。 |
| 所有権 | ユーザーまたはチーム所有、または組織所有のいずれかを選択できます。 詳細: エンティティの所有権。 |
注
- ブラウザとしてSafariを使用している場合、新しいカスタムエンティティを保存または公開しようとするとタイムアウトエラーが表示されることがあります。 これが発生した場合は、別のブラウザーを使用してエンティティを作成することをお勧めします。
- エンティティ名を Dynamics 365 for Customer Service の埋め込みサポート情報検索で機能させるには、発行元のプレフィックスを含むエンティティ名の最大長が 24 文字を超えることはできません。
活動エンティティを作成するには、エンティティを保存する前に 、活動エンティティとして定義 を選択します。 詳細: 活動エンティティ
[このエンティティを表示する領域] で、ナビゲーション バーで使用可能な領域のうち、このエンティティを使用できるようにしたい領域を選択します。 これは必須ではありませんが、ユーザーがエンティティを簡単に発見できるようにする必要がある場合は、次のいずれかを選択します。 ここで変更を加えると、ナビゲーション ウィンドウを定義するデータが更新されます。 システムエンティティの設定を変更することはできません。 ただし、このデータを編集して、サイトマップを編集することで、各エンティティの表示場所と表示方法を変更できます。
デフォルトで設定されるオプションは多数あります。 これらをユーザー定義エンティティに必要かどうかわからない場合は、保存する前に無効にしてください。 後でいつでも有効にすることができますが、特定のオプションは有効にした後で無効にすることはできません。 メモ、 アクティビティ、 および接続 はデフォルトで有効になっており、後で無効にすることはできません。 使用可能なオプションの詳細については、「 エンティティの編集」を参照してください。
各ユーザー定義エンティティには、プライマリ フィールドがあります。 これは、[ プライマリ フィールド ] タブで定義します。このフィールドは、エンティティのレコードがリストに表示される場合に使用されます。 通常、プライマリ フィールドはレコードを開くリンクです。 このフィールドは、テキスト形式の 1 行テキスト フィールドである必要があります。 エンティティを作成するとき、後で変更できない唯一の値は Name です。 既定では、 表示名は "Name" で、 名前 はソリューション発行者のカスタマイズ プレフィックス、アンダースコア、および "name" です。 これが望ましくない場合は、エンティティを作成する前にこれを変更してください。 エンティティを保存した後は、エンティティの プライマリ フィールド タブからプライマリ フィールドの値を編集することはできません。 このフィールドは、エンティティ フィールド内で配置する必要があります。 他の1行のテキストフィールドと同様に、そこで編集できます。
システム管理者またはシステム カスタマイザーのセキュリティ ロールを持つユーザーは、すべての新しいユーザー定義エンティティを表示できます。 これにより、システムを使用するユーザーに表示する前に、カスタム エンティティをテストできます。 他のセキュリティ ロールを持つユーザーがこれらのエンティティを表示できるようにするには、セキュリティ ロールを編集し、他のユーザーにアクセス権を付与して、エンティティを表示できるようにする必要があります。 ユーザー定義エンティティが作成されると、各セキュリティ ロールの ユーザー定義エンティティ タブに含まれます。 ユーザーがアプリでカスタムエンティティを表示できるようにするには、少なくともユーザーレベルの読み取りアクセス権を付与する必要があります。
新しいエンティティが作成されると、そのエンティティに対して多数のメタデータとサポート システム レコードが作成されます。 エンティティの編集を続行するには、これらを使用します。
エンティティの作成
アプリ作成者またはカスタマイザーは、ソリューション エクスプローラーを使用してエンティティを作成および編集できます。
- Dynamics 365 Customer Engagement (on-premises) インスタンスにサインインします。
- ソリューション エクスプローラーを起動します。 設定>カスタマイズ>システムをカスタマイズします。
- [コンポーネントの種類] ボックスの一覧で、[新規] を選択し、[エンティティ] を選択します。
- 次の必須情報を入力します。 使用可能なオプションのプロパティの詳細については、「 有効にのみできるエンティティオプション 」および「 エンティティオプションを有効または無効にする」を参照してください。
- 表示名: エンティティ参照と、エンティティに基づいて作成されたレコード ( ウィジェットなど) に対してアプリに表示されるラベルを定義します。
- 複数形の名前。 これは、ウィジェットなどの複数のレコードを含むエンティティ レコードへの参照のためにアプリに表示されるラベル です。
- 名前。 このフィールドは、入力した 表示名 に基づいて事前に入力され、ソリューション発行者のカスタマイズ接頭辞 ( new_widget など) が含まれます。 表示名は後で変更できますが、フィールドの保存後に名前を変更することはできません。 詳細: 既定の発行者のソリューション発行者の接頭辞を変更する