EscalationRules
ケースが一定の期間内に解決されない場合に自動的にエスカレーションを行うための、ケースのエスカレーションルールを表します。該当するすべてのオブジェクト、特定のオブジェクト、または特定のオブジェクトの特定のルールのルールメタデータにアクセスできます。
すべてのオブジェクトのすべてのエスカレーションルールにアクセスする package.xml 構文は次のとおりです。
特定のオブジェクトのすべてのルールでは、ワイルドカードを使用しない類似の構文が使用されます。たとえば、Case オブジェクトのすべてのエスカレーションルールでは、次の構文が使用されます。
オブジェクトの特定のエスカレーションルールにもアクセスできます。次の例では、Case オブジェクトの「samplerule」および「newrule」エスカレーションルールのみにアクセスできます。この例では、型名の構文は EscalationRules ではなく、EscalationRule です。
1<types>
2 <members>*</members>
3 <name>EscalationRules</name>
4 </types>1<types>
2 <members>Case</members>
3 <name>EscalationRules</name>
4 </types>1<types>
2 <members>Case.samplerule</members>
3 <members>Case.newrule</members>
4 <name>EscalationRule</name>
5 </types>ファイルのサフィックスおよびディ��クトリの場所
オブジェクトの EscalationRules のサフィックスは .escalationRules で、escalationRules フォルダに保存されます。たとえば、すべての Case エスカレーションルールは、Case.escalationRules ファイルに保存されます。
バージョン
EscalationRules コンポーネントは、API バージョン 27.0 以降で使用できます。
項目
| 項目名 | 項目の型 | 説明 |
|---|---|---|
| escalationRule | EscalationRule[] | 1 つのエスカレーションルールを表し、有効かどうかを示します。エスカレーションルールは EscalationRules コンテナ内に表示される順序で処理されます。 |
EscalationRule
| 項目名 | 項目の型 | 説明 |
|---|---|---|
| active | boolean | エスカレーションルールが有効であるか (true)、否か (false) を示します。 |
| fullname | string |
Metadata から継承されるこの項目は、このメタデータ型の WSDL で定義されます。作成時、更新時、または削除時に指定する必要があります。コールにおけるこの項目の例を確認するには、「createMetadata()」を参照してください。 この値は null にできません。 |
| ruleEntry | RuleEntry[] | エスカレーションルールのルールエントリの定義が含まれます。 |
RuleEntry
ルールで使用される項目を表します。
| 項目名 | 項目の型 | 説明 |
|---|---|---|
| booleanFilter | string | ルールに指定されている高度な絞り込み条件。 |
| businessHours | string | エスカレーションアクションが実行される時間。businessHoursSource が Static に設定されている場合のみ指定します。 |
| businessHoursSource | BusinessHoursSourceType (string 型の列挙) | 有効な値は、次のとおりです。
|
| criteriaItems | FilterItem | 割り当て条件を定義するリストの項目。 |
| disableEscalationWhenModified | boolean | レコードが変更されるとエスカレーションが無効化されるか (true)、否か (false) を示します。 |
| escalationAction | EscalationAction[] | エスカレーション条件が一致すると実行されるアクション。 |
| escalationStartTime | EscalationStartTimeType (string 型の列挙) | エスカレーションの開始時間を示します。有効な値は、次のとおりです。
|
| formula | string | 入力規則数式。 |
EscalationAction
エスカレーションルールで実行されるアクションを説明します。
| 項目名 | 項目の型 | 説明 |
|---|---|---|
| assignedTo | string | 項目が割り当てられるユーザまたはキューの名前。 |
| assignedToTemplate | string | エスカレーションルールで指定された新しい所有者に自動送信されるメールで使用するテンプレートを指定します。 Lightning メールテンプレートは、パッケージ化できません。Classic メールテンプレートを使用することをお勧めします。 |
| assignedToType | AssignToLookupValueType (string 型の列挙) | 有効な値は、次のとおりです。
|
| minutesToEscalation | int | エスカレーションが発生するまでの分数。 |
| notifyCaseOwner | boolean | ケースがエスカレーションされたときにケース所有者に通知するか (true)、否か (false) を示します。 |
| notifyEmail | string | 通知するユーザのメールアドレスを指定します。 |
| notifyTo | string | 通知するユーザを指定します。 |
| notifyToTemplate | string | 通知メールに使用するテンプレートを指定します。 |
宣言的なメタデータの定義のサンプル
EscalationRules コンポーネントの例を次に示します。
1<EscalationRules xmlns="http://soap.sforce.com/2006/04/metadata">
2 <escalationRule>
3 <fullName>samplerule</fullName>
4 <active>false</active>
5 <ruleEntry>
6 <businessHours>test</businessHours>
7 <businessHoursSource>Static</businessHoursSource>
8 <criteriaItems>
9 <field>Case.Description</field>
10 <operation>contains</operation>
11 <value>test</value>
12 </criteriaItems>
13 <escalationAction>
14 <assignedTo>someuser@org.com</assignedTo>
15 <assignedToTemplate>emailtemplatename</assignedToTemplate>
16 <assignedToType>User</assignedToType>
17 <minutesToEscalation>1440</minutesToEscalation>
18 <notifyCaseOwner>false</notifyCaseOwner>
19 </escalationAction>
20 <escalationStartTime>CaseLastModified</escalationStartTime>
21 </ruleEntry>
22 </escalationRule>
23</EscalationRules>