Frame.io レガシーモジュール

IMPORTANT
この記事では、Frame.io コネクタのレガシーバージョンについて説明します。 このコネクタは、Frame.io バージョン 3 への接続に使用されます。
Frame.io コネクタの新しい(ベータ版)バージョンについて詳しくは、Frame.io Beta コネクタを参照してください。

Adobe Workfront Fusion Frame.io モジュールを使用すると、Frame.io アカウント内のアセットやコメントをモニター、作成、更新、取得、削除できます。

Workfrontには、接続先の Frame.io のバージョンに基づく 2 つの Frame.io コネクタが用意されています。

コネクタ
Frame.io バージョン
Frame.io (Beta)
V4
Frame.io (レガシー)
V3

Frame.io コネクタの新しい(ベータ版)バージョンについて詳しくは、Frame.io Beta コネクタを参照してください。

Frame.io コネクタの紹介ビデオについては、以下を参照してください。

アクセス要件

展開すると、この記事の機能のアクセス要件が表示されます。

この記事で説明している機能を使用するには、次のアクセス権が必要です。

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Adobe Workfront パッケージ 任意
Adobe Workfront プラン

新規:標準

または

現在:仕事以上

Adobe Workfront Fusion ライセンス**

現在:Workfront Fusion ライセンス要件なし

または

従来のバージョン:作業の自動化と統合のためのWorkfront Fusion

製品

新規:

  • Prime Workfront パッケージを選択する:Adobe Workfront Fusion を購入する必要があります。
  • Ultimate Workfront パッケージ:Workfront Fusion が含まれています。

または

現在:Adobe Workfront Fusion を購入する必要があります。

このテーブルの情報について詳しくは、 ドキュメントのアクセス要件を参照してください。

Adobe Workfront Fusion ライセンスについて詳しくは、Adobe Workfront Fusion ライセンスを参照してください。

前提条件

Frame.io モジュールを使用するには、Frame.io アカウントが必要です。

Frame.io API 情報

Frame.io コネクタでは、以下を使用します。

ベース URL
https://api.frame.io/v2
API バージョン
v2
API タグ
v1.0.76

Frame.io から Adobe Workfront Fusion への接続

Frame.io には、API トークンまたは OAuth 2.0 を使用して接続できます。

API トークンを使用した Frame.io への接続

OAuth 2.0 PKCE を使用した Frame.io への接続

API トークンを使用した Frame.io への接続

API トークンを使用して Frame.io アカウントをWorkfront Fusion に接続するには、Frame.io アカウントで API トークンを作成し、Workfront Fusion Frame.io​ 接続を作成 ​ ダイアログに挿入する必要があります。

  1. Frame.io アカウントにログインします。
  2. Frame.io Developer の「トークン」ページに移動します。
  3. 新規」をクリックします。
  4. トークンの名前を入力して使用する範囲を選択し、「作成」をクリックします。
  5. 提供されたトークンをコピーします。
  6. Workfront Fusion に移動し、Frame.io モジュールの 接続を作成 ダイアログを開きます。
  7. 接続タイプ」フィールドで「Frame.io」を選択します。
  8. 手順 5 でコピーしたトークンを「Frame.io API キー フィールドに入力します
  9. 続行」をクリックして接続を確立し、モジュールに戻ります。

OAuth 2.0 PKCE を使用した Frame.io への接続

OAuth 2.0 PKCE とオプションのクライアント ID を使用して、Frame.io への接続を作成できます。接続にクライアント ID を含める場合は、Frame.io アカウントで OAuth 2.0 アプリを作成する必要があります。

OAuth 2.0 PKCE(クライアント ID なし)を使用した Frame.io への接続

  1. Workfront Fusion に移動し、Frame.io モジュールの 接続を作成 ダイアログを開きます。
  2. 接続タイプ」フィールドで「Frame.ioOAuth 2.0 PKCE」を選択します。
  3. 新しい接続の名前を「接続名」フィールドに入力します。
  4. 続行」をクリックして接続を確立し、モジュールに戻ります。

OAuth 2.0 PKCE(クライアント ID あり)を使用した Frame.io への接続

  1. Frame.io で OAuth 2.0 アプリを作成します。手順については、Frame.io ドキュメントの OAuth 2.0 コード承認フロー を参照してください。

    note important
    IMPORTANT
    Frame.io で OAuth 2.0 アプリを作成する際には:
    • リダイレクト URI として次のように入力します。

      • アメリカ / APAC:https://app.workfrontfusion.com/oauth/cb/frame-io5

      • EMEA: https://app-eu.workfrontfusion.com/oauth/cb/frame-io5

    • 「PCKE」オプションを有効にします。

  2. 提供された client_id をコピーします。

  3. Workfront Fusion に移動し、Frame.io モジュールの 接続を作成 ダイアログを開きます。

  4. 接続タイプ」フィールドで「Frame.ioOAuth 2.0 PKCE」を選択します。

  5. 新しい接続の名前を「接続名」フィールドに入力します。

  6. 詳細設定を表示」をクリックします。

  7. 手順 2 でコピーした client_id を「クライアント ID」フィールドに入力します。

  8. 続行」をクリックして接続を確立し、モジュールに戻ります。

Frame.io モジュールとそのフィールド

Frame.io モジュールを設定すると、Workfront Fusion には以下のフィールドが表示されます。これらとともに、アプリやサービスのアクセスレベルなどの要因に応じて、追加の「Frame.io」フィールドが表示される場合があります。モジュール内の太字のタイトルは、必須フィールドを示します。

フィールドまたは関数の上にマップボタンが表示されている場合は、このボタンを使用すると、そのフィールドの変数や関数を設定できます。詳しくは、 モジュール間で情報をマッピングするを参照してください。

マップ切り替え

アセット

アセットの作成

このアクションモジュールでは、新しいアセットを作成できます。

Connection
Frame.io への接続を作成する方法については、この記事の Adobe Workfront Fusion への Frame.io の接続を参照してください。
Team ID
アセットを作成するプロジェクトを所有するチームを選択またはマッピングします。
Project ID
アセットを作成するプロジェクトを選択するか、プロジェクトの ID をマッピングします。
Folder ID
アセットを作成するフォルダーを選択するか、フォルダーの ID をマッピングします。
Type
フォルダーを作成するか、ファイルを作成するかを選択します。
Name
新規ファイルまたはフォルダーの名前を入力します。
Source URL
ファイルを作成する場合、アップロードするファイルの URL を入力します。
Description
ファイルを作成する場合、アセットの簡単な説明を入力します。
ラベル ​
ファイルを作成する場合は、ファイルが進行中か、レビューが必要か、承認済みかを選択します。

アセットを削除

このアクションモジュールは、指定したアセットを削除します。

Connection
Frame.io への接続を作成する方法については、この記事の Adobe Workfront Fusion への Frame.io の接続を参照してください。
Team ID
削除するアセットが含まれるプロジェクトを所有するチームを選択またはマッピングします。
Project ID
削除するアセットが含まれるプロジェクトまたはプロジェクトを選択します。
Folder ID
削除するアセットを含むフォルダーを選択
Asset ID
削除するアセットを選択またはマッピングします。

アセットを取得

このアクションモジュールは、アセットの詳細を取得します。

Connection
Frame.io への接続を作成する方法については、この記事の Adobe Workfront Fusion への Frame.io の接続を参照してください。
Team ID
詳細を取得するアセットを含むプロジェクトを所有するチームを、選択またはマッピングします。
Project ID
詳細を取得するアセットを含むプロジェクトを選択します。
Folder ID
詳細を取得するアセットを含むフォルダーを選択します。
Asset ID
詳細を取得するアセットを選択するか、そのアセットの ID をマッピングします。

アセットを一覧表示

この検索モジュールは、指定されたプロジェクトのフォルダー内のすべてのアセットを取得します。

Connection
Frame.io への接続を作成する方法については、この記事の Adobe Workfront Fusion への Frame.io の接続を参照してください。
Team ID
アセットを取得するフォルダーを含む、プロジェクトを所有するチームを選択またはマッピングします。
Project ID
アセットを取得するフォルダーを含むプロジェクトを選択します。
Folder ID
アセットのリストを表示するフォルダーを選択します。
Limit
各シナリオの実行サイクル中に、モジュールが返すアセットの最大数を入力またはマッピングします。

アセットの更新

このアクションモジュールを使用すると、既存のアセットの名前、説明、またはカスタムフィールドを更新できます。

Connection
Frame.io への接続を作成する方法については、この記事の Adobe Workfront Fusion への Frame.io の接続を参照してください。
Team ID
アセットを更新するプロジェクトを所有する、チームを選択またはマッピングします。
Project ID
アセットを更新するプロジェクトを選択するか、プロジェクトの ID をマッピングします。
Folder ID
アセットを更新するフォルダーを選択するか、フォルダーの ID をマッピングします。
Asset ID
更新するアセットの ID を入力またはマッピングします。
Name
更新したファイルの名前を入力します。
Description
更新したアセットの簡単な説明を入力します。

削除されたアセットを監視

このトリガーモジュールは、指定されたチームに属するアセットが削除されると、シナリオを開始します。

これはインスタントトリガーなので、使用するモジュールの Webhook を選択または作成する必要があります。

Webhook を追加する場合は、次の情報を入力します。

Webhook name
Webhook の名前(「Asset deleted」など)を入力します。
Connection
Frame.io への接続を作成する方法については、この記事の Adobe Workfront Fusion への Frame.io の接続を参照してください。
Team ID
この Web フックが作成されるチームを選択します。

更新されたアセットラベルを監視

このトリガーモジュールは、指定されたチームセット、変更または削除されたアセットのラベルが所有する場合にシナリオを開始します。

これはインスタントトリガーなので、使用するモジュールの Webhook を選択または作成する必要があります。

Webhook を追加する場合は、次の情報を入力します。

Webhook name
Webhook の名前(「アセットステータスが更新されました」など)を入力します。
Connection
Frame.io への接続を作成する方法については、この記事の Adobe Workfront Fusion への Frame.io の接続を参照してください。
Team ID
この Web フックが作成されるチームを選択します。

新しいアセットを見つける

このトリガーモジュールは、指定されたチームの新しいアセットが作成されると、シナリオを開始します。

これはインスタントトリガーなので、使用するモジュールの Webhook を選択または作成する必要があります。

Webhook を追加する場合は、次の情報を入力します。

Webhook name
Webhook の名前(「Asset created」など)を入力します。
Connection
Frame.io への接続を作成する方法については、この記事の Adobe Workfront Fusion への Frame.io の接続を参照してください。
Team ID
この Web フックが作成されるチームを選択します。

コメント

コメントを作成

このアクションモジュールは、新しいコメントまたは返信をアセットに追加します。

Connection
Frame.io への接続を作成する方法については、この記事の Adobe Workfront Fusion への Frame.io の接続を参照してください。
Type
コメントを作成するか、コメントに返信するかを選択します。
Team ID
コメントを追加するアセットを含むプロジェクトを所有するチームを選択またはマッピングします。
Project ID
プロジェクトを選択するか、コメントを追加するアセットが含まれるプロジェクトの ID をマッピングします。
Folder ID
フォルダーを選択するか、コメントを追加するアセットが含まれるフォルダーの ID をマッピングします。
Asset ID
コメントを追加するアセットを選択またはマッピングします。
Comment ID
返信を追加するコメントを選択またはマッピングします。
Text
コメントまたは返信のテキスト内容を入力します。
Timestamp
コメントのリンク先となるビデオのフレーム番号を入力します。

コメントの削除

このアクションモジュールは、既存のコメントを削除します。

Connection
Frame.io への接続を作成する方法については、この記事の Adobe Workfront Fusion への Frame.io の接続を参照してください。
Team ID
コメントを削除するアセットを含むプロジェクトを所有するチームを選択またはマッピングします。
Project ID
コメントを削除するアセットを含むプロジェクトを選択するか、プロジェクトの ID をマッピングします。
Folder ID
コメントを削除するアセットを含むフォルダーを選択します。
Asset ID
削除するコメントを含むアセットの ID を入力またはマッピングします。
Comment ID
削除するコメントの ID を入力またはマッピングします。

コメントを取得

このアクションモジュールは、指定されたコメントの詳細を取得します。

Connection
Frame.io への接続を作成する方法については、この記事の Adobe Workfront Fusion への Frame.io の接続を参照してください。
Team ID
アセットを取得するフォルダーを含む、プロジェクトを所有するチームを選択またはマッピングします。
Project ID
アセットを取得するフォルダーを含むプロジェクトを選択します。
Folder ID
アセットのリストを表示するフォルダーを選択します。
Asset ID
取得するコメントを含むアセットを選択します。
Comment ID
詳細を取得するコメントを選択します。

コメントをリスト

この検索モジュールは、指定されたアセットのすべてのコメントを取得します。

Connection
Frame.io への接続を作成する方法については、この記事の Adobe Workfront Fusion への Frame.io の接続を参照してください。
Team ID
コメントを取得するフォルダーを含む、プロジェクトを所有するチームを選択またはマッピングします。
Project ID
コメントを取得するフォルダーを含むプロジェクトを選択します。
Folder ID
コメントのリストを表示するアセットを含むフォルダーを選択します。
Asset ID
コメントのリストを表示するアセットを選択します。
Limit
各シナリオの実行サイクル中にモジュールが返すコメントの最大数を入力またはマッピングします。

コメントの更新

このアクションモジュールは、既存のコメントを編集します。

Connection
Frame.io への接続を作成する方法については、この記事の Adobe Workfront Fusion への Frame.io の接続を参照してください。
Team ID
コメントを更新するアセットを含むプロジェクトを所有するチームを選択またはマッピングします。
Project ID
コメントを更新するアセットを含んだプロジェクトを選択します。
Folder ID
コメントを更新するアセットを含むフォルダーを選択します。
Asset ID
コメントを更新するアセットを選択します。
Comment ID
更新するコメントを選択します。
Text
コメントのテキストコンテンツを入力します。
Timestamp
コメントのリンク先となるビデオのフレーム番号を入力します。

更新されたコメントを監視

このトリガーモジュールは、コメントが編集されたときにシナリオを開始します。

これはインスタントトリガーなので、使用するモジュールの Webhook を選択または作成する必要があります。

Webhook を追加する場合は、次の情報を入力します。

Webhook name
Web フックの名前(例:「編集されたコメント」)を入力します。
Connection
Frame.io への接続を作成する方法については、この記事の Adobe Workfront Fusion への Frame.io の接続を参照してください。
Team ID
この Web フックが作成されるチームを選択します。

新規コメントを監視

このトリガーモジュールは、新しいコメントまたは返信が作成されたときにシナリオを開始します。

これはインスタントトリガーなので、使用するモジュールの Webhook を選択または作成する必要があります。

Webhook を追加する場合は、次の情報を入力します。

Webhook name
Web フックの名前(例:新規コメント)を入力します。
Connection
Frame.io への接続を作成する方法については、この記事の Adobe Workfront Fusion への Frame.io の接続を参照してください。
Team ID
この Web フックが作成されるチームを選択します。

プロジェクト

プロジェクトのリスト

この検索モジュールは、指定したチームのすべてのプロジェクトを取得します。

Connection
Frame.io への接続を作成する方法については、この記事の Adobe Workfront Fusion への Frame.io の接続を参照してください。
Team ID
プロジェクトを取得するチームを選択またはマッピングします。
Limit
各シナリオ実行サイクルでモジュールが返すプロジェクトの最大数を入力またはマッピングします。

その他

API 呼び出しの実行

このモジュールでは、カスタム API 呼び出しを実行できます。

Connection
Frame.io への接続を作成する方法については、この記事の Adobe Workfront Fusion への Frame.io の接続を参照してください。
URL

https://api.frame.io からの相対パスを入力します。例: /v2/teams

メモ:使用可能なエンドポイントの一覧については、Frame.io API リファレンスを参照してください。

Method
API 呼び出しの設定に必要な HTTP リクエストメソッドを選択します。詳しくは、HTTP リクエストメソッドを参照してください。
Headers

リクエストのヘッダーを標準 JSON オブジェクトの形式で追加します。

例: {"Content-type":"application/json"}

Workfront Fusion は、認証ヘッダーを自動的に追加します。

Query String
リクエストクエリ文字列を入力します。クエリ文字列に含める各パラメーターに対して、Add item をクリックして、フィールドの名前と必要な値を入力します。
Body

標準の JSON オブジェクトの形式で、API 呼び出しの本文の内容を追加します。

メモ:

if などの条件文を JSON で使用する場合は、条件文を引用符で囲みます。

recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3