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

列出评论

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

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

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

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

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

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

发表评论

此操作模块向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的文件。
节点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但不知道项目的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