Adobe Workfront模組

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

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。
   Instance Lane	輸入此連線將連線的環境型別。 範例：若您的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。

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

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

選取您想用於資料輸入的欄位。 這可讓您使用這些欄位，而無需捲動瀏覽您不需要的欄位。 您接著可以在這些欄位中輸入或對應資料。

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

• 輸入物件的ID時，您可以開始輸入物件的名稱，然後從清單中選取它。 模組接著在欄位中輸入適當的ID。
• 輸入自訂欄位或Note物件（註解或回覆）的文字時，您可以使用註解文字欄位中的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物件，並在「ID=」後複製URL結尾的文字。 例如： https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e

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

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

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

選取您希望模組執行的動作。

視您選擇的記錄型別和動作而定，您可能需要填寫其他欄位。 這兩個設定的某些組合可能只需要記錄ID，而其他設定（例如 記錄型別 的Project和 動作 的附加範本）則需要其他資訊（例如物件ID和範本ID）。

如需某些動作可用的選項，請參閱本文中的其他動作選項。

如需個別欄位的詳細資訊，請參閱Workfront開發人員檔案。

注意：開發人員檔案網站僅包含透過API版本14的資訊，但仍包含API呼叫的重要資訊。

1. 在Workfront開發人員檔案頁面的左側導覽區中選取記錄型別。 下列型別有自己的頁面：

   • 專案

   • 工作

   • 問題

   • 使用者

   • 檔案

   針對所有其他記錄型別，選取Other objects and endpoints，然後在依字母順序排序的頁面上尋找記錄型別。

2. 在適當記錄型別的頁面上，搜尋動作（Ctrl-F或Cmd-F）。

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

注意：

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

如需使用Workfront API （此模組使用）建立校訂的詳細資訊，請參閱透過Adobe Workfront API建立校訂時新增進階校訂選項

輸入或對應您希望模組與之互動之記錄的唯一Workfront ID。

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

• clearApprovers

• clearAssigments

• clearConstraints

• clearCustomData

• clearDocuments

• clearExpenses

• clearFinancials

  清除財務資料

• clearpermissions

• clearPredecessors

• clearProgress

• clearTimedNotifications

  清除提醒通知

• clearApprovers

• clearAssigments

• clearDocuments

• clearConstraints

• clearExpenses

• clearFinancials

  清除財務資料

• clearpermissions

• clearPredecessors

• clearProgress

• clearTimedNotifications

  清除提醒通知

• clearApprovers
• clearAssigments
• clearCustomData
• clearDocuments
• clearpermissions
• clearProgress

• preserveIssue

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

• preservePrimaryContact

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

• preserveCompletionDate

  保持問題的計畫完成日期

• preserveIssue

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

• preservePrimaryContact

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

• clearApprovers

• clearAssigments

• clearCustomData

• clearDocuments

• clearExpenses

• clearFinancials

  清除財務資料

• clearpermissions

• clearPredecessors

• clearProgress

• clearTimedNotifications

  清除提醒通知

• clearApprovers

• clearAssigments

• clearBillingRates

• clearConstraints

• clearDeliverables

  清除目標

• clearDocuments

• clearExpenses

• clearFinancials

  清除財務資料

• clearHourTypes

• Clearisssetup

  清除佇列屬性和問題設定

• clearPredecessors

• clearrisks

• clearSharingOptions

• clearTimedNotifications

  清除提醒通知

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

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

輸入您希望模組更新的記錄的唯一Workfront ID。

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

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

若要為您要附加在此模組中的表單提供欄位值，請在要對應的欄位區段中加入自訂表單ID。

選取您要讀取其關聯記錄的父記錄型別(Workfront物件)。

請參閱本文中每個Workfront模組可用的Workfront物件型別中，可使用此模組的Workfront物件型別清單。

輸入或對應您要讀取其關聯記錄的父記錄識別碼。

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

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

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

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

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

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

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