Crear una sèrie, una instància o una excepció de cites periòdiques

Quan creeu un mestre de cites periòdiques (sèrie), el Dynamics 365 Customer Engagement (on-premises) crea instàncies de cites individuals basades en la informació de periodicitat especificada. També podeu crear instàncies de cites periòdiques individuals i excepcions a aquestes instàncies, i podeu convertir una cita en una cita periòdica.

Crear una sèrie de cites periòdiques

Per crear una sèrie de cites periòdiques (un RecurringAppointmentMaster registre), podeu utilitzar el BookRequest missatge, el CreateRequest missatge o el IOrganizationServicemètode .Create

Quan creeu una sèrie de cites periòdiques, es produeixen les coses següents:

1. Es crea un RecurringAppointmentMaster registre (sèrie de cites periòdiques) que conté la informació bàsica i de periodicitat sobre la sèrie de cites periòdiques. Cada registre es pot identificar de manera única mitjançant la RecurringAppointmentMaster.ActivityId propietat. A més, aquesta sèrie de cites periòdiques també es crea i s'emmagatzema com a registre d'activitat (ActivityPointer). El registre d'activitat es pot identificar de manera única mitjançant la ActivityPointer.ActivityId propietat.

2. Les instàncies de cites periòdiques individuals es creen en funció de la informació de periodicitat i s'emmagatzemen com a Appointment registres. Aquests objectes de cita s'associen amb la sèrie de cites periòdiques principals mitjançant la Appointment.SeriesId propietat i tenen el mateix valor que l'identificador de la sèrie de cites periòdiques principals (ActivityPointer.SeriesId).

   El valor de la Appointment.InstanceTypeCode propietat es defineix com a Instància periòdica (valor de llista de selecció 2) per a aquests objectes de cita.

   Nota

   Les instàncies de cita periòdiques es creen en funció del model d'expansió i dels paràmetres que el defineixen. Més informació: Model d'expansió parcial de cites periòdiques.

   Per obtenir un codi d'exemple que demostri com crear una sèrie de cites periòdiques, vegeu Exemple: Crear una cita periòdica.

Crear una instància de cita periòdica

Per crear una instància de cita periòdica (un RecurringAppointmentMaster registre), podeu utilitzar el CreateInstanceRequest. Aquest missatge pren dos paràmetres: el nombre d'instàncies que s'han de crear i la sèrie de cites periòdiques per a les quals s'han de crear les instàncies.

Les instàncies es creen després de l'última instància de la sèrie de cites periòdiques. A més, les instàncies només es creen fins a la data límit de la instància futura, independentment del nombre d'instàncies que hàgiu especificat per a la creació.

Crear una excepció de cita periòdica

Es crea una excepció quan actualitzeu o suprimiu una instància de la cita periòdica. Les instàncies de cites periòdiques s'emmagatzemen com a registre de cita juntament amb altres cites i podeu identificar una instància de cita periòdica mitjançant l'atribut Appointment.InstanceTypeCode d'un registre de cita, que tindrà un valor d'Instància periòdica (valor de llista de selecció 2).

Podeu crear excepcions de les maneres següents:

• Utilitzeu la UpdateRequest classe de l'entitat Appointment per actualitzar una instància de cita periòdica i definiu el valor de l'atribut Appointment.InstanceTypeCode com a Excepció periòdica (valor de llista de selecció 3).

• Utilitzeu la DeleteRequest classe de l'entitat Appointment per suprimir una instància de cita periòdica. La supressió d'una instància de cita marca com una excepció creant una entrada per a la instància a l'atribut RecurringAppointmentMaster.DeletedExceptionsList de l'objecte de sèrie de cites principal.

• Utilitzeu la CreateExceptionRequest classe a l'entitat Appointment .

Convertir una cita en una cita periòdica

Una cita periòdica és una cita amb informació de periodicitat. Podeu convertir una cita existent al Dynamics 365 Customer Engagement (on-premises) en una cita periòdica mitjançant AddRecurrenceRequest. Quan convertiu una cita existent en una cita periòdica, les dades de la cita existent es copien a una nova instància mestra de cites periòdiques i se suprimeix la cita existent.

Consulteu també

Entitats de cita periòdica
Actualitzar una cita periòdica
Exemple: Crear una cita periòdica
Exemple: Convertir una cita en una cita periòdica