Adobe Workfront 模組

任何 Adobe Workfront Workflow 封裝及任何 Adobe Workfront Automation and Integration 封裝

Workfront Ultimate

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

標準

工作或更高層級

Workfront 連接器使用 OAuth 2.0 連接至 Workfront。

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

• 使用用戶端 ID 和用戶端密碼連接至 Workfront
• 使用伺服器對伺服器連線連接 Workfront

使用用戶端 ID 和用戶端密碼連接至 Workfront

1. 在任何 Adobe Workfront 模組中，按一下「連線」欄位旁的「新增」。

2. 填寫下列欄位：

   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。

3. 按一下「繼續」，儲存連線並返回模組。

   若您未登入 Workfront，系統會將您導向至登入畫面。登入後，您可以允許連線。

使用伺服器對伺服器連線連接 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 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。

3. 按一下「繼續」，儲存連線並返回模組。

   若您未登入 Workfront，系統會將您導向至登入畫面。登入後，您可以允許連線。

Workfront 模組及其欄位

當您設定 Workfront 模組時，Workfront Fusion 會顯示下列欄位。除了這些欄位以外，也可能因為其他因素，例如您在應用程式或服務中的存取層級，而顯示其他 Workfront 欄位。在模組中，粗體標題表示那是必要欄位。

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

• 觸發程序
• 動作
• 搜尋

觸發程序

選取您要模組監視的 Workfront 記錄類型。

例如，若您要在每次任務中的記錄欄位更新時開始執行情境，請選取「任務」。

選取您要模組監視的 Workfront 記錄類型。

例如，若您要在每次建立新專案時啟動情境，請選取「專案」

輸入物件的 ID。

注意：輸入物件的 ID 時，您可以開始輸入物件的名稱，然後從清單中選取。然後模組會在欄位中輸入適當的 ID。

若要轉換成專案，請選取您要用於專案的範本 ID。

注意：輸入物件的 ID 時，您可以開始輸入物件的名稱，然後從清單中選取。然後模組會在欄位中輸入適當的 ID。

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

例如，若您要建立專案，請從下拉式清單中選取「專案」。

選取可供輸入資料的欄位。這樣一來，您可以使用這些欄位，但是不需要捲動瀏覽不需要的欄位。接著，您可以在這些欄位中輸入或對應資料。

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

• 輸入物件的 ID 時，您可以開始輸入物件的名稱，然後從清單中選取。然後模組會在欄位中輸入適當的 ID。
• 輸入自訂欄位或備註物件 (註解或回覆) 的文字時，您可以在「備註文字」欄位中使用 HTML 標記來建立 RTF 文字，例如粗體或斜體文字。

• 解析個別使用者

  code language-none
  您可以解析使用者清單中的個別使用者。

• 解析大批新增的使用者

  若要解析大批新增的使用者，您可以直接將該批次的使用者新增至 Adobe Admin Console。

  相關說明請參閱 Adobe 文件中的管理多個使用者 | 上傳大量 CSV。

以標準 JSON 物件的形式新增要求標頭。此資訊會決定請求的內容類型。

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

注意：如果您收到錯誤訊息而且無法判斷其來源，請考慮根據 Workfront 文件修改標頭。如果您的自訂 API 呼叫傳回 422 HTTP 要求錯誤，請嘗試使用 "Content-Type":"text/plain" 標頭。

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

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

提示：建議您透過 JSON 正文而非查詢參數傳送資訊。

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

注意：

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

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

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

1. 同步刪除記錄。
2. 將錯誤處理新增至刪除記錄模組，以便忽略因為 40 秒逾時造成的錯誤。

對應或手動輸入您要模組下載的檔案之唯一 Workfront ID。

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

選取您要模組執行的動作。

視您選擇的「記錄類型」和「動作」而定，可能需要填寫其他欄位。這兩項設定的部分組合可能只需要記錄 ID，而其他設定 (例如「記錄類型」為專案以及「動作」為「附加範本」) 則需要其他資訊 (例如物件 ID 和範本 ID)。

關於部分動作可用的選項，請參閱這篇文章中的其他動作選項。

關於個別欄位的詳細資訊，請參閱 Workfront 開發人員文件。

注意：開發人員文件網站僅包含至 API 版本 14 為止的資訊，但仍包含 API 呼叫的重要資訊。

1. 在 Workfront 開發人員文件頁面的左側導覽區中選取記錄類型。下列類型有其專屬頁面：

   • 專案

   • 任務

   • 問題

   • 使用者

   • 文件

   針對所有其他記錄類型，請選取「其他物件和端點」，然後在依字母順序排序的頁面上尋找記錄類型。

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

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

注意：

透過 Workfront 其他動作模組建立校訂時，最佳做法是建立不含任何進階選項的校訂，然後使用 Workfront Proof SOAP API 更新校訂。

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

輸入或對應模組要與其互動之記錄的不重複 Workfront ID。

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

• clearApprovers

• clearAssignments

• clearConstraints

• clearCustomData

• clearDocuments

• clearExpenses

• clearFinancials

  清除財務資料

• clearPermissions

• clearPredecessors

• clearProgress

• clearTimedNotifications

  清除提醒通知

• clearApprovers

• clearAssignments

• clearDocuments

• clearConstraints

• clearExpenses

• clearFinancials

  清除財務資料

• clearPermissions

• clearPredecessors

• clearProgress

• clearTimedNotifications

  清除提醒通知

• clearApprovers
• clearAssignments
• clearCustomData
• clearDocuments
• clearPermissions
• clearProgress

• preserveIssue

  保留原始問題並將其解決方案連結至此任務

• preservePrimaryContact

  允許問題的主要聯絡人存取此任務

• preserveCompletionDate

  維持問題的規劃完成日期

• preserveIssue

  保留原始問題並將其解決方案連結至此任務

• preservePrimaryContact

  允許問題的主要聯絡人存取此任務

• clearApprovers

• clearAssignments

• clearCustomData

• clearDocuments

• clearExpenses

• clearFinancials

  清除財務資料

• clearPermissions

• clearPredecessors

• clearProgress

• clearTimedNotifications

  清除提醒通知

• clearApprovers

• clearAssignments

• clearBillingRates

• clearConstraints

• clearDeliverables

  清除目標

• clearDocuments

• clearExpenses

• clearFinancials

  清除財務資料

• clearHourTypes

• clearIssueSetup

  清除佇列屬性和問題設定

• clearPredecessors

• clearRisks

• clearSharingOptions

• clearTimedNotifications

  清除提醒通知

輸入您要模組讀取之記錄的唯一 Workfront ID。

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

輸入您要模組更新之記錄的唯一 Workfront ID。

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

選取您要在新記錄上提供欄位值的自訂表單。選取表單後，在表單上的欄位中輸入資料。

若要對您附加在此模組的表單提供欄位值，需包含欄位中的自訂表單 ID 才能對應區段。

選取您要讀取其關聯記錄的上層記錄 (Workfront 物件) 類型。

在這篇文章的各 Workfront 模組可用的 Workfront 物件類型中查看可使用此模組的 Workfront 物件類型清單。

輸入或對應您要讀取其關聯記錄的上層記錄的 ID。

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

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

注意：請勿在您的搜尋條件中使用 username 。若在對 Workfront 進行的 API 查詢中加入 username ，使用者便會登入 Workfront，而搜尋不會成功。

注意：In 和 NotIn 可搭配陣列使用。輸入應使用陣列的格式。

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

注意：請勿在您的搜尋條件中使用 username 。若在對 Workfront 進行的 API 查詢中加入 username ，使用者便會登入 Workfront，而搜尋不會成功。

注意：In 和 NotIn 可搭配陣列使用。輸入應使用陣列的格式。