Utilisation des files projets pour planifier des tâches

Utilisez la page Entrées de la file d’attente des travaux pour planifier et exécuter des rapports et des unités de code 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’une tâche est terminée avec succès, Business Central la supprime de la liste des entrées de la file d’attente des tâches, sauf s’il s’agit d’une tâche récurrente. Pour les tâches récurrentes, le champ Heure de début la plus ancienne est ajusté pour afficher la prochaine heure à laquelle la tâche sera exécutée.

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 dans le champ Date/heure de début la plus ancienne de la page Entrée de file d’attente de travaux carte indique la prochaine heure à laquelle 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 de n’importe quelle tâche. Pour en savoir plus sur les limites opérationnelles, accédez à Limites asynchrones tâche.

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 Désignation
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 Attribuer le statut Prêt pour modifier le statut sur Préparer. Choisissez l’action Définir sur Suspendu pour rétablir le statut sur En attente. Pour en savoir plus, accédez à À propos de la fonction En attente.
En attente pour inactivité Utilisé principalement pour les entrées de file d’attente de 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.

Pourboire

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.

À propos de l’attente

La définition d’une entrée de file d’attente de tâches sur En attente n’affecte pas une tâche 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 le démarrage automatique d’une tâche lorsqu’elle atteint l’heure de démarrage programmée. 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., entrez Entrées de la 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.

Pourboire

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 trace du cycle de vie de la file d’attente des tâches.

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

La partie Ma file d’attente de travaux de votre centre de rôles affiche les entrées des files d’attente de travaux que vous avez commencées mais que vous n’avez pas terminées. Par défaut, le composant n’est pas affiché, mais vous pouvez l’ajouter à votre tableau de bord. Pour en savoir plus sur la personnalisation, accédez à 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.

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.

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

Planifier 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 choisissez l’option Planifier après avoir choisi l’action Envoyer à , puis vous entrez des informations telles que l’imprimante, l’heure, la date et la récurrence.

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

Planifier une synchronisation entre Business Central et Dataverse

Si vous intégrez Business Central à Dataverse, la file d’attente des tâches vous permet de planifier le moment de synchronisation des 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, accédez à 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 les files d’attente de travaux.

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

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 le statut de l’entrée de la file d’attente des tâches 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é l’ éditeur) du code dans la trace de la pile AL dans le journal de la file d’attente des tâches. 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’entrée de la file d’attente de tâches s’exécute là où l’erreur s’est produite
  • L’horodatage du moment où l’erreur s’est produite
  • Votre fuseau horaire

Pourboire

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

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

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

Les administrateurs peuvent utiliser Azure Application Insights pour collecter et analyser la télémétrie qui 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 trace du cycle de vie de la file d’attente des tâches.

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
Modifier les paramètres de base
Analyse de la télémétrie de suivi du cycle de vie de la file d’attente des tâches
Alerte sur la télémétrie

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