|
您必須具備下列專案才能存取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帳戶的連線。
-
在任何Adobe Workfront Planning模組中,按一下[連線]方塊旁的新增。
-
填寫下列欄位:
| 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-。
|
-
按一下 繼續 以儲存連線並返回模組。
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模組。
|