この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。

SchedulingRule

ワークフォースエンゲージメントの管理でのスケジュールルールを表します。スケジュールルールにより、エージェントがいつシフトに割り当てられるかが決まります。

親種別

Metadata メタデータ型を拡張し、その fullName 項目を継承します。

ファイルのサフィックスおよびディレクトリの場所

SchedulingRule コンポーネントのサフィックスは .schedulingRule で、SchedulingRules フォルダーに保存されます。

バージョン

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

特別なアクセスルール

この種別は、組織でワークフォースエンゲージメントが有効になっている場合にのみ使用できます。レコードを表示、作成、編集、および削除するには、ユーザーに「ワークフォースエンゲージメントプランナー」権限セットが必要です。

項目

項目名	説明
isProtected	項目の型 boolean 説明コンポーネントが保護されるか (`true`)、否か (`false`) を示します。デフォルト値は、`false` です。
masterLabel	項目の型 string 説明必須。ルールの名前。
schedulingCategory	項目の型 SchedulingCategory (string 型の列挙) 説明必須。スケジュールロジックでルールを何に適用するか。有効な値は次のとおりです。 `A` — サービス予定 `B` — シフト
schedulingRuleParameters	項目の型 SchedulingRuleParameter[] 説明スケジュールルールに関連付けられたパラメーター (作業制限など)。
schedulingRuleType	項目の型 SchedulingRuleType (string 型の列挙) 説明必須。ルールの種別を指定します。有効な値は次のとおりです。 `A` — 有効なリソース `B` — スキルを照合 `C` — 空き状況 `M` — テリトリーを照合 `Q` — キューを照合 `RestTimeMinutes` — 休憩時間 (分)。API バージョン 56.0 以降で利用できます。 `W` — 作業制限 `LimitNonstandardShifts` — 各エージェントに割り当てることができる非標準シフトの数を制限するルールタイプを指定します。API バージョン 54.0 以降で利用できます。

SchedulingRuleParameter

スケジュールルールに関連付けられた作業制限などのスケジュールルールパラメーターを表します。

項目名	説明
schedulingParameterKey	項目の型 SchedulingParameterKey (string 型の列挙) 説明必須。スケジュールルールパラメーターキー。 `C` — 制約項目名 `L` — 制限種別 `R` — 解決策 `T` — 期間 `W` — 作業単位 `ConsiderAbsence` — 空き状況を評価するときにリソースの不在を考慮します。API バージョン 56.0 以降で利用できます。 `ConsiderSTM` — 空き状況を評価するときに、勤務時間を定義するサービステリトリーメンバーシップを考慮します。API バージョン 56.0 以降で利用できます。
value	項目の型 string 説明スケジュールルールのパラメーター値。

項目名

説明

schedulingParameterKey

項目の型

SchedulingParameterKey (string 型の列挙)

説明

必須。スケジュールルールパラメーターキー。

C — 制約項目名
L — 制限種別
R — 解決策
T — 期間
W — 作業単位
ConsiderAbsence — 空き状況を評価するときにリソースの不在を考慮します。API バージョン 56.0 以降で利用できます。
ConsiderSTM — 空き状況を評価するときに、勤務時間を定義するサービステリトリーメンバーシップを考慮します。API バージョン 56.0 以降で利用できます。

value

項目の型: string
説明: スケジュールルールのパラメーター値。

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

SchedulingRule コンポーネントの例を次に示します。

1<?xml version="1.0" encoding="UTF-8"?>
2<SchedulingRule xmlns="http://soap.sforce.com/2006/04/metadata">
3    <masterLabel>Max Shifts Per Week</masterLabel>
4    <schedulingCategory>B</schedulingCategory>
5    <schedulingRuleParameters>
6        <schedulingParameterKey>C</schedulingParameterKey>
7        <value>MaxShiftsPerWeek</value>
8    </schedulingRuleParameters>
9    <schedulingRuleParameters>
10        <schedulingParameterKey>W</schedulingParameterKey>
11        <value>Shifts</value>
12    </schedulingRuleParameters>
13    <schedulingRuleParameters>
14        <schedulingParameterKey>R</schedulingParameterKey>
15        <value>Week</value>
16    </schedulingRuleParameters>
17    <schedulingRuleParameters>
18        <schedulingParameterKey>L</schedulingParameterKey>
19        <value>Max</value>
20    </schedulingRuleParameters>
21    <schedulingRuleType>W</schedulingRuleType>
22</SchedulingRule>

前の定義を参照する package.xml の例を次に示します。

1<?xml version="1.0" encoding="UTF-8"?>
2<Package xmlns="http://soap.sforce.com/2006/04/metadata">
3    <types>
4        <name>SchedulingRule</name>
5	<members>MaxShiftsPerWeek</members>
6    </types>
7    <version>53.0</version>
8</Package>

マニフェストファイル内のワイルドカードのサポート

このメタデータ型では、package.xml マニフェストファイル内のワイルドカード文字 * (アスタリスク) がサポートされます。マニフェストファイルの使用についての詳細は、「zip ファイルを使用したメタデータのリリースと取得」を参照してください。

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