Einen wiederkehrenden Termin aktualisieren

Artikel
03/04/2017

Veröffentlicht: Januar 2017

Gilt für: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

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

Eine Terminserie aktualisieren

Sie können eine Terminserie mithilfe der Methode IOrganizationService.Update oder der Message UpdateRequest auf der Entität RecurringAppointmentMaster aktualisieren. 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:

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.
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.

Hinweis

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.

Den Beispielcode zum Aktualisieren einer Terminserie finden Sie unter Beispiel: Erneutes planen und stornieren eines Serientermins.

Eine wiederkehrenden Termininstanz aktualisieren

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

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ätsmeldungen und -methoden

Siehe auch

Serientermin-Entitäten
Terminserie oder Terminserieninstanz löschen oder beenden
Beispiel: Einen wiederkehrenden Termin erstellen, abbrufen, aktualisieren und löschen
Beispiel: Erneutes planen und stornieren eines Serientermins

Microsoft Dynamics 365

Freigeben über