JavaScript の機能を最大限に活用し、ファイルのプロパティに基づいて値を動的に計算できます。
標準の JavaScript 演算子を使って、欠落したメタデータにデフォルト値を設定します。
ファイルのサイズ、種類、寸法、任意のメタデータフィールドに応じて、異なる処理を適用します。
開発を加速
ひとつのワークフローで、より多くのファイルに対応できます。
ルールごとに別のサービスを構築せずに、アップロードごとに処理を調整します。
カスタムワークフローの早期提供
式を使って、各ファイルに合わせて処理設定を調整できます。
出力の一貫性を維持
ソースのメタデータから寸法やその他の設定を計算します。
手動判断の削減
ファイルのプロパティに応じて処理ルールを適用するように定義できます。
バックエンドをシンプルに維持
ファイル固有の計算を処理用 Template に移します。
既存設定のさらなる再利用
柔軟に対応できる一つの Template で、さまざまな入力を処理します。
ファイルをプロダクトと連携
ファイルのプロパティと独自のメタデータから出力パスを構築します。
動的なファイル処理
JavaScript 式を使って、インテリジェントな処理パイプラインを作成できます。
動的な寸法
入力ファイルのプロパティに基づいて出力サイズを計算します。
"width": "${file.meta.width * (720 / file.meta.height)}"

フォールバック値
ファイルのメタデータが欠けている場合にデフォルト値を設定します。
"title": "${file.meta.title || 'Untitled'}"

条件分岐
ファイルの種類、サイズ、任意のメタデータフィールドに応じて、異なる処理を適用します。
"resize_strategy": "${file.meta.width > file.meta.height ? 'fit' : 'pad'}"
- ファイル
panorama.jpg
- 寸法
- 3840 × 1080
- リサイズ方式
- fit
- ファイル
portrait.png
- 寸法
- 800 × 1200
- リサイズ方式
- pad
- ファイル
banner.jpg
- 寸法
- 1920 × 400
- リサイズ方式
- fit
- ファイル
avatar.png
- 寸法
- 512 × 512
- リサイズ方式
- pad
- ファイル
cover.jpg
- 寸法
- 2560 × 1440
- リサイズ方式
- fit
- ファイル
headshot.png
- 寸法
- 600 × 900
- リサイズ方式
- pad
- ファイル
hero.jpg
- 寸法
- 1920 × 800
- リサイズ方式
- fit
- ファイル
logo.png
- 寸法
- 256 × 256
- リサイズ方式
- pad
- ファイル
slide.jpg
- 寸法
- 1280 × 720
- リサイズ方式
- fit
- ファイル
icon.png
- 寸法
- 64 × 64
- リサイズ方式
- pad
- ファイル
splash.jpg
- 寸法
- 3000 × 1500
- リサイズ方式
- fit
- ファイル
thumb.png
- 寸法
- 150 × 200
- リサイズ方式
- pad
- ファイル
wallpaper.jpg
- 寸法
- 2560 × 1080
- リサイズ方式
- fit
- ファイル
profile.png
- 寸法
- 400 × 400
- リサイズ方式
- pad
- ファイル
backdrop.jpg
- 寸法
- 4096 × 2160
- リサイズ方式
- fit
- ファイル
stamp.png
- 寸法
- 128 × 128
- リサイズ方式
- pad
- ファイル
feature.jpg
- 寸法
- 1600 × 900
- リサイズ方式
- fit
- ファイル
badge.png
- 寸法
- 96 × 96
- リサイズ方式
- pad
- ファイル
promo.jpg
- 寸法
- 1200 × 630
- リサイズ方式
- fit
- ファイル
photo.png
- 寸法
- 800 × 1067
- リサイズ方式
- pad
思いどおりに制御できるワークフロー
手間のかからないコード評価
複数のスクリプトに処理ルールを重複して記述するのはやめましょう。ファイル処理のロジックは、そのロジックが制御するステップの近くに配置してください。
設定値をその場で計算
対応する処理パラメーターで JavaScript 式を使用します。
ファイルメタデータの活用
式の中で寸法や再生時間などのプロパティを読み取れます。
意味のあるファイル名を生成
利用可能な変数からエクスポート先のパスと名前を生成します。
欠損値への対応
ファイルに含まれていない可能性のあるメタデータには、式の中でフォールバックを定義してください。
カスタムルールによるファイルの振り分け
式とファイルフィルターを組み合わせて、次の処理工程を選択します。
保存済み Template の再利用
アップロードとバッチジョブの処理設定を一か所にまとめます。
処理結果を確認
Assembly のステータスとエラーを使って、ファイルに依存する動作をデバッグします。
各 Assembly の完了を把握
Assembly の終了時に Transloadit からサーバーに通知を送り、その後ステータスを確認して結果やエラーを把握してください。
支出の抑制
通知を受け取るソフト請求上限、または到達すると新しい Assembly を拒否するハード請求上限を設定します。
よくある質問
ファイルのワークフローでコード評価は何をしますか?
動的評価では、JavaScript 式を使い、ファイルのプロパティやその他の利用可能な変数から処理パラメーターを計算できます。たとえば、リサイズ後の幅を元画像の寸法に応じて設定できます。まずは動的評価ガイドをご覧ください。
JavaScript サービスを別途デプロイする必要はありますか?
Assembly Instructions 内の対応する式を評価するために、別のサービスを用意する必要はありません。Transloadit が処理の一環として評価します。汎用アプリケーションのホスティングではなく、ファイルワークフローのロジック向けに設計されています。スクリプト Robot の仕組みをご覧ください。
式ではどのファイルプロパティを使用できますか?
利用可能な Assembly Variables を使用してください。対応している場合は、ファイルのメタデータや独自のユーザーメタデータも利用できます。値は入力ファイルや処理の段階によって異なるため、省略可能なフィールドにはフォールバック値を用意してください。Assembly Variables の詳細を見る。
式を使って処理対象のファイルを選べますか?
はい。ファイルフィルターで式を使ってファイルを受け入れるか拒否するかを決め、受け入れたファイルを後続の処理につなげます。JavaScript が不要な場合は、シンプルな配列条件も使えます。ファイルフィルタリングのオプションをご覧ください。
ファイル名やストレージのパスを動的に作成できますか?
はい。対応するパスパラメーターで利用可能な変数や式を使うと、ファイルのプロパティやアプリケーションのメタデータに応じて出力を整理できます。ご利用のストレージプロバイダーに対応するエクスポート用 Robot のパスの動作を確認してください。S3 エクスポートのオプションを見る。
式の評価はどのように課金されますか?
単純な Assembly Variable の参照は無料です。ロジックや関数を含む式は、スクリプト実行 Robot を呼び出すため、使用料金が発生します。スクリプト実行 Robot と料金をご確認ください。
コストを見積もり、管理するにはどうすればよいですか?
料金は処理内容と使用量によって異なります。ソフト請求上限に達すると通知が送信され、ハード上限に達すると新しい Assembly は拒否されます。ワークロードが大きい場合は、ボリューム料金と追加の優先スロットについてご相談ください。ワークフローのコストを見積もる。
