Actualizar una cita periódica
Publicado: enero de 2017
Se aplica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Puede actualizar la serie entera o actualizar una instancia de una cita periódica.
Actualizar una serie de citas periódicas
Puede actualizar una serie de citas periódicas utilizando el método IOrganizationService.Update o el mensaje UpdateRequest en la entidad RecurringAppointmentMaster. Puede actualizar la información básica o periódica.
Actualizar la información básica
Cuando se actualiza la información básica de una serie de citas periódicas, como el asunto, la ubicación o los asistentes, todas las instancias de la serie se actualizan excepto las que tienen excepciones en el mismo atributo.
Actualizar la información periódica
Cuando se actualiza la información periódica de una serie de citas periódicas, como el patrón y el intervalo, se produce lo siguiente:
Se crea una nueva serie con un nuevo RecurringAppointmentMaster.ActivityId que tiene la misma información que la serie original, y la fecha del atributo RecurringAppointmentMaster.EffectiveEndDate de la nueva serie se establece en la instancia que ocurrió en último lugar de la serie original. Todas las instancias futuras de la serie original se eliminan. De esta manera, se finaliza la serie original y se conserva el historial de las últimas instancias en el sistema almacenado en una nueva serie.
La nueva información se usa para crear las futuras instancias de la serie nueva desde la fecha de inicio efectiva (RecurringAppointmentMaster.EffectiveStartDate).
Además, el atributo RecurringAppointmentMaster.GroupId para la serie original y nueva se rellena con el mismo valor. Esto implica que siempre que actualice la información de la periodicidad de una serie de citas periódicas, todas las nuevas series que se crean tienen el mismo valor en el atributo RecurringAppointmentMaster.GroupId que la serie de citas periódicas que se actualiza, aunque cada serie tenga un identificador de serie único.
Nota
Cuando actualice la información de la periodicidad de una serie de citas periódicas que tiene todas las instancias programadas para que ocurran en el futuro, se eliminan todas las instancias y la nueva información de la frecuencia se usa para crear o ampliar las nuevas instancias.
Para ver el código de ejemplo para actualizar una serie de citas periódicas, consulte Ejemplo: reprogramar y cancelar una cita periódica.
Actualizar una instancia de citas periódicas
Ya que los registros de citas periódicas se almacenan como objetos de cita, puede usar el método IOrganizationService.Update de la entidad Appointment para actualizar una instancia de cita periódica. Cuando se actualiza una instancia de cita periódica, la instancia se marca como una excepción en la serie de citas periódicas.Más información:Crear una excepción a la cita periódica
También puede usar la clase CreateExceptionRequest de la entidad Appointment para actualizar una instancia de cita periódica.
Sugerencia
Las instancias de citas periódicas se pueden identificar mediante el atributo Appointment.InstanceTypeCode, que tendrá que un valor de "2 " (instancia periódica).Más información:Mensajes y métodos de la entidad de cita
Ver también
Entidades de cita periódica
Eliminar o finalizar una instancia o serie de cita periódica
Ejemplo: crear, recuperar, actualizar y eliminar una cita periódica
Ejemplo: reprogramar y cancelar una cita periódica
Microsoft Dynamics 365
© 2017 Microsoft. Todos los derechos reservados. Copyright