Opdater en gentaget aftale
Udgivet: januar 2017
Gælder for: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Du kan opdatere hele serien eller opdatere en forekomst af en tilbagevendende aftale.
Opdater en serie med en gentaget aftale
Du kan opdatere serien med en gentaget aftale ved hjælp af IOrganizationService.Update metoden eller UpdateRequest meddelelsen på RecurringAppointmentMaster enheden. Du kan opdatere de grundlæggende eller tilbagevendende oplysninger.
Opdater grundlæggende oplysninger
Når du opdaterer de grundlæggende oplysninger for en tilbagevendende aftaleserie, som emne, sted eller deltagere, opdateres alle forekomster i aftaleserien med den gentagne aftale, undtagen dem, der har undtagelser på den samme attribut.
Opdater gentagelsesoplysninger
Når du opdaterer de oplysninger, der gentages af en tilbagevendende aftaleserie som mønster og område, sker følgende:
En ny serie med en ny RecurringAppointmentMaster.ActivityId oprettes, som har de samme oplysninger som den oprindelige serie og datoen i RecurringAppointmentMaster.EffectiveEndDate attributten for den nye serie, der er indstillet til den sidste gentagne tidligere forekomst af den oprindelige serie. Alle fremtidige forekomster af den oprindelige serie slettes. Den oprindelige serie er afsluttet, og historikken for tidligere forekomster bevares i systemet ved at gemme dem i en ny serie på denne måde.
De nye oplysninger bruges til at oprette fremtidige forekomster af den nye serie fra en faktisk startdato (RecurringAppointmentMaster.EffectiveStartDate).
Også RecurringAppointmentMaster.GroupId attributten for både den oprindelige og den nye serie bliver udfyldt med samme værdi. Dette indebærer, at hver gang du opdaterer gentagelsesoplysningerne i serien med en gentaget aftale, har alle de nye serier, der er oprettet den samme værdi for RecurringAppointmentMaster.GroupId attributten som serien med den gentagne aftale, der opdateres, selvom hver serie har et entydigt serie-ID.
Bemærk
Når du opdaterer gentagelsesoplysninger for en tilbagevendende aftaleserie, der har alle de forekomster, der skal ske i fremtiden, slettes alle forekomster og nye oplysninger, der bruges til at oprette eller udvide nye forekomster.
Du kan se eksempelkoden til opdatering af serien med en gentaget aftale på Eksempel: Omlægge og annullere en tilbagevendende aftale.
Opdater en forekomst med en gentaget aftale
Da de tilbagevendende aftaleposter gemmes som aftaleobjekter, kan du bruge IOrganizationService.Update metoden på Appointment enheden for at opdatere en tilbagevendende aftaleforekomst. Når du opdaterer en tilbagevendende aftaleforekomst, er forekomsten markeret som en undtagelse fra serien med den gentagne aftale.Flere oplysninger:Oprette en undtagelse for en gentaget aftale
Du kan også bruge CreateExceptionRequest klassen på Appointment enheden for at opdatere en tilbagevendende aftaleforekomst.
Tip
Forekomster af tilbagevendende aftaler kan identificeres ved hjælp af Appointment.InstanceTypeCode-attributten, som skal have værdien "2" (tilbagevendende forekomst).Flere oplysninger:Objektmeddelelser og -metoder for aftaler
Se også
Objekter for tilbagevendende aftale
Slette eller afslutte en tilbagevendende aftaleserie eller -forekomst
Eksempel: Oprette, hente, opdatere og slette en tilbagevendende aftale
Eksempel: Omlægge og annullere en tilbagevendende aftale
Microsoft Dynamics 365
© 2017 Microsoft. Alle rettigheder forbeholdes. Ophavsret