Assembly Variable とは何ですか?
Transloadit の Assembly Variable は、${file.original_basename} のような、処理中に値が解決されるプレースホルダーです。Robots はこれらの値を使用して、現在のファイル、送信されたフィールド、または ${assembly.id} や ${unique_prefix} などの Assembly レベルのコンテキストに基づいて動作を調整します。
Assembly Variable の仕組み
変数は、Template 作成時には分からない値が Robot に必要なときに、実行時のコンテキストに基づいて評価される式です。変数の名前空間からは、ファイル属性、送信されたフィールド、識別子や一意のプレフィックスなどの Assembly レベルの値を参照できます。これにより、一つのグラフで入力ごとに名前やオプションを変えられます。実行中に展開され、ファイルごとに値が異なる場合がある点で、リテラルのパラメーターとは異なります。解決された値はパスや Robot の設定に渡されるため、その型、使用可能な文字、値がない場合の動作が重要です。
要点
- ファイルスコープの変数は、一つの Assembly 内でも項目ごとに異なる値に解決されることがあります。これによりソースごとの命名が可能になりますが、ベース名が重複すると名前の衝突が起きる場合もあります。
- フィールドを使うと、Template を変更せずにリクエスト固有のデータを処理設定に渡せます。アップロード時にフォームフィールドとして送信するか、
fieldsパラメーターでプログラムから設定できます。値が競合した場合は、フォームで送信した値が優先されます。これらは信頼できない入力であり、機密性の高い処理に使用する前に検証が必要です。 - 欠落した値や不正な形式の値が、Robot のパラメーターや出力パスにそのまま渡ることがあります。連携を実装する際は、すべてのファイルにすべてのフィールドがあると想定せず、フォールバックの動作をテストしてください。
Assembly Variable が重要になる場面
処理設定を別に用意せず、ファイルやリクエストごとのデータに応じて出力名や Robot のオプションを変える場合は、変数を使用してください。想定外の入力によって無効な出力や競合する出力が生成されることがあるため、パスや名前に使う値はサニタイズしてください。