Figma模組

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

如果您需要有關建立案例的指示,請參閱建立案例

如需模組的相關資訊,請參閱 Adobe Workfront Fusion🔗中的模組。

存取需求

您必須具有下列存取權才能使用本文中的功能:

Adobe Workfront 計畫*
Pro或更高版本
Adobe Workfront 授權*
計畫,工作
Adobe Workfront Fusion 授權**

目前授權需求:無Workfront Fusion授權需求。

舊版授權需求:Workfront Fusion for Work Automation and Integration

產品

目前產品需求:如果您有Select或Prime Adobe Workfront計畫,貴組織必須購買Adobe Workfront Fusion及Adobe Workfront,才能使用本文所述的功能。 Workfront Fusion包含在Ultimate Workfront計畫中。

舊版產品需求:您的組織必須購買Adobe Workfront Fusion及Adobe Workfront,才能使用本文所述的功能。

若要瞭解您擁有的計畫、授權型別或存取權,請連絡您的Workfront管理員。

如需Adobe Workfront Fusion授權的相關資訊,請參閱Adobe Workfront Fusion 授權

先決條件

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

圖表API資訊

Figma聯結器使用下列專案:

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

Figma模組及其欄位

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

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

評論

刪除註解

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

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

列出註解

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

Connection
如需有關將您的Figma帳戶連線到Workfront Fusion的指示,請參閱建立與Adobe Workfront Fusion的連線 — 基本指示。
檔案ID

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

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

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

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

張貼註解

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

Connection
如需有關將您的Figma帳戶連線到Workfront Fusion的指示,請參閱建立與Adobe Workfront Fusion的連線 — 基本指示。
檔案ID

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

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

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

註解
輸入註解的文字。

專案和檔案

取得檔案或影像

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

Connection
如需有關將您的Figma帳戶連線到Workfront Fusion的指示,請參閱建立與Adobe Workfront Fusion的連線 — 基本指示。
物件型別

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

  • 檔案

    模組會傳回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。
版本ID
輸入或對應您希望模組傳回的檔案版本。 對於目前的模組,請將此欄位留空。
取得檔案或影像:影像填色
檔案索引鍵
選取您要傳回JSON的來源檔案。

列出檔案版本記錄

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

Connection
如需有關將您的Figma帳戶連線到Workfront Fusion的指示,請參閱建立與Adobe Workfront Fusion的連線 — 基本指示。
檔案ID

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

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

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

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

列出專案檔

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

Connection
如需有關將您的Figma帳戶連線到Workfront Fusion的指示,請參閱建立與Adobe Workfront Fusion的連線 — 基本指示。
檔案ID

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

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

列出專案

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

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

元件和樣式

取得樣式或元件

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

Connection
如需有關將您的Figma帳戶連線到Workfront Fusion的指示,請參閱建立與Adobe Workfront Fusion的連線 — 基本指示。
<Object>鍵
輸入您要擷取之物件的金鑰(唯一識別碼)。
團隊ID
輸入或對應與一個或多個記錄關聯的團隊ID。
頁面大小
輸入或對應每頁要傳回的數目或結果。 預設值: 30。
After

輸入或對應結果編號,之後開始擷取結果。 這可以與頁面大小欄位結合以分頁結果。

此值未對應至物件ID。

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

Before

輸入或對應開始擷取結果之前的結果編號。 這可以與頁面大小欄位結合以分頁結果。

此值未對應至物件ID。

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

其他

進行API呼叫

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

Connection
如需有關將您的Figma帳戶連線到Workfront Fusion的指示,請參閱建立與Adobe Workfront Fusion的連線 — 基本指示。
URL

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

例如: files/7179110/comments

方法

選取設定API呼叫所需的HTTP要求方法。 如需詳細資訊,請參閱Adobe Workfront Fusion中的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的連線。 如需有關將Figma帳戶連線至Workfront Fusion的說明,請參閱建立與Adobe Workfront Fusion的連線 — 基本說明。

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

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

  5. 輸入您希望webhook觀看的事件的狀態或說明。

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

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43