Qu’est-ce que l’Assembly Status ?
L’Assembly Status de Transloadit est la représentation JSON d’une Assembly. Il comprend l’identifiant de l’Assembly, les téléversements, les résultats, les durées d’exécution et les informations nécessaires pour localiser les fichiers de résultat.
Fonctionnement de l’Assembly Status
La représentation du statut est l’instantané de référence d’un traitement au moment où elle est produite. Transloadit utilise ce format unique dans les réponses de création d’Assemblies, à l’URL de statut et dans les données des notifications. Il rassemble l’état du cycle de vie, les données temporelles, les enregistrements d’entrée, les sorties des Steps, les erreurs et les emplacements des résultats dans un document lisible par machine. Les instantanés intermédiaires peuvent évoluer à mesure que les branches se terminent, tandis que les instantanés finaux permettent une ingestion durable des résultats. Un backend normalise généralement ce document selon son propre modèle de tâches et conserve les identifiants pour les diagnostics du support.
Points clés
- 1Les fichiers téléversés et les résultats générés constituent des collections distinctes dans la réponse, ce qui permet aux clients de distinguer les enregistrements sources soumis des fichiers dérivés produits par les Steps.
- 2Les entrées de résultats sont organisées par nom de Step. Les systèmes qui les exploitent devraient donc se rattacher à la branche prévue du processus plutôt que de supposer que le premier fichier renvoyé est la ressource souhaitée.
- 3Les clients qui procèdent par interrogation périodique doivent reconnaître explicitement les états finaux de réussite et d’échec ; la présence de métadonnées partielles ou de quelques fichiers de résultat ne prouve pas la réussite de l’ensemble du graphe.
Quand l’Assembly Status est important
Récupérez-le depuis l’URL de statut de l’Assembly pour examiner son état d’achèvement, collecter les URL des résultats ou diagnostiquer un Step ayant échoué. Le même document est renvoyé lors de la création d’une Assembly et transmis dans les Assembly Notifications. Ne considérez pas un instantané de traitement inachevé comme définitif et traitez les états d’échec finaux avant d’utiliser les sorties.