CloudConvert モジュール
Adobe Workfront Fusion のシナリオでは、CloudConvert を使用するワークフローを自動化し、それを複数のサードパーティのアプリケーションやサービスに接続できます。CloudConvert モジュールを使用すると、CloudConvert アカウントで業務、タスクを監視および管理し、ファイルを読み出しおよび書き出すことができます。
CloudConvert API 情報
CloudConvert コネクタは以下を使用します。
CloudConvert を Workfront Fusion に接続 connect-cloudconvert-to-workfront-fusion
CloudConvert アカウントを Workfront Fusion に接続するには、CloudConvert アカウントから API キーを取得する必要があります。
-
CloudConvert アカウントにログインし、Dashboard を開きます。
-
Authorization/API Keys セクションを開きます。
-
Create New API key をクリックします。
-
API キーの名前を入力し、使用する範囲を有効にして、「Create」をクリックします。
-
提供されたトークンをコピーし、安全な場所に保存します。
-
Workfront Fusion で、シナリオの作成を開始し、CloudConvert モジュールの Create a connection ダイアログを開きます。
手順については Adobe Workfront Fusion でシナリオを作成を参照してください。
-
手順 5 で保存したトークンを入力し、「Continue」をクリックして接続を確立します。
CloudConvert モジュールとそのフィールド cloudconvert-modules-and-their-fields
CloudConvert モジュールを設定する際、Workfront Fusion に以下のフィールドが表示されます。これらに加えて、アプリまたはサービスのアクセスレベルなどの要因に応じて、追加の CloudConvert フィールドが表示される場合があります。モジュール内の太字のタイトルは、必須フィールドを示します。
フィールドまたは関数の上にマップボタンが表示されている場合は、このボタンを使用すると、そのフィールドの変数や関数を設定できます。詳しくは、 モジュール間で情報をマッピングするを参照してください。
一般的なタスク
Capture a Website
このアクションモジュールは、指定された web サイトをキャプチャし、PDF、JPG、または PNG 形式で保存します。
Web サイトの URL と、情報の保存場所などのその他の情報を指定します。
このモジュールは、ファイルの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
Convert a file
ファイルを選択した出力形式に変換します。
Create an Archive
ZIP、RAR、7Z、TAR、TAR.GZ または TAR.BZ2 アーカイブに 1 つまたは複数のファイルを追加できます。
Merge Files
2 つ以上のファイルを 1 つの PDF に結合します。入力ファイルが PDF 以外の場合、入力ファイルは自動的に PDF に変換されます。
Optimize a File
このアクションモジュールは、ファイルを PDF、PNG、または JPG 形式で最適化および圧縮します。
ファイルと、最適化および保存のためのパラメーターを指定します。
このモジュールは、ファイルの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
ジョブ
Create a Job (advanced)
このモジュールではジョブを作成します。1 つのジョブは、「Name」フィールドで識別され、「Input」フィールドを使用して相互にリンクされる 1 つまたは複数のタスクにすることができます。
Delete a Job
このモジュールは、すべてのタスクとデータを含む業務を削除します。
Get a Job
このモジュールは、業務の詳細を取得します。
List Jobs
このモジュールは、アカウントで実行されたすべての業務を取得します。
New Job Event
アカウントまたはタスク内の業務が作成、終了、失敗したときにトリガーされます。
- Create a Job (advanced) モジュールで作成されるジョブは、複数 のタスクで構成されます。
- New Job Event トリガーは、個人 タスクが作成されたとき、完了したとき、または失敗したときにもトリガーされます。
-
配列アグリゲータを操作する場合（変換するファイルの形式が異なるなど）、Add a task のダイアログで I don’t know the input format オプションを使用します。 それ以外の場合は、エラーが返されます。
-
業務内のタスクをリンクしています（名前／入力、名前／入力、…）：
タスク
Cancel a Task
このモジュールは、ステータスが「待機中」または「処理中」のタスクをキャンセルします。
Delete a Task
すべてのデータを含むタスクを削除します。
Download a File
このモジュールは、指定されたタスクからファイル名とファイルデータを取得します。
Get a Task
このモジュールは、タスクの詳細を取得します。
List Tasks
このモジュールは、フィルター設定に基づいて、アカウント内のすべてのタスクを取得します。
Retry a Task
このモジュールは、別のタスクの設定（ペイロード）に基づいて、タスクを新規作成します。
その他
Get My Info
現在のユーザーに関する認証済みアカウントの詳細を取得します。
Make an API Call
カスタム API 呼び出しを実行できます。
API 呼び出しの設定に必要な HTTP リクエストメソッドを選択します。詳しくは、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
検索の一致は、モジュールの出力の Bundle > Body > data で見つけることができます。
この例では、次の 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」オプションを無効にします。 この場合、モジュールは変換結果を待ちません。コンバージョン結果を取得するには、新しいシナリオを作成し、CloudConvert/New Job Event トリガーを使用します。
CloudConvert コネクタのワークフローの例
-
Select File をクリックして、サンプルの MOV ファイルを選択します。
-
「Convert to」の横にあるドロップダウンをクリックし、「MP4」を選択します。
-
wrench アイコンをクリックします。
-
必要に応じて、MP4 圧縮設定を指定します。
-
Convert をクリックします。
-
変換が完了したら、「Download」をクリックします。
-
変換後のビデオを確認します。
-
手順 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/Convert a File モジュールをシナリオに挿入します。
-
モジュールの設定を開きます。
-
以下のようにモジュールを設定します。
-
必ず、「コンバージョンとエンジン固有のオプション」フィールドのすべての設定を含めてください。手順 5 の各設定で、手順 13 の対応するパラメーターとそれに対応する値を探します。