Freigeben über

Terminserie oder Terminserieninstanz löschen oder beenden

  • Artikel

Sie können eine Terminserie löschen, eine Instanz in der Serie löschen oder eine Terminserie nach einem bestimmten Datum und einer bestimmten Uhrzeit beenden.

Terminserieninstanz löschen

Da wiederkehrende Termininstanzen als Terminobjekte gespeichert werden, können Sie die IOrganizationService.DeleteRequest auf einem Termindatensatz verwenden, um eine wiederkehrende Termininstanz zu löschen. Eine gelöschte Terminserieninstanz wird als Ausnahme gekennzeichnet, indem für das übergeordnete Terminserienobjekt im RecurringAppointmentMaster.DeletedExceptionsList-Attribut ein Eintrag für die Instanz erstellt wird. Dies ist notwendig, um die gelöschte Instanz für eine spätere Synchronisierung mit Dynamics 365 for Outlook zu ermitteln.

Terminserie löschen

Sie können die Methode IOrganizationService.Delete oder die DeleteRequest bei einem RecurringAppointmentMaster-Datensatz verwenden, um eine wiederkehrende Terminserie zu löschen. Wenn Sie eine Serie löschen, wird auch der Datensatz alle zugeordneten Terminserieninstanzen gelöscht.

Terminserie beenden

Wenn Sie eine Serie vor dem ursprünglich beim Erstellen der Serie festgelegten Enddatum beenden möchten, können Sie die DeleteOpenInstancesRequest-Klasse verwenden. Wenn Sie diese Meldung verwenden, passiert Folgendes:

  • Es werden alle "geöffneten" und "geplanten" künftigen Instanzen der angegebenen Serie ab dem Datum gelöscht, das in der SeriesEndDate-Eigenschaft angegeben ist. Wenn der Status der künftigen Instanzen auf "Abgeschlossen" oder "Storniert" geändert wird, werden sie nicht gelöscht.

  • Der Status der vergangenen Instanzen wird auf den Wert festgelegt, der in der StateOfPastInstances-Eigenschaft angegeben ist. Allerdings werden die vergangenen Instanzen nicht gelöscht.

  • Die Serie wird nach dem in der SeriesEndDate-Eigenschaft angegebenen Datum am Datum der zuletzt aufgetretenen vergangenen Instanz beendet und der Status der Serie wird auf "Storniert" festgelegt.

    Dadurch können die Instanzen einer Terminserie beibehalten werden, auch wenn Sie sich entschieden haben, die Serie vorzeitig zu beenden. Dies ist hilfreich, wenn Sie Notizen oder Anlagen an vergangene Instanzen der Terminserie angefügt haben, die wichtige Informationen über den Kunden oder das Unternehmen enthalten.

Siehe auch

Serientermin-Entitäten
Verknüpfen von benutzerdefinierten Attributen für Serienterminmaster- und Termin-Entitäten
Beispiel: Einen wiederkehrenden Termin erstellen, abbrufen, aktualisieren und löschen (CRUD)
Beispiel: Erstellen einer Terminserie