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 自动化和集成包

Workfront Ultimate

Workfront Prime 和 Select 包,且需额外购买 Workfront Fusion。

Adobe Workfront 许可证

标准

工作版或更高版本

Adobe Workfront Fusion 许可证

基于操作:不需要 Workfront Fusion 许可证

基于连接器(旧版):用于工作自动化和集成的 Workfront Fusion

产品 如果您的组织使用的 Workfront Select 或 Prime 包不包含 Workfront 自动化和集成,则必须单独购买 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,然后选择该文件。

  • 如果您不知道项目的ID,请单击查找项目,然后输入或映射拥有该文件所关联项目的团队的ID,然后选择该项目,然后选择该文件。

返回评论的最大数量
输入或映射该模块在每次场景执行周期内应返回的评论最大数量。

发表评论

此操作模块向Figma文件发布评论。

连接
有关将Figma帐户连接到Workfront Fusion的说明,请参阅本文中的创建与Figma的连接
文件ID

输入或映射要向其发布注释的文件的文件ID。

  • 如果您不知道文件的ID,请单击查找文件,然后输入或映射与文件关联的项目的ID,然后选择该文件。

  • 如果您尝试查找文件的ID但不知道项目的ID,请单击查找项目,然后输入或映射拥有该文件关联的项目的团队的ID。 选择项目,然后选择文件。

Comment
输入注释的文本。

项目和文件

获取文件或图像

此操作模块从Figma库中检索单个文件或图像

连接
有关将Figma帐户连接到Workfront Fusion的说明,请参阅本文中的创建与Figma的连接
对象类型

选择要检索的对象类型。

  • 文件

    模块会返回由Key引用的文档作为JSON对象。 可以从任何Figma文件URL解析文件密钥。

    有关字段,请参阅获取文件或图像:文件

  • 文件节点

    将ID引用的节点作为JSON对象返回。 从Key引用的Figma文件中检索节点。

    有关字段,请参阅获取文件或图像:文件节点

  • 图像

    模块从文件渲染图像。

    有关字段,请参阅获取文件或图像:图像

  • 图像填充

    模块会返回文档图像填充中存在的所有图像的下载链接。 图像填充是Figma表示任何用户提供的图像的方式。 将图像拖入Figma中时,Figma会创建一个矩形,其中只有一个填充代表图像,用户能够转换矩形(和填充上的属性)。

    有关字段,请参阅获取文件或图像:图像填充

获取文件或图像:文件
文件键
选择要从中返回JSON的文件。
版本ID
输入或映射您希望模块返回的文件版本。 对于当前模块,请将此字段留空。
节点ID

要仅返回文档的子集,请输入您希望模块返回的节点。 该模块会返回列出的节点、它们的子节点以及根节点与列出的节点之间的任何内容。

对于每个要返回的节点,单击 添加 并输入节点的文本。

深度

输入或映射一个整数,该整数表示在文档树中要返回结果的深度。

示例:

  • 要仅返回页面,请输入1

  • 要返回页面和顶级对象,请输入2

要返回所有节点,请将此字段留空。

Geometry
若要返回矢量数据,请输入paths
插件数据
插件ID和/或字符串“shared”的逗号分隔列表。 由这些插件编写的文档中存在的任何数据都将包含在pluginDatasharedPluginData属性的结果中。
分支数据
启用此选项可返回所请求文件的分支元数据。 如果文件是分支,则主文件的密钥包含在返回的响应中。 如果文件具有分支,则其元数据将包含在返回的响应中。 默认值: false
获取文件或图像:文件节点
文件键
选择要从中返回JSON的文件。
节点ID

输入您希望模块返回并转换的节点

对于每个要返回的节点,单击 添加 并输入节点的文本。

版本ID
输入或映射您希望模块返回的文件版本。 对于当前模块,请将此字段留空。
深度

输入或映射一个整数,该整数表示在文档树中要返回结果的深度。

示例:

  • 要仅返回页面,请输入1

  • 要返回页面和顶级对象,请输入2

要返回所有节点,请将此字段留空。

Geometry
若要返回矢量数据,请输入paths
插件数据
插件ID和/或字符串“shared”的逗号分隔列表。 由这些插件编写的文档中存在的任何数据都将包含在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但不知道项目的ID,请单击查找项目,然后输入或映射拥有该文件关联的项目的团队的ID。 选择项目,然后选择文件。

返回的最大文件数
输入或映射您希望模块在每个方案执行周期内返回的最大记录数。

列出项目文件

此搜索模块返回指定项目中所有文件的列表。

连接
有关将Figma帐户连接到Workfront Fusion的说明,请参阅本文中的创建与Figma的连接
文件ID

输入或映射要为其检索文件的项目的项目ID。

  • 如果您不知道项目的ID,请单击查找项目,然后输入或映射与项目关联的团队的ID,然后选择该项目。
返回的最大文件数
输入或映射您希望模块在每个方案执行周期内返回的最大记录数。

列出项目

此搜索模块返回指定团队中所有项目的列表。

连接
有关将Figma帐户连接到Workfront Fusion的说明,请参阅本文中的创建与Figma的连接
团队ID
输入或映射要检索其文件的项目的项目ID。 团队ID可在Figma中的团队页面URL中找到
返回项目的最大数量
输入或映射您希望模块在每个方案执行周期内返回的最大记录数。

组件和样式

获取样式或组件

此操作模块可检索单个样式或组件,或一组样式或组件。

连接
有关将Figma帐户连接到Workfront Fusion的说明,请参阅本文中的创建与Figma的连接
对象>类型
选择要检索的对象类型。
<Object>键
输入要检索的对象的键(唯一标识符)。
团队ID
如果检索团队组件或团队组件集,请输入或映射与记录关联的团队的ID。
页面大小
如果检索团队组件或团队组件集,请输入或映射每页要返回的数量或结果。 默认值:30。
After

如果检索团队组件或团队组件集,请输入或映射结果编号,之后将开始检索结果。 可以与Page Size字段结合使用来对结果进行分页。

此值未与对象ID相对应。

此字段不能与Before字段结合使用。

Before

如果检索团队组件或团队组件集,请输入或映射要开始检索结果的结果数量。 可以与Page Size字段结合使用来对结果进行分页。

此值未与对象ID相对应。

此字段不能与After字段结合使用。

其他

进行API调用

通过此操作模块,您无需考虑身份验证,即可对Figma API进行经过身份验证的自定义调用。 这样,您可以创建其他图形模块无法实现的数据流自动化。

连接
有关将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观看其事件的团队的ID。

  6. 选择是希望激活还是暂停webhook。

  7. 输入webhook的说明。

  8. 单击 保存 以保存webhook并返回模块。

recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3