Freigeben über


Kalenderentitäten

Der Kalenderentität speichert Daten für Kundenservicekalender und Feiertagskalender zusätzlich zum Unternehmen. Jeder Kalender wird für eine bestimmte Zeitzone festgelegt.

Ein Kalender beschreibt die Verfügbarkeit eines Service oder einer Ressource. Kalender sind mit calendarrule-Datensätzen verknüpft, die Details über die Dauer, die Start- und Endzeiten und wiederkehrende Muster von Ereignissen im Kalender enthalten.

In Dynamics 365 Customer Engagement (on-premises) stehen zwei Arten von Kalenderregeln zur Verfügung:

  • Stamm: Eine Kalenderregel, die einen inneren Kalender enthält oder geschachtelte (Blatt-) Regeln umfasst. Sie können einen inneren Kalender für eine Stammkalenderregel angeben, indem Sie das CalendarRule.InnerCalendarId-Attribut verwenden. Der Attributwert CalendarRule.InnerCalendarId einer Stammregel ist mit dem Attributwert CalendarRule.CalendarId der zugehörigen Blattregeln identisch.

  • Blatt: Eine Kalenderregel, die keinen inneren Kalender enthält und daher das Ende der "Verzweigung" darstellt.

    Kalenderregeln werden geordnet, oder eingestuft, um ihre Rangfolge zu beschreiben, und Regeln können sich überschneiden. Die geschachtelte Regelerweiterung definiert die Dauer, oder den Umfang, einer Regel. Sie können das CalendarRule.ExtentCode-Attribut verwenden, um zu definieren, wie eine Regelerweiterungsüberschneidung behandelt wird, beispielsweise, ob sowohl die Dauer als auch der Umfang einer Regel gezeigt wird oder ob nur eins davon enthalten ist. Diese Funktionen ermöglichen Serienmuster, beispielsweise verschiedene Schichtzeitpläne für Winter- und Sommermonate, in einem einzigen Servicekalender.

    Ein Kalender kann eine komplexe Struktur von Regeln und geschachtelten Kalendern sein, die eine Zusammenfassung des Arbeitsplans auf hoher Ebene darstellt. Die Kalenderentität unterstützt die ExpandCalendarRequest-Meldung für die Konvertierung in eine einfache Ansicht, bei der es sich um ein Array von Zeitblöcken handelt, die die Verfügbarkeit in bestimmten Bereichen bestimmen.

Notiz

Das Ausführen von ABRUFEN, ERSTELLEN, AKTUALISIEREN und LÖSCHEN ist mit calendarrule Entitäten nicht möglich. Weitere Informationen: CalendarRule EntityType.

In diesem Abschnitt

Kalendertypen

Kalenderentität

Terminentitäten

Serientermin-Entitäten

Ressourcenentitäten

Serviceentität

Beispielcode für Zeitplan- und Terminentitäten