利用者
コミュニティの利用者を表します。利用者は、その利用者をコミュニティでのターゲティングに割り当てて使用できるさまざまな条件で構成されます。Metadata メタデータ型を拡張し、その fullName 項目を継承します。
ファイルのサフィックスおよびディレクトリの場所
Audience コンポーネントのサフィックスは .audience で、audience フォルダに保存されます。
バージョン
Audience コンポーネントは、API バージョン 44.0 以降で使用できます。
特別なアクセスルール
Audience 型のメタデータアクセスは、AudienceMetadata 権限によって裏付けられます。この権限は、ネットワークが有効化されている組織ではデフォルトで有効になります。
項目
| 項目名 | 項目のデータ型 | 説明 |
|---|---|---|
| audienceName | string | 必須。利用者の名前。 |
| container | string | 必須。Network または Organization のいずれかで、Audience が含まれる場所を表します。 |
| criterion | AudienceCriterion[] | 利用者の条件のリスト。 |
| description | string | 利用者の説明。 |
| FormulaFilterType | FormulaFilterType | 利用者の数式の種類を示します。有効な値は、次のとおりです。
|
AudienceCriterion
| 項目名 | 項目のデータ型 | 説明 |
|---|---|---|
| criterionValue | AudienceCriteriaValue | 条件の値。 |
| operator | AudienceCriterionOperator (string 型の列挙) | この条件に関連付けられている演算子。有効な値は、次のとおりです。
|
| type | AudienceCriterionType (string 型の列挙) | 有効な値は、次のとおりです。
|
AudienceCriteriaValue
- AudienceCriterion の type 項目の値が GeoLocation の場合、city、country、および subdivision 項目のみを使用できます。
- AudienceCriterion の type 項目の値が Domain の場合、domain 項目のみを使用できます。
- AudienceCriterion の type 項目の値が Profile の場合、profile 項目のみを使用できます。
- AudienceCriterion の type 項目の値が FieldBased の場合、entityField、entityType、および fieldValue 項目のみを使用できます。
| 項目名 | 項目のデータ型 | 説明 |
|---|---|---|
| city | string | AudienceCriterion の type が GeoLocation の場合にのみ使用できます。 |
| country | string | AudienceCriterion の type が GeoLocation の場合にのみ使用できます。 |
| domain | string | AudienceCriterion の type が Domain の場合にのみ使用できます。 |
| entityField | string | AudienceCriterion の type が FieldBased の場合にのみ使用できます。 |
| entityType | string | AudienceCriterion の type が FieldBased の場合にのみ使用できます。 |
| fieldValue | string | AudienceCriterion の type が FieldBased の場合にのみ使用できます。 |
| profile | string | AudienceCriterion の type が Profile の場合にのみ使用できます。 |
| subdivision | string | AudienceCriterion の type が GeoLocation の場合にのみ使用できます。 |
宣言的なメタデータの定義のサンプル
Audience コンポーネントの例を次に示します。
1<?xml version="1.0" encoding="UTF-8"?>
2<Audience xmlns="http://soap.sforce.com/2006/04/metadata">
3 <audienceName>Audience Metadata</audienceName>
4 <container>Customer</container>
5 <criterion>
6 <criterionValue>
7 <country>United States</country>
8 <subdivision>Nevada</subdivision>
9 </criterionValue>
10 <operator>Equal</operator>
11 <type>GeoLocation</type>
12 </criterion>
13 <criterion>
14 <criterionValue>
15 <profile>customer community user</profile>
16 </criterionValue>
17 <operator>Equal</operator>
18 <type>Profile</type>
19 </criterion>
20 <criterion>
21 <criterionValue>
22 <domain>mobile1.t.salesforce.com</domain>
23 </criterionValue>
24 <operator>Equal</operator>
25 <type>Domain</type>
26 </criterion>
27 <criterion>
28 <criterionValue>
29 <entityField>Manager.Profile.CreatedBy.Contact.MailingCountry</entityField>
30 <entityType>User</entityType>
31 <fieldValue>USA</fieldValue>
32 </criterionValue>
33 <operator>StartsWith</operator>
34 <type>FieldBased</type>
35 </criterion>
36 <criterion>
37 <criterionValue>
38 <entityField>RecordTypeId</entityField>
39 <entityType>CollaborationGroup</entityType>
40 <fieldValue>CollaborationGroup.Group_RT2</fieldValue>
41 </criterionValue>
42 <operator>Equal</operator>
43 <type>FieldBased</type>
44 </criterion>
45 <formulaFilterType>AllCriteriaMatch</formulaFilterType>
46</Audience>