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帳戶。

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