エンティティの作成および編集

公開日: 2017年2月

対象: Dynamics 365 (online)、Dynamics 365 (on-premises)、Dynamics CRM 2016、Dynamics CRM Online

エンティティは、ユーザーが Microsoft Dynamics 365 の組織で使用できるレコードの種類を定義します。Dynamics 365 アプリケーションで、カスタマイズ可能なシステム エンティティを編集して、ユーザー定義エンティティを作成、編集、および削除できます。

このトピックの内容

エンティティの種類

セキュリティに関する考慮事項: 活動およびエンティティへのアクセス

エンティティの作成

エンティティの編集

システム エンティティ メッセージの編集

ユーザー定義エンティティの削除

管理プロパティの設定

エンティティの種類

エンティティを作成または編集するには、その前に、さまざまな種類のエンティティがあることを理解する必要があります。 ユーザー定義エンティティをいったん作成すると、これらの種類は変更できません。 2 つの重要な部分が、エンティティの所有権とエンティティが活動エンティティであるかどうかに基づいています。

エンティティの所有権

エンティティの所有権には 4 つの異なる種類があります。 ユーザー定義エンティティを作成するときのオプションは [ユーザーまたはチームが所有] または [組織所有] のみですが、他のエンティティは異なる所有権の種類を使用することに留意してください。

作成するユーザー定義エンティティ、およびほとんどのカスタマイズ可能なシステム エンティティは、[組織所有] または [ユーザーまたはチームが所有] のいずれかです。

活動エンティティ

活動は、カレンダーにエントリを作成できるアクションと考えることができます。 活動には、アクションがいつ実行されたか、またはいつ実行されるかの特定に役立つ時間ディメンション (開始時間、停止時間、期限、期間) が存在します。 また、活動には、活動が表しているアクションを判断するために役立つデータ (主題や説明) も含まれています。 活動は、開いたり、取り消したり、完了することができます。 活動の完了状態には、活動がどのように完了したかを明らかにする数種類のサブ状態値が関連付けられます。

活動エンティティはユーザーまたはチームのみが所有することができ、組織が所有することはできません。

次の表に示すように、活動を表す 15 のシステム エンティティが存在します。

ユーザー定義の活動エンティティを新規に作成できます。 たとえば、インスタント メッセージング通信を記録するために、ユーザー定義の活動エンティティを作成する場合があります。 活動エンティティの作成は、プライマリ フィールドを指定しないので、非活動エンティティの作成とは異なります。 すべての活動エンティティには、[件名] に設定されている [プライマリ フィールド] と、活動エンティティによって定義されるその他の共通フィールドがあります。 これにより、すべての種類の活動を、共通フィールドだけが表示されるビューに表示することができます。

ユーザー定義の活動エンティティを作成するには、[活動エンティティとして定義] を選択します。 これを選択した後、[活動メニューに表示する] が選択されていることが分かります。 この設定によって、活動メニューでこの種類の活動を作成できます。 これは、特定のイベントに通常関連付けられていて、コードを使用するかまたはワークフローによって作成される活動については選択されません。 いったんエンティティを保存したら、これらの設定を変更できません。

セキュリティに関する考慮事項: 活動およびエンティティへのアクセス

Dynamics 365では、特定のセキュリティ ロールを持つユーザーは、すべてのシステムとユーザー定義の活動に対して同じ一連の特権があります。 個々の活動に対して、特権の追加や削除はできません。 たとえば、ユーザーは、システム活動 (タスクなど) に削除権限は付与できず、カスタム活動に削除権限は付与できません。 ただし、個々のシステム エンティティまたはユーザー定義エンティティにユーザーがさまざまな特権を付与することができます。詳細:コミュニティ ブログ: ユーザー定義エンティティまたはユーザー定義の活動

エンティティの作成

ユーザー定義エンティティを作成する場合は、その前に、既存のエンティティの使用が要件を満たしているかどうかを確認します。詳細:メタデータの新規作成、または既存のメタデータの使用

作成するユーザー定義エンティティの名前の一部はカスタマイズの接頭辞です。 これは、作業中のソリューションの発行者に基づいて設定されます。 カスタマイズの接頭辞に注意を払う場合は、アンマネージド ソリューションか、またはカスタマイズの接頭辞がこのエンティティに対して必要な接頭辞である既定のソリューションで作業するようにします。 カスタマイズの接頭辞の変更方法については、ソリューション発行者 を参照してください。

エンティティを作成するための詳細な手順については、ヘルプとトレーニング: エンティティの新規作成 を参照してください。

ユーザー定義エンティティを作成するために必要な最小限のフィールドは次のとおりです。

活動エンティティを作成するには、そのエンティティを保存する前に、[活動エンティティとして定義] を選択します。詳細:活動エンティティ

[このエンティティが表示される領域] で、このエンティティを使用できるようにする必要のあるナビゲーション バー内のどの領域が使用できるかを選択します。 これは必須ではありませんが、ユーザーがエンティティを簡単に検索できることが必要な場合は、これらのいずれかを選択します。 ここで変更を行うと、ナビゲーション ウィンドウを定義するデータが更新されます。 システム エンティティの設定を変更することはできません。 ただし、このデータを編集して、各エンティティが表示場所と表示方法をサイトマップを編集することで変更できます。

既定で設定される複数のオプションがあります。 ユーザー定義エンティティとしてこれらが必要なことが確かでない場合は、保存する前にそれらを無効にします。 後で有効にすることはいつでも選択できますが、特定のオプションは、有効になった後は無効にすることはできません。[メモ]、[活動]、および [接続] は既定で有効になっていますが、後で無効にすることはできません。 使用できるオプションの詳細については、エンティティの編集 を参照してください。

各ユーザー定義エンティティにはプライマリ フィールドがあります。 これは、[プライマリ フィールド] タブで定義されます。 このフィールドは、エンティティのレコードを一覧で表示するときに使用されます。 通常、プライマリ フィールドはレコードを開くリンクです。 このフィールドは、[テキスト] 形式の [1 行テキスト] フィールドである必要があります。 エンティティを作成した後、変更できない唯一の値が [名前] です。 既定では、[表示名] は "名前" であり、[名前] は、ソリューション発行者のカスタマイズの接頭辞、アンダースコア、および "name" です。 これが望むものでない場合は、エンティティを作成する前にこれを変更します。 エンティティを保存した後は、エンティティの [プライマリ フィールド] タブからプライマリ フィールドの値を編集できません。 エンティティ フィールドでこのフィールドを特定する必要があります。 テキスト フィールドの他の単一行と同じように、これを編集することができます。

システム管理者またはシステム カスタマイザーのセキュリティ ロールを持つユーザーは、すべての新規ユーザー定義エンティティを表示できます。 これによって、このシステムの使用者に表示する前に、ユーザー定義エンティティをテストすることができます。 他のセキュリティ ロールを持つユーザーがこれらのエンティティを参照するには、その前に、セキュリティ ロールを編集して、他のユーザーにアクセス権を付与して、他のユーザーが参照できるようにする必要があります。 ユーザー定義エンティティを作成するとき、そのエンティティは各セキュリティ ロールの [ユーザー定義エンティティ] タブに含まれます。 ユーザー定義エンティティをアプリケーションでユーザーが表示できるようにするには、その前に、少なくとも、ユーザー レベルの読み取りアクセス権をユーザー定義エンティティに与える必要があります。

エンティティを新規に作成すると、複数のメタデータおよびサポートするシステム レコードがそのエンティティに対して作成されます。 これらのエンティティを使用して編集を続けます。

エンティティの編集

作成するユーザー定義エンティティはいずれも編集できます。 システム エンティティまたは管理ユーザー定義エンティティには、加えられる変更に制限があります。

システム エンティティは、Microsoft Dynamics 365 に含まれるエンティティです。 管理ユーザー定義エンティティは、管理ソリューションのインポートによってシステムに追加されているエンティティです。 これらのエンティティを編集できる程度は、各エンティティに設定されている管理プロパティによって決まります。 編集できないすべてのプロパティは無効になります。 ソリューション エクスプローラーで選択されるエンティティの マネージド プロパティ を表示するには、メニュー バーの [管理プロパティ] ボタンをクリックします。

エンティティの編集時に、メタデータを次のように変更できます。

• エンティティ フィールドの編集詳細:フィールドの作成および編集

• エンティティの関連付けの編集詳細:エンティティ関連付けの作成および編集

また、エンティティをサポートするレコードを変更することもできます。

• フォーム詳細:フォームの作成および設計

• 業務ルール詳細:業務ルールの作成および編集

ユーザー定義エンティティについては、[このエンティティが表示される領域] を変更できますが、システム エンティティまたは管理ユーザー定義エンティティについては、オプションが無効であることが分かります。

エンティティ名の変更

アプリケーションでエンティティの名前を変更するには、[表示名] と [複数名] プロパティを使用します。 ただし、多くのシステム エンティティの名前は、アプリケーションの他のテキストで使用されている可能性もあります。 この名前が使用されているテキストを見つけて変更するには、" システム エンティティ メッセージの編集を参照してください。

ユーザー定義エンティティで使用されるアイコンの変更

既定では、Web アプリケーションのすべてのユーザー定義エンティティは同じアイコンを使用します。 ユーザー定義エンティティに使用するアイコンのイメージ Web リソースを作成し、ツール バーの [更新アイコン] ボタンを使用してそれらを設定できます。 アイコンには次の 2 つのサイズがあります。

• [Web アプリケーション内のアイコン] このアイコンは 16x16 ピクセルにする必要があります。

• [エンティティ フォームのアイコン] このアイコンは 32x32 ピクセルです。

どちらのアイコンも 10 KB よりも大きくすることはできません。 バックグラウンドが透過の PNG 形式ファイルを推奨します。詳細:ヘルプとトレーニング: エンティティ アイコンの変更を参照してください。

唯一有効にすることができるエンティティ オプション

次の表に、エンティティに対して有効にすることができるオプションを表示しますが、これらの項目は有効にされると、その後、無効にすることはできません。

エンティティを有効化または無効化

次の表に、いつでも有効または無効にできるエンティティのオプションを示します。

システム エンティティ メッセージの編集

一部のシステム エンティティの既定の表示名は、Dynamics 365 のユーザー インターフェイスのテキストおよびエラー メッセージで使用されます。 表示名を変更した場合は、既定の表示名を使用するメッセージも更新する必要があります。 たとえば、表示名を "取引先企業" から "会社" に変更した場合は、古い名前を使用するエラー メッセージがまだ表示されます。

ソリューション エクスプローラーでは、エンティティの下に [メッセージ] ノードが表示される場合、元のエンティティ表示名への参照を含む特定のテキストを編集できます。 このテキストの編集は簡単です。 メッセージを開くと、次の 3 つのフィールドのあるフォームが表示されます。

メッセージ テキストの一部にはプレースホルダーを持ったものがあります。 これらのプレースホルダーは、かっこ付きの数値です。 例: {0}。 これらのプレースホルダーにより、テキストをメッセージに挿入できます。 メッセージを編集する場合は、これらのプレースホルダーを保持していることを確認します。

ユーザー定義エンティティの削除

システム管理者のセキュリティ ロールを持つユーザーとして、管理ソリューションの一部でないユーザー定義エンティティを削除できます。

ユーザー定義エンティティを削除するには、その前に、他のソリューション コンポーネントに存在する依存関係を削除する必要があります。 たとえば、別のエンティティの検索フィールドがこのユーザー定義エンティティを使用するフォーム上にある場合、ユーザー定義エンティティを削除するには、その前に、そのフォームから検索フィールドを削除する必要があります。 これは、このエンティティに対する参照が含まれている他のエンティティに対して定義するビューにも適用されます。 エンティティの削除を試みて、依存関係が見つかった場合、削除は認められません。 エンティティを削除するには、その前に、削除する必要がある依存関係の特定に役立つメニュー バーで、[依存関係の表示] をクリックまたはタップします。

削除されたエンティティからのデータを回復する唯一の方法は、エンティティが削除される前の時点からデータベースを復元します。

管理プロパティの設定

マネージド プロパティ は、管理ソリューションを使用してエンティティを含め、別の組織にインポートするときにだけ適用されます。 これらの設定により、ソリューション開発者は、ソリューションをインストールするユーザーに許可するカスタマイズのレベルをある程度制御できます。 エンティティの管理プロパティを設定するには、そのエンティティを選択し、メニュー バーの [管理プロパティ] をクリックします。

[カスタマイズ可能] オプションは、そのほかのすべてのオプションを制御します。 このオプションが False の場合、そのほかの設定は一切適用されません。 これが True の場合、そのほかのカスタマイズ オプションを指定できます。

エンティティには、他の種類のソリューション コンポーネントよりも多くの管理プロパティがあります。 エンティティがカスタマイズ可能な場合、以下のオプションを設定できます。

• 修正可能な表示名

• 追加プロパティを変更可能

• 新しいフォームを作成可能

• 新しいグラフを作成可能

• 新しいビューを作成可能

[追加プロパティを変更可能] を除き、これらのオプションは一目瞭然にする必要があります。[追加プロパティを変更可能] プロパティは、他のオプションによって発見されていないプロパティを単純に意味しています。 すべての個別のオプションを Falseに設定した場合、[カスタマイズ可能] もFalse に設定できます。

関連項目

メタデータの作成と編集
フィールドの作成および編集
エンティティ関連付けの作成および編集
グローバル オプション セットの作成および編集
コミュニティ ブログ: ユーザー定義エンティティまたはユーザー定義の活動

© 2017 Microsoft. All rights reserved. 著作権