Was ist der Template Editor?
Der Template Editor ist eine Oberfläche im Transloadit-Konto zum Erstellen und Ändern von Templates. In seinem Code-Editor werden Assembly Instructions verfasst, das deklarative JSON, das einen Workflow zur Dateiverarbeitung definiert.
So funktioniert der Template Editor
Der Template Editor von Transloadit bietet eine verwaltete Umgebung zum Erstellen von Assembly Instructions im JSON-Format, die einen Assembly-Workflow definieren. Er kann bei der Syntax und den verfügbaren Vorgängen helfen. Wer die Instructions erstellt, bestimmt weiterhin Step-Namen, Abhängigkeiten, Parametertypen und den Ausgabefluss. Die Bearbeitung ist daher sowohl eine Konfigurationsaufgabe als auch eine Änderung an einer produktiven Abhängigkeit mit API-Anbindung. Teams nutzen die Oberfläche für den Workflow-Entwurf und die Fehleranalyse und validieren anschließend repräsentative Dateien, bevor sie eine überarbeitete Fassung für aufrufende Anwendungen bereitstellen.
Wichtige Fakten
- 1Gültiges JSON belegt nur, dass sich das Dokument parsen lässt. Verweise können weiterhin auf den falschen Step zeigen, Parameter können semantisch ungültig sein und Ausgaben von den Erwartungen einer aufrufenden Anwendung abweichen.
- 2Tests sollten jede akzeptierte Eingabekategorie und wichtige Fehlerpfade abdecken, da medienabhängige Verzweigungen möglicherweise nicht ausgeführt werden, wenn der Editor mit nur einer repräsentativen Datei ausprobiert wird.
- 3Gleichzeitige oder undokumentierte Änderungen können das Zurücksetzen erschweren. Der Export geprüfter Definitionen oder eine gleichwertige Versionshistorie außerhalb der Oberfläche verbessert daher die Nachvollziehbarkeit.
Wann der Template Editor wichtig ist
Prüfen und überarbeiten Sie Workflow-Steps im Editor und stellen Sie dabei sicher, dass das resultierende JSON gültig bleibt. Auch eine syntaktisch korrekte Änderung kann Abhängigkeiten zwischen Steps oder deren Ausgaben verändern. Testen Sie Änderungen daher vor dem Einsatz im Produktivbetrieb.