Critère de périodicité dans l’exécution d’une tâche asynchrone
Date de publication : janvier 2017
S’applique à : Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Vous pouvez exécuter des opérations système asynchrones une fois ou sur une base périodique en utilisant une règle de périodicité. Utilisez l’attribut AsyncOperation.RecurrencePattern pour définir la règle de périodicité. Cette propriété est incluse dans les classes de demandes des messages IOrganizationService qui soumettent des travaux asynchrones, comme la suppression en bloc ou la détection de doublons. Elle est également intégrée aux entités qui représentent des opérations asynchrones, comme l’entité AsyncOperation (tâche système).
Utilisez le format suivant pour définir l’attribut AsyncOperation.RecurrencePattern.
Critère de périodicité |
Fréquence d’exécution d’une tâche |
|---|---|
"FREQ=MONTHLY;" |
Une fois par mois |
"FREQ=WEEKLY;" |
Une fois par semaine |
FREQ=DAILY;" |
Une fois par jour |
"FREQ=HOURLY;" |
Une fois par heure |
Notes
Un format complet de règle de périodicité est décrit dans RFC2445 Internet standard (Internet Calendaring and Scheduling Core Object Specification).
Vous pouvez spécifier la fréquence à laquelle vous souhaitez répéter la règle de périodicité en utilisant une partie de la règle INTERVAL. Par exemple, pour exécuter une tâche tous les trois jours, utilisez le format suivant : "FREQ=DAILY;INTERVAL=3;".INTERVAL est une partie facultative de la règle de périodicité. Si vous ne spécifiez pas INTERVAL, la valeur 1 est définie par défaut.
Pour exécuter une tâche asynchrone sans périodicité, définissez cette propriété à une valeur qui est spécifiée dans la rubrique de référence de programmation des propriétés AsyncOperation.RecurrencePattern pour une classe ou une entité de demande de messages spécifique.
Pour spécifier l’heure de début de l’exécution d’une tâche, utilisez la propriété AsyncOperation.RecurrenceStartTime ou la propriété StartDateTime dans les classes de demande de messages ou dans les enregistrements qui représentent des opérations asynchrones. Si la propriété n’est pas définie, l’heure de début est définie à la valeur qui est contenue dans la propriété DateTime.Now.
Voir aussi
RecurrencePattern
StartDateTime
RecurrencePattern
RecurrenceStartTime
Supprimer en bloc des données
Entité AsyncOperation (tâche système)
Service asynchrone dans Microsoft Dynamics 365
Entités prises en charge pour les opérations asynchrones
Microsoft Dynamics 365
© 2017 Microsoft. Tous droits réservés. Copyright