File d'attente des travaux
Les messages de synchronisation sont traités en arrière-plan par une écriture file d'attente des travaux récurrente, gérée depuis la page Configuration Jira.
Configuration de la file d'attente des travaux
- Ouvrez Configuration Jira.
- Sélectionnez Initialiser la file d'attente des travaux pour créer l'écriture file d'attente des travaux. Celle-ci exécute le codeunit de traitement des messages en tant que travail récurrent, planifié tous les jours de la semaine et démarrant immédiatement.
- Sélectionnez Démarrer la file d'attente des travaux pour la définir sur Prêt afin qu'elle commence le traitement selon la planification configurée.
- Utilisez Ouvrir l'écriture file d'attente des travaux pour ouvrir directement la fiche de l'écriture file d'attente des travaux, par exemple pour modifier sa planification à l'aide des champs standard de file d'attente des travaux de Business Central, ou Arrêter la file d'attente des travaux pour la définir sur En attente.
- Sélectionnez Actualiser le statut pour mettre à jour les champs Statut de la file d'attente des travaux et Dernière exécution de la file d'attente des travaux affichés sur la page de configuration.
L'écriture file d'attente des travaux utilise la file d'attente des travaux standard de Business Central : elle doit donc s'exécuter sous un utilisateur disposant d'autorisations suffisantes, et la file d'attente des travaux de Business Central elle-même doit être active pour l'environnement.
Paramètres généraux
La section Paramètres généraux de Configuration Jira contrôle le traitement des messages :
| Champ | Signification | Valeur par défaut |
|---|---|---|
| Seuil d'actualisation (minutes) | Fréquence d'exécution de l'écriture file d'attente des travaux | 10 |
| Priorité par défaut | Priorité utilisée pour les messages dont la configuration d'entité n'en spécifie pas | 500 |
| Nombre max. de tentatives | Nombre maximal de nouvelles tentatives pour un message en échec avant qu'il ne soit marqué Échec | 5 |
| Délai de nouvelle tentative (minutes) | Délai avant qu'un message planifié pour une nouvelle tentative soit de nouveau traité | 5 |
Le même Seuil d'actualisation détermine également combien de temps un jeton d'accès peut rester inutilisé avant que la file d'attente des travaux ne l'actualise de manière proactive, de sorte que les jetons restent valides entre les exécutions.
Déroulement de chaque exécution
Chaque exécution :
- Actualise le jeton d'accès OAuth2 de chaque configuration OAuth2 activée qui le nécessite.
- Traite les messages en attente et les nouvelles tentatives arrivées à échéance dans l'ordre croissant de Priorité de traitement (numéro le plus petit en premier) - par défaut, les organisations sont traitées avant les clients, et les autres types d'entité suivent la Priorité par défaut.
- Enregistre la progression (COMMIT) tous les 50 messages traités et s'arrête après 1 000 messages, afin qu'une exécution ne puisse pas bloquer la file d'attente des travaux trop longtemps ; les messages restants sont repris lors de l'exécution suivante.
Un message en échec est soit planifié pour une nouvelle tentative (Réessayer) après le Délai de nouvelle tentative configuré, soit marqué Échec une fois le Nombre max. de tentatives atteint - voir Comprendre les messages pour l'ensemble des statuts et les actions possibles.
Statistiques de la file d'attente des messages
Configuration Jira affiche également Total des messages, Messages en attente et Messages en échec, chacun renvoyant vers la vue filtrée correspondante de la File d'attente des messages Jira. Le groupe d'actions Naviguer donne un accès rapide aux pages File d'attente de messages, Configuration OAuth2 et Mappages de table.