Crear una instancia, excepción o serie de cita periódica.

Al crear un maestro de citas periódicas (serie), Dynamics 365 Customer Engagement (on-premises) crea instancias de citas individuales en función de la información de periodicidad especificada. También puede crear instancias de citas periódicas individuales y excepciones a esas instancias, y puede convertir una cita en una cita periódica.

Crear una serie de citas periódicas

Para crear una serie de citas periódicas (un registro de RecurringAppointmentMaster), puede usar el mensaje BookRequest, el mensaje CreateRequest o el método IOrganizationService.Create

Al crear una serie de citas periódicas, ocurre lo siguiente:

1. Se crea un RecurringAppointmentMaster registro (serie de citas periódicas) que contiene la información básica y de periodicidad sobre la serie de citas periódicas. Cada registro se puede identificar de forma única mediante la RecurringAppointmentMaster.ActivityId propiedad. Además, esta serie de citas periódicas también se crea y almacena como un registro de actividad (ActivityPointer). El registro de actividad se puede identificar de forma única mediante la ActivityPointer.ActivityId propiedad.

2. Las instancias individuales de citas recurrentes se crean a partir de la información de recurrencia y se almacenan como Appointment registros. Estos objetos de cita se asocian a la serie de citas periódicas principal mediante la Appointment.SeriesId propiedad y tienen el mismo valor que el ID de la serie de citas periódicas principal (ActivityPointer.SeriesId).

   El valor de la propiedad de Appointment.InstanceTypeCode se establece en Instancia periódica (valor de lista desplegable 2) para estos objetos de cita.

   Nota:

   Las instancias de citas periódicas se crean en función del modelo de expansión y los parámetros que lo definen. Más información: Modelo de expansión parcial de citas periódicas

   Para ver código de ejemplo que muestra cómo crear una serie de citas periódicas, vea Ejemplo: Crear una cita periódica.

Creación de una instancia de cita periódica

Para crear una instancia de cita periódica (un RecurringAppointmentMaster registro), puede utilizar el CreateInstanceRequest. Este mensaje toma dos parámetros: el número de instancias que se van a crear y la serie de citas periódicas para las que se deben crear las instancias.

Las instancias se crean después de la última instancia de la serie de citas periódicas. Además, solo se crean instancias hasta la fecha de finalización futura de la instancia, independientemente del número de instancias que se haya especificado para la creación.

Crear una excepción de cita periódica

Se crea una excepción cuando se actualiza o se elimina una instancia de la cita periódica. Las instancias de citas periódicas se almacenan como un registro de citas al igual que otras citas, y puede identificar una instancia de cita periódica mediante el Appointment.InstanceTypeCode atributo de un registro de cita, que tendrá un valor de Instancia recurrente (valor de lista de selección 2).

Puede crear excepciones de las siguientes maneras:

• Use la clase UpdateRequest en la entidad Appointment para actualizar una instancia de citas periódicas y establezca el valor del atributo Appointment.InstanceTypeCode en Excepción periódica (valor de lista desplegable 3).

• Use la DeleteRequest clase de la Appointment entidad para eliminar una instancia de cita periódica. Al eliminar una instancia de cita, se señala como una excepción creando una entrada para la instancia en el atributo RecurringAppointmentMaster.DeletedExceptionsList del objeto primario de la serie de citas.

• Utilice la CreateExceptionRequest clase en la Appointment entidad.

Convertir una cita en una cita periódica

Una cita periódica es una cita con información de la frecuencia. Puede convertir una cita existente en Dynamics 365 Customer Engagement (on-premises) en una cita periódica mediante AddRecurrenceRequest. Al convertir una cita existente en una cita periódica, los datos de la cita existente se copian en una nueva instancia maestra de citas periódicas y se elimina la cita existente.

Consulte también

Entidades de citas recurrentes
Actualizar una cita periódica
Ejemplo: Crear una cita periódica
Ejemplo: Convertir una cita en una cita periódica