Queue | メタデータ API 開発者ガイド

宣言的なメタデータファイルのサフィックスおよびディレクトリの場所

キューコンポーネントのファイルサフィックスは .queue で、コンポーネントは対応するパッケージディレクトリの queues ディレクトリに保存されます。このコンポーネントは、ケース、リード、サービス契約 (エンタイトルメントが有効である場合)、およびカスタムオブジェクトをサポートします。

バージョン

キューコンポーネントは、API バージョン 24.0 以降で使用できます。

項目

このメタデータ型はキューを定義する有効な値を表します。

項目名	データ型	説明
doesSendEmailToMembers	boolean	新しいレコードがキューに追加されたときに、メールがキューメンバーに送信されるか (`true`)、否か (`false`) を示します。
email	string	キュー��所有者のメールアドレス。
name	string	必須。キューの名前。ユーザインターフェースの [表示ラベル] に対応します。
queueMembers	QueueMembers[]	キューに追加されるキューメンバーを表します。メンバーは直接追加することも、ロールや属している公開グループで選択することもできます。API バージョン 42.0 以降で利用できます。
queueRoutingConfig	string	ルーティング設定名。ルーティング設定でオムニチャネルを使用する組織に適用されます。API バージョン 42.0 以降で利用できます。
queueSobject	QueueSobject[]	サポートされているエンティティ種別を示します。

QueueMembers

キューに追加されるキューメンバーを表します。メンバーをユーザとして直接追加したり、所属するロールと公開グループでメンバーを選択したりできます。API バージョン 42.0 以降で利用できます。

項目名	データ型	説明
publicGroups	PublicGroups[]	組織の公開グループを表します。必要に応じて、公開グループを使用してキューメンバーを追加できます。
roleAndSubordinates	RoleAndSubordinates[]	ロールと、組織のロール階層のそれらの下位ロールを表します (カスタマーロールとパートナーロールを含む)。必要に応じて、ロールとその下位階層を使用してキューメンバーを追加できます。
roleAndSubordinatesInternal	RoleAndSubordinatesInternal[]	カスタマーロールとパートナーロールを除く、組織のロール階層内の内部ロールとその下位ロールを表します。必要に応じて、ロールとその下位階層を使用してキューメンバーを追加できます。
roles	Roles[]	組織のロールを表します。必要に応じて、ロールを使用してキューメンバーを追加できます。
users	Users[]	組織のユーザを表します。ユーザは、キューメンバーとして直接追加できます。

PublicGroups

組織の公開グループを表します。必要に応じて、公開グループを使用してキューメンバーを追加できます。API バージョン 42.0 以降で利用できます。

項目名	データ型	説明
publicGroup	string	公開グループを表します。

RoleAndSubordinates

ロールと、組織のロール階層のそれらの下位ロールを表します (カスタマーロールとパートナーロールを含む)。ロールとそれらの下位ロールの階層は、キューメンバーを追加するために使用できます。API バージョン 42.0 以降で利用できます。

項目名	データ型	説明
roleAndSubordinate	string	カスタマーロールとパートナーロールを含む、ロールとその下位ロールを表します。

RoleAndSubordinatesInternal

カスタマーロールとパートナーロールを除く、組織のロール階層内の内部ロールとその下位ロールを表します。ロールとそれらの下位ロールの階層は、キューメンバーを追加するために使用できます。API バージョン 42.0 以降で利用できます。

項目名	データ型	説明
roleAndSubordinateInternal	string	カスタマーロールとパートナーロールを除く、ロールとその下位ロールを表します。

ロール

組織のロールを表します。ロールは、キューメンバーを追加するために使用できます。API バージョン 42.0 以降で利用できます。

項目名	データ型	説明
role	string	ロールを表します。

ユーザ

組織のユーザを表します。ユーザは、キューメンバーとして直接追加できます。API バージョン 42.0 以降で利用できます。

項目名	データ型	説明
user	string	ユーザを表します。

QueueSobject

QueueSobject ではキューがサポートするエンティティ種別を表します。

項目名	データ型	説明
sobjectType	string	有効な値は、次のとおりです。 `Case` `Lead` `ServiceContract` カスタムオブジェクト (`ObjA_c` など)

宣言的なメタデータの定義のサンプル

ケース、リードおよび ObjA という名前のカスタムオブジェクトをサポートするキューの定義を次に示します。

1<?xml version="1.0" encoding="UTF-8"?>
2<Queue xmlns="http://soap.sforce.com/2006/04/metadata">
3    <doesSendEmailToMembers>true</doesSendEmailToMembers>
4    <email>member@company.com</email>
5    <fullName>Your Name</fullName>
6    <name>memberQueue</name>
7    <queueSobject>
8        <sobjectType>Case</sobjectType>
9    </queueSobject>
10    <queueSobject>
11        <sobjectType>Lead</sobjectType>
12    </queueSobject>
13    <queueSobject>
14        <sobjectType>ObjA__c</sobjectType>
15    </queueSobject>
16</Queue>

キューの別の定義を次に示します。このキューには、直接追加されたまたは公開グループとロールによって追加されたキューメンバーが含まれます。

1<?xml version="1.0" encoding="UTF-8"?>
2<Queue xmlns="http://soap.sforce.com/2006/04/metadata">
3    <doesSendEmailToMembers>false</doesSendEmailToMembers>
4    <name>queue1</name>
5    <queueMembers>
6        <groups>
7            <publicGroup>All Internal Users</publicGroup>
8        </groups>
9        <roleAndSubordinates>
10            <roleAndSubordinate>role1</roleAndSubordinate>
11        </roleAndSubordinates>
12        <roleAndSubordinatesInternal>
13            <roleAndSubordinateInternal>role2</roleAndSubordinateInternal>
14        </roleAndSubordinatesInternal>
15        <roles>
16            <role>role3</role>
17        </roles>
18        <users>
19            <user>admin@myorg.com</user>
20            <user>user1@myorg.com</user>
21            <user>user2@myorg.com</user>
22        </users>
23    </queueMembers>
24    <queueRoutingConfig>my_omni_routing_config</queueRoutingConfig>
25    <queueSobject>
26        <sobjectType>Case</sobjectType>
27    </queueSobject>
28    <queueSobject>
29        <sobjectType>Lead</sobjectType>
30    </queueSobject>
31</Queue>