ドキュメントWorkfrontWorkfront ガイド

Frame.io モジュール

Last update: Thu Nov 21 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • トピック：

作成対象：

  • ユーザー

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

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

アクセス要件

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

Adobe Workfront プラン*
Pro 以降
Adobe Workfront ライセンス*
Plan、Work
Adobe Workfront Fusion ライセンス**

現在のライセンス要件：Workfront Fusion ライセンス要件なし。

または

従来のライセンス要件：Workfront Fusion for Work Automation and Integration

製品

現在の製品要件：Select または Prime Adobe Workfront プランがある場合、この記事で説明する機能を使用するには、組織で Adobe Workfront Fusion の購入 Adobe Workfront 必要です。 Workfront Fusion は、Workfront Ultimate プランに含まれています。

または

従来の製品要件：この記事で説明している機能を使用するには、Adobe Workfront Fusion と Adobe Workfrontを組織で購入する必要があります。

ご利用のプラン、ライセンスタイプまたはアクセス権を確認するには、Workfront 管理者にお問い合わせください。

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 キー」フィールドに入力し、「続行」をクリックして接続を確立します。

接続が確立されました。モジュールの設定に進むことができます。

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 フィールドが表示される場合があります。モジュール内の太字のタイトルは、必須フィールドを示します。

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

アセット

アセットの作成

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

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
Workfront Fusion が 1 回の実行サイクルで返すアセット数の上限を設定します。

Update an Asset

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

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

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

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

Webhook name
Web フックの名前（例：削除済みアセット）を入力します。
Connection
Frame.io への接続を作成する手順については、この記事にあるAdobe Workfront Fusion への Frame.io の接続を参照してください。
Team ID
この Web フックが作成されるチームを選択します。

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

このトリガーモジュールは、アセットのステータスが設定、変更または削除されたときにシナリオを開始します。

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

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

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

Webhook name
Web フックの名前を入力します（例：作成されたアセット）。
Connection
Frame.io への接続を作成する手順については、この記事にあるAdobe Workfront Fusion への Frame.io の接続を参照してください。
Team ID
この Web フックが作成されるチームを選択します。

コメント

コメントを作成

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

Connection
Frame.io への接続を作成する手順については、この記事にあるFrame.io を Adobe Workfront Fusion に接続を参照してください。
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
削除するコメントが含まれているアセットを選択します。
Comment 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
Workfront Fusion が 1 回の実行サイクルで返すコメントの最大数を設定します。

コメントの更新

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

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

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

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

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

新規コメントを監視

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

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
Workfront Fusion が 1 回の実行サイクルで返すコメントの最大数を設定します。

その他

API 呼び出しの実行

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

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

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

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

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

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

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

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

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

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

メモ：

if などの条件ステートメントを JSON で使用する場合は、条件ステートメントの外側に引用符を挿入します。

例： 次の API 呼び出しは、Frame.io アカウントのすべてのチームとその詳細を返します。

URL：/v2/teams

メソッド：GET

結果は、モジュールの出力のバンドル／本文にあります。

この例では、1 チームの詳細が返されました。

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43