Intégration et exploitation
Files de messages : réception, traitement et reprise des dossiers
Un message reçu peut attendre un traitement, être repris ou revenir après un délai. Le suivi doit relier le message à son effet métier et à la preuve de sa fin, sans supposer que la réception garantit une exécution unique.
Ce que documentent les sources
La documentation décrit un message reçu qui reste dans la file mais devient temporairement invisible ; sans suppression à temps, il peut redevenir visible. La livraison au moins une fois peut produire des doublons.
Amazon SQS : délai de visibilité — consulté le . Comportement SQS documenté ; aucun service cloud créé ni délai standard recommandé pour un dossier de voyage.
Nommer le message et son effet attendu
Conservez type d’événement, référence métier, identité du message et version utile. Une confirmation, une tâche de support et une mise à jour de catalogue demandent des traitements différents. Faites préciser le système qui produit l’événement et celui qui décide de son effet. Le journal doit montrer si la réception a seulement commencé un travail ou si la décision a réellement été appliquée.
Protéger la reprise contre un double effet
Définissez comment retrouver un effet déjà exécuté avant de le reproduire. Un nouveau reçu ou une nouvelle tentative ne constitue pas toujours un nouveau besoin métier. Préparez des exemples fictifs de message répété et de traitement interrompu après action. La preuve attendue concerne le dossier : une seule modification voulue, une réponse récupérable et une décision claire lorsque l’état est encore inconnu.
Traiter les erreurs persistantes avec une responsabilité
Le délai de visibilité doit être rapproché du traitement effectif et de sa surveillance. Documentez les reprises autorisées, les erreurs qui exigent une intervention et le circuit prévu pour les messages persistants. Une file d’erreurs ne résout pas le dossier ; elle rend nécessaire un responsable, une explication et une suite. Conservez la trace de la reprise sans exposer le contenu personnel des voyageurs.
Deux situations à rapprocher
Le traitement réussit avant une interruption
Scénario fictif : la tâche modifie un dossier puis s’arrête avant la fin du circuit de message. La prochaine tentative doit retrouver l’effet existant plutôt que le reproduire sur la seule présence du message.
Le même échec se répète
Scénario fictif : une référence inconnue provoque plusieurs reprises. Faites attribuer l’erreur à un responsable et définir la preuve nécessaire à sa correction ; augmenter le nombre de tentatives ne crée pas la référence manquante.
Conserver la décision et sa prochaine suite
| Point | Preuve à retrouver | Contrôle proposé |
|---|---|---|
| Identité | Message, événement et dossier | Rapprocher le besoin métier. |
| Réception | Heure et tentative | Ne pas annoncer un effet à cette étape. |
| Traitement | Opération et état retrouvé | Vérifier ce qui a effectivement changé. |
| Doublon | Effet déjà appliqué | Empêcher sa répétition involontaire. |
| Visibilité | Délai et durée observée | Adapter la surveillance au circuit retenu. |
| Fin | Résultat et action sur le message | Distinguer dossier terminé et message reçu. |
| Erreur | Motif et reprises | Identifier les échecs persistants. |
| Responsable | Suite et preuve attendue | Conserver une décision retrouvable. |
Le traitement utile donne une preuve du résultat métier et de la décision sur le message. Les états inconnus restent investigables avant toute reprise pouvant produire un second effet. La file et ses délais ne remplacent ni la protection du dossier ni la responsabilité d’exploitation.
Erreurs à éviter
- Assimiler réception et traitement terminé.
- Supposer qu’un message ne peut être livré qu’une fois.
- Laisser une file d’erreurs sans responsable de reprise.
La fiche de contrôle permet de suivre les points à confirmer. Le registre associé conserve le périmètre, les preuves et la décision ; ses champs peuvent être remplis dans l’atelier avec des données fictives ou anonymisées.
Nommer les points du dossier
- Visibilité d’un message en file : Disponibilité d’un message pour sa réception selon le circuit et le délai configurés.
- Preuve d’effet d’un message : Trace permettant de retrouver le résultat métier d’une tentative de traitement.
- Reprise d’un message interrompu : Nouvelle tentative dont la décision tient compte de l’état déjà atteint.
- Responsable d’une erreur en file : Rôle chargé d’investiguer et de décider la suite d’un message en échec persistant.
Sources et périmètre des faits documentés
La date de consultation figure avec chaque référence. Les méthodes d’essai et recommandations de ce guide sont éditoriales ; les conditions d’accès et d’usage se vérifient dans la documentation actuelle.
- Amazon SQS : délai de visibilité — Comportement SQS documenté ; aucun service cloud créé ni délai standard recommandé pour un dossier de voyage. (consultée le )
Questions fréquentes
Questions utiles avant de décider
Un message invisible a-t-il disparu ?
Dans le comportement documenté, il reste temporairement indisponible à la réception ; sa fin doit être rapprochée du circuit de suppression et du traitement.
Pourquoi tester un doublon ?
Pour vérifier que la reprise retrouve l’effet déjà appliqué et ne crée pas une seconde action involontaire.
Une file d’erreurs clôture-t-elle l’incident ?
Il faut encore attribuer une suite, résoudre le motif et conserver le résultat de la reprise.