Frame.io V4模組

IMPORTANT
本文說明Frame.io聯結器的新版本。 此聯結器用於連線至Frame.io版本4。
如需舊版Frame.io聯結器的說明,請參閱Frame.io舊版聯結器

Adobe Workfront Fusion Frame.io模組可讓您監視、建立、更新、擷取或刪除您Frame.io帳戶中的資產和註解。

Workfront提供兩個Frame.io聯結器,根據您連線的Frame.io版本而定。

聯結器
Frame.io版本
Frame.io
V4
Frame.io (舊版)
V3

如需舊版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授權

新增:標準

目前:工作或以上

Adobe Workfront Fusion授權**

目前:無Workfront Fusion授權需求

舊版:Workfront Fusion for Work Automation and Integration

產品

新增:

  • 選取或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/v4
API版本
v2
API標籤
v1.0.76

將Frame.io連線至Adobe Workfront Fusion

您可以使用使用者認證自動連線、手動建立使用者認證連線,或建立伺服器對伺服器連線。

使用使用者認證自動連線

如果您已登入Frame.io,此方法會自動建立連線,或將您連線至Frame.io登入頁面以便您登入。

  1. 在任何Frame.io Beta模組中,按一下[連線]方塊旁的​ 新增
  2. 輸入連線的名稱。
  3. 按一下​ 繼續
  4. 如果系統提示您登入Frame.io帳戶,請登入。
  5. 如果您屬於多個Frame.io組織,請選取要用於此連線的組織。

已建立連線。

手動建立使用者認證連線

您可以登入Frame.io或提供使用者端ID或使用者端密碼來建立使用者認證連線。

若要建立伺服器對伺服器連線,您必須先在Adobe Developer Console中設定應用程式。

在Adobe Developer Console中建立使用者認證

如果您在Adobe Developer Console專案中還沒有伺服器對伺服器認證,您可以建立這些認證。

  1. 開啟Adobe Developer Console

  2. 在Adobe Developer Console中選取要用於此連線的現有專案

    在Adobe Developer Console中建立新專案。 如需指示,請參閱建立空白專案

  3. 在專案概觀頁面或開始使用新專案頁面上,按一下​ 新增API

  4. 在開啟的頁面上,找到並按一下​ Frame.io API

  5. 在[選取驗證型別]頁面上,選取[使用者驗證],然後按一下[下一步]

  6. 在[新增使用者驗證認證]頁面上,選取​ OAuth Web App,然後按一下[下一步]​

  7. 在設定OAuth Web App認證頁面上,輸入下列內容:

    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
  8. 按一下​ 下一步

  9. 按一下​ 儲存設定的API

  10. 在產品頁面上,按一下您剛建立之憑證的卡片。

    您可以在這裡找到您的使用者端ID和使用者端密碼。

NOTE
建議您在Adobe Workfront Fusion中開始設定連線時,保持此視窗開啟。 您可以複製使用者端ID,並從此頁面擷取及複製使用者端密碼,以貼入連線欄位。

設定使用者驗證連線

  1. 在任何Frame.io Beta模組中,按一下[連線]方塊旁的​ 新增

  2. 在[建立連線]方塊中,按一下[顯示進階設定]。

  3. 填寫下列欄位:

    table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
    連線型別 選取 IMS使用者驗證
    連線名稱 輸入此連線的名稱。
    使用者端ID

    輸入您的Adobe 使用者端識別碼。 這可以在Adobe Developer Console的認證詳細資料區段中找到。

    如需建立認證的指示,請參閱本文中的在Adobe Developer Console中建立使用者認證

    使用者端密碼

    輸入您的Adobe 使用者端密碼。 這可以在Adobe Developer Console的認證詳細資料區段中找到。

    如需建立認證的指示,請參閱本文中的在Adobe Developer Console中建立使用者認證

  4. 如果系統提示您登入Frame.io帳戶,請登入。

  5. 如果您屬於多個Frame.io組織,請選取要用於此連線的組織。

已建立連線。

建立伺服器對伺服器連線

若要建立伺服器對伺服器連線,您必須先在Adobe Developer Console中設定應用程式。

在Adobe Developer Console中建立伺服器對伺服器認證

如果您在Adobe Developer Console專案中還沒有伺服器對伺服器認證,您可以建立這些認證。

  1. 開啟Adobe Developer Console

  2. 在Adobe Developer Console中選取要用於此連線的現有專案

    在Adobe Developer Console中建立新專案。 如需指示,請參閱建立空白專案

  3. 在專案概觀頁面或開始使用新專案頁面上,按一下​ 新增API

  4. 在開啟的頁面上,找到並按一下​ Frame.io API

  5. 在[選取驗證型別]頁面上,選取​ 伺服器對伺服器驗證,然後按一下[下一步]​

  6. 輸入認證的名稱。 這可讓您稍後在Adobe Admin Console的「API認證」區域中識別認證。

  7. 按一下​ 下一步

  8. 在「選取產品設定檔」頁面上,選取包含您要連線之Frame.io帳戶的產品設定檔。

  9. 按一下​ 儲存設定的API

  10. 在產品頁面上,按一下您剛建立之憑證的卡片。

    您可以在這裡找到您的使用者端ID和使用者端密碼。

NOTE
建議您在Adobe Workfront Fusion中開始設定連線時,保持此視窗開啟。 您可以複製使用者端ID,並從此頁面擷取及複製使用者端密碼,以貼入連線欄位。

設定伺服器對伺服器連線

  1. 在任何Frame.io Beta模組中,按一下[連線]方塊旁的​ 新增

  2. 填寫下列欄位:

    table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
    連線型別 選取 IMS伺服器至伺服器
    連線名稱 輸入此連線的名稱。
    使用者端ID

    輸入您的Adobe 使用者端識別碼。 這可以在Adobe Developer Console的認證詳細資料區段中找到。

    如需建立認證的指示,請參閱本文中的在Adobe Developer Console中建立伺服器對伺服器認證

    使用者端密碼

    輸入您的Adobe 使用者端密碼。 這可以在Adobe Developer Console的認證詳細資料區段中找到。

    如需建立認證的指示,請參閱本文中的在Adobe Developer Console中建立伺服器對伺服器認證

  3. 按一下​ 繼續 ​以儲存連線並返回模組。

Frame.io模組及其欄位

當您設定Frame.io模組時,Workfront Fusion會顯示下列欄位。 除了這些欄位以外,可能還會顯示其他Frame.io欄位,視您在應用程式或服務中的存取層級等因素而定。 模組中的粗體標題表示必填欄位。

如果您在欄位或函式上方看到對應按鈕,則可以使用它來設定該欄位的變數和函式。 如需詳細資訊,請參閱將資訊從一個模組對應到另一個模組

地圖切換

資產

建立資產

此動作模組會建立新資產。

Connection
如需建立Frame.io連線的指示,請參閱本文中的連線Frame.io至Adobe Workfront Fusion
帳戶ID
選取帳戶或對應包含您要建立資產的專案之帳戶的ID。
Workspace ID
選取工作區或對應包含您要建立資產的專案之工作區的ID。
專案ID
選取專案或對應您要建立資產的專案ID。
路徑
選取您要建立資產的路徑。
檔案名稱
輸入您要用於此資產的檔案名稱。
檔案大小
輸入或對應檔案大小(位元組)。
Source URL
如果建立檔案,請輸入您要上傳之檔案的URL。
媒體型別
選取此資產的媒體型別。

刪除資產

此動作模組會刪除指定的資產。

Connection
如需建立Frame.io連線的指示,請參閱本文中的連線Frame.io至Adobe Workfront Fusion
帳戶ID
選取帳戶或對應包含您要刪除之資產的帳戶ID。
資產ID
選取或對應您要刪除的資產。

取得資產

此動作模組會擷取資產詳細資訊。

Connection
如需建立Frame.io連線的指示,請參閱本文中的連線Frame.io至Adobe Workfront Fusion
帳戶ID
選取帳戶或對應包含您要擷取之資產的帳戶ID。
資產ID
選取或對應您要擷取的資產。

列出資產

此搜尋模組會擷取指定專案資料夾中的所有資產。

Connection
如需建立Frame.io連線的指示,請參閱本文中的連線Frame.io至Adobe Workfront Fusion
帳戶ID
選取帳戶或對應包含您要列出之資產的帳戶ID。
傳回資產的最大數量
輸入或對應您希望模組在每個案例執行週期中傳回的資產最大數量。

觀看資產已刪除

此觸發模組會在資產刪除時啟動案例。

選取您要用於此模組的webhook,或按一下Webhook欄位旁的新增,然後輸入下列資訊:

Webhook名稱
輸入新webhook的名稱。
Connection
如需建立Frame.io連線的指示,請參閱本文中的連線Frame.io至Adobe Workfront Fusion
帳戶ID
選取帳戶或對應您要監視已刪除資產的帳戶ID。

觀看新資產

此觸發模組會在建立新資產時啟動案例。

選取您要用於此模組的webhook,或按一下Webhook欄位旁的新增,然後輸入下列資訊:

Webhook名稱
輸入新webhook的名稱。
Connection
如需建立Frame.io連線的指示,請參閱本文中的連線Frame.io至Adobe Workfront Fusion
帳戶ID
選取帳戶或對應您要監視新資產的帳戶ID。

註解

建立註解

此動作模組會新增註解或回覆至資產。

Connection
如需建立Frame.io連線的指示,請參閱本文中的連線Frame.io至Adobe Workfront Fusion
帳戶ID
選取帳戶或對應包含您要新增註解之資產的帳戶ID。
Workspace ID
選取帳戶或對應包含您要新增註解之資產的工作區ID。
專案ID
選取專案或對應專案ID,專案包含您要新增註解的資產。
路徑
選取您要新增註解的資產路徑。
Text
輸入評論或回覆的文字內容。
時間戳記
在影片中輸入評論應連結的影格編號。
頁面
如果資產是PDF,請輸入或對應應附加註解的頁面。

刪除註解

此動作模組會刪除現有註解。

Connection
如需建立Frame.io連線的指示,請參閱本文中的連線Frame.io至Adobe Workfront Fusion
帳戶ID
選取帳戶或對應包含您要刪除之註解的帳戶ID。
註解ID
輸入或對應您要刪除之註解的ID。

取得註解

此動作模組會擷取指定註解的詳細資料。

Connection
如需建立Frame.io連線的指示,請參閱本文中的連線Frame.io至Adobe Workfront Fusion
帳戶ID
選取帳戶或對應包含您要擷取詳細資訊之註解的帳戶ID。
註解ID
選取您要擷取有關詳細資訊的註解。

列出註解

此搜尋模組會擷取指定資產的所有註解。

Connection
如需建立Frame.io連線的指示,請參閱本文中的連線Frame.io至Adobe Workfront Fusion
帳戶ID
選取或對應包含您要擷取註解之資產的帳戶。
Workspace ID
選取或對應包含您要擷取註解之資產的工作區。
專案ID
選取包含您要擷取註解之資產的專案。
路徑
選取通往您要列出註解之資產的路徑。
傳回評論的最大數量
輸入或對應您希望模組在每個案例執行週期中傳回的最大註解數。

更新註解

此動作模組會編輯現有註解。

Connection
如需建立Frame.io連線的指示,請參閱本文中的連線Frame.io至Adobe Workfront Fusion
帳戶ID
選取或對應包含您要在其中更新評論之資產的專案的帳戶。
註解ID
選取要更新的註解。
Text
輸入註解的文字內容。
時間戳記
在評論連結的視訊中輸入影格編號。
頁面
如果資產是PDF,請輸入或對應附有註解的頁面。

觀看評論已更新

此觸發模組會在評論更新時啟動案例。

選取您要用於此模組的webhook,或按一下Webhook欄位旁的新增,然後輸入下列資訊:

Webhook名稱
輸入新webhook的名稱。
Connection
如需建立Frame.io連線的指示,請參閱本文中的連線Frame.io至Adobe Workfront Fusion
帳戶ID
選取帳戶或對應您要監視其是否有更新評論的帳戶ID。

觀看新評論

此觸發模組會在建立評論時啟動案例。

選取您要用於此模組的webhook,或按一下Webhook欄位旁的新增,然後輸入下列資訊:

Webhook名稱
輸入新webhook的名稱。
Connection
如需建立Frame.io連線的指示,請參閱本文中的連線Frame.io至Adobe Workfront Fusion
帳戶ID
選取帳戶或對應您要監視新評論的帳戶ID。

資料夾

建立資料夾

此動作模組會在Frame.io中建立新資料夾。

Connection
如需建立Frame.io連線的指示,請參閱本文中的連線Frame.io至Adobe Workfront Fusion
帳戶ID
選取或對應您要建立資料夾的帳戶。
Workspace ID
選取或對應您要建立資料夾的工作區。
專案ID
選取您要建立資料夾的位置。
路徑
選取您要建立資料夾的路徑。
姓名
輸入或對應新資料夾的名稱。

專案

建立專案

此動作模組會在Frame.io中建立新專案。

Connection
如需建立Frame.io連線的指示,請參閱本文中的連線Frame.io至Adobe Workfront Fusion
帳戶ID
選取或對應您要建立專案的帳戶。
Workspace ID
選取或對應您要建立專案的工作區。
姓名
輸入或對應新專案的名稱。

邀請使用者加入Frame.io專案

此動作模組邀請使用者加入指定的Frame.io專案。

Connection
如需建立Frame.io連線的指示,請參閱本文中的連線Frame.io至Adobe Workfront Fusion
帳戶ID
選取或對應包含您要邀請使用者加入之專案的帳戶。
Workspace ID
選取或對應包含您要邀請使用者加入之專案的工作區。
專案 ID
選取或對應您要邀請使用者加入的專案。
使用者 ID
選取或對應您要邀請加入專案的使用者。

列出專案

此搜尋模組會擷取指定團隊的所有專案。

Connection
如需建立Frame.io連線的指示,請參閱本文中的連線Frame.io至Adobe Workfront Fusion
帳戶ID
選取或對應包含您要擷取專案之資產的帳戶。
Workspace ID
選取或對應包含您要擷取專案之資產的工作區。
傳回專案的最大數量
輸入或對應最大專案數量 您希望模組在每個案例執行週期中傳回。

共用

將資產新增至共用連結

此動作模組會將資產新增至Frame.io中的共用連結。

Connection
如需建立Frame.io連線的指示,請參閱本文中的連線Frame.io至Adobe Workfront Fusion
帳戶ID
選取或對應包含您要新增資產的共用連結的帳戶。
共用連結ID
選取或對應您要新增資產的共用連結。
資產ID
輸入或對應您要新增至共用連結之資產的ID。

建立共用連結

此動作模組會在Frame.io中建立新的共用連結。

Connection
如需建立Frame.io連線的指示,請參閱本文中的連線Frame.io至Adobe Workfront Fusion
帳戶ID
選取或對應您要建立共用連結的帳戶。
Workspace ID
選取或對應您要建立共用連結的工作區。
專案ID
選取或對應您要建立共用連結的專案。
存取
選取此連結是否具有公開或限制的存取權。
資產
針對您想要新增至共用連結的每個資產,按一下 新增專案 並輸入資產識別碼。
說明
輸入或對應共用連結的說明。
姓名
輸入或對應共用連結的到期日。
姓名
輸入或對應新共用連結的名稱。
姓名
輸入或對應共用連結的密碼。

工作區

建立工作區

此動作模組會在Frame.io中建立新的工作區

Connection
如需建立Frame.io連線的指示,請參閱本文中的連線Frame.io至Adobe Workfront Fusion
帳戶ID
選取或對應您要建立工作區的帳戶。
名稱
輸入或對應工作區的新名稱。

列出工作區

此模組會列出帳戶中的所有工作區。

Connection
如需建立Frame.io連線的指示,請參閱本文中的連線Frame.io至Adobe Workfront Fusion
帳戶ID
選取或對應包含您要擷取工作區之資產的帳戶。
傳回工作區的最大數目
輸入或對應工作區的最大數目 您希望模組在每個案例執行週期中傳回。

其他

進行自訂API呼叫

此模組可讓您執行自訂API呼叫。

Connection
如需建立Frame.io連線的指示,請參閱本文中的連線Frame.io至Adobe Workfront Fusion
URL

輸入相對於https://api.frame.io的路徑。 範例: /v4/me

注意:如需可用端點的清單,請參閱Frame.io API參考。

方法
選取設定API呼叫所需的HTTP要求方法。 如需詳細資訊,請參閱HTTP要求方法
Headers

以標準JSON物件的形式新增請求的標頭。

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

Workfront Fusion會自動新增授權標頭。

查詢字串
輸入請求查詢字串。 針對您要包含在查詢字串中的每個引數,按一下 新增專案,然後輸入欄位名稱及所要的值。
Body

以標準JSON物件的形式新增API呼叫的內文內容。

注意:

在JSON中使用條件陳述式(例如if)時,請將引號放在條件陳述式之外。

觀看中繼資料值已更新

此觸發模組會在評論更新時啟動案例。

選取您要用於此模組的webhook,或按一下Webhook欄位旁的新增,然後輸入下列資訊:

Webhook名稱
輸入新webhook的名稱。
Connection
如需建立Frame.io連線的指示,請參閱本文中的連線Frame.io至Adobe Workfront Fusion
帳戶ID
選取帳戶或對應您要監視更新後中繼資料值的帳戶ID。
recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3