Criar uma série de compromissos recorrentes, instância ou exceção

 

Publicado: janeiro de 2017

Aplicável a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Quando você cria um compromisso mestre recorrente (série), Microsoft Dynamics 365 cria instâncias de compromissos individuais com base nas informações recorrentes especificadas. Também é possível criar instâncias e exceções de compromisso recorrente individual a essas instâncias e você pode converter um compromisso para um compromisso recorrente.

Neste tópico

Crie uma série de compromissos recorrentes

Crie uma instância de compromissos recorrentes

Crie uma exceção de compromissos recorrentes

Converter um compromisso para um compromisso recorrente

Crie uma série de compromissos recorrentes

Para criar uma série de compromissos recorrentes (um registro RecurringAppointmentMaster), você pode usar a mensagem BookRequest, a mensagem CreateRequest ou o método IOrganizationService.Create.

Quando você cria uma série de compromissos recorrentes, ocorre o seguinte:

1. Um registro RecurringAppointmentMaster (série de compromissos recorrentes) é criado que contém as informações básicas e recorrentes sobre a série de compromissos recorrentes. Cada registro pode ser identificado exclusivamente usando a propriedade RecurringAppointmentMaster.ActivityId. Além disso, esta série de compromissos recorrentes também é criada e armazenada como um registro de atividade (ActivityPointer). O registro de atividade pode ser identificado exclusivamente usando a propriedade ActivityPointer.ActivityId.

2. As instâncias de compromissos recorrentes individuais são criadas com base nas informações de recorrência e armazenadas como registros Appointment. Estes objetos de compromissos são associados com a série de compromissos recorrentes principal usando a propriedade de Appointment.SeriesId e possuem o mesmo valor que a ID da série de compromissos recorrentes principal (ActivityPointer.SeriesId).

   O valor da propriedade de Appointment.InstanceTypeCode é definido como Instância recorrente (valor da lista de seleção 2) para esses objetos de compromisso.

   Observação

   Instâncias de compromisso recorrente são criadas com base no modelo de expansão e nos parâmetros que a definem.Para obter mais informações:Modelo de expansão parcial de compromisso recorrente.

Para o código de exemplo que demonstra como criar uma série de compromissos recorrentes, consulte Exemplo: Criar, recuperar, atualizar e excluir um compromisso recorrente.

Crie uma instância de compromissos recorrentes

Para criar uma instância de compromissos recorrentes (um registro RecurringAppointmentMaster), você pode usar o CreateInstanceRequest. Esta mensagem tem dois parâmetros: o número de instâncias a ser criado e a série de compromissos recorrentes para a qual as instâncias devem ser criadas.

As instâncias são criadas após a última instância na série de compromissos recorrentes. Além disso, as instâncias são criadas somente até a data de interrupção futura da instância, independentemente do número de instâncias que você especificou para a criação.

Crie uma exceção de compromissos recorrentes

Uma exceção é criada quando você atualiza ou exclui uma instância do compromisso recorrente. As instâncias de compromisso recorrente são armazenadas como um registro de compromisso, juntamente como outros compromissos, e você pode identificar uma instância de compromisso recorrente usando o atributo Appointment.InstanceTypeCode de um registro de compromisso, que terá um valor de Instância recorrente (valor da lista de seleção 2).

Você pode criar exceções das seguintes maneiras:

• Use a classe de UpdateRequest na entidade de Appointment para atualizar uma instância de compromissos recorrentes e defina o valor do atributo de Appointment.InstanceTypeCode para Exceção recorrente (valor da lista de seleção 3).

• Use a classe DeleteRequest na entidade Appointment para excluir uma instância de compromissos recorrentes. Excluir uma instância de compromisso marca-se uma exceção, criando uma entrada para a instância no atributo RecurringAppointmentMaster.DeletedExceptionsList do objeto da série de compromissos principal.

• Use a classe de CreateExceptionRequest na entidade de Appointment.

Converter um compromisso para um compromisso recorrente

Um compromisso recorrente é um compromisso com informações recorrentes. Você pode converter um compromisso existente em Microsoft Dynamics 365 para um compromisso recorrente usando AddRecurrenceRequest. Quando você converte um compromisso existente a um compromisso recorrente, os dados do compromisso existente são copiados para uma nova instância mestre do compromisso recorrente e o compromisso existente é excluído.

Confira Também

Entidade de compromissos recorrentes
Atualizar um compromisso recorrente
Exemplo: Criar, recuperar, atualizar e excluir um compromisso recorrente
Exemplo: Converter um compromisso para um compromisso recorrente

Microsoft Dynamics 365

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais