Adobe Workfront模組

您可以使用Adobe Workfront Fusion Adobe Workfront聯結器在Workfront內自動化您的程式。 如果您有Workfront Fusion的Work Automation與Integration授權,也可以用它來連線到協力廠商的應用程式和服務。

Workfront聯結器不會計入您的組織可用的作用中應用程式數目。 所有情境(即使只使用Workfront應用程式)都會計入貴組織的情境總數。

如需貴組織可用應用程式和情境的詳細資訊,請參閱Adobe Workfront Fusion 組織和團隊中的組織

如果您需要有關建立案例的指示,請參閱在 Adobe Workfront Fusion中建立案例。 如需模組的相關資訊,請參閱 Adobe Workfront Fusion🔗中的模組。

存取需求

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

Adobe Workfront 計畫*
Pro或更高版本
Adobe Workfront 授權*
計畫,工作
Adobe Workfront Fusion 授權**

目前授權需求:無Workfront Fusion授權需求。

舊版授權需求: Workfront Fusion for Work Automation and Integration,Workfront Fusion for Work Automation

產品

目前產品需求:如果您有Select或Prime Adobe Workfront計畫,貴組織必須購買Adobe Workfront Fusion及Adobe Workfront,才能使用本文所述的功能。 Workfront Fusion包含在Ultimate Workfront計畫中。

舊版產品需求:您的組織必須購買Adobe Workfront Fusion及Adobe Workfront,才能使用本文所述的功能。

若要瞭解您擁有的計畫、授權型別或存取權,請連絡您的Workfront管理員。

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

將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
    連線名稱 輸入新連線的名稱。
    環境 選取要連線到生產或非生產環境。
    連線型別 選取您要連線到服務帳戶還是個人帳戶。
    使用者端ID 輸入您的Workfront使用者端識別碼。 您可在Workfront中「設定」區域的「OAuth2應用程式」區域中找到此專案。 開啟您要連線的特定應用程式以檢視使用者端ID。
    使用者端密碼 輸入您的Workfront使用者端識別碼。 您可在Workfront中「設定」區域的「OAuth2應用程式」區域中找到此專案。 開啟您要連線的特定應用程式以檢視使用者端ID。
    驗證URL

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

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

    主機前置詞 在大多數情況下,此值應該是origin
  3. 按一下​ 繼續 ​以儲存連線並返回模組。

NOTE
  • 如果您沒有看到SAML登入按鈕,表示您的組織尚未啟用單一登入(SSO)。 您可以使用您的使用者名稱和密碼登入。

    如需有關SSO的詳細資訊,請參閱單一登入概述 Adobe Workfront

  • Workfront API的OAuth 2.0連線不再依賴API金鑰。

  • 若要建立與Workfront沙箱環境的連線,您必須在該環境中建立OAuth2應用程式,然後在您的連線中使用該應用程式產生的使用者端ID和使用者端密碼。

    如需在Workfront中建立OAuth2應用程式的指示,請參閱為Workfront整合建立OAuth2應用程式一文中的使用使用者認證(授權代碼流程)建立OAuth2應用程式

Workfront模組及其欄位

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

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

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

觸發器

觀看活動

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

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

  1. 按一下​ Webhook ​方塊右側的​ [新增]

  2. 在顯示的​ 新增連結 ​方塊中設定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名稱 (可選)為webhook輸入新名稱
    Connection 如需有關將Workfront應用程式連線到Workfront Fusion的說明,請參閱本文中的將Workfront連線到Workfront Fusion
    記錄型別 選取您希望模組觀看的Workfront記錄型別。
    狀態

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

    • 新狀態

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

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

    • 舊狀態

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

      例如,如果狀態設為Old State,而篩選條件設為Status Equals In Progress,則當Status目前為In Progress的狀態變更為其他狀態時,webhook會觸發一個情境。

    事件篩選器

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

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

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

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

    排除此連線造成的事件

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

    注意 指派記錄型別不包含此選項。

    記錄來源

    選擇您希望案例僅觀看 新記錄僅更新記錄新記錄和更新記錄Deleted Records Only

    注意:如果您選擇 新增和更新的記錄,webhook建立會建立2個事件訂閱(針對相同的webhook位址)。

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

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

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

觀看欄位

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

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

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
記錄型別

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

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

欄位 選取您希望模組監視更新的欄位。 這些欄位反映Workfront管理員已設定用於追蹤的欄位。
輸出 選取要包含在此模組輸出組合中的資訊。
限制 輸入或對應您希望模組在每個案例執行週期中傳回的最大記錄數。

檢視您可以在每個 Workfront 模組🔗可用的Workfront 物件型別中使用此模組的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
Connection 如需有關將Workfront應用程式連線到Workfront Fusion的說明,請參閱本文中的將Workfront連線到Workfront Fusion
篩選器 選擇您希望案例僅觀看 新記錄僅更新記錄新記錄和更新記錄
記錄型別

(在您選擇 篩選器 之後顯示。)選取您要模組觀看的Workfront記錄型別。

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

輸出 選取要包含在此模組輸出組合中的資訊。
選用篩選器 (進階)輸入API程式碼字串,以定義將縮小條件範圍的任何其他引數或程式碼。
限制 輸入或對應您希望模組在每個案例執行週期中傳回的最大記錄數。

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

動作

轉換物件

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

  • 將問題轉換為專案
  • 將問題轉換為任務
  • 將任務轉換為專案
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
物件型別 選取您要轉換的物件型別。 這是轉換前物件的型別。
轉換為 選取您想要將它轉換成的物件。 這是物件在轉換後的型別。
<物件> ID

輸入物件的ID。

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

範本ID

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

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

自訂表單 選取您要新增至新轉換物件的任何自訂表單,然後輸入自訂表單欄位的值。
Options 啟用轉換物件時所需的任何選項。 選項是否可用取決於您轉換至哪個物件或轉換自哪個物件。
複製原生欄位 啟用此選項可將任何原生欄位從原始物件複製到新物件。
複製自訂表單 啟用此選項可將任何原生欄位從原始物件複製到新物件。
建立記錄(附加自訂表格)

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

您指定記錄的ID。

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

例如,當使用者端在需要完成的工作清單Google Sheets中新增一列時,您可以使用此模組在Workfront中建立工作。

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

請務必提供最小輸入欄位數。 例如,如果您想建立問題,則需要在「專案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
記錄型別

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

例如,如果您想要建立專案,請從下拉式清單中選取專案,然後確定您有權存取將填入專案的資料(來自案例中先前模組)。

選擇要對應的欄位

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

對於自訂表單中的欄位,請使用 附加自訂表單 欄位。

附加自訂表單 選取您要新增至新物件的任何自訂表單,然後輸入這些欄位的值。

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

note note
NOTE
  • 輸入物件的ID時,您可以開始輸入物件的名稱,然後從清單中選取它。 模組接著在欄位中輸入適當的ID。

  • 輸入自訂欄位或Note物件(註解或回覆)的文字時,您可以使用Note文字欄位中的HTML標籤來建立RTF文字,例如粗體或斜體文字。

    如需更新中RTF文字的詳細資訊,請參閱更新工作中的將更新新增至工作專案

建立記錄

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

您指定記錄的ID。

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

例如,當使用者端在Google工作表清單中新增需要完成的工作時,您可以使用此模組在Workfront中建立工作。

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

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

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

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

例如,如果您想要建立專案,請從下拉式清單中選取專案,然後確定您有權存取將填入專案的資料(來自案例中先前模組)。

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

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

note note
NOTE
  • 輸入物件的ID時,您可以開始輸入物件的名稱,然後從清單中選取它。 模組接著在欄位中輸入適當的ID。

  • 輸入自訂欄位或Note物件(註解或回覆)的文字時,您可以使用Note文字欄位中的HTML標籤來建立RTF文字,例如粗體或斜體文字。

    如需更新中RTF文字的詳細資訊,請參閱更新工作中的將更新新增至工作專案

自訂API呼叫

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

模組會傳回下列資訊:

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

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

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

  • 內文 (物件):根據您在設定模組時所選擇的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版本 選取您希望模組使用的Workfront API版本。
方法

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

Headers

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

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

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

查詢字串

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

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

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

Body

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

注意:

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

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

刪除記錄

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

您指定記錄的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
強制刪除 啟用此選項以確保刪除記錄,即使Workfront UI要求確認刪除。
ID

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

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

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

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

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

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

您指定記錄的ID。

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

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

table 0-row-2 1-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

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

其他動作

此動作模組可讓您對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
記錄型別 選取您希望模組與之互動的Workfront記錄型別。
動作

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

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

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

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

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

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

    • 專案

    • 工作

    • 問題

    • 使用者

    • 檔案

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

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

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

注意:

透過Workfront 雜湊動作模組建立校訂時,最佳實務是建立不含任何進階選項的校訂,然後使用Workfront Proof SOAP API更新校訂。

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

ID

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

若要取得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

    清除提醒通知

讀取記錄

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

您指定記錄的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
記錄型別 選擇您希望模組讀取的Workfront物件型別。
輸出 選取要包含在此模組輸出組合中的資訊。
參考 選取您要納入輸出的任何參考欄位。
集合 選取您要納入輸出的任何參考欄位。
ID

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

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

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

更新記錄

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

您指定記錄的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,請在瀏覽器中開啟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文字欄位中的HTML標籤來建立RTF文字,例如粗體或斜體文字。

    如需更新中RTF文字的詳細資訊,請參閱更新工作中的將更新新增至工作專案

上傳檔案

此動作模組會將檔案上傳到Workfront物件,例如專案、任務或問題。 此模組會以區塊上傳檔案,讓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
相關記錄ID 輸入您要將檔案上傳到其中之記錄的唯一Workfront識別碼。
相關記錄型別 選取您希望模組上傳檔案的Workfront記錄型別。
資料夾ID 視相關記錄的型別而定,您可能需要輸入或對映資料夾ID。
Source檔案 從先前的模組中選取來源檔案,或對應來源檔案的名稱和資料。

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

上傳檔案(舊版)

此動作模組會將檔案上傳到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
相關記錄ID 輸入您要將檔案上傳到其中之記錄的唯一Workfront識別碼。
相關記錄型別 選取您希望模組上傳檔案的Workfront記錄型別。
資料夾ID 視相關記錄的型別而定,您可能需要輸入或對映資料夾ID。
Source檔案 從先前的模組中選取來源檔案,或對應來源檔案的名稱和資料。

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

搜尋

讀取相關記錄

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

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

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

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
記錄型別

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

檢視Workfront物件型別的清單,您可以針對此清單在本文章中每個Workfront模組可用的Workfront物件型別中使用此模組。

父記錄ID

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

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

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

此搜尋模組會在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
記錄型別 選取您要模組搜尋的Workfront記錄型別。
結果集 選取選項以指定您希望模組取得符合搜尋條件的第一個結果,還是所有符合該條件的結果。
Maximal 輸入或對應您希望模組在每個案例執行週期中傳回的最大記錄數。
搜尋條件欄位 選取您要用於搜尋條件的欄位。 這些欄位隨後將顯示在搜尋條件下拉式清單中。
搜尋條件

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

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

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

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

此搜尋模組會在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
Connection 如需有關將Workfront應用程式連線到Workfront Fusion的說明,請參閱本文中的將Workfront連線到Workfront Fusion
記錄型別 選取您要模組搜尋的Workfront記錄型別。
結果集 選取選項以指定您希望模組取得符合搜尋條件的第一個結果,還是所有符合該條件的結果。
Maximal 輸入或對應您希望模組在每個案例執行週期中傳回的最大記錄數。
搜尋條件

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

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

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

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

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

每個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
監看紀錄 監視欄位 觀看活動
核准流程 ✓ (A)
指派 ✓ (A) ✓ (A)
基準線 ✓ (A)
計費記錄 ✓ (A)
計費率 ✓ (A)
公司 ✓ (A) ✓ (A) ✓ (A)
儀表板 ✓ (A)
文件 ✓ (A) ✓ (A) ✓ (A)
文件資料夾 ✓ (A) ✓ (A)
文件要求 ✓ (A)
文件版本 ✓ (A) ✓ (A)
費用 ✓ (A) ✓ (A) ✓ (A)
費用類型
群組 ✓ (A) ✓ (A)
小時 ✓ (A) ✓ (A)
時數類型 ✓ (A)
問題 ✓ (A) ✓ (A) ✓ (A)
反覆項目 ✓ (A) ✓ (A)
職務角色 ✓ (A) ✓ (A)
日誌輸入項目 ✓ (A)
里程碑 ✓ (A)
里程碑路徑 ✓ (A) ✓ (A)
備註 ✓ (A) ✓ (A) ✓ (A)
附註標籤 ✓ (A)
專案組合 ✓ (A) ✓ (A) ✓ (A)
方案 ✓ (A) ✓ (A) ✓ (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
下載檔案模組未包含在此資料表中,因為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
建立記錄 更新記錄 刪除記錄 上傳檔案 讀取記錄 自訂API呼叫 其他動作
核准流程 ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A)
指派 ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A)
基準線 ✓ (A) ✓ (A) ✓ (A) ✓ (A)
計費記錄 ✓ (A) ✓ (A) ✓ (A) ✓ (A)
計費率 ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A)
公司 ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A)
文件 ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A)
文件資料夾 ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A)
文件版本 ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A)
匯率 ✓ (A) ✓ (A) ✓ (A) ✓ (A)
費用 ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A)
費用類型 ✓ (A) ✓ (A) ✓ (A) ✓ (A)
外部檔案 ✓ (A)
群組 ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A)
小時 ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A)
時數類型 ✓ (A) ✓ (A) ✓ (A) ✓ (A)
問題 ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A)
反覆項目 ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A)
職務角色 ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A)
日誌輸入項目 ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A)
里程碑 ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A)
里程碑路徑 ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A)
備註 ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A)
附註標籤 ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A)
專案組合 ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A)
方案 ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A)
專案 ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A)
專案使用者 ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A)
保留時間* ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A)
風險 ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A)
風險類型 ✓ (A) ✓ (A) ✓ (A) ✓ (A)
步驟核准者 ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A)
任務 ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A) ✓ (A)
團隊 ✓ (A) ✓ (A) ✓ (A) ✓ (A)
範本 ✓ (A) ✓ (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
搜尋 讀取相關記錄
核准流程 ✓ (A) ✓ (A)
指派 ✓ (A) ✓ (A)
計費記錄 ✓ (A)
計費率 ✓ (A)
公司 ✓ (A) ✓ (A)
文件 ✓ (A) ✓ (A)
文件資料夾 ✓ (A) ✓ (A)
文件版本 ✓ (A)
費用 ✓ (A)
費用類型 ✓ (A)
群組 ✓ (A) ✓ (A)
小時 ✓ (A)
時數類型 ✓ (A)
問題 ✓ (A) ✓ (A)
反覆項目 ✓ (A)
職務角色 ✓ (A)
日誌輸入項目 ✓ (A)
里程碑 ✓ (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
我們強烈建議您在您的觀看活動模組中使用事件訂閱篩選器。

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

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

這與在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的問題,您可以在觀看事件模組之後建立篩選器。
如果一天內建立100個問題,但只有兩個問題指派給Ana,則案例將執行100次。 98個執行會在篩選後停止,但觸發模組仍在所有執行中使用資料並執行操作。

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

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

如需情境中篩選的詳細資訊,請參閱在 Adobe Workfront Fusion中將篩選新增至情境。

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43