Queue テーブル

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

注意

UI を使用したキューの操作については、基本キューの作成と管理 を参照してください。

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

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

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

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

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

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

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

メンバーの機能

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

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

QueueViewType 列は、キューがパブリックであるかプライベートであるかを定義する選択肢です。

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

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

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

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

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

SchemaName DisplayName 種類 説明
NumberOfItems キュー アイテム 整数 キューに関連付けられているキュー アイテムの数です。
NumberOfMembers 番号 メンバーの 整数 キューに関連付けられているメンバーの数です。
QueueViewType 種類​​ 候補リスト キューをパブリックにするかプライベートにするかを選択します。 パブリック キューは、すべてのユーザーが表示できます。 プライベート キューは、キューに追加されているメンバーのみが表示できます。

キューの削除の制限

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

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

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

キューに対してテーブルを有効化する

キューに対してカスタマイズ可能なテーブル(EntityMetadata.IsCustomizable = true) を有効にするには、UpdateEntityRequest メッセージを使用して IsValidForQueue 属性を true に設定します。 キュー テーブルおよびキュー アイテム テーブルはカスタマイズ可能なテーブルですが、キューに対して有効化することはできません。

次の一覧に、Microsoft Dataverse において既定でキューが有効化されているテーブルを示します。

  • 予定​​

  • Campaignactivity

  • CampaignResponse

  • 電子メール

  • FAX

  • インシデント

  • レター

  • PhoneCall

  • RecurringAppointmentMaster

  • ServiceAppointment

  • ソーシャル活動

  • タスク

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

キューおよびキュー アイテムには、親キュー レコードの操作が子キュー アイテム レコードに伝播される上位下位の関連付けがあります。

注意

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

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

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

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

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

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

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

キューでのアクション

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

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

  • これらの行をキューに追加します。

    注意

    複数のキューに行を追加することはできません。 例外は、ステータスが "受信" のメール行です。

  • さまざまな種類のテーブルの行を同じキューに追加します。

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

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

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

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

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

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

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

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

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

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

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

    注意

    キュー アイテム内のレコードの状態がアクティブから非アクティブに変わった場合、キュー アイテムは自動的に非アクティブ化されます。 このことは、アクティブ状態と非アクティブ状態を持つ、キューを有効化されたテーブルについても同様です。 テーブルがキューで有効化されているかどうか、行がアクティブまたは非アクティブ状態にできるかどうかを判断するには、テーブルの定義情報を参照してください。

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

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

関連項目

キュー テーブル
QueueItem テーブル
AddToQueueRequest

注意

ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)

この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。