Erstellen einer Terminserie, Instanz oder Ausnahme

Wenn Sie einen wiederkehrenden Terminmaster (Serie) erstellen, erstellt Dynamics 365 Customer Engagement (on-premises) einzelne Termininstanzen basierend auf den angegebenen Wiederholungsinformationen. Sie können auch einzelne Instanzen für wiederkehrende Termine und Ausnahmen für diese Instanzen erstellen, und Sie können einen Termin in einen wiederkehrenden Termin umwandeln.

Erstellen einer wiederkehrenden 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.

Wenn Sie eine wiederkehrende Terminserie erstellen, geschieht Folgendes:

1. Ein RecurringAppointmentMaster-Datensatz (Terminserie) wird erstellt, der grundlegende Informationen und Wiederholungsinformationen zur Terminserie enthält. Jeder Datensatz kann anhand der RecurringAppointmentMaster.ActivityId Eigenschaft eindeutig identifiziert werden. Darüber hinaus wird diese wiederkehrende Terminserie auch als Aktivitätsdatensatz (ActivityPointer) erstellt und gespeichert. Der Aktivitätsdatensatz kann anhand der ActivityPointer.ActivityId Eigenschaft eindeutig identifiziert werden.

2. Einzelne Serientermininstanzen werden basierend auf den Wiederholungsinformationen erstellt und als Appointment-Datensätze gespeichert. Diese Terminobjekte werden mithilfe der Appointment.SeriesId Eigenschaft mit der übergeordneten Serienserie für wiederkehrende Termine verknüpft und haben denselben Wert wie die ID der übergeordneten Serienserie für wiederkehrende Termine (ActivityPointer.SeriesId).

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

   Hinweis

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

   Beispielcode, der veranschaulicht, wie eine Serie von Terminserien erstellt wird, finden Sie unter Beispiel: Erstellen eines wiederkehrenden Termins.

Erstellen einer Instanz für wiederkehrende Termine

Um eine Instanz für wiederkehrende Termine (einen RecurringAppointmentMaster Datensatz) zu erstellen, können Sie das CreateInstanceRequest verwenden. Diese Meldung nimmt zwei Parameter an: die Anzahl der zu erstellenden Instanzen und die Serien wiederkehrender Termine, für die die Instanzen erstellt werden müssen.

Die Instanzen werden in der Terminserie nach der letzten Instanz erstellt. Außerdem werden die Instanzen nur bis zum Stichtag für zukünftige Instanzen erstellt, unabhängig von der Anzahl der Instanzen, die Sie zur Erstellung angegeben haben.

Erstellen einer Ausnahme für wiederkehrende Termine

Eine Ausnahme wird erstellt, wenn Sie eine Instanz des wiederkehrenden Termins aktualisieren oder löschen. Instanzen von wiederkehrenden Terminen werden wie andere Termine als Termindatensatz gespeichert, und Sie können eine wiederkehrende Termininstanz mithilfe des Appointment.InstanceTypeCode Attributs eines Termindatensatzes identifizieren, der den Wert Wiederkehrende Instanz (Auswahllistenwert 2) hat.

Sie können Ausnahmen auf folgende Weise erstellen:

• Verwenden Sie die UpdateRequest Klasse für die Appointment Entität, um eine Instanz für wiederkehrende Termine zu aktualisieren, und legen Sie den Wert des Appointment.InstanceTypeCode Attributs auf Wiederkehrende Ausnahme (Auswahllistenwert 3) fest.

• Verwenden Sie die DeleteRequest Klasse für die Appointment Entität, um eine Instanz für wiederkehrende Termine zu löschen. Wenn Sie eine Termininstanz löschen, wird sie als Ausnahme gekennzeichnet, indem ein Eintrag für die Instanz im RecurringAppointmentMaster.DeletedExceptionsList Attribut für das übergeordnete Terminserienobjekt erstellt wird.

• Verwenden Sie die CreateExceptionRequest Klasse für die Appointment Entität.

Konvertieren eines Termins in eine Terminserie

Eine Terminserie ist ein Termin mit Wiederholungsinformationen. Sie können einen vorhandenen Termin in Dynamics 365 Customer Engagement (on-premises) in einen wiederkehrenden Termin umwandeln, indem Sie AddRecurrenceRequest verwenden. Wenn Sie einen vorhandenen Termin in einen wiederkehrenden Termin konvertieren, werden die Daten aus dem vorhandenen Termin in eine neue Masterinstanz für wiederkehrende Termine kopiert und der vorhandene Termin wird gelöscht.

Siehe auch

Serientermin-Entitäten
Aktualisieren eines wiederkehrenden Termins
Beispiel: Erstellen eines wiederkehrenden Termins
Beispiel: Konvertieren eines Termins in eine Terminserie