Adobe Workfront主機板模組

NOTE
主機板Fusion聯結器處於測試版狀態。 因此,此聯結器的支援有限,而且可能會因主機板的未來開發而變更。 此外,GraphQL API可能會有所變更,恕不另行通知,這可能會影響您的Fusion聯結器程式。

Adobe Workfront展示板是彈性的工具,可讓團隊透過提供對包含欄和卡片的共用展示板的存取權進行共同作業。

您可以使用Adobe Workfront面板模組來讀取或更新記錄、對Workfront面板API進行API呼叫,或當面板上發生動作時觸發情境。

存取權要求

展開以檢視這篇文章中所述功能的存取權要求。
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。

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

先決條件

您必須先在Adobe Workfront中設定主機板,才能連線至該主機板。

Adobe Workfront面板API資訊

Adobe Workfront面板聯結器會使用以下專案:

API 標記
v1.23.6

建立與Workfront展示板的連線

NOTE
您可以使用Workfront連線來連線至Workfront面板,或是建立個別的Workfront面板連線。

若要建立Workfront面板連線:

  1. 在任何 Adobe Workfront Boards 模組中,按一下「連線」方塊旁的「新增」。

  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面板模組及其欄位

當您設定Workfront面板模組時,Workfront Fusion會顯示下列欄位。 除此之外,可能還會顯示其他Workfront面板欄位,視您應用程式或服務中的存取層級等因素而定。 在模組中,粗體標題表示那是必要欄位。

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

對應切換

卡片

新增檢查清單項目

此動作模組會將檢查清單專案新增至指定的卡片。

連線

您可以使用現有的Workfront連線來連線至Workfront面板,或使用特定的Workfront面板連線。

如需有關將Workfront應用程式連線到Workfront Fusion的說明,請參閱本文中的建立與Workfront展示板的連線

卡片ID

輸入或對應您要新增檢查清單專案的卡片ID。

在Workfront中檢視卡片時,您可以在URL中找到卡片ID。

檢查清單專案
針對您要新增的每個檢查清單專案,按一下「新增專案」,輸入檢查清單專案的名稱,然後選取該專案是否已完成。

新增子任務

此動作模組會將子任務新增到展示板中的卡片。 此卡片必須是已連線的卡片。 子任務也會新增至卡片所代表的Workfront任務。

連線

您可以使用現有的Workfront連線來連線至Workfront面板,或使用特定的Workfront面板連線。

如需有關將Workfront應用程式連線到Workfront Fusion的說明,請參閱本文中的建立與Workfront展示板的連線

父卡片ID

輸入或對應您要新增子任務的卡片ID。

在Workfront中檢視卡片時,您可以在URL中找到卡片ID。

展示板ID

輸入或對應包含您要新增子任務之卡片之展示板的ID。

在Workfront中檢視展示板時,您可以在URL中找到展示板ID。

名稱
輸入或對應新子工作的名稱。

建立卡片

此動作模組會在Workfront展示板上建立新卡片。

連線

您可以使用現有的Workfront連線來連線至Workfront面板,或使用特定的Workfront面板連線。

如需有關將Workfront應用程式連線到Workfront Fusion的說明,請參閱本文中的建立與Workfront展示板的連線

展示板ID

輸入或對應您要新增卡片之主機板的ID。

在Workfront中檢視展示板時,您可以在URL中找到展示板ID。

資料行ID

輸入或對應您要新增子工作的資料行ID。

您可以從讀取展示板模組傳回的資訊中找到欄ID。

名稱
輸入或對應新卡片的名稱。

移動卡片

此動作模組會將卡片移至相同展示板上的不同欄。

連線

您可以使用現有的Workfront連線來連線至Workfront面板,或使用特定的Workfront面板連線。

如需有關將Workfront應用程式連線到Workfront Fusion的說明,請參閱本文中的建立與Workfront展示板的連線

卡片ID

輸入或對應您要移動之卡片的ID。

在Workfront中檢視卡片時,您可以在URL中找到卡片ID。

展示板ID

輸入或對應包含您要移動之卡片的主機板ID。

在Workfront中檢視展示板時,您可以在URL中找到展示板ID。

目的地資料行ID

輸入或對應您要移動卡片的目標欄ID。

您可以從讀取展示板模組傳回的資訊中找到欄ID。

至索引

輸入或對應您要卡片在新欄中的位置。

索引0中資料行的頂端位置。

讀取卡片

此動作模組會擷取特定卡片的相關資訊。

連線

您可以使用現有的Workfront連線來連線至Workfront面板,或使用特定的Workfront面板連線。

如需有關將Workfront應用程式連線到Workfront Fusion的說明,請參閱本文中的建立與Workfront展示板的連線

卡片ID

輸入或對應您要讀取的卡片ID。

在Workfront中檢視卡片時,您可以在URL中找到卡片ID。

卡片ID

輸入或對應包含您要讀取之卡片之主機板的ID。

在Workfront中檢視展示板時,您可以在URL中找到展示板ID。

更新卡片

此動作模組會更新您指定之卡片的資訊。

連線

您可以使用現有的Workfront連線來連線至Workfront面板,或使用特定的Workfront面板連線。

如需有關將Workfront應用程式連線到Workfront Fusion的說明,請參閱本文中的建立與Workfront展示板的連線

卡片ID

輸入或對應您要更新的卡片ID。

在Workfront中檢視卡片時,您可以在URL中找到卡片ID。

展示板ID

輸入或對應包含要更新卡片之展示板的ID。

在Workfront中檢視展示板時,您可以在URL中找到展示板ID。

名稱
輸入或對映卡片的新名稱。
說明
輸入或對映卡片的新說明。
估算
輸入或對應完成這張卡片所需時間的預估。
到期日期

輸入或對應此卡片的到期日。

如需支援之日期和時間格式的清單,請參閱類型強制轉換

狀態
為卡片選取新狀態。

展示板

建立展示板

此動作模組會在Workfront中建立展示板。 您可以指定要建立的電路板型別。

連線

您可以使用現有的Workfront連線來連線至Workfront面板,或使用特定的Workfront面板連線。

如需有關將Workfront應用程式連線到Workfront Fusion的說明,請參閱本文中的建立與Workfront展示板的連線

展示板名稱
輸入或對映新展示板的名稱。
範本
為要建立的電路板型別選取範本。

讀取展示板

此動作模組會傳回單一展示板的資訊,例如展示板的卡片、欄、標籤和成員。

連線

您可以使用現有的Workfront連線來連線至Workfront面板,或使用特定的Workfront面板連線。

如需有關將Workfront應用程式連線到Workfront Fusion的說明,請參閱本文中的建立與Workfront展示板的連線

展示板ID

輸入或對應您要擷取資訊之展示板的ID。

在Workfront中檢視展示板時,您可以在URL中找到展示板ID。

建立欄

此動作模組會在指定的展示板上建立新欄。

連線

您可以使用現有的Workfront連線來連線至Workfront面板,或使用特定的Workfront面板連線。

如需有關將Workfront應用程式連線到Workfront Fusion的說明,請參閱本文中的建立與Workfront展示板的連線

展示板ID

輸入或對應您要新增欄的展示板ID。

在Workfront中檢視展示板時,您可以在URL中找到展示板ID。

資料行ID

輸入或對應您要更新之欄的ID。

您可以從讀取展示板模組傳回的資訊中找到欄ID。

欄名稱
輸入或對映欄的新名稱。

搜尋欄

此搜尋模組會傳回指定名稱之資料行的相關資訊。

連線

您可以使用現有的Workfront連線來連線至Workfront面板,或使用特定的Workfront面板連線。

如需有關將Workfront應用程式連線到Workfront Fusion的說明,請參閱本文中的建立與Workfront展示板的連線

展示板ID

輸入或對應包含您要擷取之欄的展示板ID。

在Workfront中檢視展示板時,您可以在URL中找到展示板ID。

欄名稱
輸入或對應您要擷取的資料行名稱。

更新欄

此動作模組會更新指定欄的名稱或WIP限制。

連線

您可以使用現有的Workfront連線來連線至Workfront面板,或使用特定的Workfront面板連線。

如需有關將Workfront應用程式連線到Workfront Fusion的說明,請參閱本文中的建立與Workfront展示板的連線

展示板ID

輸入或對應包含您要擷取之欄的展示板ID。

在Workfront中檢視展示板時,您可以在URL中找到展示板ID。

欄名稱
輸入或對應您要擷取的資料行名稱。
WIP限制
輸入或對應欄位的新在製品限制。

標記

新增標籤至卡片

此動作模組會將標籤新增至卡片。

連線

您可以使用現有的Workfront連線來連線至Workfront面板,或使用特定的Workfront面板連線。

如需有關將Workfront應用程式連線到Workfront Fusion的說明,請參閱本文中的建立與Workfront展示板的連線

卡片ID

輸入或對應您要新增標籤的卡片ID。

在Workfront中檢視卡片時,您可以在URL中找到卡片ID。

展示板ID

輸入或對應包含您要新增標籤之卡片的主機板ID。

在Workfront中檢視展示板時,您可以在URL中找到展示板ID。

標籤ID

輸入或對應您要新增之標籤的ID。

您可以從讀取展示板模組傳回的資訊中找到標籤ID。

建立標記

此動作模組會建立新標籤並為其指派顏色。

連線

您可以使用現有的Workfront連線來連線至Workfront面板,或使用特定的Workfront面板連線。

如需有關將Workfront應用程式連線到Workfront Fusion的說明,請參閱本文中的建立與Workfront展示板的連線

展示板ID

輸入或對應您要建立標籤之展示板的ID。

在Workfront中檢視展示板時,您可以在URL中找到展示板ID。

標籤名稱
輸入或對映新標籤的名稱。
標籤顏色
選取此標籤的顏色。

註解

建立評論

此動作模組已在指定卡片上建立註解。

連線

您可以使用現有的Workfront連線來連線至Workfront面板,或使用特定的Workfront面板連線。

如需有關將Workfront應用程式連線到Workfront Fusion的說明,請參閱本文中的建立與Workfront展示板的連線

卡片ID

輸入或對應您要新增註解的卡片ID。

在Workfront中檢視卡片時,您可以在URL中找到卡片ID。

註解
輸入或對應您要新增的註解文字。

讀取卡片註解

此動作模組會從指定的卡片擷取註解。

連線

您可以使用現有的Workfront連線來連線至Workfront面板,或使用特定的Workfront面板連線。

如需有關將Workfront應用程式連線到Workfront Fusion的說明,請參閱本文中的建立與Workfront展示板的連線

卡片ID

輸入或對應您要擷取註解的卡片ID。

在Workfront中檢視卡片時,您可以在URL中找到卡片ID。

限制
輸入您希望模組在一個執行週期內傳回的最大註解數。

其他

進行自訂的 API 呼叫

此動作模組會對Workfront看板API進行自訂呼叫。

連線

您可以使用現有的Workfront連線來連線至Workfront面板,或使用特定的Workfront面板連線。

如需有關將Workfront應用程式連線到Workfront Fusion的說明,請參閱本文中的建立與Workfront展示板的連線

URL
輸入相對於 https://<WORKFRONT_DOMAIN>/boards-service/graphql? 的路徑。
方法

選取您設定 API 呼叫所需的 HTTP 要求方法。如需詳細資訊,請參閱 HTTP 要求方法

對於大多數展示板呼叫,方法是POST。

標頭

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

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

查詢字串

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

若為Workfront面板,此區段通常會保留空白。

正文

以JSON內嵌Graphql的形式,新增API呼叫的內文內容

範例:

此範例會更新欄名稱。 您可以將boardIdcolumnId加入為GUID,以硬式編碼或對映自先前的模組。

{
 "query": "mutation { updateColumn(boardId: \"\", columnId: \"\", updateColumnInput: { name: \"\" }) { id name }}"
}

注意:

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

進行自訂GraphQL API呼叫

此動作模組會向Workfront面板API提出自訂GraphQL請求。

連線

您可以使用現有的Workfront連線來連線至Workfront面板,或使用特定的Workfront面板連線。

如需有關將Workfront應用程式連線到Workfront Fusion的說明,請參閱本文中的建立與Workfront展示板的連線

方法
選取這個呼叫的方法。
Query
以標準 JSON 物件的形式新增 API 呼叫的查詢。
操作名稱
輸入此作業的名稱。 如此可讓追蹤及偵錯呼叫變得更加容易。
變數資料來源
選取變數來自表單或集合。
變數
針對您要新增的每個變數,按一下 新增專案 並輸入變數的索引鍵和值。
限制
輸入或對應您要此模組在每個情境執行週期中傳回的最大記錄數量。
recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3