Robot Parameter とは?
Robot Parameter は、画像リサイズ用 Step の width のように、Transloadit の Robot の動作を設定します。Assembly Instructions では、use などの共通の Step パラメータも使用して、Step をそのワークフローの入力に接続します。
Robot Parameter の仕組み
Robot Parameter は、Assembly Step の処理設定のうち、操作に固有の部分を構成します。寸法、形式、コーデック、メタデータの扱い、出力先の設定などの動作を選択します。使用できるキーと値の型は選択した Robot によって定義されますが、use などの共通キーは入力の選択を記述し、すべての Robot で共有されます。パラメーターは Assembly の実行時に解決され、再現可能な処理設定の一部となります。
要点
- 同じパラメーター名が複数の Robot で使われていても、受け付ける値、デフォルト値、単位が同じとは限りません。検証には、対象の Robot のドキュメントを使用する必要があります。
- パラメーターを省略すると、Robot が定義したデフォルト値が適用されることがあります。これは、空文字列、ゼロ、false、その他の明示的な値を送信する場合とは、観測できる動作が異なります。
- Template に基づく Assembly ではパラメーターセットを一元管理でき、リクエスト時のフィールドを使えば、ワークフローグラフ全体を複製せずに、制御された範囲で変更を加えられます。
Robot Parameter が重要になる場面
Robot 固有のパラメーターで処理ステップの出力を制御し、共通のステップパラメーターでワークフロー内の接続方法を制御します。ある Robot で有効なパラメーターでも、別の Robot ではサポートされていなかったり、意味が異なったりする場合があります。