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聯結器使用下列專案：
將Workfront Planning連線至Workfront Fusion
Workfront Planning聯結器使用OAuth 2.0連線至Workfront Planning。
您可以直接從Workfront Planning Fusion模組內建立與Workfront Planning帳戶的連線。
使用使用者端ID和使用者端密碼連線至Workfront Planning
-
在任何Adobe Workfront Planning模組中，按一下「連線」欄位旁的新增。
-
填寫下列欄位：
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 連線類型 選取「Adobe Workfront 驗證連線」。 連線名稱 輸入新連線的名稱。 用戶端 ID 輸入您的 Workfront 用戶端 ID。您可在 Workfront「設定」區域的「OAuth2 應用程式」區域內找到此項資訊。開啟您要連接的特定應用程式以便查看用戶端 ID。 用戶端密碼 輸入您的 Workfront 用戶端密碼。您可在 Workfront「設定」區域的「OAuth2 應用程式」區域內找到此項資訊。如果您在 Workfront 的 OAuth2 應用程式沒有用戶端密碼，您可以產生另一個密碼。相關說明請參閱 Workfront 文件。 驗證 URL 此欄位可維持預設值，或者您可以輸入 Workfront 實例的 URL 且後面接著
/integrations/oauth2。範例：
https://mydomain.my.workfront.com/integrations/oauth2主機前置詞 在大多數情況下，此值應為 origin。 -
按一下「繼續」，儲存連線並返回模組。
如果您未登入Workfront Planning，系統會將您導向至登入畫面。 登入後，您可以允許連線。
- Workfront API 的 OAuth 2.0 連線不再依賴 API 金鑰。
- 若要建立與 Workfront 沙箱環境的連線，您必須在該環境中建立 OAuth2 應用程式，然後在您的連線中使用該應用程式產生的用戶端 ID 和用戶端密碼。
使用伺服器對伺服器連線來連線至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 7-row-2 layout-auto html-authored no-header 連線類型 選取「Adobe Workfront 伺服器對伺服器連線」。 連線名稱 輸入新連線的名稱。 執行個體名稱 輸入執行個體的名稱，也是您的網域。
範例：若您的 URL 為
https://example.my.workfront.com，請輸入example。執行個體路徑 輸入此連線將連接的環境類型。
範例：若您的 URL 為
https://example.my.workfront.com，請輸入my。用戶端 ID 輸入您的 Workfront 用戶端 ID。您可在 Workfront「設定」區域的「OAuth2 應用程式」區域內找到此項資訊。開啟您要連接的特定應用程式以便查看用戶端 ID。 用戶端密碼 輸入您的 Workfront 用戶端密碼。您可在 Workfront「設定」區域的「OAuth2 應用程式」區域內找到此項資訊。如果您在 Workfront 的 OAuth2 應用程式沒有用戶端密碼，您可以產生另一個密碼。相關說明請參閱 Workfront 文件。 範圍 輸入此連線的適用範圍。 主機前置詞 在大多數情況下，此值應為 origin。 -
按一下「繼續」，儲存連線並返回模組。
如果您未登入Workfront Planning，系統會將您導向至登入畫面。 登入後，您可以允許連線。
- Workfront API 的 OAuth 2.0 連線不再依賴 API 金鑰。
- 若要建立與 Workfront 沙箱環境的連線，您必須在該環境中建立 OAuth2 應用程式，然後在您的連線中使用該應用程式產生的用戶端 ID 和用戶端密碼。
Adobe Workfront Planning 模組及其欄位
當您設定 Workfront 模組時，Workfront Fusion 會顯示下列欄位。除了這些欄位以外，也可能因為其他因素，例如您在應用程式或服務中的存取層級，而顯示其他 Workfront 欄位。在模組中，粗體標題表示那是必要欄位。
若在欄位或函式上方看到對應按鈕，可以使用按鈕設定該欄位的變數和函式。如需詳細資訊，請參閱將資訊從一個模組對應到另一個模組。
觸發程序
觀看活動
在Workfront Planning中建立、更新或刪除記錄、記錄型別或工作區時，此觸發模組會啟動案例。
動作
刪除記錄型別
此動作模組會依據其ID刪除Workfront Planning中的單一記錄型別。
進行自訂的 API 呼叫
此模組會對Adobe Workfront Planning API發出自訂API呼叫。
https://(YOUR_WORKFRONT_DOMAIN)/maestro/api/以標準 JSON 物件的形式新增要求標頭。
例如， {"Content-type":"application/json"}
Workfront Fusion 會自動新增授權標頭。
以標準 JSON 物件的形式新增 API 呼叫的正文內容。
注意：
在 JSON 中使用條件陳述式 (例如 if) 時，請將引號放在條件陳述式的外面。
搜尋
搜尋記錄
此動作模組會根據您指定的條件擷取記錄清單。
未分類
建立記錄
這個動作會在Workfront Planning中建立單一記錄。
刪除記錄
此動作模組會刪除Workfront Planning中的指定記錄。
取得記錄
此動作模組會從其ID所指定的Adobe Workfront Planning擷取單一記錄。
依記錄型別取得記錄
此動作模組會擷取指定型別的所有記錄。
取得記錄型別
此動作模組會擷取Adobe Workfront Planning帳戶中的記錄型別清單。
更新記錄
此動作會更新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模組。