Erstellen einer Terminserie, Instanz oder Ausnahme

Wenn Sie einen Terminserienmaster (Serie) erstellen, erstellt Microsoft Dataverse 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 (eine RecurringAppointmentMaster-Zeile) zu erstellen, können Sie die BookRequest-Nachricht, die CreateRequest-Nachricht oder die IOrganizationService und Create verwenden.

Beim Erstellen einer Terminserie passiert Folgendes:

1. Es wird eine RecurringAppointmentMaster-Zeile (wiederkehrende Terminserie) erstellt, die die grundlegenden und wiederkehrenden Informationen über die wiederkehrende Terminserie enthält. Jede Zeile kann über die Eigenschaft RecurringAppointmentMaster.ActivityId eindeutig identifiziert werden. Außerdem wird diese wiederkehrende Terminserie auch als Aktivitätszeile (ActivityPointer) erstellt und gespeichert. Die Aktivitätszeile kann über die Eigenschaft ActivityPointer.ActivityId eindeutig identifiziert werden.

2. Einzelne wiederkehrende Termininstanzen werden auf Basis der Wiederholungsinformationen erstellt und als Appointment-Zeile 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 Eigenschaft Appointment.InstanceTypeCode wird für diese Terminobjekte auf Wiederkehrende Instanz (Auswahlwert 2) festgelegt.

   Anmerkung

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

   Ein Codebeispiel, das zeigt, wie Sie eine wiederkehrende Terminserie erstellen, finden Sie unter Beispiel: Erstellen, Abrufen, Aktualisieren und Löschen eines wiederkehrenden Termins.

Erstellen einer Terminserieninstanz

Um eine wiederkehrende Termininstanz (eine RecurringAppointmentMaster-Zeile) zu erstellen, können Sie die 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. Wiederkehrende Termininstanzen werden wie andere Termine als eine Terminzeile gespeichert, und Sie können eine wiederkehrende Termininstanz über die Spalte Appointment.InstanceTypeCode einer Terminzeile identifizieren, die den Wert Wiederkehrende Instanz (Auswahlwert 2) hat.

Sie können Ausnahmen wie folgt erstellen:

• Verwenden Sie die Klasse UpdateRequest auf der Tabelle Appointment, um eine wiederkehrende Termininstanz zu aktualisieren, und legen Sie den Wert der Spalte Appointment.InstanceTypeCode auf Wiederkehrende Ausnahme (Auswahlwert 3) fest.

• Verwenden Sie die Klasse DeleteRequest auf der Tabelle Appointment, um eine wiederkehrende Termininstanz zu löschen. Das Löschen einer Termininstanz markiert diese als Ausnahme, indem ein Eintrag für die Instanz in der Spalte RecurringAppointmentMaster.DeletedExceptionsList für das übergeordnete Terminserienobjekt erstellt wird.

• Verwenden Sie die Klasse CreateExceptionRequest in der Tabelle Appointment.

Konvertieren eines Termins in eine Terminserie

Eine Terminserie ist ein Termin mit Wiederholungsinformationen. Sie können in Dataverse 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

Einen wiederkehrenden Termin aktualisieren
Beispiel: Beispiel: Erzeugen, Abrufen, Aktualisieren und Löschen eines wiederkehrenden Termins