Erstellen einer Terminserie, Instanz oder Ausnahme

  • Artikel

 

Veröffentlicht: Januar 2017

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

Wenn Sie einen Terminserienmaster (Serie) erstellen, erstellt Microsoft Dynamics 365 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.

In diesem Thema

Erstellen einer Terminserie

Erstellen einer Terminserieninstanz

Erstellen einer Terminserienausnahme

Konvertieren eines Termins in eine Terminserie

Erstellen einer Terminserie

Um eine Terminserie zu erstellen (ein RecurringAppointmentMaster-Datensatz), können Sie die BookRequest-Meldung, die CreateRequest-Meldung oder die IOrganizationService.Create-Methode 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.

    Hinweis

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

Beispielcode, der veranschaulicht, wie Terminserien erstellt werden, finden Sie unter Beispiel: Einen wiederkehrenden Termin erstellen, abbrufen, aktualisieren und löschen.

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 Microsoft Dynamics 365 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: Einen wiederkehrenden Termin erstellen, abbrufen, aktualisieren und löschen
Beispiel: Konvertieren eines Termins in eine Terminserie

Microsoft Dynamics 365

© 2017 Microsoft. Alle Rechte vorbehalten. Copyright