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授權

新增:標準

目前:工作或以上

Adobe Workfront Fusion授權**

目前:無Workfront Fusion授權需求

舊版:Workfront Fusion for Work Automation and Integration

產品

新增:

  • 選取或Prime Workfront套件:您的組織必須購買Adobe Workfront Fusion。
  • Ultimate Workfront套件:包含Workfront Fusion。

目前:您的組織必須購買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的連線

若要建立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欄位,視您在應用程式或服務中的存取層級等因素而定。 模組中的粗體標題表示必填欄位。

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

地圖切換

註解

刪除註解

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

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

列出註解

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

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

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

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

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

傳回評論的最大數量
輸入或對應您希望模組在每個案例執行週期中傳回的最大註解數。

張貼註解

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

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

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

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

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

註解
輸入註解的文字。

專案和檔案

取得檔案或影像

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

Connection
如需有關將您的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中單一檔案的版本記錄。

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

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

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

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

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

列出專案檔

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

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

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

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

列出專案

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

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

元件和樣式

取得樣式或元件

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

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

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

此值未對應至物件ID。

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

Before

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

此值未對應至物件ID。

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

其他

進行API呼叫

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

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

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

例如: files/7179110/comments

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

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

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

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

查詢字串

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

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

Body

以標準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
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3