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 for Work Automation and Integration

产品 如果您的组织使用的 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
workfront-fusion-help-workfront-fusion