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授權 |
新增：標準 或 目前：工作或以上 |
| Adobe Workfront Fusion授權** |
目前：無Workfront Fusion授權需求 或 舊版：Workfront Fusion for Work 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")}}