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

Al crear una cita periódica maestra (serie), Microsoft Dataverse crea instancias individuales de la cita en función de la información periódica especificada. También puede crear instancias individuales de citas periódicas y las excepciones a dichas 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 (una fila de RecurringAppointmentMaster), puede usar el mensaje BookRequest, el mensaje CreateRequest o el método IOrganizationService.Create.

Cuando crea una serie de citas periódicas, ocurre lo siguiente:

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

2. Se crean instancias individuales de citas periódicas basándose en la información de periodicidad y se almacenan como filas Appointment . Estos objetos de cita se asocian a la serie primaria de citas periódicas mediante la propiedad Appointment.SeriesId y tienen el mismo valor que el Id. primario de la serie de citas periódicas (ActivityPointer.SeriesId).

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

   Nota

   Las instancias de citas periódicas se crean basándose en el modelo de la expansión y los parámetros que se definen. Más información: Modelo de expansión parcial de citas periódicas

   Para ver el código de muestra para crear una serie de citas periódicas, consulte Ejemplo: crear, recuperar, actuaizar y eliminar una cita periódica.

Crear una instancia de citas periódicas

Para crear una instancia de citas periódicas (una fia RecurringAppointmentMaster), puede usar CreateInstanceRequest. Para este mensaje se necesitan dos parámetros: el número de instancias que se van a crear y la serie de citas periódicas para las que se tienen que crear 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 a la cita periódica

Se crea una excepción al actualizar o eliminar una instancia de la cita periódica. Las instancias de citas periódicas se almacenan como una fila de cita junto a otras citas, y puede identificar una instancia de citas periódicas mediante la columna Appointment.InstanceTypeCode de una fila de cita, que tendrá un valor de Instancia periódica (valor de elección 2).

Puede crear excepciones de las siguientes formas:

• Use la clase UpdateRequest de la tabla Appointment para actualizar una instancia de citas periódicas y establezca el valor de la columna Appointment.InstanceTypeCode en Excepción periódica (valor de elección 3).

• Use la clase DeleteRequest de la tabla Appointment 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 la columna RecurringAppointmentMaster.DeletedExceptionsList del objeto primario de la serie de citas.

• Use la clase CreateExceptionRequest de la tabla Appointment.

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 Dataverse en una cita periódica mediante AddRecurrenceRequest. Cuando se convierte una cita existente en una cita periódica, los datos de la cita existente se copian en una nueva instancia de cita periódica maestra y se elimina la cita existente.

Consultar también

Actualizar una cita periódica
Ejemplo: crear, recuperar, actualizar y eliminar una cita periódica