Adobe Workfront Planning模組

透過Adobe Workfront Planning模組,您可以在Workfront Planning中發生事件時觸發案例。 您也可以建立、讀取、更新及刪除記錄,或執行自訂API呼叫至您的Adobe Workfront Planning帳戶。

存取需求

展開以檢視本文中功能的存取需求。
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
Adobe Workfront套件

任何Adobe Workfront Workflow套件和任何Adobe Workfront自動化與整合套件

Workfront Ultimate

Workfront Prime和Select套件,以及額外購買的Workfront Fusion。

Adobe Workfront授權

標準

工作或更高

產品 如果您的組織有Select或Prime Workfront套件,但不包含Workfront Automation和Integration,則您的組織必須購買Adobe Workfront Fusion。

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

accordion
##必要條件

您必須具備下列專案才能存取Workfront Planning:

  • 新的Workfront套件和授權。 Workfront計畫不適用於舊版Workfront套件或授權。
  • Workfront計畫套件。
  • 貴組織的Workfront執行個體必須上線至Adobe統一體驗。

Adobe Workfront規劃API資訊

Adobe Workfront Planning聯結器使用下列專案:

table 0-row-2 1-row-2 layout-auto html-authored no-header
基礎 URL https://{{connection.host}}/maestro/api/{{common.maestroApiVersion}}/
API標籤 v1.13.7

建立與Adobe Workfront Planning的連線 create-a-connection-to-adobe-workfront-planning

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

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

  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

    (選填)

    輸入您的Adobe 使用者端識別碼。 這可以在Adobe Developer Console的認證詳細資料區段中找到。

    使用者端密碼

    (選填)

    輸入您的Adobe 使用者端密碼。 這可以在Adobe Developer Console的認證詳細資料區段中找到。
    驗證URL

    輸入您的Workfront執行個體將用來驗證此連線的URL。

    預設值為 https://oauth.my.workfront.com/integrations/oauth2

    主機前置詞

    輸入您的主機前置詞。

    預設值為 origin-

  3. 按一下​ 繼續 ​以儲存連線並返回模組。

Adobe Workfront Planning模組及其欄位

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

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

地圖切換

觸發程序

觀看活動

在Workfront Planning中建立、更新或刪除記錄、記錄型別或工作區時,此觸發模組會啟動案例。

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
Webhook 選取您要使用的webhook,或按一下「新增」以建立新的webhook。
Connection 如需建立Adobe Workfront Planning連線的說明,請參閱本文中的建立與Adobe Workfront Planning的連線。
物件型別 選取您要監視記錄、記錄型別或工作區。
狀態

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

  • 新狀態

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

  • 舊狀態

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

Workspace 如果觀看記錄,請選取您要觀看記錄的Workspace 。
記錄型別 如果觀看記錄,請選取您要觀看的記錄型別。
事件篩選器

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

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

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

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

要觀看的物件 選取是否要監視新專案。 更新、新增和更新或刪除的記錄。
排除此連線所做的更新 啟用此選項可防止此模組使用的連線進行變更時觸發此案例。 如此可防止在此案例執行觸發動作時觸發另一個案例例項。

動作

刪除記錄型別

此動作模組會依據其ID刪除Workfront Planning中的單一記錄型別。

note warning
WARNING
刪除Workfront Planning中的記錄型別也會刪除記錄型別表格中的所有記錄。
table 0-row-2 1-row-2 layout-auto html-authored no-header
Connection 如需建立Adobe Workfront Planning連線的說明,請參閱本文中的建立與Adobe Workfront Planning的連線。
記錄型別ID 輸入或對應您要刪除之記錄型別的ID。

進行自訂API呼叫

此模組會對Adobe Workfront Planning API發出自訂API呼叫。

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 如需建立Adobe Workfront Planning連線的說明,請參閱本文中的建立與Adobe Workfront Planning的連線。
URL 輸入相對於 https://(YOUR_WORKFRONT_DOMAIN)/maestro/api/
方法 選取設定API呼叫所需的HTTP要求方法。 如需詳細資訊,請參閱HTTP要求方法
Headers

以標準JSON物件的形式新增請求的標頭。

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

Workfront Fusion會自動新增授權標頭。

查詢字串 針對您想要新增至查詢字串的每個索引鍵/值組,按一下 新增專案 並輸入索引鍵和值。
Body

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

注意:

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

搜尋

搜尋記錄

此動作模組會根據您指定的條件擷取記錄清單。

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 如需建立Adobe Workfront Planning連線的說明,請參閱本文中的建立與Adobe Workfront Planning的連線。
Workspace 輸入或對應包含您要搜尋之記錄的Workspace。
記錄型別 選取您要搜尋的記錄型別。
記錄欄位 針對搜尋中要使用的每個欄位,找到該欄位,選取運運算元,然後輸入或對應您要搜尋的值。 根據所選的記錄型別,可使用欄位。
篩選條件

選取篩選條件:

  • 模組傳回符合您選取之欄位值的 所有 的記錄。

  • 模組傳回符合您選取之欄位值的 任一 的記錄。

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

未分類

建立記錄

這個動作會在Workfront Planning中建立單一記錄。

table 0-row-2 1-row-2 2-row-2 3-row-0 layout-auto html-authored no-header
Connection 如需建立Adobe Workfront Planning連線的說明,請參閱本文中的建立與Adobe Workfront Planning的連線。
記錄型別ID 輸入或對應您要建立的記錄型別。 可用的記錄型別取決於您的Workfront Planning帳戶。
其他欄位 輸入您希望新記錄具有的值。 這些欄位是根據您選取的記錄型別。

刪除記錄

此動作模組會刪除Workfront Planning中的指定記錄。

table 0-row-2 1-row-2 layout-auto html-authored no-header
Connection 如需建立Adobe Workfront Planning連線的說明,請參閱本文中的建立與Adobe Workfront Planning的連線。
記錄ID 輸入或對應您要刪除之記錄的ID。

取得記錄

此動作模組會從其ID所指定的Adobe Workfront Planning擷取單一記錄。

table 0-row-2 1-row-2 layout-auto html-authored no-header
Connection 如需建立Adobe Workfront Planning連線的說明,請參閱本文中的建立與Adobe Workfront Planning的連線。
記錄ID 輸入或對應您要擷取之記錄的ID。

依記錄型別取得記錄

此動作模組會擷取指定型別的所有記錄。

table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
Connection 如需建立Adobe Workfront Planning連線的說明,請參閱本文中的建立與Adobe Workfront Planning的連線。
Workspace 選取或對映包含您要擷取之記錄的工作區。
記錄型別 選取您要擷取的記錄型別。

取得記錄型別

此動作模組會擷取Adobe Workfront Planning帳戶中的記錄型別清單。

table 0-row-2 1-row-2 layout-auto html-authored no-header
Connection 如需建立Adobe Workfront Planning連線的說明,請參閱本文中的建立與Adobe Workfront Planning的連線。
Workspace 選取或對應包含您要擷取之記錄型別的工作區。

更新記錄

此動作會更新Workfront Planning中的單一記錄。

table 0-row-2 1-row-2 2-row-2 3-row-0 layout-auto html-authored no-header
Connection 如需建立Adobe Workfront Planning連線的說明,請參閱本文中的建立與Adobe Workfront Planning的連線。
記錄ID 輸入或對應您要更新的記錄型別。 可用的記錄型別取決於您的Workfront Planning帳戶。
其他欄位 輸入您要記錄的新值。 這些欄位是根據您選取的記錄型別。

使用JSONata進行可讀取的record-types劃分

下列JSONata運算式會建立可讀取的Planning查詢輸出,提供您記錄型別劃分。 這使記錄型別名稱、欄位名稱和欄位選項名稱(如果適用)可由名稱讀取,並保持結構的其餘部分不變。

code language-none
(
    $s0 := ({"data":$ ~> | fields | {"options":(options){name:$}} |});
    $s1 := ({"data":$s0.data ~> | **.fields | {"options_name":(options.*){displayName:$}} | });
    $s2 := $s1 ~> | data | {"fields":(fields){displayName:$}} |;
    $s2.data{displayName:$}
)

如需有關使用JSONata模組的資訊,請參閱JSONata模組

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