Adobe Workfront 模組
- 在建立或更新情境時使用新連接器。
- 將現有模組升級為使用新連接器。
您可以使用 Adobe Workfront Fusion Adobe Workfront 連接器，在 Workfront 內部將流程自動化。 您也可以將 Workfront 連接至其他應用程式和服務。
關於建立情境的說明，請參閱建立情境：文章索引之下的文章。 關於模組的資訊，請參閱模組：文章索引之下的文章。
存取權要求
| table 0-row-2 1-row-2 2-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 授權 |
標準 工作或更高層級 |
| 產品 | 如果您的組織擁有 Select 或 Prime Workfront 封裝，但不包括 Workfront Automation and Integration，則您的組織必須購買 Adobe Workfront Fusion。 |
若要詳細了解此表格中的資訊，請參閱🔗文件中的存取權要求。
將 Workfront 連接至 Workfront Fusion
Workfront 連接器使用 OAuth 2.0 連接至 Workfront。
您可以直接從 Workfront Fusion 模組內部建立與 Workfront 帳戶的連線。
使用用戶端 ID 和用戶端密碼連接至 Workfront
-
在任何 Adobe Workfront 模組中，按一下「連線」欄位旁的「新增」。
-
填寫下列欄位：
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 連線類型 選取「Adobe Workfront 驗證連線」。 連線名稱 輸入新連線的名稱。 用戶端 ID 輸入您的 Workfront 用戶端 ID。 您可在 Workfront「設定」區域的「OAuth2 應用程式」區域內找到此項資訊。 開啟您要連接的特定應用程式以便查看用戶端 ID。 用戶端密碼 輸入您的 Workfront 用戶端密碼。 您可在 Workfront「設定」區域的「OAuth2 應用程式」區域內找到此項資訊。 如果您在 Workfront 的 OAuth2 應用程式沒有用戶端密碼，您可以產生另一個密碼。 相關說明請參閱 Workfront 文件。 驗證 URL 此欄位可維持預設值，或者您可以輸入 Workfront 實例的 URL 且後面接著
/integrations/oauth2。範例：
https://mydomain.my.workfront.com/integrations/oauth2主機前置詞 在大多數情況下，此值應為 origin。 -
按一下「繼續」，儲存連線並返回模組。
若您未登入 Workfront，系統會將您導向至登入畫面。 登入後，您可以允許連線。
- Workfront API 的 OAuth 2.0 連線不再依賴 API 金鑰。
- 若要建立與 Workfront 沙箱環境的連線，您必須在該環境中建立 OAuth2 應用程式，然後在您的連線中使用該應用程式產生的用戶端 ID 和用戶端密碼。
使用伺服器對伺服器連線連接 Workfront
-
在任何 Adobe Workfront 模組中，按一下「連線」欄位旁的「新增」。
-
填寫下列欄位：
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 layout-auto html-authored no-header 連線類型 選取「Adobe Workfront 伺服器對伺服器連線」。 連線名稱 輸入新連線的名稱。 執行個體名稱 輸入執行個體的名稱，也是您的網域。
範例：若您的 URL 為
https://example.my.workfront.com，請輸入example。執行個體路徑 輸入此連線將連接的環境類型。
範例：若您的 URL 為
https://example.my.workfront.com，請輸入my。用戶端 ID 輸入您的 Workfront 用戶端 ID。 您可在 Workfront「設定」區域的「OAuth2 應用程式」區域內找到此項資訊。 開啟您要連接的特定應用程式以便查看用戶端 ID。 用戶端密碼 輸入您的 Workfront 用戶端密碼。 您可在 Workfront「設定」區域的「OAuth2 應用程式」區域內找到此項資訊。 如果您在 Workfront 的 OAuth2 應用程式沒有用戶端密碼，您可以產生另一個密碼。 相關說明請參閱 Workfront 文件。 範圍 輸入此連線的適用範圍。 主機前置詞 在大多數情況下，此值應為 origin。 -
按一下「繼續」，儲存連線並返回模組。
若您未登入 Workfront，系統會將您導向至登入畫面。 登入後，您可以允許連線。
- Workfront API 的 OAuth 2.0 連線不再依賴 API 金鑰。
- 若要建立與 Workfront 沙箱環境的連線，您必須在該環境中建立 OAuth2 應用程式，然後在您的連線中使用該應用程式產生的用戶端 ID 和用戶端密碼。
Workfront 模組及其欄位
當您設定 Workfront 模組時，Workfront Fusion 會顯示下列欄位。 除了這些欄位以外，也可能因為其他因素，例如您在應用程式或服務中的存取層級，而顯示其他 Workfront 欄位。 在模組中，粗體標題表示那是必要欄位。
若在欄位或函式上方看到對應按鈕，可以使用按鈕設定該欄位的變數和函式。 如需詳細資訊，請參閱將資訊從一個模組對應到另一個模組。
- 若您在 Workfront 模組中未看到最新的欄位，可能是因為快取問題。 請等待一小時，然後再試一次。
- Adobe Workfront 發出的 HTTP 429 狀態代碼不應導致停用，而是在情境中觸發短暫的執行暫停。
觸發程序
監視事件
在 Workfront 中新增、更新或刪除特定類型的物件時，此觸發程序模組會即時執行某個情境。
此模組會顯示與 Webhook 相關的所有事件訂閱。 其中包括透過 Fusion 建立的事件訂閱，以及直接透過 API 建立的事件訂閱。 舊版觀看事件模組並未提供此事件訂閱視圖。
模組會傳回與記錄相關聯的任何標準欄位，以及連線存取的任何自訂欄位和值。 您可以在情境內之後的模組中對應此資訊。
- Workfront事件訂閱會將編輯後的webhook視為新訂閱。 系統不會保留先前webhook設定的事件訂閱歷史記錄，因為這會視為個別的事件訂閱。
- 從舊事件訂閱切換到新事件訂閱可能不會完全同步。 因此，可能會收到事件兩次（如果新訂閱在舊訂閱停止之前開始執行），或錯過事件（如果舊訂閱在新訂閱開始執行之前停止）。
-
按一下「Webhook」方框右側的「新增」。
-
在所顯示的「新增鉤子」方框中設定 Webhook。
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 layout-auto html-authored no-header Webhook 名稱 輸入 Webhook 的名稱 連線 關於將 Workfront 應用程式連接至 Workfront Fusion 的說明，請參閱這篇文章中的將 Workfront 連接至 Workfront Fusion。 記錄類型 選取您要模組監視的 Workfront 記錄類型。 狀態 選取您要監視舊狀態或新狀態。
-
新狀態
當記錄變更 為 特定值時觸發一個情境。
例如，若狀態設定為「新狀態」而篩選器設定為「狀態 等於 進行中」，則當「狀態」變更為「進行中」時，無論先前的狀態為何，Webhook 會觸發一個情境。
-
舊狀態
當記錄 從 特定值變更為其他時會觸發一個情境。
例如，若狀態設定為「舊狀態」而篩選器設定為「狀態 等於 進行中」，則當目前為「進行中」的「狀態」變更為其他狀態時，Webhook 會觸發一個情境。
事件篩選器 您可以設定篩選器為僅監視符合所選取條件的記錄。
對於每個篩選器，輸入您要篩選器評估的欄位、運算子，以及要讓篩選器允許的值。 您可以新增 AND 規則，以便使用一個以上的篩選器。
注意：您無法編輯現有 Workfront Webhook 中的篩選器。 若要為 Workfront 事件訂閱設定不同的篩選器，請移除目前的 Webhook 並建立新的。
關於事件篩選器的詳細資訊，請參閱這篇文章中的 Workfront 中的事件訂閱篩選器 > 監視事件模組。
排除此連線所造成的事件 啟用此選項，以便排除使用與此觸發程序模組相同的連接器所建立或更新的事件。 這樣可以避免情境可能觸發自身，導致其在無限迴圈中重複的情況。
注意：指派記錄類型不包含此選項。
記錄來源 選擇您想要情境監視「僅限新記錄」、「僅限更新的記錄」、「新記錄以及更新的記錄」或者「Deleted Records Only。」
注意：若選擇「新記錄以及更新的記錄」，建立 Webhook 時會建立 2 個事件訂閱 (但使用相同的 Webhook 位址)。
啟用安全鉤點 選擇您是否要為此webhook啟用authToken型安全性。
注意： 2026年8月23日之後，Fusion將依預設為所有Workfront >觀看活動模組（包括現有模組）啟用authToken型安全性。 如果特定的webhook中斷，或由於相容性原因需要停用此功能，您可以在2026年8月23日之前關閉「啟用安全鉤點」選項。
-
建立 Webhook 後，您可以檢視事件傳送目標端點的位址。
如需詳細資訊，請參閱 Workfront 文件中「事件訂閱 API」文章中的事件承載範例區段。
在各 Workfront 模組可用的 Workfront 物件類型中查看可使用此模組的 Workfront 物件類型清單。
監視欄位
當您指定的欄位更新時，此觸發程序模組會執行一個情境。 模組會同時傳回指定欄位舊的值和新的值。 您可以在情境內之後的模組中對應此資訊。
當您設定此模組時，會顯示下列欄位。
在各 Workfront 模組可用的 Workfront 物件類型中查看可使用此模組的 Workfront 物件類型清單。
監視記錄
此觸發程序模組會在新增、更新或是同時新增和更新特定類型的物件時執行情境。 模組會傳回與記錄相關聯的所有標準欄位，以及連線存取的任何自訂欄位和值。 您可以在情境內之後的模組中對應此資訊。
在輸出中，模組會指出每個記錄是新記錄或是更新的記錄。
自上次執行情境後新增和更新的記錄會傳回為新記錄。
當您設定此模組時，會顯示下列欄位。
在各 Workfront 模組可用的 Workfront 物件類型中查看可使用此模組的 Workfront 物件類型清單。
動作
轉換物件
此動作模組會進行下列其中一種轉換：
- 將問題轉換成專案
- 將問題轉換成任務
- 將任務轉換成專案
建立記錄
此動作模組會建立物件，例如 Workfront 中的專案、任務或問題，並讓您在新物件中新增自訂表單。 您可以透過模組選取在模組中可以使用物件的哪些欄位。
您指定記錄的 ID。
模組會傳回記錄的 ID 和任何相關欄位，以及連線存取的任何自訂欄位和值。 您可以在情境內之後的模組中對應此資訊。
請務必提供最少數量的輸入欄位。 例如，若您要建立問題，則需要在「專案 ID」欄位中提供有效的上層專案 ID，以便指出問題在 Workfront 中應存放在哪裡。 您可以使用對應面板來對應來自情境中另一個模組的這些資訊，或是輸入名稱然後從清單中選取，以手動方式輸入資訊。
當您設定此模組時，會顯示下列欄位。
在各 Workfront 模組可用的 Workfront 物件類型中查看可使用此模組的 Workfront 物件類型清單。
- 輸入物件的 ID 時，您可以開始輸入物件的名稱，然後從清單中選取。 然後模組會在欄位中輸入適當的 ID。
- 輸入自訂欄位或備註物件 (註解或回覆) 的文字時，您可以在「備註文字」欄位中使用 HTML 標記來建立 RTF 文字，例如粗體或斜體文字。
-
解析個別使用者
您可以解析使用者清單中的個別使用者。
- 在使用者清單中選取一個或多個使用者。
- 按一下清單標頭中的三點選單。
- 選取「核准」。
- 幾分鐘後，重新整理頁面。
-
解析大批新增的使用者
若要解析大批新增的使用者，您可以直接將該批次的使用者新增至 Adobe Admin Console。
相關說明請參閱 Adobe 文件中的管理多個使用者 | 上傳大量 CSV。
自訂 API 呼叫
您可以利用此動作模組，對 Workfront API 進行已驗證的自訂呼叫。 如此一來，您就可以建立其他 Workfront 模組無法完成的資料流程自動化。
模組會傳回以下資訊：
-
狀態代碼 (數字)：此代碼表示您的 HTTP 要求是成功或失敗。 您可以在網際網路上查閱這些標準代碼。
-
標頭 (物件)：與輸出正文無關之回應/狀態代碼的更詳細內容。 並非顯示在回應標頭中的所有標頭都是回應標頭，因此有一部分對您而言可能並無用處。
回應標頭取決於您在設定模組時所選擇的 HTTP 要求。
-
正文 (物件)：根據您在設定模組時所選擇的 HTTP 要求，您可能會收到一些傳回的資料。 該資料 (例如來自 GET 請求的資料) 會包含在此物件中。
您可以在情境內之後的模組中對應此資訊。
當您設定此模組時，會顯示下列欄位。
https://<WORKFRONT_DOMAIN>/attask/api/<API_VERSION>/ 的路徑。以標準 JSON 物件的形式新增要求標頭。 此資訊會決定請求的內容類型。
例如， {"Content-type":"application/json"}
注意：如果您收到錯誤訊息而且無法判斷其來源，請考慮根據 Workfront 文件修改標頭。 如果您的自訂 API 呼叫傳回 422 HTTP 要求錯誤，請嘗試使用 "Content-Type":"text/plain" 標頭。
以標準 JSON 物件的形式新增 API 呼叫的查詢。
例如： {"name":"something-urgent"}
提示：建議您透過 JSON 正文而非查詢參數傳送資訊。
以標準 JSON 物件的形式新增 API 呼叫的正文內容。
注意：
在 JSON 中使用條件陳述式 (例如 if) 時，請將引號放在條件陳述式的外面。
在各 Workfront 模組可用的 Workfront 物件類型中查看可使用此模組的 Workfront 物件類型清單。
刪除記錄
此動作模組會刪除物件，例如 Workfront 中的專案、任務或問題。
您指定記錄的 ID。
模組會傳回記錄的 ID 和任何相關欄位，以及連線存取的任何自訂欄位和值。 您可以在情境內之後的模組中對應此資訊。
當您設定此模組時，會顯示下列欄位。
在各 Workfront 模組可用的 Workfront 物件類型中查看可使用此模組的 Workfront 物件類型清單。
- 同步刪除記錄。
- 將錯誤處理新增至刪除記錄模組，以便忽略因為 40 秒逾時造成的錯誤。
下載文件
此動作模組會從 Workfront 下載文件。
您指定記錄的 ID。
模組會傳回文件的內容、檔案名稱、副檔名和檔案大小。 您可以在情境內之後的模組中對應此資訊。
當您設定此模組時，會顯示下列欄位。
在各 Workfront 模組可用的 Workfront 物件類型中查看可使用此模組的 Workfront 物件類型清單。
取得預先簽署的檔案URL
此動作模組會取得預先簽署的檔案 URL，稍後可供其他 API 使用。
其他動作
此動作模組讓您對 API 執行動作。
convertToProject 動作包含欄位 copyCategories。 設定為 TRUE 時，所有自訂表單都將包含在由問題轉換而成的專案中。當您設定此模組時，會顯示下列欄位。
在各 Workfront 模組可用的 Workfront 物件類型中查看可使用此模組的 Workfront 物件類型清單。
專案
讀取記錄
此動作模組會從單一記錄檢索資料。
您指定記錄的 ID。 您也可以指定您要模組讀取的相關記錄。
例如，若模組正在讀取的記錄為專案，您可以指定要讀取專案的任務。
模組會傳回取自您指定的輸出欄位的資料陣列。
當您設定此模組時，會顯示下列欄位。
在各 Workfront 模組可用的 Workfront 物件類型中查看可使用此模組的 Workfront 物件類型清單。
更新事件裝載版本
Workfront 最近發行新版本的事件訂閱服務。 新版本並非對 Workfront API 有所變更，而是變更事件訂閱功能。 此動作模組會更新此情境所使用的事件承載版本。
關於事件訂閱新版本的詳細資訊，請參閱 Workfront 文件中的事件訂閱版本設定
關於在事件訂閱升級期間保留 Workfront Fusion 情境的資源，包括網路研討會錄影，請參閱在事件訂閱 V2 升級期間保留 Fusion 情境。
更新記錄
此動作模組會更新物件，例如專案、任務或問題。 您可以透過模組選取在模組中可以使用物件的哪些欄位。
您指定記錄的 ID。
模組會傳回物件的 ID 和任何相關欄位，以及連線存取的任何自訂欄位和值。 您可以在情境內之後的模組中對應此資訊。
當您設定此模組時，會顯示下列欄位。
在各 Workfront 模組可用的 Workfront 物件類型中查看可使用此模組的 Workfront 物件類型清單。
上傳文件
此動作模組會將文件上傳至 Workfront 物件，例如專案、任務或問題。 此模組會以區塊形式上傳文件，讓 Workfront 的上傳流程更為順暢。
此模組能夠處理比舊版模組更大的檔案，而且是採分階段方式向擁有 Ultimate Workfront 封裝的組織推出實施。
您可以指定文件的位置、要上傳的檔案，以及可供檔案選用的新名稱。
模組會傳回文件的 ID 和任何相關欄位，以及連線存取的任何自訂欄位和值。 您可以在情境內之後的模組中對應此資訊。
當您設定此模組時，會顯示下列欄位。
在各 Workfront 模組可用的 Workfront 物件類型中查看可使用此模組的 Workfront 物件類型清單。
搜尋
讀取關聯的記錄
此搜尋模組會讀取在特定上層物件中，符合您指定之搜尋查詢的記錄。
您指定在輸出中要包含哪些欄位。 您可以在情境內之後的模組中對應此資訊。
當您設定此模組時，會顯示下列欄位。
搜尋
此搜尋模組會在 Workfront 中尋找物件中符合您指定之搜尋查詢的記錄。
您可以在情境內之後的模組中對應此資訊。
當您設定此模組時，會顯示下列欄位。
搜尋 (舊版)
使用這個模組的現有情境將繼續如常運作。 這個模組將在 2025 年 5 月從模組選擇器中移除。
此搜尋模組會在 Workfront 中尋找物件中符合您指定之搜尋查詢的記錄。
您可以在情境內之後的模組中對應此資訊。
當您設定此模組時，會顯示下列欄位。
各 Workfront 模組可用的 Workfront 物件類型
每個Workfront觸發程式模組可用的物件型別
每個Workfront動作模組可用的物件型別
每個Workfront搜尋模組可用的物件型別
我們建議您再次檢查，以確保其運作方式符合預期。
Workfront > 監視事件模組中的事件訂閱篩選器
事件訂閱中的篩選器可讓您確保案例只在符合某些引數時執行。
事件訂閱篩選器最佳實務
-
我們強烈建議您在監視事件模組中使用事件訂閱篩選器。
-
Workfront 最近發行新版本的事件訂閱服務。 新版本並非對 Workfront API 有所變更，而是變更事件訂閱功能。 此動作模組會更新此情境所使用的事件承載版本。
關於事件訂閱新版本的詳細資訊，請參閱 Workfront 文件中的事件訂閱版本設定
關於在事件訂閱升級期間保留 Workfront Fusion 情境的資源，包括網路研討會錄影，請參閱在事件訂閱 V2 升級期間保留 Fusion 情境。
Workfront 監視事件模組會根據在 Workfront API 中建立事件訂閱的 Webhook 觸發情境。 事件訂閱是一個資料集，用於決定哪些事件要傳送至 Webhook。 例如，若您設定監視問題的監視事件模組，則事件訂閱只會傳送與問題相關的事件。
藉由使用事件訂閱篩選器，Fusion 使用者可以根據其使用案例建立更加合適的事件訂閱。 例如，您可以在 Workfront API 中設定事件訂閱，僅將特定專案中的問題傳送至 Webhook，確保監視事件模組僅會因為該專案中的問題而觸發。 由於能夠建立範圍較小的觸發程序，因此可以減少不相關的觸發程序的數量，進而改善情境設計。
這與在 Workfront Fusion 情境中設定篩選器不同。 若沒有事件訂閱篩選器，您的 Webhook 會接收與所選物件類型相關的所有事件。 這些事件大多與情境無關，必須先篩選掉，情境才能繼續。
Workfront > 監視事件篩選器中提供下列運算子：
-
等於
-
不等於
-
大於
-
小於
-
大於或等於
-
小於或等於
-
包含
-
存在
- 此運算子不需要值，且值欄位不存在。
-
不存在
- 此運算子不需要值，且值欄位不存在。
-
已變更
- 此運算子不需要值，且值欄位不存在。
- 此運算子會忽略狀態欄位。
- 使用
Changed時，請在「記錄來源」欄位中選取「僅更新事件」。
使用事件訂閱篩選器來篩選事件 (建議使用)
在情境內篩選事件 (不建議使用)
關於 Workfront 事件訂閱的詳細資訊，請參閱常見問題集 - 事件訂閱。
關於 Webhook 的詳細資訊，請參閱 Adobe Workfront Fusion 中的即時觸發程序 (Webhook)
如需關於情境中篩選器的詳細資訊，請參閱在情境中加入篩選器。
使用進階篩選
Workfront >觀看活動模組提供兩種型別的篩選器。
- 簡單：此篩選器提供介面，可讓您選取欄位、運運算元和值，以及AND和OR運運算元，以建立篩選器。
- 進階：此篩選器可讓您上傳代表您篩選器的JSON。
簡單與進階篩選
這兩種型別的主要差異在於濾鏡的「狀態」。
- 簡單：設定簡單篩選時，請選取您是要篩選欄位的舊狀態還是新狀態。 也就是說，您決定當欄位從 變更指定值時，是否要啟動案例，或當欄位從 變更為 指定值時，是否要啟動。 使用AND和OR可讓您包含多個欄位和值，但它們必須共用相同的狀態。 您不能對某些欄位使用舊狀態，而對其他欄位使用新狀態。
- 進階：您可以在進階篩選器中設定JSON，以指定相同篩選器中新舊狀態的值。 例如，您可以指定當專案從「計畫」狀態移至「目前」狀態時，要觸發案例。 這會排除從「計畫」移至「廢棄」或從「保留」移至「目前」的專案。