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 nouvelle écriture de file d’attente de travaux que vous souhaitez exécuter planifier, 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 en question.
• 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.
• Quand et à quelle fréquence l’écriture de la file d’attente des travaux sera exécutée.

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 les files d’attente des travaux configurées et en cours de exécution, le statut est modifié comme suit au cours de chaque période d’abonnement :

• En suspens
• Prêt
• En cours
• Erreur
• Terminé
• Suspendu en raison d’une indisponibilité

Note

Le statut En attente pour inactivité est utilisé principalement pour les entrées de file d’attente de tâches 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é.

Une fois qu’un travail s’est terminé correctement, il est supprimé de la liste d’écritures 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.

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’entrées dans la file d’attente et, par exemple, que l’une d’entre elles échoue ou que les entrées prennent simplement 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	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 suspens	Le statut par défaut de l’écriture file d’attente des travaux lorsqu’elle est créée. 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 plus d’informations, reportez-vous à À propos de l’attente.
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.

Conseil

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 file d’attente des travaux En attente n’affecte pas un projet déjà en cours. Une fois qu’un projet a démarré dans la file d’attente, il continue à être exécuté 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 l’exécution d’un projet avant qu’il ne commence à être traité. Toutefois, lorsqu’un projet est déjà en cours d’exécution, le passage du statut à « En attente » n’interrompt pas l’exécution du projet et n’a pas d’incidence sur celui-ci.

Si vous devez arrêter ou annuler un projet en cours, vous pouvez le faire en intervenant manuellement dans le processus, par exemple en mettant fin à la session correspondante ou au processus responsable de l’exécution du projet.

Pour visualiser le statut de tous les travaux

1. Sélectionnez entrez Écritures file d’attente des travaux, puis sélectionnez 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.

Conseil

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.

Note

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 Tableau de bord répertorie les écritures 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 tableau de bord. 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.

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 devez choisir l’option Planifié après avoir cliqué sur l’action Envoyer à, puis vous devez entrer des informations telles que l’imprimante, l’heure et la date, et la récurrence.

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

Planifier la synchronisation entre Business Central et Dataverse

Si vous avez intégré 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 avez définies, 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.

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 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 projets où l’erreur s’est produite
• L’horodatage du moment où l’erreur s’est produite
• Votre fuseau horaire

Conseil

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).

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