Atualizar um compromisso recorrente
Publicado: janeiro de 2017
Aplicável a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
É possível atualizar a série inteira ou uma instância de um compromisso recorrente.
Atualizar uma série de compromissos recorrentes
É possível atualizar uma série de compromissos recorrentes usando o método IOrganizationService.Update ou a mensagem UpdateRequest na entidade RecurringAppointmentMaster. É possível atualizar as informações básicas ou recorrentes.
Atualizar informações básicas
Ao atualizar as informações básicas de uma série de compromissos recorrentes, como assunto, local ou participantes, todas as instâncias da série de compromissos recorrentes serão atualizadas, com exceção daquelas que tenham exceções no mesmo atributo.
Atualizar informações recorrentes
Ao atualizar as informações recorrentes de uma série de compromissos recorrentes, como padrão e intervalo, as seguintes ações ocorrem:
Uma nova série com um novo RecurringAppointmentMaster.ActivityId é criada com as mesmas informações que a série original e a data no atributo RecurringAppointmentMaster.EffectiveEndDate da nova série é definida para a instância anterior com a última ocorrência da série original. Todas as futuras instâncias da série original são excluídas. Assim, a série original é finalizada e o histórico das instâncias anteriores é preservado no sistema, por meio de seu armazenamento em uma nova série.
As novas informações são usadas para criar futuras instâncias da nova série a partir da data de início da vigência (RecurringAppointmentMaster.EffectiveStartDate).
Além disso, o atributo RecurringAppointmentMaster.GroupId da série original e da nova série é preenchido com o mesmo valor. Isso implica que sempre que as informações recorrentes de uma série de compromissos recorrentes forem atualizadas, todas as novas séries criadas terão o mesmo valor para o atributo RecurringAppointmentMaster.GroupId que a série de compromissos recorrentes que foi atualizada, embora cada série tenha um ID de série exclusivo.
Observação
Ao atualizar as informações recorrentes de uma série de compromissos recorrentes que tenha todas as instâncias listadas para ocorrer no futuro, todas as instâncias serão excluídas e as novas informações recorrentes serão usadas para criar ou expandir novas instâncias.
Para ver o código de exemplo para atualizar uma série de compromissos recorrentes, consulte Exemplo: Remarcar e cancelar um compromisso recorrente.
Atualizar uma instância de compromissos recorrentes
Como os registros de compromissos recorrentes são armazenados como objetos de compromisso, é possível usar o método IOrganizationService.Update na entidade Appointment para atualizar uma instância de compromissos recorrentes. Ao atualizar uma instância de compromissos recorrentes, a instância será marcada como uma exceção na série de compromissos recorrentes.Para obter mais informações:Crie uma exceção de compromissos recorrentes
Também é possível usar a classe CreateExceptionRequest na entidade Appointment para atualizar uma instância de compromissos recorrentes.
Dica
As instâncias de compromissos recorrentes podem ser identificadas com o atributo Appointment.InstanceTypeCode, que terá um valor de “2“ (Instância Recorrente).Para obter mais informações:Mensagens e métodos de entidade de compromisso
Confira Também
Entidade de compromissos recorrentes
Excluir ou finalizar uma série de compromissos recorrentes ou instância
Exemplo: Criar, recuperar, atualizar e excluir um compromisso recorrente
Exemplo: Remarcar e cancelar um compromisso recorrente
Microsoft Dynamics 365
© 2017 Microsoft. Todos os direitos reservados. Direitos autorais