Partager via


Utilisation des files projets pour planifier des tâches

Utilisez la page Écritures file d’attente des travaux permet aux utilisateurs de planifier et d’exécuter des états et codeunits spécifiques. Vous pouvez définir des projets à exécuter une fois, ou sur une base récurrente. Par exemple, vous souhaiterez peut-être exécuter l’état Statistiques vente * commerciaux sur une base hebdomadaire, pour suivre les ventes par vendeur chaque semaine, ou exécuter le codeunit Déléguer les demandes d’approbation quotidiennement, pour empêcher les documents de s’empiler ou de bloquer le flux de travail.

La page Écritures file d’attente des travaux répertorie tous les projets existants. Si vous ajoutez une écriture de file d’attente des travaux qui s’exécute solon une planification, vous devez fournir certaines informations. Par exemple :

  • Le type d’objet à exécuter, tel qu’un rapport ou une codeunit. Vous devez être autorisé à exécuter le rapport ou la codeunit.
  • Le nom et l’ID objet de l’objet.
  • Les paramètres pour spécifier le comportement de la file d’attente des travaux. Par exemple, vous pouvez ajouter un paramètre pour envoyer uniquement des commandes vente validées.
  • Planification du moment et de la fréquence d’exécution de l’écriture de file d’attente des travaux.

Important

Si vous bénéficiez de l’ensemble d’autorisations SUPER qui est fourni avec Business Central, vous disposez des autorisations pour exécuter tous les objets inclus dans votre licence. Si vous disposez du rôle Administrateur délégué, vous pouvez créer et planifier des écritures de file d’attente de travaux, mais seuls les administrateurs et les utilisateurs sous licence peuvent les exécuter.

Une fois qu’un travail se termine correctement, Business Central le supprime de la liste d’écritures de la file d’attente des travaux, sauf en cas de projet récurrent. Pour les travaux récurrents, le champ Heure de début (au plus tôt) est ajusté pour afficher la prochaine heure d’exécution du projet.

Exemples de ce que vous pouvez planifier à l’aide des écritures de la file d’attente des travaux

Planification des états

Vous pouvez planifier ou traiter par lots un état à exécuter à une date et une heure spécifiques. Les états prévus ou les traitements par lots sont entrés dans la file projets et traités au moment prévu, comme les autres projets. Vous devez choisir l’option Planifier après avoir cliqué sur l’action Envoyer à, puis vous devez entrer des informations telles que l’imprimante, l’heure, la date et la récurrence.

Pour en savoir plus sur la planification, accédez à Planifier l’exécution d’un rapport

Planifier une synchronisation entre Business Central et Dataverse

Si vous intégrez Business Central avec Dataverse, la file d’attente des travaux vous permet de planifier à quel moment synchroniser les données. Selon la direction et les règles que vous définissez, l’entrée de la file d’attente des tâches peut créer des enregistrements dans une application pour faire correspondre les enregistrements dans l’autre. Un bon exemple est lorsque vous enregistrez un contact dans Dynamics 365 Sales, l’entrée de la file d’attente peut configurer ce contact pour vous dans Business Central. Pour en savoir plus sur la planification, voir Planification d’une synchronisation entre Business Central et Dynamics 365 Sales.

Planifier le moment de validation des commande vente et achat

Vous pouvez utiliser les entrées de la file d’attente des travaux pour planifier l’exécution des processus métier en arrière-plan. Par exemple, les tâches en arrière-plan sont utiles quand plusieurs utilisateurs valident des commandes vente en même temps, mais qu’une seule commande peut être traitée à la fois. Pour en savoir plus sur la publication en arrière-plan, accédez à Pour configurer la publication en arrière-plan avec des files d’attente de travaux.

Important pour planifier des tâches récurrentes

Important

Les files d’attente de tâches récurrentes peuvent affecter les performances, vous ne devez donc pas les exécuter trop fréquemment. Lorsque vous configurez la fréquence d’exécution d’une tâche récurrente, essayez de définir l’intervalle de temps le plus grand possible. Par exemple, si vous êtes sur le point de définir une récurrence de cinq minutes, demandez-vous si elle peut être de 15 minutes, ou même d’une fois par heure. Lors de la planification de files d’attente de tâches récurrentes, réfléchissez aux zones de l’application que la tâche concernera. Est-ce un domaine où travaillent de nombreux utilisateurs et qui sera impacté par une forte activité ? Tenez compte de la durée d’une seule exécution de tâche et des motivations commerciales pour exécuter des tâches à une cadence donnée.

Date début au plus tôt

La valeur du champ Date/heure de début au plus tôt sur la page Ficve écriture la file d’attente des travaux indique la prochaine fois que le le travail sera exécuté. Plusieurs facteurs peuvent affecter l’exécution réelle d’une entrée de la file d’attente de travaux à ce moment-là.

Les facteurs les plus courants sont le nombre d’écritures dans la file d’attente des travaux dans un environnement et le nombre total de travaux planifiées. Pour protéger les niveaux de performances, il existe des limites opérationnelles. Si vous avez beaucoup d’écritures et, par exemple, l’une d’entre elles échoue ou prend plus de temps que prévu, la tâche suivante risque de ne pas démarrer à l’heure prévue. Si vous disposez de codeunits qui génèrent 100 000 tâches planifiées ou plus, vous devez déterminer si vous avez réellement besoin de toutes ces tâches. Vous pouvez accéder à la liste de toutes les tâches planifiées sur la page Tâches planifiées.

Pour en savoir plus sur la surveillance de l’état des entrées de la file d’attente des tâches, accédez à Pour afficher l’état d’une tâche. Pour en savoir plus sur les limites opérationnelles, accédez à Limites des tâches asynchrones.

Surveiller le statut ou les erreurs dans la file d’attente des travaux

Les données générées par la file d’attente des travaux sont stockées, de sorte que vous pouvez résoudre les erreurs.

Pour chaque entrée de file d’attente de travaux, vous pouvez afficher et modifier l’état. Lorsque vous créez une écriture file d’attente des travaux, son statut est défini sur En attente. Vous pouvez définir le statut sur Prêt et revenir à En attente, par exemple. Sinon, les informations de statut sont mises à jour automatiquement.

Le tableau suivant décrit les valeurs du champ Statut.

Statut Description
Prêt L’écriture file d’attente des travaux est prête à être exécutée.
En cours L’écriture file d’attente des travaux est en cours. Ce champ est mis à jour lors de l’exécution de la file d’attente des travaux.
En attente Le statut par défaut de l’écriture de file d’attente des travaux lorsque vous la créez. Choisissez l’action Définir le statut sur Prêt pour modifier le statut en Prêt. Choisissez l’action Définir en attente pour rétablir le statut sur En attente. Pour en savoir plus, accédez à À propos de l’attente.
En attente pour inactivité Utilisé principalement pour les écritures de la file d’attente des travaux qui planifient la synchronisation entre Business Central et une autre application, telle que Dataverse. Pour en savoir plus sur ce statut, accédez à À propos des délais d’inactivité.
En attente Uniquement pertinent pour les écritures de file d’attente des travaux auxquelles est attribué un code de catégorie. Indique que la tâche est planifiée, mais que le tâche planifiée sous-jacente n’est pas active. Une fois que l’écriture de file d’attente des travaux en cours d’exécution qui se trouve dans la même catégorie se termine, le statut de la tâche suivante dans la catégorie avec le statut En attente devient Prêt.
Erreur Un problème est survenu. Choisissez Afficher erreur pour afficher le message d’erreur.
PROD FINIS L’écriture file d’attente des travaux est complète.

À propos de l’attente

La définition d’une écriture de file d’attente des travaux sur En attente n’affecte pas un projet déjà en cours d’exécution. Une fois qu’une tâche démarre, elle continue à s’exécuter jusqu’à son terme, quelles que soient les modifications apportées ultérieurement à l’entrée de la file d’attente, par exemple en la mettant en attente.

Le statut En attente est généralement utilisé pour empêcher un projet de démarrer automatiquement lorsqu’il atteint l’heure de début prévue. Il permet d’interrompre temporairement un projet avant qu’il ne commence à être traité.

Si vous devez arrêter ou annuler une tâche en cours d’exécution, vous pouvez intervenir manuellement dans le processus. Par exemple, vous pouvez arrêter la session ou le processus correspondant.

Pour visualiser le statut de tous les travaux

  1. Choisissez l’icône Icône en forme d’ampoule qui ouvre la fenêtre de recherche., saisissez Écritures file d’attente des travaux, puis choisissez le lien associé.
  2. Sur la page Écritures file d’attente des travaux, sélectionnez une écriture file d’attente des travaux, puis sélectionnez l’action Écritures journal.

Astuce

Pour une analyse plus approfondie basée sur la télémétrie, utilisez Application Insights dans Microsoft Azure pour voir le statut des écritures file d’attente. Pour en savoir plus sur la télémétrie, accédez à Surveillance et analyse de la télémétrie et Analyse de la télémétrie de la trace du cycle de vie des files d’attente de travaux.

Afficher les tâches planifiées

La page Tâches planifiées dans Business Central indique quelles tâches sont prêtes à être exécutées dans la file d’attente des travaux. La page affiche également des informations sur l’entreprise dans laquelle chaque tâche est configurée pour s’exécuter. Cependant, seules les tâches marquées comme appartenant à l’environnement actuel peuvent s’exécuter.

Par exemple, toutes les tâches planifiées s’arrêtent si l’entreprise se trouve dans un environnement qui est une copie d’un autre environnement. Utilisez la page Tâches planifiées pour définir les tâches comme prêtes à être exécutées dans la file d’attente des travaux.

Noter

Les administrateurs internes et les utilisateurs sous licence peuvent planifier l’exécution des tâches. Les administrateurs délégués peuvent configurer et programmer des tâches à exécuter, mais seuls les utilisateurs sous licence peuvent les exécuter.

Composant Ma file d’attente des travaux

Le composant Ma file d’attente des travaux sur votre page d’accueil répertorie les écritures de files d’attente des travaux que vous avez commencées, mais qui ne sont pas terminées. Par défaut, le composant n’est pas affiché, mais vous pouvez l’ajouter à votre page d’accueil. Pour plus d’informations sur la personnalisation, consultez Personnaliser votre espace de travail.

Le composant affiche les informations suivantes :

  • Quels documents ayant votre ID dans le champ Code utilisateur affecté sont en cours de traitement ou en attente, y compris ceux validés à l’arrière-plan.
  • S’il y a eu une erreur lors de la validation d’un document ou dans l’entrée de la file d’attente des travaux.

Le composant Ma file d’attente des travaux permet également d’annuler une validation de document.

Astuce

Une autre fonctionnalité utile est la pile Tâches file d’attente des travaux sur votre page d’accueil. La pile facilite la surveillance des entrées de la file d’attente des travaux en fonction de leur statut. Pour en savoir plus, consultez Pile Tâches file d’attente des travaux.

Pour afficher une erreur dans le composant Ma file d’attente des travaux

  1. Sur une écriture indiquant le statut Erreur, sélectionnez l’action Afficher erreur.
  2. Examinez le message d’erreur et résolvez le problème.

Pile Tâches file d’attente des travaux

La pile Tâches file d’attente des travaux sur votre page d’accueil vous permet de garder facilement un œil sur les entrées de votre file d’attente des travaux. La pile affiche des vignettes pour trois statuts :

  • Tâches échouées : ces tâches nécessitent une attention particulière. Les tâches s’affichent dans cette vignette lorsqu’elles dépassent le nombre maximal de tentatives d’exécution que vous avez spécifié pour l’écriture de la file d’attente des travaux. Pour en savoir plus, consultez Gérer les problèmes d’écritures dans la file d’attente des tâches.
  • Tâches en cours : ces tâches sont en cours d’exécution.
  • Tâches en file d’attente : ces tâches attendent leur tour.

Vous pouvez configurer la pile Tâches file d’attente des travaux pour utiliser des indicateurs de couleur, afin de savoir facilement quand les écritures de la file d’attente des travaux nécessitent une attention particulière. Pour en savoir plus sur les indicateurs de couleur pour les piles, accédez à Configurer un indicateur coloré sur les piles pour la société ou les utilisateurs individuelles.

Gérer les problèmes d’écritures dans la file d’attente des tâches

Les écriture de la file d’attente des tâches cessent de s’exécuter en cas d’erreur. Par exemple, cela peut être un problème lorsqu’une entrée se connecte à un service externe, tel qu’un flux bancaire. Si le service est temporairement indisponible et que l’entrée de la file d’attente des travaux ne peut pas se connecter, l’entrée affichera une erreur et cessera de s’exécuter. Vous devrez redémarrer manuellement l’entrée de la file d’attente des travaux. Cependant, les champs Nombre maximal de tentatives et Délai de réexécution (sec.) peuvent vous aider à éviter cette situation. Le champ Nombre maximal de tentatives vous permet de spécifier combien de fois l’entrée de la file d’attente des travaux peut échouer avant qu’elle n’arrête d’essayer de s’exécuter. Le champ Délai de réexécution (sec.) vous permet de spécifier la durée, en secondes, entre les tentatives. La combinaison de ces deux champs peut maintenir l’entrée de la file d’attente des travaux en cours d’exécution jusqu’à ce que le service externe soit disponible.

Si une écriture de la file d’attente des travaux affiche une erreur, votre première option pour résoudre le problème consiste à redémarrer l’entrée de la file d’attente des travaux. Vous pouvez définir l’état de l’entrée de la file d’attente des travaux sur En attente, puis sur Prêt, ou simplement la redémarrer.

Si un redémarrage n’aide pas, le problème peut être dans le code. Vous pouvez trouver le propriétaire (également appelé éditeur) du code dans la trace de la pile AL dans le journal de la file d’attente des travaux. Si l’erreur provient d’une application/extension, contactez votre partenaire Microsoft. Si l’erreur provient d’une application Microsoft, ouvrez une demande de support auprès de Microsoft.

Si vous contactez votre partenaire Microsoft ou Microsoft pour obtenir de l’aide, fournissez les informations suivantes :

  • L’ID de l’exécution d’une écriture file d’attente des travaux où l’erreur s’est produite
  • L’horodatage du moment où l’erreur s’est produite
  • Votre fuseau horaire

Astuce

Selon que votre Business Central est antérieur ou ultérieur à la version 22.1, rassemblez les informations de la manière suivante :

  • Pour les versions antérieures, fournissez une capture d’écran de la page Écritures journal file d’attente des travaux.
  • Pour les versions ultérieures, utilisez l’action Copier les détails sur la page Écritures journal file d’attente des travaux pour copier les informations (ID de la file d’attente des travaux, horodatage et votre fuseau horaire).

Recevoir une notification lorsqu’une écriture de la file d’attente des travaux échoue

Si un problème se produit et qu’une écriture de la file d’attente des travaux échoue ou n’est pas planifiée pour une raison quelconque, vous souhaiterez être informé afin de pouvoir réagir rapidement. Vous pouvez configurer des notifications pour vous alerter, alerter l’administrateur de votre file d’attente des travaux ou les deux. La notification vous permet de :

  • Redémarrer l’écriture de la file d’attente des travaux, ce qui est généralement la première chose à essayer.
  • Accéder directement aux détails de l’échec.

Pour configurer les notifications en cas d’échec des écritures de la file d’attente des travaux, démarrez le guide de configuration assistée Config. notifications file d’attente des tâches à partir de la page Configuration assistée. Utilisez le guide pour saisir les paramètres suivants :

  • À qui envoyer une notification d’échec. Vous pouvez envoyer une notification à la personne qui a démarré l’écriture de la file d’attente des travaux, ou les administrateurs de l’écriture de la file d’attente des travaux, ou les deux.

  • Comment vous souhaitez recevoir une notification. Vous pouvez activer les notifications intégrées au produit qui s’affichent en haut de votre page d’accueil.

    Affiche une notification en haut d’une page d’accueil.

    Ou bien, utilisez des événements commerciaux externes pour démarrer un flux Power Automate. Vous pouvez spécifier quand, comment et qui notifier pour le flux. Votre flux Power Automate doit s’abonner à l’événement Tâches file d’attente des travaux ayant échoué. Pour faciliter la création d’un flux qui utilise des événements commerciaux externes, Business Central fournit le modèle Power Platform Notifier dans Outlook lorsque la file d’attente des travaux dans Business Central échoue. Un guide de configuration assistée vous aide à la configuration en quelques étapes seulement. Pour en savoir plus sur les flux Power Automate, consultez Utiliser les flux Power Automate dans Business Central.

  • Quand vous souhaitez recevoir une notification. Vous pouvez choisir de recevoir une notification immédiatement ou de spécifier des seuils pour reevoir une notification uniquement après l’échec d’un certain nombre d’écritures de la file d’attente des travaux.

Après avoir configuré les notifications, vous pouvez toujours les activer ou les désactiver. Sur la page Mes notifications, pour Notification d’échec de la file d’attente des travaux, cochez ou décochez la case Activé.

Surveiller la file d’attente des travaux avec la télémétrie

Les administrateurs peuvent utiliser Azure Application Insights pour recueillir et analyser la télémétrie qui vous permet d’identifier les problèmes. Pour en savoir plus sur la télémétrie, accédez à Surveillance et analyse de la télémétrie et Analyse de la télémétrie de la trace du cycle de vie des files d’attente de travaux.

La télémétrie permet aux administrateurs de configurer des alertes sur les problèmes de file d’attente des tâches qui envoient un SMS, un e-mail ou un message dans Teams si quelque chose ne va pas. Pour en savoir plus sur ces alertes, accédez à Alerte sur la télémétrie.

Voir aussi

Administration
Configuration de Business Central
Modification des paramètres de base
Analyse de la télémétrie de suivi du cycle de vie de la file d’attente des travaux
Alerte sur la télémétrie

Trouvez des modules d’apprentissage en ligne gratuits pour Business Central ici