Een reeks terugkerende afspraken, een exemplaar of een uitzondering maken

 

Gepubliceerd: januari 2017

Is van toepassing op: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Wanneer u een model voor terugkerende afspraken (reeks) maakt, maakt Microsoft Dynamics 365 afzonderlijke afspraakexemplaren op basis van de opgegeven terugkeerpatrooninformatie. U kunt ook afzonderlijke exemplaren maken van terugkerende afspraken, evenals uitzonderingen op die afspraken, en u kunt een afspraak converteren naar een weerkerende afspraak.

In dit onderwerp

Een terugkerende afspraakreeksen maken

Een terugkerend exemplaar van afspraak maken

Een uitzondering maken voor een terugkerende afspraak

Een afspraak converteren naar een terugkerende afspraak

Een terugkerende afspraakreeksen maken

Om een terugkerende afsprakenreeks te maken (een RecurringAppointmentMaster record), kunt u de berichten BookRequest of CreateRequest, of de methode IOrganizationService.Create gebruiken.

Wanneer u een terugkerende afsprakenreeks maakt, doen zich de volgende gebeurtenissen voor:

1. Een RecurringAppointmentMaster record (terugkerende afsprakenreeks) wordt gemaakt met de basisgegevens en de terugkeerinformatie over de reeks terugkerende afspraken. Elke record kan uniek worden geïdentificeerd met de eigenschap RecurringAppointmentMaster.ActivityId. Verder wordt deze terugkerende afsprakenreeks ook gemaakt en opgeslagen als een activiteitenrecord (ActivityPointer). De activiteitenrecord kan uniek worden geïdentificeerd met de eigenschap ActivityPointer.ActivityId.

2. De afzonderlijke exemplaren van de terugkerende afspraken worden gemaakt op basis van de terugkeerpatrooninformatie en opgeslagen als Appointment records. Deze afspraakobjecten zijn gekoppeld aan de bovenliggende reeks terugkerende afspraken met behulp van de eigenschap Appointment.SeriesId en hebben dezelfde waarde als de id van de bovenliggende reeks terugkerende afspraken (ActivityPointer.SeriesId).

   De waarde van de eigenschap Appointment.InstanceTypeCode is ingesteld op Terugkerend exemplaar (selectielijstwaarde 2) voor deze afspraakobjecten.

   Notitie

   Terugkerende afspraakexemplaren worden gemaakt op basis van het uitbreidingsmodel en de parameters die dit definiëren.Meer informatie:Model voor gedeeltelijke uitbreiding van terugkerende afspraken.

Voor voorbeeldcode die aantoont hoe een reeks terugkerende afspraken wordt gemaakt, zie Voorbeeld: Een terugkerende afspraak maken, ophalen, bijwerken en verwijderen.

Een terugkerend exemplaar van afspraak maken

Om een terugkerend exemplaar van afspraak te maken (een RecurringAppointmentMaster record), kunt u de CreateInstanceRequest gebruiken. Dit bericht neemt twee parameters: het aantal exemplaren dat moet worden gemaakt, en de reeks terugkerende afspraken waarvoor de exemplaren moeten worden gemaakt.

De exemplaren worden gemaakt na het laatste exemplaar in de reeks terugkerende afspraken. Bovendien worden de exemplaren alleen gemaakt tot de volgende toekomstige afsluitdatum van het exemplaar, ongeacht het aantal exemplaren dat u hebt opgegeven om te maken.

Een uitzondering maken voor een terugkerende afspraak

Een uitzondering wordt gemaakt wanneer u een exemplaar van de terugkerende afspraak bijwerkt of verwijdert. Terugkerende afspraakexemplaren worden opgeslagen als een afsprakenrecord zoals andere afspraken, en u kunt een terugkerend afspraakexemplaar identificeren met het kenmerk Appointment.InstanceTypeCode van een afsprakenrecord, die een waarde Terugkerend exemplaar heeft (selectielijstwaarde 2).

U kunt op de volgende manieren uitzonderingen maken:

• Gebruik de klasse UpdateRequest op de entiteit Appointment om een exemplaar van een terugkerende afspraak bij te werken, en de waarde in te stellen van het kenmerk Appointment.InstanceTypeCode in te stellen op Terugkerende uitzondering (selectielijstwaarde 3).

• Gebruik de klasse DeleteRequest op de entiteit Appointment om een exemplaar van een terugkerende afspraak te verwijderen. Het verwijderen van een afspraakexemplaar markeert deze als een uitzondering door een vermelding te maken voor het exemplaar in het kenmerk RecurringAppointmentMaster.DeletedExceptionsList voor het object van de bovenliggende afsprakenreeks.

• Gebruik de klasse CreateExceptionRequest op de entiteit Appointment.

Een afspraak converteren naar een terugkerende afspraak

Een terugkerende afspraak is een afspraak met terugkeerpatrooninformatie. U kunt een bestaande afspraak in Microsoft Dynamics 365 converteren naar een terugkerende afspraak met behulp van AddRecurrenceRequest. Als u een bestaande afspraak converteert naar een terugkerende afspraak, worden de gegevens van de bestaande afspraak gekopieerd naar een nieuw hoofdexemplaar van een terugkerende afspraak en wordt de bestaande afspraak verwijderd.

Zie ook

Entiteit voor terugkerende afspraak
Terugkerende afspraak bijwerken
Voorbeeld: Een terugkerende afspraak maken, ophalen, bijwerken en verwijderen
Voorbeeld: Een afspraak converteren naar een terugkerende afspraak

Microsoft Dynamics 365

© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht