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。
Comment
输入要删除的注释的文本。

列出评论

此搜索模块列出了附加到Figma中单个文件的所有注释。

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

输入或映射要为其检索注释的文件的文件ID。

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

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

限制
输入或映射您希望模块在每个方案执行周期中返回的最大注释数。

Post评论

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

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

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

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

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

Comment
输入注释的文本。

项目和文件

获取文件或图像

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

Connection
有关将Figma帐户连接到Workfront Fusion的说明,请参阅创建与Adobe Workfront Fusion的连接 — 基本说明。
对象类型

选择要检索的对象类型。

  • 文件

    模块会返回由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的文件。
节点编号

输入您希望模块呈现的节点。

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

缩放
要缩放图像,请输入或映射缩放因子。 此数字必须介于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但不知道项目的ID,请单击 查找项目,然后输入或映射拥有该文件关联的项目的团队的ID。 选择项目,然后选择文件。

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

列出项目文件

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

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

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

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

列出项目

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

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

组件和样式

获取样式或组件

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

Connection
有关将Figma帐户连接到Workfront Fusion的说明,请参阅创建与Adobe Workfront Fusion的连接 — 基本说明。
<Object>键
输入要检索的对象的键(唯一标识符)。
团队ID
输入或映射与一个或多个记录关联的团队的ID。
页面大小
输入或映射每页返回的数字或结果。 默认值:30。
After

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

此值未与对象ID相对应。

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

Before

输入或映射开始检索结果之前的结果编号。 可以与Page Size字段结合使用来对结果进行分页。

此值未与对象ID相对应。

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

其他

进行API调用

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

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观看其事件的团队的ID。

  5. 输入您希望webhook监视的事件的状态或描述。

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

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