Frame.io V4 模組
Adobe Workfront Fusion Frame.io 模組讓您可以監視、建立、更新、檢索或刪除您 Frame.io 帳戶中的資產和註解。
Workfront 提供兩個 Frame.io 連接器，根據您所連接的 Frame.io 版本而定。
關於舊版 Frame.io 連接器的說明，請參閱 Frame.io 舊版連接器。
關於 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 Workflow 封裝及任何 Adobe Workfront Automation and Integration 封裝 Workfront Ultimate Workfront Prime 和 Select 封裝，以及額外購買的 Workfront Fusion。 |
| Adobe Workfront 授權 |
標準 工作或更高層級 |
| Adobe Workfront Fusion 授權 |
作業型：無 Workfront Fusion 授權要求 連接器型 (舊版)：Workfront Fusion for Work Automation and Integration |
| 產品 | 如果您的組織擁有 Select 或 Prime Workfront 封裝，但不包括 Workfront Automation and Integration，則您的組織必須購買 Adobe Workfront Fusion。 |
若要詳細了解此表格中的資訊，請參閱🔗文件中的存取權要求。
關於 Adobe Workfront Fusion 授權的資訊，請參閱 Adobe Workfront Fusion 授權。
先決條件
若要使用 Frame.io 模組，您必須擁有 Frame.io 帳戶
Frame.io API 資訊
Frame.io 連接器會使用以下項目：
將 Frame.io 連接至 Adobe Workfront Fusion
您可以利用使用者認證進行自動連線、手動建立使用者認證連線，或建立伺服器對伺服器連線。
利用使用者認證進行自動連線
若您登入 Frame.io，此方法會自動建立連線，或將您連線至 Frame.io 登入頁面以便您登入。
- 在任何 Frame.io 模組中，按一下「連線」方框旁的「新增」。
- 輸入此連線的名稱。
- 按一下「繼續」。
- 如果系統提示您登入 Frame.io 帳戶，請登入。
- 若您屬於多個 Frame.io 組織，請選取您要用於此連線的組織。
已建立連線。
手動建立使用者認證連線
您可以透過登入 Frame.io、提供用戶端 ID 或用戶端密碼來建立使用者認證連線。
若要建立伺服器對伺服器連線，您必須先在 Adobe Developer Console 中設定應用程式。
在 Adobe Developer Console 中建立使用者認證
若在 Adobe Developer Console 專案中尚未擁有伺服器對伺服器認證，您可以建立這些認證。
-
在 Adobe Developer Console 中選取此連線要使用的現有專案
或
在 Adobe Developer Console 中建立新專案。相關說明請參閱建立空白專案。
-
在專案概觀頁面或開始使用新專案頁面上，按一下「新增 API」。
-
在開啟的頁面上，找到「Frame.io API」並按一下。
-
在選取驗證類型頁面上，選取「使用者驗證」，然後按一下「下一步」。
-
在新增使用者驗證認證頁面上，選取「OAuth 網頁應用程式」，然後按一下「下一步」。
-
在設定 OAuth 網頁應用程式認證頁面上，輸入下列內容：
table 0-row-2 1-row-2 layout-auto html-authored no-header 預設重新導向 URI https://oauth.app.workfrontfusion.com/oauth/cb/frame-io2重新導向 URI 模式 https://oauth\.app\.workfrontfusion\.com/oauth/cb/frame-io2 -
按一下「下一步」。
-
按一下「儲存已設定的 API」。
-
在產品頁面上，按一下您剛建立的認證卡片。
您可以在此處找到您的用戶端 ID 和用戶端密碼。
設定使用者驗證連線
-
在任何 Frame.io 模組中，按一下「連線」方框旁的「新增」。
-
在「建立連線」方框中，按一下「顯示進階設定」。
-
填寫下列欄位：
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header 連線類型 選取「IMS 使用者驗證」。 連線名稱 輸入此連線的名稱。 用戶端 ID 輸入您的 Adobe 用戶端 ID。此資訊可在 Adobe Developer Console 的認證詳細資訊區段中找到。
關於建立認證的說明，請參閱這篇文章中的在 Adobe Developer Console 中建立使用者認證。
用戶端密碼 輸入您的 Adobe 用戶端密碼。此資訊可在 Adobe Developer Console 的認證詳細資訊區段中找到。
關於建立認證的說明，請參閱這篇文章中的在 Adobe Developer Console 中建立使用者認證。
-
如果系統提示您登入 Frame.io 帳戶，請登入。
-
若您屬於多個 Frame.io 組織，請選取您要用於此連線的組織。
已建立連線。
建立伺服器對伺服器連線
若要建立伺服器對伺服器連線，您必須先在 Adobe Developer Console 中設定應用程式。
在 Adobe Developer Console 中建立伺服器對伺服器認證
若在 Adobe Developer Console 專案中尚未擁有伺服器對伺服器認證，您可以建立這些認證。
-
在 Adobe Developer Console 中選取此連線要使用的現有專案
或
在 Adobe Developer Console 中建立新專案。相關說明請參閱建立空白專案。
-
在專案概觀頁面或開始使用新專案頁面上，按一下「新增 API」。
-
在開啟的頁面上，找到「Frame.io API」並按一下。
-
在選取驗證類型頁面上，選取「伺服器對伺服器驗證」，然後按一下「下一步」。
-
輸入此認證的名稱。這樣一來，您稍後在 Adobe Admin Console 的「API 認證」區域中即可找到認證。
-
按一下「下一步」。
-
在選取產品設定檔頁面上，選取包括您要連接之 Frame.io 帳戶的產品設定檔。
-
按一下「儲存已設定的 API」。
-
在產品頁面上，按一下您剛建立的認證卡片。
您可以在此處找到您的用戶端 ID 和用戶端密碼。
設定伺服器對伺服器連線
-
在任何 Frame.io 模組中，按一下「連線」方框旁的「新增」。
-
填寫下列欄位：
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header 連線類型 選取「IMS 伺服器對伺服器」。 連線名稱 輸入此連線的名稱。 用戶端 ID 輸入您的 Adobe 用戶端 ID。此資訊可在 Adobe Developer Console 的認證詳細資訊區段中找到。
關於建立認證的說明，請參閱這篇文章中的在 Adobe Developer Console 中建立伺服器對伺服器認證。
用戶端密碼 輸入您的 Adobe 用戶端密碼。此資訊可在 Adobe Developer Console 的認證詳細資訊區段中找到。
關於建立認證的說明，請參閱這篇文章中的在 Adobe Developer Console 中建立伺服器對伺服器認證。
-
按一下「繼續」，儲存連線並返回模組。
Frame.io 模組及其欄位
當您設定 Frame.io 模組時，Workfront Fusion 會顯示下列欄位。除了這些欄位以外，也可能因為其他因素，例如您在應用程式或服務中的存取層級，而顯示其他 Frame.io 欄位。在模組中，粗體標題表示那是必要欄位。
若在欄位或函式上方看到對應按鈕，可以使用按鈕設定該欄位的變數和函式。如需詳細資訊，請參閱將資訊從一個模組對應到另一個模組。
資產
建立資產
此動作模組會建立新資產。 您可以上傳本機檔案，或提供遠端檔案的URL，以便從中建立資產。
建立資產（舊版）
此動作模組會建立新資產。
刪除資產
此動作模組會刪除指定的資產。
取得資產
此動作模組會檢索資產詳細資訊。
列出資產清單
此搜尋模組會檢索指定的專案資料夾中的所有資產。
監視資產被刪除
此觸發程序模組會在刪除資產時啟動一個情境。
選取您要用於此模組的 Webhook，或按一下「Webhook」欄位旁的「新增」，並輸入下列資訊：
監視新資產
此觸發程序模組會在建立新資產時啟動一個情境。
選取您要用於此模組的 Webhook，或按一下「Webhook」欄位旁的「新增」，並輸入下列資訊：
註解
建立註解
此動作模組會新增新註解或回覆資產。
刪除註解
此動作模組會刪除現有的註解。
取得註解
此動作模組會檢索指定註解的詳細資訊。
列出註解清單
此搜尋模組會檢索指定資產的所有註解。
更新註解
此動作模組會編輯現有的註解。
監視註解更新
此觸發程序模組會在註解更新時啟動一個情境。
選取您要用於此模組的 Webhook，或按一下「Webhook」欄位旁的「新增」，並輸入下列資訊：
監視新註解
此觸發程序模組會在建立註解時啟動一個情境。
選取您要用於此模組的 Webhook，或按一下「Webhook」欄位旁的「新增」，並輸入下列資訊：
資料夾
建立資料夾
此動作模組會在 Frame.io 中建立新資料夾。
專案
建立專案
此動作模組會在 Frame.io 中建立新專案。
邀請使用者加入 Frame.io 專案
此動作模組會邀請使用者加入指定的 Frame.io 專案。
列出專案清單
此搜尋模組會檢索指定團隊的所有專案。
共用
將資產新增至共用連結
此動作模組會將資產新增至 Frame.io 中的共用連結。
建立共用連結
此動作模組會在 Frame.io 中建立新的共用連結。
工作區
建立工作區
此動作模組會在 Frame.io 中建立新工作區。
列出工作區清單
此模組會列出帳戶中所有工作區的清單。
中繼資料
建立帳戶層級欄位
此動作模組會建立及設定新的帳戶層級中繼資料欄位。
刪除帳戶層級欄位
此動作模組會刪除單一帳戶層級中繼資料欄位。
取得中繼資料
此動作模組會擷取Frame.io中檔案的中繼資料。
列出帳戶層級欄位
此模組會擷取指定帳戶的帳戶層級中繼資料欄位清單。
更新科目層次欄位定義
此模組會更新單一現有中繼資料欄位的定義。
在多個檔案中更新中繼資料
此模組會以您指定的值更新一或多個檔案的中繼資料欄位。
其他
進行自訂的 API 呼叫
您可以透過此模組進行自訂的 API 呼叫。
輸入相對於 https://api.frame.io 的路徑。範例： /v4/me
注：如需可用端點的清單，請參閱 Frame.io API 參考資料。
以標準 JSON 物件的形式新增要求標頭。
例如， {"Content-type":"application/json"}
Workfront Fusion 會自動新增授權標頭。
以標準 JSON 物件的形式新增 API 呼叫的正文內容。
注意：
在 JSON 中使用條件陳述式 (例如 if) 時，請將引號放在條件陳述式的外面。
觀看活動
此即時觸發模組會在選取的事件發生在Frame.io中時啟動案例。
您可以使用現有的webhook，也可以建立新的。
若要建立新的 Webhook：
-
按一下 Webhook 欄位旁的「新增」。
-
填寫下列資訊：
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header Webhook名稱 輸入新 Webhook 的名稱。 連線 關於建立與 Frame.io 的連線的說明，請參閱這篇文章中的將 Frame.io 連接至 Adobe Workfront Fusion。 帳戶 ID 選取或對應包含您要觀看活動之工作區的帳戶。 工作區 ID 輸入您要觀看活動之工作區的ID。 事件 選取您要觸發此模組的事件 -
按一下 儲存 以儲存webhook並返回模組。
-
按一下「觀看事件」模組中的 確定 以儲存設定。
監視後設資料值更新
此觸發程序模組會在註解更新時啟動一個情境。
選取您要用於此模組的 Webhook，或按一下「Webhook」欄位旁的「新增」，並輸入下列資訊：