Erstellen einer Terminserie, Instanz oder Ausnahme

Wenn Sie einen Terminserienmaster (Serie) erstellen, erstellt Dynamics 365 Customer Engagement (on-premises) einzelne Termininstanzen basierend auf den angegebenen Wiederholungsinformationen. Sie können auch einzelne Serientermininstanzen und Ausnahmen für diese Instanzen erstellen, und Sie können einen Termin zu einem Serientermin konvertieren.

Erstellen einer Terminserie

Um eine wiederkehrende Terminserie (einen RecurringAppointmentMaster-Datensatz) zu erstellen, können Sie die Nachricht BookRequest, die Nachricht CreateRequest oder die Methode IOrganizationService.Create verwenden.

Beim Erstellen einer Terminserie passiert Folgendes:

1. Ein RecurringAppointmentMaster-Datensatz (Terminserie) wird erstellt, der grundlegende Informationen und Wiederholungsinformationen zur Terminserie enthält. Jeder Datensatz kann mit der Eigenschaft RecurringAppointmentMaster.ActivityId eindeutig identifiziert werden. Außerdem wird diese Terminserie auch als Aktivitätsdatensatz (ActivityPointer) erstellt und gespeichert. Der Aktivitätsdatensatz kann mit der Eigenschaft ActivityPointer.ActivityId eindeutig identifiziert werden.

2. Einzelne Serientermininstanzen werden basierend auf den Wiederholungsinformationen erstellt und als Appointment-Datensätze gespeichert. Diese Terminobjekte werden der übergeordneten Terminserie mithilfe der Eigenschaft Appointment.SeriesId zugeordnet und haben denselben Wert wie die ID der übergeordneten Terminserie (ActivityPointer.SeriesId).

   Der Wert der Appointment.InstanceTypeCode-Eigenschaft wird für diese Terminobjekte auf Wiederkehrende Instanz (Auswahllistenwert 2) festgelegt.

   Notiz

   Terminserieninstanzen werden basierend auf dem Erweiterungsmodell und der Parameter erstellt, die es definieren. Weitere Informationen: Teilerweiterungsmodell für Serientermine.

   Für Beispielcode, der zeigt, wie ein Serientermin erstellt wird, siehe Beispiel: Erstellen Sie einen Serientermin.

Erstellen einer Terminserieninstanz

Um eine Terminserieninstanz (ein RecurringAppointmentMaster-Datensatz) zu erstellen, können Sie CreateInstanceRequest verwenden. Diese Meldung verwendet zwei Parameter: die Anzahl der zu erstellenden Instanzen und die Terminserie, für die die Instanzen erstellt werden müssen.

Die Instanzen werden in der Terminserie nach der letzten Instanz erstellt. Die Instanzen werden nur bis zum zukünftigen Instanzen-Schlussdatum erstellt, unabhängig von der Anzahl der Instanzen, die Sie für die Erstellung angegeben haben.

Erstellen einer Terminserienausnahme

Eine Ausnahme wird erstellt, wenn Sie entweder eine Instanz der Terminserie aktualisieren oder löschen. Terminserieninstanzen werden wie andere Termine als Termindatensatz gespeichert, und Sie können eine Terminserieninstanz mithilfe des Appointment.InstanceTypeCode-Attributs eines Termindatensatzes angegeben, das den Wert Wiederkehrende Instanz (Auswahllistenwert 2) besitzt.

Sie können Ausnahmen wie folgt erstellen:

• Verwenden Sie die UpdateRequest-Klasse in der Appointment-Entität, um eine Terminserieninstanz zu aktualisieren, und legen Sie den Wert des Attributs Appointment.InstanceTypeCode auf Wiederkehrende Ausnahme (Auswahllistenwert 3) fest.

• Verwenden Sie die DeleteRequest-Klasse in der Appointment-Entität, um eine Terminserieninstanz 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.

• Verwenden Sie die CreateExceptionRequest-Klasse in der Appointment-Entität.

Konvertieren eines Termins in eine Terminserie

Eine Terminserie ist ein Termin mit Wiederholungsinformationen. Sie können in Dynamics 365 Customer Engagement (on-premises) einen vorhandenen Termin in eine Terminserie konvertieren, indem Sie AddRecurrenceRequest verwenden. Wenn Sie einen vorhandenen Termin in eine Terminserie konvertieren, werden die Daten von dem vorhandenen Termin in eine neue Terminserienmasterinstanz kopiert und der vorhandene Termin wird gelöscht.

Siehe auch

Serientermin-Entitäten
Einen wiederkehrenden Termin aktualisieren
Beispiel: Erstellen einer Terminserie
Beispiel: Konvertieren eines Termins in eine Terminserie