Transloadit

Was ist eine Assembly Variable?

Eine Transloadit Assembly Variable ist ein Platzhalter wie ${file.original_basename}, der während der Verarbeitung aufgelöst wird. Robots verwenden diese Werte, um ihr Verhalten an die aktuelle Datei, übermittelte Felder oder den Assembly-Kontext wie ${assembly.id} und ${unique_prefix} anzupassen.

So funktionieren Assembly Variables

Variablen sind Ausdrücke, die anhand des Laufzeitkontexts ausgewertet werden, wenn ein Robot Werte benötigt, die beim Erstellen des Templates noch unbekannt sind. Ihre Namensräume stellen Dateiattribute, übermittelte Felder und Werte auf Assembly-Ebene wie Kennungen und eindeutige Präfixe bereit. So kann ein Graph Namen und Optionen für jede Eingabe anpassen. Sie unterscheiden sich von literalen Parametern, weil die Ersetzung während der Ausführung erfolgt und je nach Datei unterschiedlich ausfallen kann. Der aufgelöste Wert fließt in Pfade oder Robot-Einstellungen ein. Daher sind sein Typ, die zulässigen Zeichen und das Verhalten bei fehlendem Wert wichtig.

Wichtige Fakten

  1. Dateibezogene Variablen können für jedes Element einer Assembly unterschiedlich aufgelöst werden. Das ermöglicht eine Benennung je Quelldatei, kann aber auch zu Kollisionen führen, wenn sich Basisnamen wiederholen.
  2. Felder liefern den Instructions anfragespezifische Daten, ohne das Template zu ändern: Sie können als Formularfelder mit dem Upload übermittelt oder programmatisch im Parameter fields gesetzt werden. Bei Konflikten haben die per Formular übermittelten Werte Vorrang. Sie bleiben nicht vertrauenswürdige Eingaben und müssen vor sicherheitskritischer Verwendung validiert werden.
  3. Ein fehlender oder fehlerhaft formatierter Wert kann in einen Robot-Parameter oder Ausgabepfad einfließen. Integrationen sollten das Fallback-Verhalten testen, statt vorauszusetzen, dass jede Datei jedes Feld bereitstellt.

Wann Assembly Variables relevant sind

Verwenden Sie Variablen, wenn Ausgabenamen oder Robot-Optionen ohne separate Instructions von datei- oder anfragespezifischen Daten abhängen müssen. Bereinigen Sie Werte, die in Pfaden oder Namen verwendet werden, da unerwartete Eingaben ungültige oder miteinander kollidierende Ausgaben erzeugen können.

Machen Sie aus Medienwissen eine funktionierende Pipeline

Verbinden Sie Uploads, Verarbeitung, KI, Storage und Auslieferung über eine deklarative API – um Encoding-Stack, Skalierung und ständig wechselnde Formate müssen Sie sich nicht selbst kümmern.

Transloadit kostenlos ausprobieren