CloudConvert モジュール
Adobe Workfront Fusion のシナリオでは、CloudConvert を使用するワークフローを自動化し、それを複数のサードパーティのアプリケーションやサービスに接続できます。CloudConvert モジュールを使用すると、CloudConvert アカウントで業務、タスクを監視および管理し、ファイルを読み出しおよび書き出すことができます。
CloudConvert API 情報
CloudConvert コネクタは以下を使用します。
CloudConvert を Workfront Fusion に接続 connect-cloudconvert-to-workfront-fusion
CloudConvert アカウントを Workfront Fusion に接続するには、CloudConvert アカウントから API キーを取得する必要があります。
-
CloudConvert のアカウントにログインし、ダッシュボードを開きます。
-
認証／「API キー」セクションを開きます。
-
「API キーを新規作成」をクリックします。
-
API キーの名前を入力し、使用するスコープを有効にして、さらに「作成」をクリックします。
-
提供されたトークンをコピーし、安全な場所に保存します。
-
Workfront Fusion で、シナリオの作成を開始し、CloudConvert モジュールの 接続を作成 ダイアログを開きます。
手順については Adobe Workfront Fusion でシナリオを作成を参照してください。
-
手順 5 で保存したトークンを入力し、続いて「続行」をクリックして接続を確立します。
CloudConvert モジュールとそのフィールド cloudconvert-modules-and-their-fields
CloudConvert モジュールを設定する際、Workfront Fusion に以下のフィールドが表示されます。これらに加えて、アプリまたはサービスのアクセスレベルなどの要因に応じて、追加の CloudConvert フィールドが表示される場合があります。モジュール内の太字のタイトルは、必須フィールドを示します。
フィールドまたは関数の上にマップボタンが表示されている場合は、このボタンを使用すると、そのフィールドの変数や関数を設定できます。詳しくは、 Adobe Workfront Fusion で 1 つのモジュールから別のモジュールに情報をマッピングを参照してください。
一般的なタスク
Web サイトをキャプチャ
このアクションモジュールは、指定された web サイトをキャプチャし、PDF、JPG、または PNG 形式で保存します。
Web サイトの URL と、情報の保存場所などのその他の情報を指定します。
このモジュールは、ファイルの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
ファイルを変換
ファイルを選択した出力形式に変換します。
アーカイブを作成
ZIP、RAR、7Z、TAR、TAR.GZ または TAR.BZ2 アーカイブに 1 つまたは複数のファイルを追加できます。
ファイルを結合
2 つ以上のファイルを 1 つの PDF に結合します。入力ファイルが PDF 以外の場合、入力ファイルは自動的に PDF に変換されます。
ファイルの最適化
このアクションモジュールは、ファイルを PDF、PNG、または JPG 形式で最適化および圧縮します。
ファイルと、最適化および保存のためのパラメーターを指定します。
このモジュールは、ファイルの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
ジョブ
ジョブの作成（詳細）
このモジュールではジョブを作成します。ジョブは、「名前」フィールドで識別され、「入力」フィールドを使用して相互にリンクされる 1 つまたは複数のタスクです。
業務を削除
このモジュールは、すべてのタスクとデータを含む業務を削除します。
業務を取得
このモジュールは、業務の詳細を取得します。
業務をリスト
このモジュールは、アカウントで実行されたすべての業務を取得します。
新しい業務イベント
アカウントまたはタスク内の業務が作成、終了、失敗したときにトリガーされます。
- 業務の作成（詳細）モジュールで作成した業務は、複数の タスクで構成されています。
- 新しい業務イベントのトリガーは、個人 のタスクが作成されたか、完了したか、失敗ときも起動します。
-
配列アグリゲーターを使用する場合（変換するファイルが異なる形式で多数ある場合）、タスクを追加ダイアログにある 入力形式がわかりません のオプションを使用します。それ以外の場合は、エラーが返されます。
-
業務内のタスクをリンクしています（名前／入力、名前／入力、…）：
タスク
タスクをキャンセル
このモジュールは、ステータスが「待機中」または「処理中」のタスクをキャンセルします。
タスクを削除
すべてのデータを含むタスクを削除します。
ファイルをダウンロード
このモジュールは、指定されたタスクからファイル名とファイルデータを取得します。
タスクを取得
このモジュールは、タスクの詳細を取得します。
タスクをリスト
このモジュールは、フィルター設定に基づいて、アカウント内のすべてのタスクを取得します。
タスクを再試行
このモジュールは、別のタスクの設定（ペイロード）に基づいて、タスクを新規作成します。
その他
ユーザー情報を取得
現在のユーザーに関する認証済みアカウントの詳細を取得します。
API 呼び出しを実行
カスタム API 呼び出しを実行できます。
API 呼び出しの設定に必要な HTTP リクエストメソッドを選択します。詳しくは、Adobe Workfront Fusionでの HTTP リクエストメソッドを参照してください。
https://api.cloudconvert.com/ への相対パスを入力します。例： /v2/tasks
使用可能なエンドポイントのリストについては、CloudConvert API v2 ドキュメントを参照してください。
リクエストのヘッダーを標準 JSON オブジェクトの形式で追加します。
例： {"Content-type":"application/json"}
Workfront Fusion 2.0 により、認証ヘッダーが追加されます。
API 呼び出しのクエリを標準 JSON オブジェクトの形式で追加します。
例： {"name":"something-urgent"}
if などの条件ステートメントを使用する場合、条件ステートメントの外側に引用符を置きます。
例： タスクをリスト
次の API 呼び出しは、CloudFront アカウントからすべてのタスクを返します。
URL：/v2/tasks
メソッド：GET
一致した検索結果は、バンドル／本文／データ下のモジュールの出力に表示されます。
この例では、次の 6 つのタスクが返されました。
トラブルシューティング troubleshooting
起こりうるエラーとその解決策については、次の表を参照してください。
RuntimeError:
Maximum number of repeats exceeded.
該当する CloudConvert のジョブを CloudConvert ダッシュボードのジョブリストで見つけ、ジョブの期間を確認します。
CloudConvert／Convert a File モジュールのタイムアウトが 3 分に設定されています。ジョブの期間が 3 分を超える（おそらくは CloudConvert サービスの一時的な過負荷によるもの）場合、モジュールは上記のエラーを返します。
この場合、次のいずれかのオプションを検討します。
- シナリオ設定で Allow storing of Incomplete Executions オプションを有効にして、不完全な実行を保存しておき、後で手動で解決できるようにします。オプションで、Break ディレクティブと一緒にエラー処理ルートを CloudConvert モジュールにアタッチし、不完全な実行を自動的に解決することも可能です。
- CloudConvert／Convert a file モジュールで Download a file option オプションを無効にします。この場合、モジュールは変換結果を待ちません。変換結果を取得するには、新しいシナリオを作成し、CloudConvert／New Job Event トリガーを使用します。
CloudConvert コネクタのワークフローの例
-
「ファイルを選択」をクリックして、サンプルの MOV ファイルを選択します。
-
「変換先」の横にあるドロップダウンをクリックし、「MP4」を選択します。
-
レンチ アイコンをクリックします。
-
必要に応じて、MP4 圧縮設定を指定します。
-
「変換」をクリックします。
-
変換処理が完了したら、「ダウンロード」をクリックします。
-
変換後のビデオを確認します。
-
手順 5 の最適な変換設定が見つかるまで、手順 1 ～ 8 を繰り返します。
-
https://cloudconvert.com/api/v2/convert#convert-tasksに移動します。
-
「input_format」フィールドで「mov」を選択します。
-
「output_format」フィールドで「mp4」を選択します。
-
video_codec、crf など、使用可能なすべてのパラメーターのリストが。表示されます。
-
Workfront Fusion 2.0 で、シナリオに CloudConvert／ファイルを変換 モジュールを挿入します。
-
モジュールの設定を開きます。
-
以下のようにモジュールを設定します。
-
必ず、「コンバージョンとエンジン固有のオプション」フィールドのすべての設定を含めてください。手順 5 の各設定で、手順 13 の対応するパラメーターとそれに対応する値を探します。