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 Automation and Integration 封裝

Workfront Ultimate

Workfront Prime 和 Select 封裝,以及額外購買的 Workfront Fusion。

Adobe Workfront 授權

標準

工作或更高層級

產品 如果您的組織擁有 Select 或 Prime Workfront 封裝,但不包括 Workfront Automation and Integration,則您的組織必須購買 Adobe Workfront Fusion。

若要詳細了解此表格中的資訊,請參閱🔗文件中的存取權要求。

s##必要條件

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

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

Adobe Workfront規劃API資訊

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

基礎 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 用戶端 ID。此資訊可在 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中建立、更新或刪除記錄、記錄型別或工作區時,此觸發模組會啟動案例。

Webhook
選取您要使用的webhook,或按一下「新增」以建立新的webhook。
連線
關於建立與 Adobe Workfront Planning 的連線的說明,請參閱這篇文章中的建立與 Adobe Workfront Planning 的連線。
物件類型
選取您要監視記錄、記錄型別或工作區。
狀態

選取您要監視舊狀態或新狀態。

  • 新狀態

    當記錄變更 特定值時觸發一個情境。

  • 舊狀態

    當記錄 特定值變更為其他時會觸發一個情境。

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

您可以設定篩選器為僅監視符合所選取條件的記錄。

對於每個篩選器,輸入您要篩選器評估的欄位、運算子,以及要讓篩選器允許的值。您可以新增 AND 規則,以便使用一個以上的篩選器。

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

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

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

動作

刪除記錄型別

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

WARNING
刪除Workfront Planning中的記錄型別也會刪除記錄型別表格中的所有記錄。
連線
關於建立與 Adobe Workfront Planning 的連線的說明,請參閱這篇文章中的建立與 Adobe Workfront Planning 的連線。
記錄型別ID
輸入或對應您要刪除之記錄型別的ID。

進行自訂的 API 呼叫

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

連線
關於建立與 Adobe Workfront Planning 的連線的說明,請參閱這篇文章中的建立與 Adobe Workfront Planning 的連線。
URL
輸入相對於 https://(YOUR_WORKFRONT_DOMAIN)/maestro/api/
方法
選取您設定 API 呼叫所需的 HTTP 要求方法。如需詳細資訊,請參閱 HTTP 要求方法
標頭

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

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

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

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

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

注意:

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

搜尋

搜尋記錄

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

連線
關於建立與 Adobe Workfront Planning 的連線的說明,請參閱這篇文章中的建立與 Adobe Workfront Planning 的連線。
Workspace
輸入或對應包含您要搜尋之記錄的Workspace。
記錄類型
選取您要搜尋的記錄型別。
記錄欄位
針對搜尋中要使用的每個欄位,找到該欄位,選取運運算元,然後輸入或對應您要搜尋的值。 根據所選的記錄型別,可使用欄位。
篩選條件

選取篩選條件:

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

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

限制
輸入或對應您要此模組在每個情境執行週期中傳回的最大記錄數量。

未分類

建立記錄

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

連線
關於建立與 Adobe Workfront Planning 的連線的說明,請參閱這篇文章中的建立與 Adobe Workfront Planning 的連線。
記錄型別ID
輸入或對應您要建立的記錄型別。 可用的記錄型別取決於您的Workfront Planning帳戶。
其他欄位
輸入您希望新記錄具有的值。 這些欄位是根據您選取的記錄型別。

刪除記錄

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

連線
關於建立與 Adobe Workfront Planning 的連線的說明,請參閱這篇文章中的建立與 Adobe Workfront Planning 的連線。
記錄ID
輸入或對應您要刪除之記錄的ID。

取得記錄

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

連線
關於建立與 Adobe Workfront Planning 的連線的說明,請參閱這篇文章中的建立與 Adobe Workfront Planning 的連線。
記錄ID
輸入或對應您要擷取之記錄的ID。

依記錄型別取得記錄

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

連線
關於建立與 Adobe Workfront Planning 的連線的說明,請參閱這篇文章中的建立與 Adobe Workfront Planning 的連線。
Workspace
選取或對映包含您要擷取之記錄的工作區。
記錄類型
選取您要擷取的記錄型別。

取得記錄型別

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

連線
關於建立與 Adobe Workfront Planning 的連線的說明,請參閱這篇文章中的建立與 Adobe Workfront Planning 的連線。
Workspace
選取或對應包含您要擷取之記錄型別的工作區。

更新記錄

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

連線
關於建立與 Adobe Workfront Planning 的連線的說明,請參閱這篇文章中的建立與 Adobe Workfront Planning 的連線。
記錄ID
輸入或對應您要更新的記錄型別。 可用的記錄型別取決於您的Workfront Planning帳戶。
其他欄位
輸入您要記錄的新值。 這些欄位是根據您選取的記錄型別。

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

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

(
    $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