カレンダーエンティティ

[アーティクル]
05/09/2023

カレンダーエンティティは、業務カレンダーに加え、顧客サービスカレンダーおよび祝日スケジュールのためのデータを格納します。各カレンダーは、特定のタイムゾーンに設定されます。

カレンダーは、サービスやリソースの可用性を示します。カレンダーは、calendarrule レコードに関連付けられます。このレコードには、期間、開始と終了時刻、およびカレンダーに含まれるイベントの定期的なパターンの詳細が含まれています。

Dynamics 365 Customer Engagement (on-premises) には 2 種類のカレンダールールがあります。

ルート: 内部カレンダーを含むか入れ子になった (リーフ) ルールがあるカレンダールール。 CalendarRule.InnerCalendarId 属性を使用して、ルートカレンダールールの内部カレンダーを指定できます。ルートルールの CalendarRule.InnerCalendarId の属性値は、そのリーフルールの CalendarRule.CalendarId の属性値と同じです。
リーフ: 内部カレンダーを含まないため、"分岐" の最後であるカレンダールール。

カレンダールールには、それらの優先順位を記述する順序 (ランク) が設定されており、場合によってはルールが重複することもあります。入れ子になったルール拡張によって、ルールの時間帯 (範囲) が定義されます。 CalendarRule.ExtentCode 属性を使用して、ルール拡張の重複がどのように処理されるかを定義します。たとえば、時間帯またはルールの拡張の両方が表示されるか、一方のみが表示されるかなどが設定されます。これらの機能によって、定期的なパターンを表現できます。たとえば、単一のサービスカレンダーで、冬期と夏期で異なるシフトスケジュールを設定できます。

カレンダーが、ルールおよび入れ子になったカレンダーの複合ツリーとして、作業スケジュールを高レベルで抽象化している場合があります。カレンダーエンティティは、簡易ビュー、つまり特定範囲における空き時間を決定する時間ブロックの配列に変換するための ExpandCalendarRequest メッセージをサポートしています。