Frame.io模块

通过Adobe Workfront Fusion Frame.io模块,您可以在Frame.io帐户中监视、创建、更新、检索或删除资源和评论。

有关Frame.io连接器的视频介绍,请参阅:

访问要求

您必须具有以下权限才能使用本文中的功能:

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 许可证

先决条件

要使用Frame.io模块,您必须具有Frame.io帐户

Frame.io API信息

Frame.io连接器使用以下对象:

基本URL
https://api.frame.io/v2
API版本
v2
API标记
v1.0.76

将Frame.io连接到Adobe Workfront Fusion

您可以使用API令牌或使用OAuth 2.0连接到Frame.io。

使用API令牌连接到 Frame.io

使用OAuth 2.0 PKCE连接到 Frame.io

使用API令牌连接到Frame.io

要使用API令牌将您的Frame.io帐户连接到Workfront Fusion,您必须在Frame.io帐户中创建API令牌并将其插入到Workfront Fusion Frame.io 创建连接对话框中。

  1. 登录到您的Frame.io帐户。
  2. 转到Frame.io开发人员中的​ 令牌 ​页面。
  3. 单击​ 新建
  4. 输入令牌的名称,选择要使用的范围,然后单击​ 创建
  5. 复制提供的令牌。
  6. 转到Workfront Fusion并打开Frame.io模块的​ 创建连接 ​对话框。
  7. 在​ 连接类型 ​字段中,选择​ Frame.io
  8. 输入您在步骤5中复制到​ 您的Frame.io API密钥 ​字段的令牌,然后单击​ 继续 ​以建立连接。

已建立连接。 您可以继续设置模块。

使用OAuth 2.0 PKCE连接到Frame.io

您可以使用带有可选客户端ID的OAuth 2.0 PKCE创建与Frame.io的连接。 如果要在连接中包含客户端ID,则必须在Frame.io帐户中创建OAuth 2.0应用程序。

使用OAuth 2.0 PKCE(不带客户端ID)连接到Frame.io

  1. 转到Workfront Fusion并打开Frame.io模块的​ 创建连接 ​对话框。
  2. 在​ 连接类型 ​字段中,选择​ Frame.ioOAuth 2.0 PKCE
  3. 在​ 连接名称 ​字段中输入新连接的名称。
  4. 单击​ 继续 ​以建立连接。

已建立连接。 您可以继续设置模块。

使用OAuth 2.0 PKCE(带客户端ID)连接到Frame.io

  1. 在Frame.io中创建OAuth 2.0应用程序。 有关说明,请参阅有关OAuth 2.0代码授权流的Frame.io文档。

    note important
    IMPORTANT
    在Frame.io中创建OAuth 2.0应用程序时:
    • 输入以下内容作为重定向URI:

      美洲/APAC https://app.workfrontfusion.com/oauth/cb/frame-io5

      EMEA https://app-eu.workfrontfusion.com/oauth/cb/frame-io5

    • 启用PCKE选项。

  2. 复制提供的client_id

  3. 转到Workfront Fusion并打开Frame.io模块的​ 创建连接 ​对话框。

  4. 在​ 连接类型 ​字段中,选择​ Frame.ioOAuth 2.0 PKCE

  5. 在​ 连接名称 ​字段中输入新连接的名称。

  6. 单击​ 显示高级设置

  7. 输入您在步骤2中复制到​ 客户端ID ​字段的client_id

  8. 单击​ 继续 ​以建立连接。

已建立连接。 您可以继续设置模块。

Frame.io模块及其字段

配置Frame.io模块时,Workfront Fusion显示下面列出的字段。 除此以外,可能还会显示其他Frame.io字段,具体取决于应用程序或服务中的访问级别等因素。 模块中的粗体标题表示必填字段。

如果看到字段或函数上方的映射按钮,则可以使用该按钮设置该字段的变量和函数。 有关详细信息,请参阅在 Adobe Workfront Fusion中将信息从一个模块映射到另一个模块。

资源

创建资产

此操作模块将创建新资源。

Connection
有关创建与Frame.io的连接的说明,请参阅本文中的将Frame.io连接到Adobe Workfront Fusion
团队ID
选择或映射拥有要为其创建资源的项目的团队。
项目ID
选择项目或映射要为其创建资源的项目的ID。
文件夹ID
选择文件夹或映射要在其中创建资产的文件夹的ID。
类型
选择创建文件夹还是文件。
名称
输入新文件或文件夹的名称。
Source URL
输入要上载的文件的URL。
描述
输入资产的简要说明。

删除资产

此操作模块删除指定的资产。

Connection
有关创建与Frame.io的连接的说明,请参阅本文中的将Frame.io连接到Adobe Workfront Fusion
团队ID
选择或映射拥有包含要删除的资产项目的团队。
项目ID
选择包含要删除的资产的项目或。
文件夹ID
选择包含要删除的资源的文件夹
资产ID
选择或映射要删除的资源。

获取资源

此操作模块可检索资产详细信息。

Connection
有关创建与Frame.io的连接的说明,请参阅本文中的将Frame.io连接到Adobe Workfront Fusion
团队ID
选择或映射拥有项目的团队,该项目包含要检索其详细信息的资产。
项目ID
选择包含要检索其详细信息的资源的项目。
文件夹ID
选择包含要检索其详细信息的资源的文件夹。
资产ID
选择资源或映射要检索其详细信息的资源的ID。

列出Assets

此搜索模块可检索指定项目文件夹中的所有资产。

Connection
有关创建与Frame.io的连接的说明,请参阅本文中的将Frame.io连接到Adobe Workfront Fusion
团队ID
选择或映射拥有项目的团队,该项目包含要从中检索资产的文件夹。
项目ID
选择包含要从中检索资源的文件夹的项目。
文件夹ID
选择要从中列出资产的文件夹。
限制
设置在一个执行周期内返回的最大资源数Workfront Fusion。

Update an Asset

使用此操作模块,可更新现有资源的名称、描述或自定义字段。

Connection
有关创建与Frame.io的连接的说明,请参阅本文中的将Frame.io连接到Adobe Workfront Fusion
团队ID
选择或映射拥有要为其更新资产的项目的团队。
项目ID
选择项目或映射要为其更新资源的项目的ID。
文件夹ID
选择文件夹或映射要更新其中资产的文件夹的ID。
名称
输入更新文件的名称。
描述
输入已更新资源的简短说明。

观看资源已删除

此触发器模块会在删除资产后启动方案。

Webhook名称
输入webhook的名称,例如已删除的资产。
Connection
有关创建与Frame.io的连接的说明,请参阅本文中的将Frame.io连接到Adobe Workfront Fusion
团队ID
选择为此webhook创建的团队。

监视资产标签已更新

此触发器模块会在设置、更改或删除资产状态时启动方案。

Webhook名称
输入webhook的名称,例如已更新的资产状态。
Connection
有关创建与Frame.io的连接的说明,请参阅本文中的将Frame.io连接到Adobe Workfront Fusion
团队ID
选择为此webhook创建的团队。

观看新资源

此触发器模块会在创建新资产后启动方案。

Webhook名称
输入webhook的名称,例如创建的资产。
Connection
有关创建与Frame.io的连接的说明,请参阅本文中的将Frame.io连接到Adobe Workfront Fusion
团队ID
选择为此webhook创建的团队。

评论

创建评论

此操作模块向资源添加新评论或回复。

Connection
有关创建与Frame.io的连接的说明,请参阅本文中的将Frame.io连接到Adobe Workfront Fusion
类型
选择是要创建注释还是要回复注释。
团队ID
选择或映射拥有项目的团队,该项目包含要添加注释的资产。
项目ID
选择项目或映射项目ID,该项目包含要添加注释的资产。
文件夹ID
选择文件夹,或映射包含要添加注释的资源的文件夹的ID。
资产ID
选择或映射要将评论添加到的资源。
注释ID
选择或映射您要添加回复的注释。
Text
输入评论或回复的文本内容。
Timestamp
在视频中输入评论应链接到的帧号。

删除评论

此操作模块删除现有评论。

Connection
有关创建与Frame.io的连接的说明,请参阅本文中的将Frame.io连接到Adobe Workfront Fusion
团队ID
选择或映射拥有项目的团队,该项目包含您要从中删除评论的资产。
项目ID
选择项目或映射项目ID,该项目包含您要从中删除评论的资产。
文件夹ID
选择包含要删除评论的资源的文件夹。
资产ID
选择包含要删除的注释的资源。
注释ID
选择要删除的注释。

获取评论

此操作模块检索指定注释的详细信息。

Connection
有关创建与Frame.io的连接的说明,请参阅本文中的将Frame.io连接到Adobe Workfront Fusion
团队ID
选择或映射拥有项目的团队,该项目包含要从中检索资产的文件夹。
项目ID
选择包含要从中检索资源的文件夹的项目。
文件夹ID
选择要从中列出资产的文件夹。
资产ID
选择包含要检索的注释的资源。
注释ID
选择要检索其详细信息的注释。

列出评论

此搜索模块检索指定资源的所有注释。

Connection
有关创建与Frame.io的连接的说明,请参阅本文中的将Frame.io连接到Adobe Workfront Fusion
团队ID
选择或映射拥有项目的团队,该项目包含要从中检索注释的文件夹。
项目ID
选择包含要从中检索注释的文件夹的项目。
文件夹ID
选择包含要从中列出注释的资源文件夹。
资产ID
选择要为其列出注释的资源。
限制
设置在一个执行周期内Workfront Fusion将返回的最大注释数。

更新评论

此操作模块编辑现有评论。

Connection
有关创建与Frame.io的连接的说明,请参阅本文中的将Frame.io连接到Adobe Workfront Fusion
团队ID
选择或映射拥有项目的团队,该项目包含要更新评论的资产。
项目ID
选择包含要更新评论的资源的项目\ 。
文件夹ID
选择包含要更新评论的资源的文件夹。
资产ID
选择要更新评论的资产。
注释ID
选择要更新的注释。
Text
输入注释的文本内容。
Timestamp
在评论链接到的视频中输入帧号。

观看评论已更新

此触发器模块在编辑评论时启动方案。

Webhook名称
输入webhook的名称,例如“编辑的注释”。
Connection
有关创建与Frame.io的连接的说明,请参阅本文中的将Frame.io连接到Adobe Workfront Fusion
团队ID
选择为此webhook创建的团队。

观看新评论

此触发器模块会在创建新评论或回复时启动方案。

Webhook名称
输入webhook的名称,例如新建注释。
Connection
有关创建与Frame.io的连接的说明,请参阅本文中的将Frame.io连接到Adobe Workfront Fusion
团队ID
选择为此webhook创建的团队。

项目

列出项目

此搜索模块检索指定团队的所有项目。

Connection
有关创建与Frame.io的连接的说明,请参阅本文中的将Frame.io连接到Adobe Workfront Fusion
团队ID
选择或映射要为其检索项目的团队。
限制
设置在一个执行周期内Workfront Fusion将返回的最大项目数。

其他

进行API调用

此模块允许您执行自定义API调用。

Connection
有关创建与Frame.io的连接的说明,请参阅本文中的将Frame.io连接到Adobe Workfront Fusion
URL

输入相对于https://api.frame.io的路径。 示例: /v2/teams

注意:有关可用端点的列表,请参阅Frame.io API参考。

方法

选择配置API调用所需的HTTP请求方法。 有关详细信息,请参阅Adobe Workfront Fusion中的HTTP请求方法。

Headers

以标准JSON对象的形式添加请求的标头。

例如, {"Content-type":"application/json"}

Workfront Fusion 自动添加授权标头。

查询字符串
输入请求查询字符串。 对于要包含在查询字符串中的每个参数,单击 添加项 并输入字段名称和所需值。
Body

以标准JSON对象的形式添加API调用的正文内容。

注意:

在JSON中使用条件语句(如if)时,请将引号放在条件语句之外。

示例: ​以下API调用返回您Frame.io帐户中的所有团队及其详细信息:

URL: /v2/teams

方法: GET

可以在“包”>“正文”下的模块输出中找到结果。

在我们的示例中,返回了1个团队的详细信息:

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