Adobe Workfront模組

您可以使用Adobe Workfront Fusion Adobe Workfront聯結器在Workfront中自動化您的流程。 您也可以將Workfront連線至其他應用程式和服務。

如需建立情境的說明,請參閱建立情境:文章索引下的文章。 如需有關模組的資訊,請參閱模組:文章索引下的文章。

存取需求

展開以檢視本文中功能的存取需求。

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

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授權需求。

舊版:任何

產品

新增:

  • 選取或Prime Workfront套件:您的組織必須購買Adobe Workfront Fusion。
  • Ultimate Workfront套件:包含Workfront Fusion。

目前:您的組織必須購買Adobe Workfront Fusion。

如需此表格中資訊的詳細資訊,請參閱檔案🔗中的存取需求。

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

note note
NOTE
  • 如果您的組織使用舊版授權套件(以聯結器為基礎),它必須具有Workfront Fusion for Work Automation and Integration授權才能連線至協力廠商應用程式和服務。 Workfront聯結器不會計入貴組織可用的作用中應用程式數量。 所有情境(即使只使用Workfront應用程式)都會計入貴組織的情境總數中。

將Workfront連線至Workfront Fusion

Workfront聯結器使用OAuth 2.0連線至Workfront。

您可以直接從Workfront Fusion模組內建立與Workfront帳戶的連線。

  1. 在任何Adobe Workfront模組中,按一下[連線]欄位旁的​ 新增

  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
    Connection name 輸入新連線的名稱。
    Environment 選取要連線到生產或非生產環境。
    Connection type 選取您要連線到服務帳戶還是個人帳戶。
    Client ID 輸入您的Workfront使用者端ID。 您可在Workfront中「設定」區域的「OAuth2應用程式」區域中找到此專案。 開啟您要連線的特定應用程式以檢視使用者端ID。
    Client Secret 輸入您的Workfront使用者端密碼。 您可在Workfront中「設定」區域的「OAuth2應用程式」區域中找到此專案。 如果您的Workfront中的OAuth2應用程式沒有使用者端密碼,您可以產生另一個密碼。 如需指示,請參閱Workfront檔案。
    Authentication URL

    這可以維持預設值,或者您可以輸入Workfront執行個體的URL,然後輸入/integrations/oauth2

    範例: https://mydomain.my.workfront.com/integrations/oauth2

    Host prefix 在大多數情況下,此值應該是origin
  3. 按一下​ Continue ​以儲存連線並返回模組。

    如果您未登入Workfront,系統會將您導向至登入畫面。 登入後,您可以允許連線。

NOTE
  • Workfront API的OAuth 2.0連線不再依賴API金鑰。
  • 若要建立與Workfront沙箱環境的連線,您必須在該環境中建立OAuth2應用程式,然後在您的連線中使用該應用程式產生的使用者端ID和使用者端密碼。

Workfront模組及其欄位

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

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

地圖切換

NOTE
  • 如果您在Workfront模組中未看到最新欄位,可能是因為快取問題。 請等待一小時,然後再試一次。
  • 來自Adobe Workfront的HTTP 429狀態程式碼不應導致停用,而會在案例中觸發短暫的執行暫停。

觸發程序

Watch Events

在Workfront中新增、更新或刪除特定型別的物件時,此觸發模組會即時執行案例

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

  1. 按一下​ Webhook ​方塊右側的​ Add

  2. 在顯示的​ Add a hook ​方塊中設定webhook。

    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
    Webhook name 輸入webhook的名稱
    Connection 如需有關將Workfront應用程式連線到Workfront Fusion的說明,請參閱本文中的將Workfront連線到Workfront Fusion
    Record Type 選取您要模組觀看的Workfront記錄型別。
    State

    選取您要觀看舊狀態還是新狀態。

    • New state

      當記錄將指定值 變更為 時觸發案例。

      例如,如果狀態設定為New State且篩選器設定為Status Equals In Progress,則無論狀態之前為何,webhook會在Status變更為In Progress時觸發案例。

    • Old state

      當記錄從變更指定值時,觸發案例

      例如,如果狀態設定為Old State且篩選器設定為Status Equals In Progress,則當目前為In Progress的Status變更為另一個狀態時,webhook會觸發一個情境。

    Events filters

    您可以設定篩選器,只監視符合您選取條件的記錄。

    針對每個篩選器,輸入您希望篩選器評估的欄位、運運算元,以及您希望篩選器允許的值。 您可以新增AND規則來使用一個以上的篩選器。

    注意:您無法編輯現有Workfront Webhook中的篩選器。 若要為Workfront活動訂閱設定不同的篩選器,請移除目前的webhook並建立新的篩選器。

    如需事件篩選的詳細資訊,請參閱本文中的Workfront > Watch Events模組中的事件訂閱篩選。

    排除此連線造成的事件

    啟用此選項可排除使用此觸發模組使用的相同聯結器建立或更新的事件。 這可防止案例可能觸發自身的情況,導致其在無限回圈中重複。

    注意: Assignment記錄型別不包含此選項。

    Record Origin

    選擇您要案例觀看New Records Only、Updated Records Only、New and Updated Records或Deleted Records Only。

    注意:如果您選擇New and Updated Records,webhook建立會建立2個事件訂閱(針對相同的webhook位址)。

建立webhook後,您可以檢視事件傳送到的端點位址。

如需詳細資訊,請參閱Workfront檔案中事件訂閱API一文中的事件裝載範例小節。

檢視您可以在每個Workfront模組🔗可用的Workfront物件型別中使用此模組的Workfront物件型別清單。

Watch Field

當您指定的欄位更新時,此觸發模組會執行情境。 模組會傳回指定欄位的舊值和新值。 您可以在情境中的後續模組中對應此資訊。

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

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header
Connection 如需有關將Workfront應用程式連線到Workfront Fusion的說明,請參閱本文中的將Workfront連線到Workfront Fusion
Record Type

選取您要模組觀看的Workfront記錄型別。

例如,如果您要在每次更新任務中的記錄欄位時開始執行案例,請選取Task。

Field 選取您希望模組監視更新的欄位。 這些欄位反映Workfront管理員針對追蹤而設定的欄位。
Outputs 選取您要包含在此模組輸出組合中的物件欄位。
Limit 輸入或對應您希望模組在每個案例執行週期中傳回的最大記錄數。

檢視您可以在每個Workfront模組🔗可用的Workfront物件型別中使用此模組的Workfront物件型別清單。

Watch Record

此觸發模組會在新增、更新特定型別的物件或兩者同時進行時,執行案例。 模組會傳回與一個或多個記錄相關聯的所有標準欄位,以及連線存取的任何自訂欄位和值。 您可以在情境中的後續模組中對應此資訊。

在輸出中,模組會指出每個記錄是新的還是更新的。

自上次執行案例後新增和更新的記錄會傳回為新記錄。

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

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
Connection 如需有關將Workfront應用程式連線到Workfront Fusion的說明,請參閱本文中的將Workfront連線到Workfront Fusion
Filter 選擇您要讓情境觀看New Records Only、Updated Records Only或New and Updated Records。
Record Type

選取您要模組觀看的Workfront記錄型別。

例如,如果您要在每次建立新專案時啟動案例,請選取 Project

Outputs 選取您要包含在此模組之輸出組合中的欄位。
Reference 選取您要包含在此模組輸出組合中的參考欄位。
Outputs 選取您要包含在此模組輸出組合中的集合欄位。
Optional Filter (進階)輸入API程式碼字串,以定義將縮小條件範圍的任何其他引數或程式碼。
Limit 輸入或對應您希望模組在每個案例執行週期中傳回的最大記錄數。

檢視您可以在每個Workfront模組🔗可用的Workfront物件型別中使用此模組的Workfront物件型別清單。

動作

Convert object

此動作模組會進行下列其中一個轉換:

  • 將問題轉換為專案
  • 將問題轉換為任務
  • 將任務轉換為專案
note note
NOTE
自2024年7月起,轉換物件時可包含自訂表單。
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 8-row-2 layout-auto html-authored no-header
Connection 如需有關將Workfront應用程式連線到Workfront Fusion的說明,請參閱本文中的將Workfront連線到Workfront Fusion
Object type 選取您要轉換的物件型別。 這是轉換前物件的型別。
Convert to 選取您想要將它轉換成的物件。 這是物件在轉換後的型別。
<Object> ID

輸入物件的ID。

附註:輸入物件識別碼時,您可以開始輸入物件的名稱,然後從清單中選取它。 模組接著在欄位中輸入適當的ID。

Template ID

如果要轉換為專案,請選取要用於專案的範本ID。

附註:輸入物件識別碼時,您可以開始輸入物件的名稱,然後從清單中選取它。 模組接著在欄位中輸入適當的ID。

Custom forms 選取您要新增至新轉換物件的任何自訂表單,然後輸入自訂表單欄位的值。
Options 啟用轉換物件時所需的任何選項。 選項是否可用取決於您轉換至哪個物件或轉換自哪個物件。
Copy native fields 啟用此選項可將任何原生欄位從原始物件複製到新物件。
Copy custom forms 啟用此選項可將任何原生欄位從原始物件複製到新物件。
Create a record (attaching custom forms)

此動作模組會建立物件,例如Workfront中的專案、任務或問題,並允許您新增自訂表單至新物件。 模組可讓您選取可在模組中取得哪些物件欄位。

您指定記錄的ID。

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

請務必提供最小輸入欄位數。 例如,如果您想建立問題,則需要在「專案ID」欄位中提供有效的父專案ID,以指出問題應存在於Workfront中的何處。 您可以使用對應面板從情境中的另一個模組對應此資訊,或是輸入名稱,然後從清單中選取它,以手動方式輸入資訊。

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

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Connection 如需有關將Workfront應用程式連線到Workfront Fusion的說明,請參閱本文中的將Workfront連線到Workfront Fusion
Record Type

選取您要模組建立的Workfront記錄型別。

例如,如果您想要建立專案,請從下拉式清單中選取Project。

Select fields to map

選取您想用於資料輸入的欄位。 這可讓您使用這些欄位,而無需捲動瀏覽您不需要的欄位。 您接著可以在這些欄位中輸入或對應資料。

對於自訂表單中的欄位,請使用 Attach Custom Form 欄位。

Attach Custom Form 選取您要新增至新物件的任何自訂表單,然後輸入或對應這些欄位的值。

檢視您可以在每個Workfront模組🔗可用的Workfront物件型別中使用此模組的Workfront物件型別清單。

note note
NOTE
  • 輸入物件的ID時,您可以開始輸入物件的名稱,然後從清單中選取它。 模組接著在欄位中輸入適當的ID。
  • 輸入自訂欄位或Note物件(註解或回覆)的文字時,您可以使用Note Text欄位中的HTML標籤來建立RTF文字,例如粗體或斜體文字。
Create Record

此動作模組會建立物件,例如Workfront中的專案、任務或問題。 模組可讓您選取可在模組中取得哪些物件欄位。

您指定記錄的ID。

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

請務必提供最小輸入欄位數。 例如,如果您想建立問題,則需要在「專案ID」欄位中提供有效的父專案ID,以指出問題應存在於Workfront中的何處。 您可以使用對應面板從情境中的另一個模組對應此資訊,或是輸入名稱,然後從清單中選取它,以手動方式輸入資訊。

此模組在建立物件時未附加自訂表單。 若要在建立物件時附加自訂表單,請使用Create a record (attaching custom forms)模組。

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

table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
Connection 如需有關將Workfront應用程式連線到Workfront Fusion的說明,請參閱本文中的將Workfront連線到Workfront Fusion
Record Type

選取您要模組建立的Workfront記錄型別。

例如,如果您想要建立專案,請從下拉式清單中選取Project。

Select fields to map 選取您想用於資料輸入的欄位。 這可讓您使用這些欄位,而無需捲動瀏覽您不需要的欄位。

檢視您可以在每個Workfront模組🔗可用的Workfront物件型別中使用此模組的Workfront物件型別清單。

note note
NOTE
  • 輸入物件的ID時,您可以開始輸入物件的名稱,然後從清單中選取它。 模組接著在欄位中輸入適當的ID。
  • 輸入自訂欄位或Note物件(註解或回覆)的文字時,您可以使用Note Text欄位中的HTML標籤來建立RTF文字,例如粗體或斜體文字。
Custom API Call

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

模組會傳回下列資訊:

  • Status Code (數字):這表示您的HTTP要求成功或失敗。 這些是您可在網際網路上查閱的標準程式碼。

  • Headers (物件):與輸出本文無關之回應/狀態代碼的更詳細內容。 並非顯示在回應標題中的所有標題都是回應標題,因此某些標題可能對您並不實用。

    回應標題取決於您在設定模組時選擇的HTTP請求。

  • Body (物件):根據您在設定模組時所選擇的HTTP要求,您可能會收到傳回的部分資料。 該資料(例如來自GET請求的資料)包含在此物件中。

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

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

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
Connection 如需有關將Workfront應用程式連線到Workfront Fusion的說明,請參閱本文中的將Workfront連線到Workfront Fusion
URL 輸入相對於 https://<WORKFRONT_DOMAIN>/attask/api/<API_VERSION>/的路徑。
API Version 選取您希望模組使用的Workfront API版本。
Method

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

Headers

以標準JSON物件的形式新增請求的標頭。 這會決定請求的內容型別。

例如, {"Content-type":"application/json"}

注意:如果您收到錯誤且難以判斷其來源,請考慮根據Workfront檔案修改標題。 如果您的自訂API呼叫傳回422 HTTP請求錯誤,請嘗試使用"Content-Type":"text/plain"標頭。

Query String

以標準JSON物件的形式新增API呼叫的查詢。

例如: {"name":"something-urgent"}

提示:建議您透過JSON內文傳送資訊,而非查詢引數。

Body

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

注意:

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

檢視您可以在每個Workfront模組🔗可用的Workfront物件型別中使用此模組的Workfront物件型別清單。

Delete Record

此動作模組會刪除物件,例如Workfront中的專案、任務或問題。

您指定記錄的ID。

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

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

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header
Connection 如需有關將Workfront應用程式連線到Workfront Fusion的說明,請參閱本文中的將Workfront連線到Workfront Fusion
Force delete 啟用此選項以確保刪除記錄,即使Workfront UI會請求確認刪除。
Async delete 啟用此選項可允許模組非同步刪除。
ID

輸入您要模組刪除之記錄的唯一Workfront ID。

若要取得ID,請在瀏覽器中開啟Workfront物件,並在「ID=」後複製URL結尾的文字。 例如: https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e

Record Type 選取您要模組刪除的Workfront記錄型別。

檢視您可以在每個Workfront模組🔗可用的Workfront物件型別中使用此模組的Workfront物件型別清單。

note note
NOTE
我們建議使用下列案例設定,以避免因非同步操作而無法刪除記錄的可能性。
  1. 同步刪除記錄。
  2. 新增錯誤處理至刪除記錄模組,以忽略40秒逾時造成的錯誤。
Download Document

此動作模組會從Workfront下載檔案。

您指定記錄的ID。

模組會傳回檔案的內容、檔案名稱、副檔名和檔案大小。 您可以在情境中的後續模組中對應此資訊。

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

table 0-row-2 1-row-2 layout-auto html-authored no-header
Connection 如需有關將Workfront應用程式連線到Workfront Fusion的說明,請參閱本文中的將Workfront連線到Workfront Fusion
Document ID

對應或手動輸入您要模組下載之檔案的唯一Workfront ID。

若要取得ID,請在瀏覽器中開啟Workfront物件,並在「ID=」後複製URL結尾的文字。 例如: https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e

檢視您可以在每個Workfront模組🔗可用的Workfront物件型別中使用此模組的Workfront物件型別清單。

Misc Action

此動作模組可讓您對API執行動作。

note note
NOTE
截至2024年7月,convertToProject動作包含欄位copyCategories。 設定為TRUE時,所有自訂表單都將包含在問題轉換為的專案中。

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

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Connection 如需有關將Workfront應用程式連線到Workfront Fusion的說明,請參閱本文中的將Workfront連線到Workfront Fusion
Record Type 選取您希望模組與之互動的Workfront記錄型別。
Action

選取您希望模組執行的動作。

視您選擇的Record Type和Action而定,您可能需要填寫其他欄位。 這兩個設定的某些組合可能只需要記錄ID,而其他設定(例如 Record Type 的Project和 Action 的Attach Template)則需要其他資訊(例如物件ID和範本ID)。

如需某些動作可用的選項,請參閱本文中的其他動作選項

如需個別欄位的詳細資訊,請參閱Workfront開發人員檔案

注意:開發人員檔案網站僅包含透過API版本14的資訊,但仍包含API呼叫的重要資訊。

  1. 在Workfront開發人員檔案頁面的左側導覽區中選取記錄型別。 下列型別有自己的頁面:

    • Projects

    • Tasks

    • Issues

    • Users

    • Documents

    對於所有其他記錄型別,請選取 Other objects and endpoints,然後在按字母順序排序的頁面上找到記錄型別。

  2. 在適當記錄型別的頁面上,搜尋動作(Ctrl-F或Cmd-F)。

  3. 檢視所選動作下可用欄位的說明。

注意:

透過Workfront Misc Action模組建立校訂時,最佳實務是在沒有任何進階選項的情況下建立校訂,然後使用Workfront Proof SOAP API更新校訂。

如需使用Workfront API (此模組使用)建立校訂的詳細資訊,請參閱透過Adobe Workfront API建立校訂時新增進階校訂選項

ID

輸入或對應您希望模組與之互動之記錄的唯一Workfront ID。

若要取得ID,請在瀏覽器中開啟Workfront物件,並在「ID=」後複製URL結尾的文字。 例如: https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e

檢視您可以在每個Workfront模組🔗可用的Workfront物件型別中使用此模組的Workfront物件型別清單。

其他動作選項

任務
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored
動作 選項
複製
  • clearApprovers

  • clearAssigments

  • clearConstraints

  • clearCustomData

  • clearDocuments

  • clearExpenses

  • clearFinancials

    清除財務資料

  • clearpermissions

  • clearPredecessors

  • clearProgress

  • clearTimedNotifications

    清除提醒通知

移動
  • clearApprovers

  • clearAssigments

  • clearDocuments

  • clearConstraints

  • clearExpenses

  • clearFinancials

    清除財務資料

  • clearpermissions

  • clearPredecessors

  • clearProgress

  • clearTimedNotifications

    清除提醒通知

問題
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored
動作 選項
複製
  • clearApprovers
  • clearAssigments
  • clearCustomData
  • clearDocuments
  • clearpermissions
  • clearProgress
轉換為任務
  • preserveIssue

    保持初始問題並將其解決方案連結至此任務

  • preservePrimaryContact

    允許問題的主要連絡人存取此任務

  • preserveCompletionDate

    保持問題的計畫完成日期

轉換為專案
  • preserveIssue

    保持初始問題並將其解決方案連結至此任務

  • preservePrimaryContact

    允許問題的主要連絡人存取此任務

專案
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored
動作 選項
複製
  • clearApprovers

  • clearAssigments

  • clearCustomData

  • clearDocuments

  • clearExpenses

  • clearFinancials

    清除財務資料

  • clearpermissions

  • clearPredecessors

  • clearProgress

  • clearTimedNotifications

    清除提醒通知

附加範本/另存為範本
  • clearApprovers

  • clearAssigments

  • clearBillingRates

  • clearConstraints

  • clearDeliverables

    清除目標

  • clearDocuments

  • clearExpenses

  • clearFinancials

    清除財務資料

  • clearHourTypes

  • Clearisssetup

    清除佇列屬性和問題設定

  • clearPredecessors

  • clearrisks

  • clearSharingOptions

  • clearTimedNotifications

    清除提醒通知

Read a Record

此動作模組會從單一記錄擷取資料。

您指定記錄的ID。 您也可以指定要讓模組讀取哪些相關記錄。

例如,如果模組正在讀取的記錄是專案,您可以指定您要讀取專案任務。

模組會從您指定的輸出欄位傳回資料陣列。

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

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
Connection 如需有關將Workfront應用程式連線到Workfront Fusion的說明,請參閱本文中的將Workfront連線到Workfront Fusion
Record Type 選擇您希望模組讀取的Workfront物件型別。
Outputs 選取要包含在此模組輸出組合中的資訊。
References 選取您要納入輸出的任何參考欄位。
Collections 選取您要納入輸出的任何參考欄位。
ID

輸入您希望模組讀取之記錄的唯一Workfront ID。

若要取得ID,請在瀏覽器中開啟Workfront物件,並在「ID=」後複製URL結尾的文字。 例如: https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e

檢視您可以在每個Workfront模組🔗可用的Workfront物件型別中使用此模組的Workfront物件型別清單。

Update Record

此動作模組會更新物件,例如專案、任務或問題。 模組可讓您選取可在模組中取得哪些物件欄位。

您指定記錄的ID。

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

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

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Connection 如需有關將Workfront應用程式連線到Workfront Fusion的說明,請參閱本文中的將Workfront連線到Workfront Fusion
ID

輸入您希望模組更新的記錄的唯一Workfront ID。

若要取得ID,請在瀏覽器中開啟Workfront物件,並在「ID=」後複製URL結尾的文字。 例如: https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e

Record Type 選取您要模組更新的Workfront記錄型別。
Select fields to map 選取您想用於資料輸入的欄位。 這可讓您使用這些欄位,而無需捲動瀏覽您不需要的欄位。 您接著可以在這些欄位中輸入或對應資料。

檢視您可以在每個Workfront模組🔗可用的Workfront物件型別中使用此模組的Workfront物件型別清單。

note note
NOTE
  • 輸入物件的ID時,您可以開始輸入物件的名稱,然後從清單中選取它。 模組接著在欄位中輸入適當的ID。
  • 輸入自訂欄位或Note物件(註解或回覆)的文字時,您可以使用Note Text欄位中的HTML標籤來建立RTF文字,例如粗體或斜體文字。
Upload Document

此動作模組會將檔案上傳到Workfront物件,例如專案、任務或問題。 此模組會以區塊上傳檔案,讓Workfront的上傳程式更順暢。

此模組可處理比舊版模組更大的檔案,屬於分階段推出至使用Ultimate Workfront套件的組織的一部分。

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

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

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

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header
Connection 如需有關將Workfront應用程式連線到Workfront Fusion的說明,請參閱本文中的將Workfront連線到Workfront Fusion
Related Record ID 輸入您要上傳檔案之記錄的唯一Workfront ID。
Related Record Type 選取您希望模組上傳檔案的Workfront記錄型別。
Folder ID 視相關記錄的型別而定,您可能需要輸入或對映資料夾ID。
Source file 從先前的模組中選取來源檔案,或對應來源檔案的名稱和資料。

檢視您可以在每個Workfront模組🔗可用的Workfront物件型別中使用此模組的Workfront物件型別清單。

Upload Document (Legacy)

此動作模組會將檔案上傳到Workfront物件,例如專案、任務或問題。 它會一次上傳整個檔案。

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

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

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

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header
Connection 如需有關將Workfront應用程式連線到Workfront Fusion的說明,請參閱本文中的將Workfront連線到Workfront Fusion
Related Record ID 輸入您要上傳檔案之記錄的唯一Workfront ID。
Related Record Type 選取您希望模組上傳檔案的Workfront記錄型別。
Folder ID 視相關記錄的型別而定,您可能需要輸入或對映資料夾ID。
Source file 從先前的模組中選取來源檔案,或對應來源檔案的名稱和資料。

檢視您可以在每個Workfront模組🔗可用的Workfront物件型別中使用此模組的Workfront物件型別清單。

搜尋

Read Related Records

此搜尋模組會讀取符合您指定之搜尋查詢的記錄(在特定父物件中)。

您可以指定要包含在輸出中的欄位。 您可以在情境中的後續模組中對應此資訊。

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

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header
Connection 如需有關將Workfront應用程式連線到Workfront Fusion的說明,請參閱本文中的將Workfront連線到Workfront Fusion
Record Type

選取您要讀取其關聯記錄的父記錄型別(Workfront物件)。

請參閱本文中每個Workfront模組可用的Workfront物件型別中,可使用此模組的Workfront物件型別清單。

Parent Record ID

輸入或對應您要讀取其關聯記錄的父記錄識別碼。

若要取得ID,請在瀏覽器中開啟Workfront物件,並在「ID=」後複製URL結尾的文字。 例如: https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e

Collections 選取或對應您希望模組讀取的子記錄型別。
Outputs 選取要包含在此模組輸出組合中的資訊。
Search

此搜尋模組會在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 8-row-2 layout-auto html-authored no-header
Connection 如需有關將Workfront應用程式連線到Workfront Fusion的說明,請參閱本文中的將Workfront連線到Workfront Fusion
Record Type 選取您要模組搜尋的Workfront記錄型別。
Result Set 選取選項以指定您希望模組取得符合搜尋條件的第一個結果,還是所有符合該條件的結果。
Maximal 輸入或對應您希望模組在每個案例執行週期中傳回的最大記錄數。
Search criteria fields 選取您要用於搜尋條件的欄位。 這些欄位隨後將顯示在搜尋條件下拉式清單中。
Search criteria

輸入您要搜尋的欄位、要在查詢中使用的運運算元,以及要在欄位中搜尋的值。

注意:請勿在您的搜尋條件中使用username 。 若在Workfront的API查詢中加入username ,使用者就會登入Workfront,搜尋將不會成功。

注意: InNotIn可搭配陣列使用。 輸入的格式應為陣列。

Outputs 選取您要包含在此模組輸出中的欄位。
References 選取您要納入搜尋的任何參考欄位。
Collections 選取您要新增至搜尋的任何集合。

適用於每個Workfront模組的Workfront物件型別

每個Workfront觸發程式模組可用的物件型別
table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 6-row-4 7-row-4 8-row-4 9-row-4 10-row-4 11-row-4 12-row-4 13-row-4 14-row-4 15-row-4 16-row-4 17-row-4 18-row-4 19-row-4 20-row-4 21-row-4 22-row-4 23-row-4 24-row-4 25-row-4 26-row-4 27-row-4 28-row-4 29-row-4 30-row-4 31-row-4 32-row-4 33-row-4 34-row-4 35-row-4 36-row-4 37-row-4 38-row-4 39-row-4 40-row-4 41-row-4 layout-auto
Watch Record Watch Field Watch Events
核准流程 ✓ (A)
指派 ✓ (A) ✓ (A)
基準線 ✓ (A)
計費記錄 ✓ (A)
計費率 ✓ (A)
公司 ✓ (A) ✓ (A) ✓ (A)
儀表板 ✓ (A)
文件 ✓ (A) ✓ (A) ✓ (A)
文件資料夾 ✓ (A) ✓ (A)
文件要求 ✓ (A)
文件版本 ✓ (A) ✓ (A)
費用 ✓ (A) ✓ (A) ✓ (A)
費用類型
群組 ✓ (A) ✓ (A)
小時 ✓ (A) ✓ (A)
時數類型 ✓ (A)
問題 ✓ (A) ✓ (A) ✓ (A)
疊代 ✓ (A) ✓ (A)
職務角色 ✓ (A) ✓ (A)
日誌輸入項目 ✓ (A)
里程碑 ✓ (A)
里程碑路徑 ✓ (A) ✓ (A)
備註 ✓ (A) ✓ (A) ✓ (A)
附註標籤 ✓ (A)
專案組合 ✓ (A) ✓ (A) ✓ (A)
方案 ✓ (A) ✓ (A) ✓ (A)
專案 ✓ (A) ✓ (A) ✓ (A)
專案使用者 ✓ (A)
校樣核准 ✓ (A)
保留時間* ✓ (A)
報告 ✓ (A)
風險
風險類型
步驟核准者 ✓ (A)
任務 ✓ (A) ✓ (A) ✓ (A)
團隊 ✓ (A)
範本 ✓ (A) ✓ (A) ✓ (A)
範本任務 ✓ (A) ✓ (A)
時程表 ✓ (A) ✓ (A) ✓ (A)
使用者 ✓ (A) ✓ (A) ✓ (A)
更新
每個Workfront動作模組可用的物件型別
note note
NOTE
Download Document模組未包含在此資料表中,因為Workfront物件型別不是其設定的一部分。
table 0-row-8 1-row-8 2-row-8 3-row-8 4-row-8 5-row-8 6-row-8 7-row-8 8-row-8 9-row-8 10-row-8 11-row-8 12-row-8 13-row-8 14-row-8 15-row-8 16-row-8 17-row-8 18-row-8 19-row-8 20-row-8 21-row-8 22-row-8 23-row-8 24-row-8 25-row-8 26-row-8 27-row-8 28-row-8 29-row-8 30-row-8 31-row-8 32-row-8 33-row-8 34-row-8 35-row-8 36-row-8 37-row-8 38-row-8 39-row-8 layout-auto
Create a record Update a record Delete a record Upload Document Read a record Custom API Call Misc Action
核准流程 ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A)
指派 ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A)
基準線 ✓ (A) ✓ (A) ✓ (A) ✓ (A)
計費記錄 ✓ (A) ✓ (A) ✓ (A) ✓ (A)
計費率 ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A)
公司 ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A)
文件 ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A)
文件資料夾 ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A)
文件版本 ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A)
匯率 ✓ (A) ✓ (A) ✓ (A) ✓ (A)
費用 ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A)
費用類型 ✓ (A) ✓ (A) ✓ (A) ✓ (A)
外部檔案 ✓ (A)
群組 ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A)
小時 ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A)
時數類型 ✓ (A) ✓ (A) ✓ (A) ✓ (A)
問題 ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A)
疊代 ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A)
職務角色 ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A)
日誌輸入項目 ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A)
里程碑 ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A)
里程碑路徑 ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A)
備註 ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A)
附註標籤 ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A)
專案組合 ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A)
方案 ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A)
專案 ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A)
專案使用者 ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A)
保留時間* ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A)
風險 ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A)
風險類型 ✓ (A) ✓ (A) ✓ (A) ✓ (A)
步驟核准者 ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A)
任務 ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A)
團隊 ✓ (A) ✓ (A) ✓ (A) ✓ (A)
範本 ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A)
範本任務 ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A)
時程表 ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A)
使用者 ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A)
更新 ✓ (A)
每個Workfront搜尋模組可用的物件型別
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 9-row-3 10-row-3 11-row-3 12-row-3 13-row-3 14-row-3 15-row-3 16-row-3 17-row-3 18-row-3 19-row-3 20-row-3 21-row-3 22-row-3 23-row-3 24-row-3 25-row-3 26-row-3 27-row-3 28-row-3 29-row-3 30-row-3 31-row-3 32-row-3 33-row-3 34-row-3 35-row-3 36-row-3 layout-auto
Search Read Related Records
核准流程 ✓ (A) ✓ (A)
指派 ✓ (A) ✓ (A)
計費記錄 ✓ (A)
計費率 ✓ (A)
公司 ✓ (A) ✓ (A)
文件 ✓ (A) ✓ (A)
文件資料夾 ✓ (A) ✓ (A)
文件版本 ✓ (A)
費用 ✓ (A)
費用類型 ✓ (A)
群組 ✓ (A) ✓ (A)
小時 ✓ (A)
時數類型 ✓ (A)
問題 ✓ (A) ✓ (A)
疊代 ✓ (A)
職務角色 ✓ (A)
日誌輸入項目 ✓ (A)
里程碑 ✓ (A)
里程碑路徑 ✓ (A)
備註 ✓ (A)
附註標籤 ✓ (A)
專案組合 ✓ (A) ✓ (A)
方案 ✓ (A)
專案 ✓ (A) ✓ (A)
專案使用者 ✓ (A)
保留時間* ✓ (A)
風險 ✓ (A)
風險類型 ✓ (A)
步驟核准者 ✓ (A)
任務 ✓ (A) ✓ (A)
團隊 ✓ (A)
範本 ✓ (A)
範本任務 ✓ (A)
時程表 ✓ (A) ✓ (A)
使用者 ✓ (A) ✓ (A)
使用者委派 ✓ (A)

建議您仔細檢查,確保此功能的運作方式與預期的一樣。

Workfront > Watch Events模組中的事件訂閱篩選器

NOTE
我們強烈建議您在您的Watch Events模組中使用事件訂閱篩選器。

Workfront Watch Events模組會根據Workfront API中建立事件訂閱的webhook來觸發案例。 事件訂閱是一組資料,可決定要將哪些事件傳送到webhook。 例如,如果您設定Watch Events模組來監視問題,則事件訂閱只會傳送與問題相關的事件。

透過使用事件訂閱篩選器,Fusion使用者可建立更適合其使用案例的事件訂閱。 例如,您可以在Workfront API中設定事件訂閱,以僅將特定專案中的問題傳送至webhook,確保Watch Events模組僅會觸發該專案中的問題。 建立較窄觸發器的功能可減少不相關觸發器的數量,進而改善情境設計。

這與在Workfront Fusion情境中設定篩選器不同。 如果沒有事件訂閱篩選器,您的webhook會接收與您選取的物件型別相關的所有事件。 這些事件大多與情境無關,必須先篩選掉,情境才能繼續。

「Workfront >關注事件」篩選器中提供下列運運算元:

  • 等於

  • 不等於

  • 大於

  • 小於

  • 大於或等於

  • 小於或等於

  • 包含

  • 存在

    • 此運運算元不需要值,而且值欄位不存在。
  • 不存在

    • 此運運算元不需要值,而且值欄位不存在。
  • 已變更

    • 此運運算元不需要值,而且值欄位不存在。
    • 此運運算元會忽略狀態列位。
    • 使用Changed時,請在​ 記錄來源 ​欄位中選取​ 僅更新事件
IMPORTANT
您無法在現有的Workfront Webhook中編輯篩選器。 若要為Workfront活動訂閱設定不同的篩選器,請移除目前的webhook並建立新的篩選器。
INFO
範例: ​考慮處理指派給特定使用者Ana之新問題的案例。

使用事件訂閱篩選器來篩選事件(建議使用) %E4%BD%BF%E7%94%A8%E4%BA%8B%E4%BB%B6%E8%A8%82%E9%96%B1%E7%AF%A9%E9%81%B8%E5%99%A8%E4%BE%86%E7%AF%A9%E9%81%B8%E4%BA%8B%E4%BB%B6%EF%BC%88%E5%BB%BA%E8%AD%B0%E4%BD%BF%E7%94%A8%EF%BC%89

使用事件篩選器,您可以設定webhook以在建立問題時將問題指派給Ana時觸發情境。 Ana具有userID b378489d8f7cd3cee0539260720a84b7。
事件篩選器
如果一天內建立100個問題,但只有兩個問題指派給Ana,則案例會執行兩次。

篩選案例中的事件(不建議) %E7%AF%A9%E9%81%B8%E6%A1%88%E4%BE%8B%E4%B8%AD%E7%9A%84%E4%BA%8B%E4%BB%B6%EF%BC%88%E4%B8%8D%E5%BB%BA%E8%AD%B0%EF%BC%89

若要篩選事件,以便只處理指派給Ana的問題,您可以在Watch Events模組之後建立篩選器。
沒有事件篩選器
如果一天內建立100個問題,但只有兩個問題指派給Ana,則案例將執行100次。 98個執行會在篩選後停止,但觸發模組仍在所有執行中使用資料並執行操作。

如需Workfront活動訂閱的詳細資訊,請參閱常見問題集 — 活動訂閱

如需Webhook的詳細資訊,請參閱Adobe Workfront Fusion中的即時觸發器(Webhook)

如需情境中篩選器的詳細資訊,請參閱將篩選器新增至情境

recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3