Dropbox 模組
在Adobe Workfront Fusion情境中，您可以自動執行使用Dropbox或Dropbox Business的工作流程，並將其連線至多個協力廠商應用程式和服務。這可讓您自動執行各種活動，例如監視、搜尋、擷取、列出、建立及編輯Dropbox中的檔案和資料夾。
關於建立情境的說明，請參閱建立情境：文章索引之下的文章。
關於模組的資訊，請參閱模組：文章索引之下的文章。
存取權要求
| 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 授權。
先決條件
- 若要使用 Dropbox 模組，您必須擁有 Dropbox 帳戶。
- 若要使用Dropbox聯結器，您必須先在Dropbox中建立應用程式。
如需詳細資訊，請搜尋Dropbox開發人員指南中的「建立應用程式」。 - 建立應用程式時，請使用下列重新導向URI：
https://app.workfrontfusion.com/oauth/cb/dropbox - Dropbox必須核准使用者超過50人的應用程式。
如需詳細資訊，請在Dropbox開發人員指南中搜尋「生產核准」。
Dropbox API資訊
Dropbox聯結器會使用以下專案：
建立與 Dropbox 的連線
若要為您的 Dropbox 模組建立連線：
-
在任何模組中，按一下[連線]方塊旁的新增。
-
填寫下列欄位：
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 layout-auto html-authored no-header 連線名稱 輸入此連線的名稱。 環境 選取此連線是用於生產或非生產環境。 類型 選取要連接至服務帳戶或者個人帳戶。 用戶端 ID 輸入您的Dropbox 使用者端ID。 用戶端密碼 輸入您的Dropbox 使用者端密碼。 帳戶型別 選取您要連線至個人Dropbox帳戶或企業（Dropbox企業）帳戶。 排除dropbox-api-path-root標頭 啟用此選項即可排除具有應用程式資料夾存取權的Dropbox應用程式的dropbox-api-path-root標頭 -
按一下「繼續」，儲存連線並返回模組。## Dropbox模組及其欄位
Dropbox 模組及其欄位
當您設定 Dropbox 模組時，Workfront Fusion 會顯示下列欄位。除了這些欄位以外，也可能因為其他因素，例如您在應用程式或服務中的存取層級，而顯示其他 Dropbox 欄位。在模組中，粗體標題表示那是必要欄位。
若在欄位或函式上方看到對應按鈕，可以使用按鈕設定該欄位的變數和函式。如需詳細資訊，請參閱將資訊從一個模組對應到另一個模組。
觸發程序模組
觀看檔案
修改指定資料夾中的檔案時，此觸發型別模組會傳回檔案詳細資訊。
取得Dropbox檔案與資料夾的模組
下載檔案
此動作模組會從資料夾下載檔案。
您可以指定檔案及其位置。
模組會傳回檔案ID和任何關聯欄位，以及連線存取的任何自訂欄位和值。 您可以在情境內之後的模組中對應此資訊。
當您設定此模組時，會顯示下列欄位。
取得資料夾中繼資料
此動作模組會擷取共用資料夾詳細資料。
您可以指定資料夾的ID。
模組會傳回資料夾的ID和任何關聯欄位，以及連線存取的任何自訂欄位和值。 您可以在情境內之後的模組中對應此資訊。
當您設定此模組時，會顯示下列欄位。
列出資料夾中的所有檔案/子資料夾
此動作模組會列出特定資料夾中的檔案或資料夾。
您可以指定資料夾的ID。
模組會傳回檔案或資料夾的ID及任何關聯欄位，以及連線存取的任何自訂欄位和值。 您可以在情境內之後的模組中對應此資訊。
當您設定此模組時，會顯示下列欄位。
列出檔案修訂版本
此動作模組會擷取特定檔案的所有檔案修訂版本（版本記錄）。
您指定檔案的ID。
模組會傳回與記錄相關聯的任何標準欄位，以及連線存取的任何自訂欄位和值。您可以在情境內之後的模組中對應此資訊。
當您設定此模組時，會顯示下列欄位。
搜尋檔案/資料夾
此搜尋模組會在Dropbox中尋找符合您指定之搜尋查詢的物件記錄。
您可以在情境內之後的模組中對應此資訊。
建立和編輯Dropbox檔案與資料夾的模組
建立資料夾
此動作模組會建立新資料夾。
您可以指定資料夾的路徑和名稱。
模組會傳回資料夾的ID和任何關聯欄位，以及連線存取的任何自訂欄位和值。 您可以在情境內之後的模組中對應此資訊。
當您設定此模組時，會顯示下列欄位。
建立/覆寫文字檔
此動作模組會建立DOC檔案，或覆寫現有檔案的內容。
您可以指定來源檔案和資料夾。
當您設定此模組時，會顯示下列欄位。
建立/更新共用連結
此動作模組會建立檔案的公開連結。
您可以指定檔案和連結的相關資訊。
模組會傳回連結的ID及任何關聯欄位，以及連線存取的任何自訂欄位和值。 您可以在情境內之後的模組中對應此資訊。
當您設定此模組時，會顯示下列欄位。
刪除檔案/資料夾
此動作模組會刪除檔案或資料夾。
您指定檔案或資料夾。
模組會傳回記錄的 ID 和任何相關欄位，以及連線存取的任何自訂欄位和值。您可以在情境內之後的模組中對應此資訊。
當您設定此模組時，會顯示下列欄位。
移動檔案/資料夾
此動作模組會將檔案或資料夾移至其他位置。
您可以指定檔案或資料夾，以及移動的方式和位置。
模組會傳回檔案或資料夾的ID以及任何關聯欄位，連同連線存取的任何自訂欄位和值。 您可以在情境內之後的模組中對應此資訊。
當您設定此模組時，會顯示下列欄位。
重新命名檔案/資料夾
此動作模組會重新命名檔案或資料夾。
您可以指定檔案或資料夾以及新名稱。
模組會傳回檔案或資料夾的ID以及任何關聯欄位，連同連線存取的任何自訂欄位和值。 您可以在情境內之後的模組中對應此資訊。
當您設定此模組時，會顯示下列欄位。
還原檔案
此動作模組會還原檔案的先前版本。
您可以指定檔案和您想要的修訂版本編號。
模組會傳回版本ID和任何關聯欄位，以及連線存取的任何自訂欄位和值。 您可以在情境內之後的模組中對應此資訊。
當您設定此模組時，會顯示下列欄位。
上傳檔案
此動作模組會將檔案上傳至資料夾。
您可以指定資訊，例如檔案的位置、要上傳的檔案，以及檔案的可選新名稱。
模組會傳回檔案ID和任何關聯欄位，以及連線存取的任何自訂欄位和值。 您可以在情境內之後的模組中對應此資訊。
當您設定此模組時，會顯示下列欄位。
其他模組
進行API呼叫
您可以利用此動作模組，對 Dropbox API 進行已驗證的自訂呼叫。如此一來，您就可以建立其他 Dropbox 模組無法完成的資料流程自動化。
當您設定此模組時，會顯示下列欄位。
https://api.dropboxapi.com的路徑。 例如， /2/files/list_folder以標準 JSON 物件的形式新增 API 呼叫的正文內容。
注意：
在 JSON 中使用條件陳述式 (例如 if) 時，請將引號放在條件陳述式的外面。
範例：
下列API呼叫會傳回您/Text files帳戶中Dropbox資料夾的前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。 若要強制轉譯影像（例如在Web瀏覽器或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
- 以
www取代dl。 - 移除
?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")}}