Einen wiederkehrenden Termin aktualisieren

Sie können entweder die ganze Reihe aktualisieren oder eine Instanz eines wiederkehrenden Termins aktualisieren.

Eine Terminserie aktualisieren

Sie können eine wiederkehrende Terminserie aktualisieren, indem Sie die Methode IOrganizationService.Update oder die Nachricht UpdateRequest auf der Entität RecurringAppointmentMaster verwenden. Sie können die standardmäßigen Information oder die Information zur Wiederholung aktualisieren.

Standardinformationen aktualisieren

Wenn Sie die standardmäßigen Informationen einer Terminserie aktualisieren, wie beispielsweise Thema, Ort oder Teilnehmer, werden alle Instanzen in der Reihe wiederkehrender Termine aktualisiert, mit Ausnahme von denen, die Ausnahmen beim selben Attribut haben.

Aktualisieren von Wiederholungsinformationen

Wenn Sie die wiederkehrenden Informationen einer Terminserie aktualisieren, wie beispielsweise das Muster und der Bereich, ereignet sich Folgendes:

1. Eine neue Reihe mit einer neuen RecurringAppointmentMaster.ActivityId wird erstellt, die die gleichen Informationen wie die ursprüngliche Reihe hat, und das Datum im Attribut RecurringAppointmentMaster.EffectiveEndDate der neuen Reihe wird auf die zuletzt auftretende vergangene Instanz der ursprünglichen Reihe festgelegt. Alle zukünftigen Instanzen der ursprünglichen Reihe werden gelöscht. Auf diese Weise wird die ursprüngliche Reihe beendet, und der Verlauf der vergangenen Instanzen wird im System erhalten, indem er in einer neuen Reihe gespeichert wird.

2. Die neuen Informationen werden verwendet, um die zukünftigen Instanzen der neuen Reihe ab dem tatsächlichen Startdatum (RecurringAppointmentMaster.EffectiveStartDate) zu erstellen.

   Außerdem wird das Attribut RecurringAppointmentMaster.GroupId sowohl für die ursprüngliche als auch die neue Reihe mit demselben Wert aufgefüllt. Dies bedeutet, dass wenn Sie die Wiederholungsinformationen in einer Terminserie aktualisieren, alle neue Reihen, die erstellt werden, denselben Wert für das Attribut RecurringAppointmentMaster.GroupId haben, wie der wiederkehrende Termin, der aktualisiert wird, obwohl jede Reihe eine eindeutige Reihen-ID hat.

Notiz

Wenn Sie die Wiederholungsinformationen einer Terminserie aktualisieren, bei der geplant ist, dass alle Instanzen in der Zukunft ausgeführt werden, werden alle Instanzen gelöscht und neue Wiederholungsinformationen verwendet, um neue Instanzen zu erstellen oder zu erweitern.

Für Beispielcode, der zeigt, wie eine wiederkehrende Terminserie aktualisiert wird, siehe Beispiel: Aktualisieren eines wiederkehrenden Termins.

Eine wiederkehrenden Termininstanz aktualisieren

Da die Datensätze für wiederkehrende Termine als Terminobjekte gespeichert werden, können Sie die Methode IOrganizationService.Update auf der Entität Appointment verwenden, um eine Instanz eines wiederkehrenden Termins zu aktualisieren. Wenn Sie eine Terminserieninstanz aktualisieren, wird die Instanz als Ausnahme der Terminserie markiert. Weitere Informationen: Erstellen einer Ausnahme eines wiederkehrenden Termins

Sie können auch die Klasse CreateExceptionRequest für die Entität Appointment verwenden, um eine Instanz wiederholender Termine zu aktualisieren.

Tipp

Terminserieninstanzen können mithilfe des vierstelligen Appointment.InstanceTypeCode identifiziert werden, in dem der Wert "2 " enthält aber auch periodische Instanz (). Weitere Informationen: Terminentität

Siehe auch

Serientermin-Entitäten
Terminserie oder Terminserieninstanz löschen oder beenden
Beispiel: Einen wiederkehrenden Termin erstellen, abbrufen, aktualisieren und löschen (CRUD)
Beispiel: Erneutes Planen und Stornieren eines Serientermins