Figma模組

使用Adobe Workfront Fusion Figma模組,您可以擷取註解、檔案、檔案版本或專案的清單。 您也可以張貼註解或呼叫Figma API。

如果您需要建立案例的指示,請參閱建立案例:文章索引下的文章。

關於模組的資訊,請參閱模組:文章索引之下的文章。

存取權要求

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

標準

工作或更高層級

Adobe Workfront Fusion 授權

作業型:無 Workfront Fusion 授權要求

連接器型 (舊版):Workfront Fusion for Work Automation and Integration

產品 如果您的組織擁有 Select 或 Prime Workfront 封裝,但不包括 Workfront Automation and Integration,則您的組織必須購買 Adobe Workfront Fusion。

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

關於 Adobe Workfront Fusion 授權的資訊,請參閱 Adobe Workfront Fusion 授權

先決條件

若要使用 Figma 模組,您必須擁有 Figma 帳戶。

圖表API資訊

Figma聯結器使用下列專案:

基礎 URL
https://api.figma.com/v1
API 版本
v1
API 標記
v1.8.25

建立與Figma的連線

IMPORTANT
  • Figma已於2025年1月變更其驗證要求。 Figma連線型別符合新需求。 Figma (Legacy)連線型別已過時,不久將會移除。
  • 如果您使用重新導向、URL,請使用https://oauth.app.workfrontfusion.com/oauth/cb/figma3

若要建立Figma模組的連線:

  1. 在任何Figma模組中,按一下[連線]方塊旁的​新增

  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
    連線類型

    選取Figma (不含舊版標籤)。

    Figma已於2025年1月變更其驗證要求。 Figma連線型別符合新需求。 Figma (Legacy)連線型別已過時,未來將予以移除。

    連線名稱 輸入此連線的名稱。
    用戶端 ID 輸入您的圖片 使用者端ID。
    用戶端密碼 輸入您的Figma 使用者端密碼。
    自訂範圍 輸入此連線所需的任何自訂範圍。
    自訂連線驗證URL 驗證連線是否成功建立的預設端點為: https://api.figma.com/v1/me如果自訂範圍不支援此URL,請提供自訂驗證URL。
  3. 按一下「繼續」,儲存連線並返回模組。

Figma 模組及其欄位

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

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

對應切換

註解

刪除註解

此動作模組會從檔案中刪除單一註解。

連線
如需有關將您的Figma帳戶連線到Workfront Fusion的說明,請參閱本文中的建立與Figma的連線
檔案 ID
輸入或對應您要新增或刪除註解的檔案的檔案ID。
註解 ID
輸入要刪除的註解文字。

列出註解清單

此搜尋模組列出附加至Figma中單一檔案的所有註解。

連線
如需有關將您的Figma帳戶連線到Workfront Fusion的說明,請參閱本文中的建立與Figma的連線
檔案 ID

輸入或對應您要擷取註解的檔案的檔案ID。

  • 如果您不知道識別碼,請按一下尋找檔案,然後輸入或對應檔案關聯之專案的識別碼,然後選取檔案。

  • 如果您不知道專案的ID,請按一下尋找專案,然後輸入或對應擁有檔案相關聯專案之團隊的ID,然後選取專案,再選取檔案。

傳回註解的最大數量
輸入或對應您要此模組在每個情境執行週期中傳回的最大註解數量。

張貼註解

此動作模組會將註解張貼至Figma檔案。

連線
如需有關將您的Figma帳戶連線到Workfront Fusion的說明,請參閱本文中的建立與Figma的連線
檔案 ID

輸入或對應您要張貼註解的檔案的檔案ID。

  • 如果您不知道檔案的識別碼,請按一下尋找檔案,然後輸入或對應與檔案關聯的專案識別碼,然後選取檔案。

  • 如果您嘗試尋找檔案的ID但不知道專案的ID,請按一下尋找專案,然後輸入或對應擁有檔案相關專案之團隊的ID。 選取專案,然後選取檔案。

註解
輸入註解的文字。

專案和檔案

取得檔案或影像

此動作模組會從Figma程式庫中擷取單一檔案或影像

連線
如需有關將您的Figma帳戶連線到Workfront Fusion的說明,請參閱本文中的建立與Figma的連線
物件類型

選取您要擷取的物件型別。

  • 檔案

    模組會傳回Key參考的檔案作為JSON物件。 您可以從任何Figma檔案URL剖析檔案金鑰。

    如需欄位,請參閱取得檔案或影像:檔案

  • 檔案節點

    傳回ID參照的節點作為JSON物件。 節點是從Key參考的Figma檔案擷取。

    如需欄位,請參閱取得檔案或影像:檔案節點

  • 影像

    模組會從檔案轉譯影像。

    如需欄位,請參閱取得檔案或影像: Image

  • 影像填滿

    模組會傳回檔案中影像填色中所有影像的下載連結。 影像填色是Figma表示任何使用者提供的影像的方式。 當您將影像拖曳至Figma中時,Figma會建立具有單一填色的矩形(代表影像),使用者可以轉換矩形(和填色上的屬性)。

    如需欄位,請參閱取得檔案或影像:影像填滿

取得檔案或影像:檔案
檔案索引鍵
選取您要傳回JSON的來源檔案。
版本ID
輸入或對應您希望模組傳回的檔案版本。 對於目前的模組,請將此欄位留空。
節點ID

若只要傳回檔案的子集,請輸入您希望模組傳回的節點。 模組會傳回列出的節點、其子系,以及根節點與列出的節點之間的任何專案。

針對您要傳回的每個節點,按一下 新增 並輸入節點的文字。

深度

輸入或對應整數,該整數代表要傳回結果的檔案樹狀結構深度。

範例:

  • 若要僅傳回頁面,請輸入1

  • 若要傳回頁面和最上層物件,請輸入2

若要傳回所有節點,請將此欄位留空。

Geometry
若要傳回向量資料,請輸入paths
外掛程式資料
外掛程式ID和/或字串「shared」的逗號分隔清單。 這些外掛程式所撰寫的檔案中的任何資料都會包含在pluginDatasharedPluginData屬性的結果中。
分支資料
啟用此選項可傳回請求檔案的分支中繼資料。 如果檔案是分支,則主要檔案的金鑰會包含在傳回的回應中。 如果檔案有分支,則其中繼資料會包含在傳回的回應中。 預設值: false
取得檔案或影像:檔案節點
檔案索引鍵
選取您要傳回JSON的來源檔案。
節點ID

輸入您希望模組傳回並轉換的節點

針對您要傳回的每個節點,按一下 新增 並輸入節點的文字。

版本ID
輸入或對應您希望模組傳回的檔案版本。 對於目前的模組,請將此欄位留空。
深度

輸入或對應整數,該整數代表要傳回結果的檔案樹狀結構深度。

範例:

  • 若要僅傳回頁面,請輸入1

  • 若要傳回頁面和最上層物件,請輸入2

若要傳回所有節點,請將此欄位留空。

Geometry
若要傳回向量資料,請輸入paths
外掛程式資料
外掛程式ID和/或「共用」字串的逗號分隔清單。 這些外掛程式所撰寫的檔案中的任何資料都會包含在pluginData和sharedPluginData屬性的結果中。
取得檔案或影像:影像
檔案索引鍵
選取您要傳回JSON的來源檔案。
節點ID

輸入您希望模組呈現的節點。

針對您要呈現的每個節點,按一下 新增 並輸入節點的文字。

縮放
若要縮放影像,請輸入或對應縮放係數。 此數字必須介於0.01到4之間。
格式

選取影像輸出的格式。

  • JPG

  • PNG

  • SVG

  • PDF

SVG — 包含ID
啟用此選項即可包含所有SVG元素的ID屬性。 預設值: false。
SVG — 簡化筆畫
啟用此選項可簡化內/外筆畫,並儘可能使用筆畫屬性而非<mask>。 預設值: true。
使用絕對界限
啟用此選項可使用節點的完整尺寸,無論節點是否裁切或周圍空間是空的。 使用此項可匯出文位元組點而不進行裁切。 預設值: false。
版本
輸入或對應您希望模組傳回的檔案版本。 對於目前的模組,請將此欄位留空。
取得檔案或影像:影像填色
檔案索引鍵
選取您要傳回JSON的來源檔案。

列出檔案版本記錄

此搜尋模組傳回Figma中單一檔案的版本記錄。

連線
如需有關將您的Figma帳戶連線到Workfront Fusion的說明,請參閱本文中的建立與Figma的連線
檔案 ID

輸入或對應您要擷取版本記錄的檔案的檔案ID。

  • 如果您不知道檔案的識別碼,請按一下尋找檔案,然後輸入或對應與檔案關聯的專案識別碼,然後選取檔案。

  • 如果您嘗試尋找檔案的ID但不知道專案的ID,請按一下尋找專案,然後輸入或對應擁有檔案相關專案之團隊的ID。 選取專案,然後選取檔案。

傳回檔案的最大數量
輸入或對應您要此模組在每個情境執行週期中傳回的最大記錄數量。

列出專案檔

此搜尋模組會傳回指定專案中所有檔案的清單。

連線
如需有關將您的Figma帳戶連線到Workfront Fusion的說明,請參閱本文中的建立與Figma的連線
檔案 ID

輸入或對映您要擷取檔案的專案之專案ID。

  • 如果您不知道專案的ID,請按一下尋找專案,然後輸入或對應專案相關團隊的ID,然後選取專案。
傳回檔案的最大數量
輸入或對應您要此模組在每個情境執行週期中傳回的最大記錄數量。

列出專案

此搜尋模組會傳回指定團隊中所有專案的清單。

連線
如需有關將您的Figma帳戶連線到Workfront Fusion的說明,請參閱本文中的建立與Figma的連線
團隊ID
輸入或對應您要擷取檔案之專案的專案ID。 團隊ID可在菲格瑪團隊頁面的URL中找到
傳回專案的最大數量
輸入或對應您要此模組在每個情境執行週期中傳回的最大記錄數量。

元件和樣式

取得樣式或元件

此動作模組會擷取單一樣式或元件,或一組樣式或元件。

連線
如需有關將您的Figma帳戶連線到Workfront Fusion的說明,請參閱本文中的建立與Figma的連線
Object>型別
選取您要擷取的物件型別。
<Object>鍵
輸入您要擷取之物件的金鑰(唯一識別碼)。
團隊ID
如果擷取專案團隊元件或專案團隊元件集,請輸入或對應與記錄關聯的專案團隊ID。
頁面大小
如果擷取群組元件或群組元件集,請輸入或對應每頁要傳回的數目或結果。 預設值: 30。
After

如果擷取群組元件或群組元件集,請輸入或對映結果數目,之後將開始擷取結果。 這可以與頁面大小欄位結合以分頁結果。

此值未對應至物件ID。

此欄位不能與Before欄位結合使用。

Before

如果擷取群組元件或群組元件集,請輸入或對應要開始擷取結果之前的結果數目。 這可以與頁面大小欄位結合以分頁結果。

此值未對應至物件ID。

此欄位不能與After欄位結合使用。

其他

進行API呼叫

此動作模組可讓您對Figma API發出自訂的已驗證呼叫,而不需思考驗證問題。 如此一來,您就可以建立其他Figma模組無法完成的資料流程自動化。

連線
如需有關將您的Figma帳戶連線到Workfront Fusion的說明,請參閱本文中的建立與Figma的連線
URL

輸入相對於 https://api.figma.com/v1/ 的路徑。

例如: files/7179110/comments

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

以標準 JSON 物件的形式新增要求標頭。

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

Workfront Fusion會為您新增授權標頭。

查詢字串

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

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

正文

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

注意:

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

觀看活動

當您的Figma團隊空間中的特定團隊發生下列其中一項事件時,此觸發模組就會啟動案例:

  • 檔案更新

  • 檔案版本更新

  • 檔案刪除

  • 程式庫發佈

  • 檔案註解

Webhook

選取模組要監視的webhook。

若要新增webhook:

  1. 按一下Webhook欄位旁的Add

  2. 輸入webhook的名稱。

  3. 選取您要用於此webhook的連線。 如需有關將Figma帳戶連線至Workfront Fusion的說明,請參閱建立與Adobe Workfront Fusion的連線 — 基本說明。

  4. 選取您要模組觀看的事件型別。

  5. 輸入您希望webhook觀看其事件的團隊識別碼。

  6. 選取您想要啟動或暫停webhook。

  7. 輸入webhook的說明。

  8. 按一下 儲存 以儲存webhook並返回模組。

recommendation-more-help
workfront-fusion-help-workfront-fusion