処理パイプラインにロジックを追加

JavaScript の式を使い、処理ステップ内で値の計算、フォールバックの設定、条件分岐をすべてインラインで記述できます。

クレジットカード不要
アップロード済みファイル
panorama.jpg横長
story_reel.png縦長
cover_art.jpg横長
headshot.png縦長
hero_banner.jpg横長
JavaScript 式

JavaScript の機能を最大限に活用し、ファイルのプロパティに基づいて値を動的に計算できます。

フォールバック値

標準の JavaScript 演算子を使って、欠落したメタデータにデフォルト値を設定します。

条件分岐

ファイルのサイズ、種類、寸法、任意のメタデータフィールドに応じて、異なる処理を適用します。

開発を加速

ひとつのワークフローで、より多くのファイルに対応できます。

ルールごとに別のサービスを構築せずに、アップロードごとに処理を調整します。

カスタムワークフローの早期提供

式を使って、各ファイルに合わせて処理設定を調整できます。

出力の一貫性を維持

ソースのメタデータから寸法やその他の設定を計算します。

手動判断の削減

ファイルのプロパティに応じて処理ルールを適用するように定義できます。

バックエンドをシンプルに維持

ファイル固有の計算を処理用 Template に移します。

既存設定のさらなる再利用

柔軟に対応できる一つの Template で、さまざまな入力を処理します。

ファイルをプロダクトと連携

ファイルのプロパティと独自のメタデータから出力パスを構築します。

ユースケース

動的なファイル処理

JavaScript 式を使って、インテリジェントな処理パイプラインを作成できます。

動的な寸法

入力ファイルのプロパティに基づいて出力サイズを計算します。

"width": "${file.meta.width * (720 / file.meta.height)}"
bird.webp
1600 × 1200
幅960

フォールバック値

ファイルのメタデータが欠けている場合にデフォルト値を設定します。

"title": "${file.meta.title || 'Untitled'}"
photo.jpg
3.8 MB · 4032 × 3024
タイトル"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 を拒否するハード請求上限を設定します。

Transloadit を試す

状況に応じて変化するファイル処理ワークフロー

式とファイルのメタデータを使って、Assembly Instructions 内の処理値を選択します。

ハードコードされた処理値
動的な式
メタデータ不足によるエラー
フォールバック値
一律の処理
条件分岐
複雑な寸法計算
数式
固定の出力ファイル名
動的パステンプレート
柔軟性に欠けるワークフロー
Assembly Instructions 内での式の評価
GDPR
HIPAA
ISO 27001ISO27001
AES-256
SOC 2 Type II
クレジットカード不要

よくある質問

ファイルのワークフローでコード評価は何をしますか?

動的評価では、JavaScript 式を使い、ファイルのプロパティやその他の利用可能な変数から処理パラメーターを計算できます。たとえば、リサイズ後の幅を元画像の寸法に応じて設定できます。まずは動的評価ガイドをご覧ください。

JavaScript サービスを別途デプロイする必要はありますか?

Assembly Instructions 内の対応する式を評価するために、別のサービスを用意する必要はありません。Transloadit が処理の一環として評価します。汎用アプリケーションのホスティングではなく、ファイルワークフローのロジック向けに設計されています。スクリプト Robot の仕組みをご覧ください。

式ではどのファイルプロパティを使用できますか?

利用可能な Assembly Variables を使用してください。対応している場合は、ファイルのメタデータや独自のユーザーメタデータも利用できます。値は入力ファイルや処理の段階によって異なるため、省略可能なフィールドにはフォールバック値を用意してください。Assembly Variables の詳細を見る。

式を使って処理対象のファイルを選べますか?

はい。ファイルフィルターで式を使ってファイルを受け入れるか拒否するかを決め、受け入れたファイルを後続の処理につなげます。JavaScript が不要な場合は、シンプルな配列条件も使えます。ファイルフィルタリングのオプションをご覧ください。

ファイル名やストレージのパスを動的に作成できますか?

はい。対応するパスパラメーターで利用可能な変数や式を使うと、ファイルのプロパティやアプリケーションのメタデータに応じて出力を整理できます。ご利用のストレージプロバイダーに対応するエクスポート用 Robot のパスの動作を確認してください。S3 エクスポートのオプションを見る。

式の評価はどのように課金されますか?

単純な Assembly Variable の参照は無料です。ロジックや関数を含む式は、スクリプト実行 Robot を呼び出すため、使用料金が発生します。スクリプト実行 Robot と料金をご確認ください。

コストを見積もり、管理するにはどうすればよいですか?

料金は処理内容と使用量によって異なります。ソフト請求上限に達すると通知が送信され、ハード上限に達すると新しい Assembly は拒否されます。ワークロードが大きい場合は、ボリューム料金と追加の優先スロットについてご相談ください。ワークフローのコストを見積もる。