Was ist Assembly Status?
Der Transloadit Assembly Status ist die JSON-Darstellung einer Assembly. Er enthält die Kennung, Uploads, Ergebnisse, Ausführungszeiten und die Informationen, die zum Auffinden von Ergebnisdateien benötigt werden.
So funktioniert Assembly Status
Die Statusdarstellung ist die maßgebliche Momentaufnahme eines Verarbeitungsauftrags zum Zeitpunkt ihrer Erstellung. Transloadit verwendet dieses einheitliche Format in den Antworten beim Erstellen einer Assembly, unter der Status-URL und in den Nutzdaten der Assembly Notifications. Es vereint Lebenszyklusstatus, Zeitangaben, Eingabedatensätze, Step-Ausgaben, Fehler und Speicherorte der Ergebnisse in einem maschinenlesbaren Dokument. Zwischenstände können sich ändern, wenn Zweige fertig werden, während abschließende Momentaufnahmen die dauerhafte Übernahme der Ergebnisse unterstützen. Ein Backend überführt dieses Dokument üblicherweise in die einheitliche Struktur seines eigenen Auftragsmodells und bewahrt Kennungen für die Supportdiagnose auf.
Wichtige Fakten
- 1Uploads und erzeugte Ergebnisse bilden getrennte Datensammlungen in der Antwort. So können Clients eingereichte Quelldatensätze von abgeleiteten Dateien unterscheiden, die durch Steps erzeugt wurden.
- 2Ergebniseinträge sind nach Step-Namen geordnet. Nutzende Anwendungen sollten daher gezielt den vorgesehenen Workflow-Zweig referenzieren, statt anzunehmen, die erste zurückgegebene Datei sei das gewünschte Asset.
- 3Clients mit Polling müssen endgültige Erfolgs- und Fehlerzustände explizit erkennen; teilweise vorhandene Metadaten oder einzelne Ergebnisdateien belegen nicht, dass der gesamte Graph erfolgreich ausgeführt wurde.
Wann Assembly Status wichtig ist
Rufen Sie das Dokument über die Status-URL der Assembly ab, um den Abschluss zu prüfen, Ergebnis-URLs zu sammeln oder die Fehlerursache bei einem fehlgeschlagenen Step zu ermitteln. Dasselbe Dokument wird beim Erstellen einer Assembly zurückgegeben und in Assembly Notifications übermittelt. Behandeln Sie eine noch nicht abgeschlossene Momentaufnahme nicht als endgültig und berücksichtigen Sie endgültige Fehlerzustände, bevor Sie Ausgaben verwenden.