Oprette en gentaget aftaleserie, forekomst eller undtagelse

 

Udgivet: januar 2017

Gælder for: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Når du opretter en master for tilbagevendende aftale (serie), opretter Microsoft Dynamics 365 individuelle aftaleforekomster, der er baseret på de angivne gentagelsesoplysninger. Du kan også oprette individuelle forekomster og undtagelser til disse forekomster for tilbagevendende aftaler, og du kan konvertere en aftale til en tilbagevendende aftale.

Dette emne indeholder

Oprette en tilbagevendende aftaleserie

Oprette en forekomst med en gentaget aftale

Oprette en undtagelse for en gentaget aftale

Konverter en aftale til en tilbagevendende aftale

Oprette en tilbagevendende aftaleserie

Du kan oprette en tilbagevendende aftaleserie (en RecurringAppointmentMaster-post) ved at bruge BookRequest-meddelelsen, CreateRequest-meddelelsen eller IOrganizationService.Create-metoden.

Når du opretter serien med en tilbagevendende aftale, sker følgende:

1. En RecurringAppointmentMaster-post (tilbagevendende aftaleserie) oprettes, der indeholder de grundlæggende og tilbagevendende oplysninger om den tilbagevendende aftaleserie. Hver post kan identificeres entydigt ved hjælp af RecurringAppointmentMaster.ActivityId-egenskaben. Desuden oprettes denne tilbagevendende aftaleserie også og gemmes som en aktivitetspost (ActivityPointer). Hver aktivitetspost kan identificeres entydigt ved hjælp af ActivityPointer.ActivityId-egenskaben.

2. Individuelle forekomster af den tilbagevendende aftale oprettes ud fra gentagelsesoplysningerne og gemmes som Appointment-poster. Disse aftaleobjekter er knyttet til den overordnede tilbagevendende aftaleserie ved hjælp af Appointment.SeriesId-egenskaben og har samme værdi som den overordnede tilbagevendende aftaleseries id (ActivityPointer.SeriesId).

   Værdien af Appointment.InstanceTypeCode-egenskaben er indstillet til Gentaget forekomst (valglisteværdi 2) for disse aftaleobjekter.

   Bemærk

   Tilbagevendende aftaleforekomster oprettes på basis af udvidelsesmodellen og de parametre, der definerer den.Flere oplysninger:Tilbagevendende aftale delvis udvidelsemodel.

Eksempelkode, der viser, hvordan du opretter serien med en tilbagevendende aftale, findes i Eksempel: Oprette, hente, opdatere og slette en tilbagevendende aftale.

Oprette en forekomst med en gentaget aftale

Hvis du vil oprette en tilbagevendende aftaleforekomst (en RecurringAppointmentMaster-post), kan du bruge CreateInstanceRequest. Denne meddelelse kræver to parametre: antallet forekomster, der skal oprettes, og den gentagne aftaleserie, som forekomsterne skal oprettes for.

Forekomsterne oprettes efter den sidste forekomst i den gentagne aftaleserie. Desuden oprettes forekomster kun indtil den fremtidige forekomsts skæringsdato, uanset antallet af forekomster, du har angivet for oprettelse.

Oprette en undtagelse for en gentaget aftale

En undtagelse oprettes, når du opdaterer eller sletter en forekomst af den tilbagevendende aftale. Tilbagevendende aftaleforeomster gemmes som en aftalepost sammen med andre lignende aftaler, og du kan identificere en tilbagevendende aftaleforekomst ved hjælp af Appointment.InstanceTypeCode-attributten for en aftalepost, som har en værdi af Gentaget forekomst (valglisteværdi 2).

Du kan oprette undtagelser på følgende måder:

• Brug UpdateRequest-klassen på Appointment-objektet til at opdatere en tilbagevendende aftaleforekomst, og angiv værdien af Appointment.InstanceTypeCode-attributten til Gentaget undtagelse (valglisteværdi 3).

• Brug DeleteRequest-klassen på Appointment-objektet til at slette en tilbagevendende aftaleforekomst. Sletning af en forekomst af aftalen markerer den som en undtagelse ved at oprette en post for forekomsten i RecurringAppointmentMaster.DeletedExceptionsList-attributten for det overordnede aftaleserieobjekt.

• Brug CreateExceptionRequest-klassen på Appointment-objektet.

Konverter en aftale til en tilbagevendende aftale

En tilbagevendende aftale er en aftale med oplysninger om gentagelse. Du kan konvertere en eksisterende aftale i Microsoft Dynamics 365 til en tilbagevendende aftale ved hjælp af AddRecurrenceRequest. Når du konverterer en eksisterende aftale til en tilbagevendende aftale, kopieres data fra den eksisterende aftale til en ny masterforekomst af den tilbagevendende aftale, og den eksisterende aftale slettes.

Se også

Objekter for tilbagevendende aftale
Opdater en gentaget aftale
Eksempel: Oprette, hente, opdatere og slette en tilbagevendende aftale
Eksempel: Konverter en aftale til en tilbagevendende aftale

Microsoft Dynamics 365

© 2017 Microsoft. Alle rettigheder forbeholdes. Ophavsret