Compartir a través de

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

  • Artículo

 

Publicado: enero de 2017

Se aplica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Al crear una cita periódica maestra (serie), Microsoft Dynamics 365 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.

En este tema

Crear una serie de citas periódicas

Crear una instancia de citas periódicas

Crear una excepción a la cita periódica

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 IOrganizationService. Método Create .

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

  1. Se crea un registro de RecurringAppointmentMaster (serie de citas periódicas) que contiene información básica y la frecuencia sobre la serie de citas periódicas. Cada registro 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 un registro de actividad (ActivityPointer). El registro 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 la frecuencia y se almacenan como registros de 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 lista desplegable 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 código de ejemplo que muestra cómo crear una serie de citas periódicas, consulte Ejemplo: crear, recuperar, actualizar y eliminar una cita periódica.

Crear una instancia de citas periódicas

Para crear una instancia de citas periódicas (un registro de 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 un registro de cita junto a otras citas, y puede identificar una instancia de citas periódicas mediante el atributo Appointment.InstanceTypeCode de un registro de cita, que tendrá un valor de Instancia periódica (valor de lista desplegable 2).

Puede crear excepciones de las siguientes formas:

  • 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 el tipo de clase DeleteRequest de la entidad 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 el atributo RecurringAppointmentMaster.DeletedExceptionsList del objeto primario de la serie de citas.

  • Use la clase CreateExceptionRequest en la entidad 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 Microsoft Dynamics 365 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.

Ver también

Entidades de cita periódica
Actualizar una cita periódica
Ejemplo: crear, recuperar, actualizar y eliminar una cita periódica
Ejemplo: convertir una cita en una cita periódica

Microsoft Dynamics 365

© 2017 Microsoft. Todos los derechos reservados. Copyright