Padrão de recorrência na execução de trabalho assíncrono

 

Publicado: janeiro de 2017

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

É possível executar operações do sistema assíncronas de forma ocasional ou recorrente, usando uma regra de recorrência. Use o atributo AsyncOperation.RecurrencePattern para especificar a regra de recorrência. Esta propriedade é incluída nas classes de solicitação das mensagens IOrganizationService que enviam trabalhos assíncronos, como exclusão em massa ou detecção de duplicidades em massa. Também está incluída nas entidades que representam operações assíncronas, como a entidade AsyncOperation (trabalho do sistema).

Use o formato a seguir para definir o atributo AsyncOperation.RecurrencePattern.

Padrão de recorrência	Frequência de execução do trabalho
"FREQ=MONTHLY;"	Uma vez por mês
"FREQ=WEEKLY;"	Uma vez por semana
FREQ=DAILY;"	Uma vez por dia
"FREQ=HOURLY;"	Uma vez por hora

Observação

Um formato completo de uma regra de recorrência está descrito no padrão de Internet RFC2445 (Internet Calendaring and Scheduling Core Object Specification).

Você pode especificar com que frequência você deseja repetir a regra, usando uma parte da regra de INTERVAL. Por exemplo, para executar um trabalho a cada três dias, use o formato a seguir: "FREQ=DAILY;INTERVAL=3;". O INTERVAL é uma parte opcional da regra de recorrência. Se você não especificar INTERVAL, será definido como 1.

Para executar um trabalho assíncrono sem recorrência, defina essa propriedade como um valor que seja especificado no tópico de referência de programação de propriedade AsyncOperation.RecurrencePattern para uma classe de solicitação ou uma entidade de mensagem específica.

Para especificar a hora de início da execução do trabalho, use a propriedade AsyncOperation.RecurrenceStartTime ou a propriedade StartDateTime nas classes da solicitação da mensagem ou nos registros que representam operações assíncronas. Se a propriedade não estiver definida, a hora de início será definida como o valor que está contido na propriedade DateTime.Now.

Confira Também

RecurrencePattern
StartDateTime
RecurrencePattern
RecurrenceStartTime
Excluir dados em massa
Entidade AsyncOperation (trabalho do sistema)
Serviço assíncrono no Microsoft Dynamics 365
Entidades suportadas para operações assíncronas

Microsoft Dynamics 365

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais