Dropbox模組

在Adobe Workfront Fusion案例中,您可以自動執行使用Dropbox或Dropbox Business的工作流程,以及將其連線至多個協力廠商應用程式和服務。這可讓您自動執行諸如監視、搜尋、擷取、列出、建立及編輯Dropbox中的檔案與資料夾等活動。

如果您需要有關建立案例的指示,請參閱在 Adobe Workfront Fusion中建立案例。

如需模組的相關資訊,請參閱 Adobe Workfront Fusion🔗中的模組。

存取需求

您必須具有下列存取權才能使用本文中的功能:

Adobe Workfront 計畫*
Pro或更高版本
Adobe Workfront 授權*
計畫,工作
Adobe Workfront Fusion 授權**

目前授權需求:無Workfront Fusion授權需求。

舊版授權需求:Workfront Fusion for Work Automation and Integration

產品

目前產品需求:如果您有Select或Prime Adobe Workfront計畫,貴組織必須購買Adobe Workfront Fusion及Adobe Workfront,才能使用本文所述的功能。 Workfront Fusion包含在Ultimate Workfront計畫中。

舊版產品需求:您的組織必須購買Adobe Workfront Fusion及Adobe Workfront,才能使用本文所述的功能。

若要瞭解您擁有的計畫、授權型別或存取權,請連絡您的Workfront管理員。

如需Adobe Workfront Fusion授權的相關資訊,請參閱Adobe Workfront Fusion 授權

先決條件

  • 若要使用Dropbox模組,您必須有Dropbox帳戶。
IMPORTANT
Dropbox必須核准使用者超過50人的應用程式。
如需詳細資訊,請在Dropbox開發人員指南中搜尋「生產核准」。

DropboxAPI資訊

Dropbox聯結器會使用以下專案:

基礎URL
https://api.dropboxapi.com/2
API版本
2
API標籤
  • Dropbox

    v5.3.9

  • Dropbox企業

    v1.0.12

建立與Dropbox的連線

若要為您的Dropbox模組建立連線:

  1. 按一下[連線]方塊旁的​ 新增

  2. 填寫下列欄位:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 layout-auto html-authored no-header
    連線名稱 輸入此連線的名稱。
    環境 選取此連線是用於生產或非生產環境。
    型別 選取您要連線到服務帳戶還是個人帳戶。
    使用者端ID 輸入您的Dropbox 使用者端ID。
    使用者端密碼 輸入您的Dropbox 使用者端密碼。
    帳戶型別 選取您要連線至個人Dropbox帳戶或企業(Dropbox企業)帳戶。
  3. 按一下​ 繼續 ​以儲存連線並返回模組。## Dropbox模組及其欄位

Dropbox模組及其欄位

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

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

觸發模組

觀看檔案

修改指定資料夾中的檔案時,此觸發型別模組會傳回檔案詳細資訊。

Connection
如需有關將您的Dropbox帳戶連線到Workfront Fusion的說明,請參閱本文中的建立與Dropbox的連線。
資料夾
選取您要監視變更的資料夾。
Watch也包含子資料夾
啟用此選項也可監視所選資料夾中用於修改檔案的子資料夾。
限制
輸入或對應您希望模組在每個案例執行週期中傳回的最大記錄數。

取得Dropbox檔案與資料夾的模組

搜尋檔案/資料夾

此搜尋模組會在Dropbox中尋找符合您指定之搜尋查詢的物件記錄。

您可以在情境中的後續模組中對應此資訊。

Connection
如需有關將您的Dropbox帳戶連線到Workfront Fusion的說明,請參閱本文中的建立與Dropbox的連線。
搜尋
輸入搜尋字詞。
資料夾
選取您要搜尋的資料夾。 如果您未選取資料夾,此模組會搜尋整個Dropbox。
檔案狀態
選取檔案狀態,將搜尋限制在選取的檔案狀態。
檔案類別
選取檔案類別,將搜尋限制在選取的類別。
副檔名
選擇您要搜尋的副檔名。
限制
輸入或對應您希望模組在每個案例執行週期中傳回的最大記錄數。

下載檔案

此動作模組會從資料夾下載檔案。

您可以指定檔案及其位置。

模組會傳回檔案ID和任何關聯欄位,以及連線存取的任何自訂欄位和值。 您可以在情境中的後續模組中對應此資訊。

NOTE
此模組對於提供檔案給後續模組相當實用。

當您設定此模組時,會顯示下列欄位。

Connection
如需有關將您的Dropbox帳戶連線到Workfront Fusion的說明,請參閱本文中的建立與Dropbox的連線。
選取檔案的方式
選取您要對應檔案路徑還是手動選取檔案。
檔案路徑/檔案

檔案路徑

輸入或對應目標路徑至檔案。

檔案

從選單中選取檔案。

取得資料夾中繼資料

此動作模組會擷取共用資料夾詳細資料。

您可以指定資料夾的ID。

模組會傳回資料夾的ID和任何關聯欄位,以及連線存取的任何自訂欄位和值。 您可以在情境中的後續模組中對應此資訊。

當您設定此模組時,會顯示下列欄位。

Connection
如需有關將您的Dropbox帳戶連線到Workfront Fusion的說明,請參閱本文中的建立與Dropbox的連線。
共用資料夾識別碼
輸入或對應您要擷取其詳細資訊的資料夾ID。

列出資料夾中的所有檔案/子資料夾

此動作模組會列出特定資料夾中的檔案或資料夾。

您可以指定資料夾的ID。

模組會傳回檔案或資料夾的ID及任何關聯欄位,以及連線存取的任何自訂欄位和值。 您可以在情境中的後續模組中對應此資訊。

當您設定此模組時,會顯示下列欄位。

Connection
如需有關將您的Dropbox帳戶連線到Workfront Fusion的說明,請參閱本文中的建立與Dropbox的連線。
清單
選取您要擷取檔案或資料夾。
僅顯示可下載的檔案
啟用此選項以僅傳回可下載的檔案。 部分型別的檔案(例如Google檔案)無法下載。
資料夾
輸入或對應您要從中擷取檔案或資料夾的資料夾。
限制
輸入或對應您希望模組在每個案例執行週期中列出的最大記錄數量。

列出檔案修訂版本

此動作模組會擷取特定檔案的所有檔案修訂版本(版本記錄)。
您指定檔案的ID。

模組會傳回與記錄相關聯的任何標準欄位,以及連線存取的任何自訂欄位和值。 您可以在情境中的後續模組中對應此資訊。

當您設定此模組時,會顯示下列欄位。

Connection
如需有關將您的Dropbox帳戶連線到Workfront Fusion的說明,請參閱本文中的建立與Dropbox的連線。
選取檔案的方式
選取您要對應檔案路徑還是手動選取檔案。
檔案路徑/檔案

檔案路徑

輸入或對應目標路徑至檔案。

檔案

從選單中選取檔案。

限制
輸入或對應您希望模組在每個案例執行週期中列出的最大記錄數量。

建立和編輯Dropbox檔案與資料夾的模組

上傳檔案

此動作模組會將檔案上傳至資料夾。

您可以指定資訊,例如檔案的位置、要上傳的檔案,以及檔案的可選新名稱。

模組會傳回檔案ID和任何關聯欄位,以及連線存取的任何自訂欄位和值。 您可以在情境中的後續模組中對應此資訊。

當您設定此模組時,會顯示下列欄位。

Connection
如需有關將您的Dropbox帳戶連線到Workfront Fusion的說明,請參閱本文中的建立與Dropbox的連線。
資料夾
選取您要上傳檔案的Dropbox資料夾。
Source檔案

輸入或對應您要新增至上方所選Dropbox資料夾的檔案。

檔案名稱

輸入或對應檔案名稱,包括副檔名。

檔案資料

輸入或對應檔案資料(來自先前的模組,例如Google Drive >Get a File)。

注意:上傳檔案的大小上限為150 MB。

覆寫現有檔案
啟用此選項以新檔案取代現有檔案。 如果此選項保持停用,則會重新命名上傳的檔案。

建立資料夾

此動作模組會建立新資料夾。

您可以指定資料夾的路徑和名稱。

模組會傳回資料夾的ID和任何關聯欄位,以及連線存取的任何自訂欄位和值。 您可以在情境中的後續模組中對應此資訊。

當您設定此模組時,會顯示下列欄位。

Connection
如需有關將您的Dropbox帳戶連線到Workfront Fusion的說明,請參閱本文中的建立與Dropbox的連線。
資料夾名稱
輸入新資料夾的名稱。
資料夾

輸入或對應您要建立新資料夾的路徑。

注意:

如果您使用Dropbox Business帳戶(含團隊空間),您必須移除斜線/,或不要按一下 按一下這裡以選擇資料夾,在根目錄中建立團隊資料夾。

如果未移除斜線,則會傳回錯誤[409] path/malformed_path/..

自動重新命名
啟用此選項可重新命名新資料夾(如果目標位置中已存在相同名稱的資料夾)。

建立/覆寫文字檔

此動作模組會建立DOC檔案或覆寫現有檔案的內容。

您可以指定來源檔案和資料夾。

模組會傳回資料夾的ID和任何關聯欄位,以及連線存取的任何自訂欄位和值。 您可以在情境中的後續模組中對應此資訊。

當您設定此模組時,會顯示下列欄位。

Connection
如需有關將您的Dropbox帳戶連線到Workfront Fusion的說明,請參閱本文中的建立與Dropbox的連線。
選取至
選取您要建立或覆寫DOC檔案。
資料夾
選取您要建立檔案的目標位置。
Source檔案

輸入或對應您要新增至Dropbox資料夾的檔案。

檔案名稱

輸入新DOC檔案的檔案名稱(沒有副檔名)。

檔案內容

輸入DOC檔案的文字內容。

建立/更新共用連結

此動作模組會建立檔案的公開連結。

您可以指定檔案和連結的相關資訊。

模組會傳回連結的ID及任何關聯欄位,以及連線存取的任何自訂欄位和值。 您可以在情境中的後續模組中對應此資訊。

當您設定此模組時,會顯示下列欄位。

Connection
如需有關將您的Dropbox帳戶連線到Workfront Fusion的說明,請參閱本文中的建立與Dropbox的連線。
選取檔案的方式
選取您要對映或輸入檔案路徑,或手動選取檔案。
檔案路徑/檔案

檔案路徑

輸入或對應目標路徑至檔案。

檔案

從選單中選取檔案。

要求的可見度

選取連結是公用連結、專案團隊連結或密碼限制連結。

注意: Team only和Access with password選項僅適用於擁有Dropbox Pro或更新版本的使用者。

連結的到期日

輸入連結到期且無法再存取的日期和時間。 如果此欄位留空,連結將不會過期。 如需支援的日期和時間格式清單,請參閱在Adobe Workfront Fusion中鍵入強制。

注意: Team only和Access with password選項僅適用於擁有Pro或更高版本的Dropbox。

連結的存取層級

設定連結收件者的許可權。

Viewer 使用此連結的使用者可以檢視內容並加上註解。

Editor 使用該連結的使用者可以編輯、檢視和評論內容。

Max 使用連結的使用者會收到您可以設定連結的最大存取層級。

還原檔案

此動作模組會還原檔案的先前版本。

您可以指定檔案和您想要的修訂版本編號。

模組會傳回版本ID和任何關聯欄位,以及連線存取的任何自訂欄位和值。 您可以在情境中的後續模組中對應此資訊。

當您設定此模組時,會顯示下列欄位。

Connection
如需有關將您的Dropbox帳戶連線到Workfront Fusion的說明,請參閱本文中的建立與Dropbox的連線。
選取檔案的方式
選取您要對映或輸入檔案路徑,或手動選取檔案。
檔案路徑 / 檔案

檔案路徑

輸入或對應目標路徑至檔案。

檔案

從選單中選取檔案。

修訂版
輸入或對應您要還原之修訂版本的修訂版本編號。

移動檔案/資料夾

此動作模組會將檔案或資料夾移至其他位置。

您可以指定檔案或資料夾,以及移動的方式和位置。

模組會傳回檔案或資料夾的ID以及任何關聯欄位,連同連線存取的任何自訂欄位和值。 您可以在情境中的後續模組中對應此資訊。

當您設定此模組時,會顯示下列欄位。

Connection
如需有關將您的Dropbox帳戶連線到Workfront Fusion的說明,請參閱本文中的建立與Dropbox的連線。
選取檔案的方式
選取您要對映或輸入檔案路徑,或手動選取檔案。
檔案/資料夾路徑 / 檔案/資料夾

檔案/資料夾路徑

輸入或對應目標路徑至檔案或資料夾。

檔案/資料夾

從選單中選取檔案或資料夾。

至資料夾
輸入或對應檔案或資料夾的目標位置。
新名稱
在新位置輸入檔案或資料夾的新名稱。
自動重新命名
啟用此選項以確保如果存在具有相同名稱的檔案或資料夾,模組會重新命名新檔案或資料夾,方法是在檔案或資料夾名稱后面新增(NUMBER)。 否則,會覆寫目標位置中的檔案或資料夾。
允許所有權轉讓
啟用此選項可允許所有者移動,即使這將導致所移動內容的所有權轉移。

重新命名檔案/資料夾

此動作模組會重新命名檔案或資料夾。

您可以指定檔案或資料夾以及新名稱。

模組會傳回檔案或資料夾的ID以及任何關聯欄位,連同連線存取的任何自訂欄位和值。 您可以在情境中的後續模組中對應此資訊。

當您設定此模組時,會顯示下列欄位。

Connection
如需有關將您的Dropbox帳戶連線到Workfront Fusion的說明,請參閱本文中的建立與Dropbox的連線。
選取檔案的方式
選取您要對映或輸入檔案路徑,或手動選取檔案。
檔案/資料夾路徑/檔案/資料夾

檔案/資料夾路徑

輸入或對應目標路徑至檔案或資料夾。

檔案/資料夾

從選單中選取檔案或資料夾。

重新命名
輸入檔案的目標名稱,包括副檔名。

刪除檔案/資料夾

此動作模組會刪除檔案或資料夾。

您指定檔案或資料夾。

模組會傳回記錄ID及任何關聯欄位,連同連線存取的任何自訂欄位和值。 您可以在情境中的後續模組中對應此資訊。

當您設定此模組時,會顯示下列欄位。

Connection
如需有關將您的Dropbox帳戶連線到Workfront Fusion的說明,請參閱本文中的建立與Dropbox的連線。
選取檔案的方式
選取您要對映或輸入檔案路徑,或手動選取檔案。
檔案路徑 / 檔案

檔案路徑

輸入或對應目標路徑至檔案。

檔案

從選單中選取檔案。

其他模組

進行API呼叫

此動作模組可讓您對Dropbox API進行自訂的已驗證呼叫。 如此一來,您就可以建立其他Dropbox模組無法完成的資料流程自動化。

當您設定此模組時,會顯示下列欄位。

Connection
如需有關將您的Dropbox帳戶連線到Workfront Fusion的說明,請參閱本文中的建立與Dropbox的連線。
URL

輸入相對路徑。輸入相對於https://api.dropboxapi.com的路徑。 例如, /2/files/list_folder

注意:如需可用端點的清單,請參閱DropboxAPI v2檔案

方法

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

Headers
輸入所需的請求標頭。 Workfront Fusion會自動新增授權標頭。
查詢字串
輸入請求查詢字串。
Body

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

注意:

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

INFO
範例: ​下列API呼叫傳回您Dropbox帳戶中/Text files資料夾的前10個檔案:
URL: /2/files/list_folder
內文:
{
"path": "/Text files",
"limit": 10,
"recursive": false,
"include_deleted": false
}
在組合 > 內文 >專案下的模組輸出中,可找到搜尋的相符專案。
在我們的範例中,傳回10張票證:

常見問題

無法上傳或更新檔案

上傳或更新檔案失敗時有幾種情況:

  • 上傳的檔案太大,超過您的Dropbox計畫允許的最大檔案大小,或者您已使用所有Dropbox帳戶的儲存配額。 您必須從您的Dropbox帳戶刪除現有檔案,或升級您的計畫。
  • 先前選取的資料夾(檔案將上傳至該資料夾)已不存在。 此情境將停止,您必須再次選取目標資料夾。

透過共用連結參照的影像無法呈現

Dropbox >建立共用連結傳回的URL不會直接連結至影像,而是連結至Dropbox頁面。 若要強制下載影像,請將結尾的?dl=0取代為?dl=1。 若要強制轉譯影像(例如在網頁瀏覽器或Facebook Messenger中),請將&raw=1附加至URL。

如果您需要取得您網站或其他Workfront Fusion模組的直接或原始影像連結,您必須以下列方式修改初始的共用URL:

原始URL:

https://www.dropbox.com/s/ia8qtvs20f3a5ux/Screen%20Shot%202018-10-15%20at%204.21.11%20PM.png?dl=0

  1. dl取代www
  2. 移除?dl=0

最終URL:

https://dl.dropbox.com/s/ia8qtvs20f3a5ux/Screen%20Shot%202018-10-15%20at%204.21.11%20PM.png

若要自動修改URL,您可以使用replace()函式兩次:

  • 以dl取代www

  • 若要移除?dl=0

若要在一個步驟中執行操作,請組合下列函式:

您也可以複製並貼到欄位中。 以URL取代1.url

{{replace(replace(1.url; "?dl=0"; ""); "www"; "dl")}}
recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43