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 帳戶。
IMPORTANT
  • 若要使用Dropbox聯結器,您必須先在Dropbox中建立應用程式。
    如需詳細資訊,請搜尋Dropbox開發人員指南中的「建立應用程式」。
  • 建立應用程式時,請使用下列重新導向URI: https://app.workfrontfusion.com/oauth/cb/dropbox
  • Dropbox必須核准使用者超過50人的應用程式。
    如需詳細資訊,請在Dropbox開發人員指南中搜尋「生產核准」。

Dropbox API資訊

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

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

    v5.3.9

  • Dropbox Business

    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 6-row-2 layout-auto html-authored no-header
    連線名稱 輸入此連線的名稱。
    環境 選取此連線是用於生產或非生產環境。
    類型 選取要連接至服務帳戶或者個人帳戶。
    用戶端 ID 輸入您的Dropbox 使用者端ID。
    用戶端密碼 輸入您的 Dropbox 用戶端密碼。
    帳戶型別 選取您要連線至個人Dropbox帳戶或企業(Dropbox企業)帳戶。
    排除dropbox-api-path-root標頭 啟用此選項即可排除具有應用程式資料夾存取權的Dropbox應用程式的dropbox-api-path-root標頭
  3. 按一下​ 繼續 ​以儲存連線並返回模組。## Dropbox模組及其欄位

Dropbox 模組及其欄位

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

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

對應切換

觸發程序模組

觀看檔案

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

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

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

下載檔案

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

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

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

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

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

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

檔案路徑

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

檔案

從選單中選取檔案。

取得資料夾中繼資料

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

您可以指定資料夾的ID。

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

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

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

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

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

您可以指定資料夾的ID。

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

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

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

列出檔案修訂版本

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

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

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

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

檔案路徑

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

檔案

從選單中選取檔案。

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

搜尋檔案/資料夾

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

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

連線
如需有關將您的Dropbox帳戶連線到Workfront Fusion的說明,請參閱本文中的建立與Dropbox的連線。
搜尋
輸入搜尋字詞。
資料夾
選取您要搜尋的資料夾。 如果您未選取資料夾,此模組會搜尋整個Dropbox帳戶。
檔案狀態
選取要包含在搜尋中的檔案狀態。
檔案類別
選取要包含在搜尋中的檔案類別。
副檔名
對於每一個要包含在搜尋中的副檔名,按一下[新增專案] ,然後輸入或對應副檔名。
限制
輸入或對應您要此模組在每個情境執行週期中傳回的最大記錄數量。

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

建立資料夾

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

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

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

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

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

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

注意:

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

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

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

建立/覆寫文字檔

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

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

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

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

選取您要建立或覆寫DOC檔案。

  • 建立選取您要建立檔案的資料夾。

  • 覆寫

    選取您要如何選擇要覆寫的檔案,然後對應檔案路徑或選取檔案。

來源檔案

從先前的模組中選取來源檔案,或對應來源檔案的內容。

如果您正在建立檔案,請選取空白

建立/更新共用連結

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

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

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

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

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

檔案路徑

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

檔案

選取目標檔案。

要求的可見度

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

注意:

Team僅適用於Dropbox企業帳戶。 Dropbox Pro或Dropbox企業帳戶只能使用[!UICONTROL密碼存取。

連結的到期日
輸入連結到期且無法再存取的日期和時間。 如果此欄位留空,連結將不會過期。 如需支援之日期和時間格式的清單,請參閱類型強制轉換
連結的存取層級

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

  • 檢視器

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

  • 編輯器

    使用連結的使用者可以編輯、檢視和評論內容。 此存取層級僅適用於雲端型檔案。

  • Max

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

刪除檔案/資料夾

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

您指定檔案或資料夾。

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

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

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

檔案/資料夾路徑

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

檔案/資料夾

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

移動檔案/資料夾

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

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

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

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

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

檔案/資料夾路徑

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

檔案/資料夾

選取您要移動檔案或資料夾,然後選取檔案或資料夾。

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

重新命名檔案/資料夾

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

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

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

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

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

檔案/資料夾路徑

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

檔案/資料夾

選取您要移動檔案或資料夾,然後選取檔案或資料夾。

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

還原檔案

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

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

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

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

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

檔案路徑

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

檔案

從選單中選取檔案。

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

上傳檔案

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

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

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

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

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

從先前的模組中選取來源檔案,或對應來源檔案的名稱和資料。

注意:

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

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

其他模組

進行API呼叫

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

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

連線
如需有關將您的Dropbox帳戶連線到Workfront Fusion的說明,請參閱本文中的建立與Dropbox的連線。
URL
輸入相對路徑。輸入相對於https://api.dropboxapi.com的路徑。 例如, /2/files/list_folder
方法
選取您設定 API 呼叫所需的 HTTP 要求方法。 如需詳細資訊,請參閱 HTTP 要求方法
標頭
輸入所需的請求標頭。 Workfront Fusion 會自動新增授權標頭。
查詢字串
輸入請求查詢字串。
正文

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

注意:

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

範例:

下列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。 若要強制轉譯影像(例如在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

  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 取代www

  • 若要移除?dl=0

    移除DL

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

取代兩者

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

{{replace(replace(1.url; "?dl=0"; ""); "www"; "dl")}}
recommendation-more-help
workfront-fusion-help-workfront-fusion