キュー エンティティ

  • [アーティクル]

 

公開日: 2017年1月

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

Microsoft Dynamics 365を使用する際、キューは作業の進捗状況の編成、優先順位の指定、および監視を行う手段です。 作業を集中管理する手段として、サポート案件の処理、サービス呼び出しの対応、または見込みのある顧客への製品情報の送信でキューが役立ちます。 プログラム的には、キューはキュー アイテムの集合です。 キュー アイテムは、処理が必要なタスク、電子メール、またはサポート案件などのエンティティ レコードのコンテナーの役割を果たします。

注意

キューの機能は、Microsoft Dynamics CRM 2013 Service Pack 1 (SP1) (設置型) および CRM Online 2014 年春 で強化されました。 以前のバージョンに追加された機能の詳細については、「このトピックの Dynamics CRM 2013 バージョン」を参照してください。

キューには次のような機能があります。

  • すべてのカスタマイズ可能なエンティティをキューに対して有効化できます。

  • キューはパブリックまたはプライベートを選択できます。 プライベート キュー アイテムは、キューのメンバーにのみ表示されます。

  • 新しいユーザーまたはチームごとに、プライベート キューが自動的に作成されます。

  • キューには、タスク、電子メール、サポート案件などの複数の種類のエンティティを含めることができます。

  • キューには、特定のキュー アイテムで作業しているユーザーに関する情報が含まれます。 これにより、リソースを効率よく管理でき、作業の重複を回避できます。

  • ワークフローおよび監査に対して、キューを有効化できます。 これにより、生産性が向上し、将来行う分析やレポート作成のためにエンティティおよび属性データの変更を追跡できます。

このトピックの内容

メンバーの機能

パブリック キューとプライベート キュー

キューを管理するために使用される属性

キューの削除の制限

キューに対してエンティティを有効化する

特権の継承およびキューへの制限されたアクセスの指定

キューおよびキュー アイテムでのアクション

メンバーの機能

キューがパブリック キューまたはプライベート キューに分類されるようになりました。 キューへのアクセスをより簡単に制御できるようにするため、プライベート キューは、個々のユーザーをメンバーとします。 プライベート キューにチームを追加する場合は、そのチームのすべてのメンバーが、プライベート キューのメンバーになります。

パブリック キューとプライベート キュー

QueueViewType属性は、キューがパブリックであるかプライベートであるかを定義する候補リストです。

  • すべてのユーザーのキューは、ユーザーのプライベート キューになります。自分のプライベート キューのキュー アイテムを表示することができるのは、そのユーザーだけです。

  • チームのキューは、メンバーのプライベートとしてマークされます。チーム所有者とすべてのチーム メンバーが、アプリケーションでキューを表示できます。

  • その他のすべてのキューはパブリックになります。 キュー エンティティの読み取り特権を持つすべてのユーザーは、これらのキューを表示することができます。

キューを管理するために使用される属性

次の属性を使用して、キューを管理します。

SchemaName

DisplayName

種類

説明

NumberOfItems

キュー アイテム

整数

キューに関連付けられているキュー アイテムの数です。

NumberOfMembers

番号 メンバーの

整数

キューに関連付けられているメンバーの数です。

QueueViewType

種類​​

候補リスト

キューをパブリックにするかプライベートにするかを選択します。 パブリック キューは、すべてのユーザーが表示できます。 プライベート キューは、キューに追加されているメンバーのみが表示できます。

キューの削除の制限

次の場合、キューは削除できません。

  • キューにキュー アイテムがある場合。

  • ルーティング ルールでキューが使用されている場合。

キューに対してエンティティを有効化する

キューに対してカスタマイズ可能なエンティティ (ビジネスまたはカスタム) を有効化するには、UpdateEntityRequest メッセージを使用して、IsValidForQueue 属性を true に設定します。 カスタマイズ可能なエンティティの一覧については、「カスタマイズ可能なエンティティ」を参照してください。 キュー エンティティおよびキュー アイテム エンティティはカスタマイズ可能なエンティティですが、キューに対して有効化することはできません。

次の一覧に、Microsoft Dynamics 365 (オンラインおよび設置型) において既定でキューが有効化されているエンティティを示します。

  • Appointment

  • Campaignactivity

  • CampaignResponse

  • Email

  • Fax

  • Incident

  • Letter

  • PhoneCall

  • RecurringAppointmentMaster

  • ServiceAppointment

  • SocialActivity

  • Task

特権の継承およびキューへの制限されたアクセスの指定

キューおよびキュー アイテムには、親キュー レコードの操作が子キュー アイテム レコードに伝播される上位下位の関連付けがあります。 上位下位の関連付け、および伝播規則の詳細については、「エンティティ関係の動作」を参照してください。

注意

この特定の上位下位の関連付けでは、削除操作のみが、親キュー エンティティから子キュー アイテム エンティティに伝播します。 割り当て、統合、共有など、その他の操作は伝播されません。

キュー アイテムの特権は、キューの特権から継承されます。

  • prvReadQueue 特権を持っている場合、キュー アイテム エンティティへの読み取り特権も持っています。

  • prvAppendToQueue 特権を持っている場合、キュー アイテム エンティティへの作成、更新、および削除の特権も持っています。

キュー アイテムへのアクセスを許可する際には、キューへのアクセスを制限しなければならない場合があります。 キューへの完全なアクセス権を持つキューの所有者が、キューへのアクセス権が制限されているチームとキューを共有する場合があります。 たとえば、キューについての読み取り特権および追加特権がサポート チームに付与されている場合、チーム メンバーはそのキューに対していかなる変更も実施できません (つまり、キュー名の変更や所有者の変更などはできません)。 ただし、キュー アイテムに対しては、作成、取得、更新、および削除の操作を実行できます。

キューおよびキュー アイテムでのアクション

キュー エンティティ、およびキュー アイテム エンティティに対して適切な特権を持っている場合、キュー およびキュー アイテムでさまざまなアクションを実行できます。

キューでのアクション

キューでは次のアクションを実行できます。

  • ユーザー定義属性を追加することによって、キューおよびキュー アイテムをカスタマイズします。

  • キューにエンティティ レコードを追加します。

    注意

    1 つのエンティティ レコードを複数のキューに追加することはできません。 例外は、ステータスが "受信" の電子メール エンティティ レコードです。

  • さまざまな種類のエンティティのエンティティ レコードを同じキューに追加します。

  • キューの所有権を他のユーザーまたはチームに割り当てることによって、その所有権を変更します。

  • AddPrincipalToQueueRequestを使用して、プライベート キューにプリンシパルを追加します。

  • 完了下電話やキャンセルされた電話など、キュー内の非アクティブなキュー アイテムを削除することによって、キューの履歴をクリーンアップします。

  • RetrieveUserQueuesRequestを使用して、ユーザーがアクセス権を持っているすべてのキューを取得します

  • SystemUser.QueueId 属性をキューの ID に設定することによって、キューをユーザーの既定のキューにすることができます。 同じキューを、異なるユーザーの既定のキューとして指定できます。

  • すべてのプライベート キューで動作するワークフローを作成します。 たとえば、ユーザーがタスクを作成すると、常にワークフローがそのタスクをユーザーの既定のキューに追加します。 また、特定のキューでのみ動作するワークフローを作成することもできます。

  • 受信電子メール メッセージをキューに配信する場合に、受信メッセージに対して電子メールを構成します。

キュー アイテムでのアクション

キュー アイテムで次のアクションを実行します。

  • PickFromQueueRequestを使用して、キュー アイテムをユーザーに割り当てます。

  • AddToQueueRequest メッセージを使用して、キュー アイテムをソース キューから別のキューに移動します。 キュー アイテムは、SetStateRequest メッセージを使用して非アクティブ化されるまで、キュー間を移動できます。

    注意

    キュー アイテム内のレコードの状態がアクティブから非アクティブに変わった場合、キュー アイテムは自動的に非アクティブ化されます。 このことは、アクティブ状態と非アクティブ状態を持つ、キューを有効化されたエンティティについても同様です。 エンティティがキューで有効化されているかどうか、エンティティ レコードがアクティブまたは非アクティブ状態にできるかどうかを判断するには、エンティティのメタデータ情報を参照してください。組織のエンティティ メタデータを表示するには、「組織のメタデータの参照」で説明されているメタデータ ブラウザー ソリューションをインストールします。 カスタマイズされていない組織のメタデータを、EntityMetadata.xlsx という名前の Excel ファイルで見ることもできます。このファイルは、ダウンロードした SDK の最上位のフォルダーに含まれています。

  • ReleaseToQueueRequestを使用して、キューアイテムを解放してキューに戻します。

  • DeleteRequest メッセージを使用して、キュー アイテムをキューから削除します。 キュー アイテムを削除するとき、参照先エンティティ レコードは削除されません。 ただし、エンティティ レコードを削除する場合は、このエンティティ レコードを参照するキュー アイテムがすべて削除されます。

関連項目

AddToQueueRequest
受信メッセージ用電子メールを構成する
キュー (Queue) エンティティのメッセージおよびメソッド
キュー アイテム (QueueItem) エンティティのメッセージおよびメソッド
キュー エンティティのサンプル コード
ビジネス管理エンティティ

Microsoft Dynamics 365

© 2017 Microsoft. All rights reserved. 著作権