CloudConvert模块

在Adobe Workfront Fusion场景中,您可以自动使用CloudConvert的工作流,并将其连接到多个第三方应用程序和服务。 CloudConvert模块允许您监视和管理CloudConvert帐户中的作业、任务以及导入和导出文件。

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,才能使用本文中介绍的功能。

CloudConvert API信息

CloudConvert连接器使用以下对象:

基本URL
https://api.cloudconvert.com/v2/
API版本
v2
API标记
v2.14.22

将CloudConvert连接到Workfront Fusion connect-cloudconvert-to-workfront-fusion

若要将您的CloudConvert帐户连接到Workfront Fusion,您需要从您的CloudConvert帐户获取API密钥。

  1. 登录到您的CloudConvert帐户并打开您的仪表板。

  2. 打开​ 授权 > API密钥 ​部分。

  3. 单击​ 创建新API密钥

  4. 输入API密钥的名称,启用要使用的范围,然后单击​ 创建

  5. 复制提供的令牌并将其存储在安全位置。

  6. 在Workfront Fusion中,开始创建方案并打开CloudConvert模块的​ 创建连接 ​对话框。

    有关说明,请参阅在 Adobe Workfront Fusion中创建方案。

  7. 输入您在步骤5中保存的令牌,然后单击​ 继续 ​以建立连接。

CloudConvert模块及其字段 cloudconvert-modules-and-their-fields

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

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

常见任务

捕获网站

此操作模块可捕获指定的网站并将其保存为PDF、JPG或PNG格式。

您可以指定网站的URL和其他信息,例如要将信息存储在何处。

模块会返回文件的ID和任何关联字段,以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。

Connection
有关将CloudConvert帐户连接到Workfront Fusion的说明,请参阅本文中的将CloudConvert连接到Workfront Fusion
URL
输入要捕获的网站的URL。
输出格式
选择您希望以PNG、JPG还是PDF格式保存捕获的网站。
文件名
为目标输出文件输入文件名(包括扩展名)。
Headers

(可选)定义请求标头。

这很有用,例如,当指定的URL需要授权时。

转换和特定于引擎的选项
指定转化和特定于引擎的选项。 要查看可用选项,请参阅有关input_formatoutput_formatCloudConvert API文档。
下载文件
如果还希望在模块的输出中包含文件数据,则启用此选项。

转换文件

将文件转换为选定的输出格式。

Connection
有关将CloudConvert帐户连接到Workfront Fusion的说明,请参阅本文中的将CloudConvert连接到Workfront Fusion
输入文件
选择是要使用Workfront Fusion上载文件,还是提供将从中上载文件的URL。
上传文件
从上一个模块中选择源文件,或映射源文件的名称和数据。
从URL导入文件
  • URL

    输入要转换的文件的URL。

  • Headers

    定义请求标头(可选)。 这很有用,例如,当指定的URL需要授权时。

格式
选择是否要指定要转换的文件的输入格式。 如果未指定,则使用输入文件的扩展名作为输入格式。
Input Format
选择文件的当前格式。
输出格式
选择要将文件转换到的目标文件格式。
文件名
选择目标输出文件的文件名(包括扩展名)。
转换和特定于引擎的选项
指定转化和特定于引擎的选项。 要查看可用选项,请参阅有关input_formatoutput_formatCloudConvert API文档。
下载文件
如果还希望在模块的输出中包含文件数据,则启用此选项。

创建存档

使您能够将一个或多个文件添加到ZIP、RAR、7Z、TAR、TAR.GZ或TAR.BZ2存档中。

Connection
有关将CloudConvert帐户连接到Workfront Fusion的说明,请参阅本文中的将CloudConvert连接到Workfront Fusion
输入文件
指定要添加到存档中的文件。
上传文件
从上一个模块中选择源文件,或映射源文件的名称和数据。
从URL导入文件

URL

输入要存档的文件的URL。

标头

定义请求标头(可选)。 这很有用,例如,当指定的URL需要授权时。

输出格式
选择存档文件的目标格式。
文件名
输入目标输出文件的文件名(包括扩展名)。
转换和特定于引擎的选项
指定转化和特定于引擎的选项。 要查看可用选项,请参阅有关input_formatoutput_formatCloudConvert API文档。
下载文件
如果还希望在模块的输出中包含文件数据,则启用此选项。

合并文件

至少将两个文件合并到一个PDF中。 如果输入文件不是PDF,则它们会自动转换为PDF。

Connection
有关将CloudConvert帐户连接到Workfront Fusion的说明,请参阅本文中的将CloudConvert连接到Workfront Fusion
输入文件
指定要合并的文件。
上传文件
从上一个模块中选择源文件,或映射源文件的名称和数据。
从URL导入文件

URL

输入要存档的文件的URL。

标头

定义请求标头(可选)。 这很有用,例如,当指定的URL需要授权时。

输出格式
选择合并文件的目标格式。
文件名
输入目标输出文件的文件名(包括扩展名)。
转换和特定于引擎的选项
指定转化和特定于引擎的选项。 要查看可用选项,请参阅有关input_formatoutput_formatCloudConvert API文档。
下载文件
如果还希望在模块的输出中包含文件数据,则启用此选项。

优化文件

该操作模块可优化和压缩PDF、PNG或JPG格式的文件。

指定文件以及用于优化和存储文件的参数。

模块会返回文件的ID和任何关联字段,以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。

配置此模块时,会显示以下字段。

Connection
有关将CloudConvert帐户连接到Workfront Fusion的说明,请参阅本文中的将CloudConvert连接到Workfront Fusion
输入文件
选择是要使用Workfront Fusion上载文件,还是提供用于上载文件的URL。
上传文件
从上一个模块中选择源文件,或映射源文件的名称和数据。
从URL导入文件
  • URL:输入要转换的文件的URL。
  • 标头: (可选)定义请求标头。 这很有用,例如,当指定的URL需要授权时。
Optimization for

为特定目标需求选择优化配置文件。

  • Web:针对Web进行优化(默认)

    • 为Web删除冗余和不必要的数据
    • 缩减像素采样、剪辑和智能压缩图像
    • 合并字体和子集字体
    • 将颜色转换为RGB
  • 打印:优化打印

    • 删除冗余和不必要的打印数据

    • 缩减像素采样、剪辑和智能压缩图像

    • 合并字体和子集字体

    • 将颜色转换为CMYK

  • 存档:针对存档目的进行优化

    • 删除冗余和不必要的数据以进行存档

    • 智能压缩图像

    • 合并字体和子集字体

  • 扫描的图像:优化扫描的图像

    • 为主要包含光栅图像的PDF优化的配置文件

    • 在不显着降低视觉质量的情况下压缩图像

  • 最大尺寸缩减:针对最大尺寸缩减进行优化

    • 使用最大可能的压缩

    • 可能会降低视觉质量

输入格式
选择要优化的输入文件格式。
文件名
为目标输出文件输入文件名(包括扩展名)。
转换和特定于引擎的选项
指定转化和特定于引擎的选项。 要查看可用选项,请参阅有关input_formatoutput_formatCloudConvert API文档。
下载文件
如果还希望在模块的输出中包含文件数据,则启用此选项。

任务

创建作业(高级)

此模块将创建一个作业。 作业可以是名称字段中标识并使用输入字段相互链接的一个或多个任务。

Connection
有关将CloudConvert帐户连接到Workfront Fusion的说明,请参阅本文中的将CloudConvert连接到Workfront Fusion
输入文件
选择是要使用Workfront Fusion上载文件,还是提供上载文件的URL。
上传文件
从上一个模块中选择源文件,或映射源文件的名称和数据。
从URL导入文件
  • URL:输入要处理的文件的URL。
  • 标头: (可选)定义请求标头。 这很有用,例如,当指定的URL需要授权时。
任务

添加将在作业中执行的任务。

请在相应的部分中找到操作字段的说明。

  • 执行命令

    有关执行命令的详细信息,请参阅CloudConvert API文档

  • 将文件导出到临时URL

    指定任务名称和输入任务名称(例如,转换)。

标记
输入标记。 标记是用于标识作业的任意字符串。 它们没有任何效果,可用于将作业与ID相关联。

删除作业

此模块会删除作业,包括所有任务和数据。

NOTE
作业在结束的24小时后自动删除。
Connection
有关将CloudConvert帐户连接到Workfront Fusion的说明,请参阅本文中的将CloudConvert连接到Workfront Fusion
作业ID
输入或映射要删除的作业的ID。

获取作业

此模块可检索作业详细信息。

Connection
有关将CloudConvert帐户连接到Workfront Fusion的说明,请参阅本文中的将CloudConvert连接到Workfront Fusion
作业ID
输入或映射要检索其详细信息的作业的ID。

列出作业

此模块可检索已在您的帐户中运行的所有作业。

Connection
有关将CloudConvert帐户连接到Workfront Fusion的说明,请参阅本文中的将CloudConvert连接到Workfront Fusion
状态
选择作业状态,以筛选返回的作业。
限制
设置Workfront Fusion 2.0在一个执行周期中返回的作业数。

新作业事件

在帐户或任务中的作业创建、完成或失败时触发。

NOTE
  • 由创建作业(高级)模块创建的作业包含​ 多个 ​任务。
  • 创建、完成或失败的​ 单个 ​任务时,也会触发新作业事件触发器。
Webhook名称
输入webhook名称。
Connection
有关将CloudConvert帐户连接到Workfront Fusion的说明,请参阅本文中的将CloudConvert连接到Workfront Fusion
输出格式
选择您希望以PNG、JPG还是PDF格式保存捕获的网站。
事件
选择在创建、完成或失败作业或任务时是否触发该模块。
NOTE
  • 如果使用数组聚合器(例如,您有许多不同格式的文件要转换),请使用添加任务对话框中的​ 我不知道输入格式 ​选项。 否则,将返回错误。

  • 链接作业中的任务(名称>输入,名称>输入,…):

    >

任务

取消任务

此模块可取消处于等待或处理状态的任务。

Connection
有关将CloudConvert帐户连接到Workfront Fusion的说明,请参阅本文中的将CloudConvert连接到Workfront Fusion
任务ID
输入或映射要取消的任务的ID。

删除任务

删除任务,包括所有数据。

NOTE
任务结束后24小时后会自动删除。
Connection
有关将CloudConvert帐户连接到Workfront Fusion的说明,请参阅本文中的将CloudConvert连接到Workfront Fusion
任务ID
输入(映射)要删除的任务的ID。

下载文件

此模块从指定任务中检索文件名和文件数据。

Connection
有关将CloudConvert帐户连接到Workfront Fusion的说明,请参阅本文中的将CloudConvert连接到Workfront Fusion
任务ID
输入或映射要从中下载文件的任务的ID。

获取任务

此模块可检索任务详细信息。

Connection
有关将CloudConvert帐户连接到Workfront Fusion的说明,请参阅本文中的将CloudConvert连接到Workfront Fusion
任务ID
输入或映射要检索其详细信息的任务的ID。

列出任务

此模块根据筛选器设置检索您帐户中的所有任务。

Connection
有关将CloudConvert帐户连接到Workfront Fusion的说明,请参阅本文中的将CloudConvert连接到Workfront Fusion
状态
选择任务状态以作为返回任务筛选依据。
作业ID
输入或映射作业ID以仅返回指定作业内的任务。
操作

输入工序类型以仅返回具有指定工序的任务。

注意:使用List Possible Operations模块检索操作。

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

重试任务

此模块根据其他任务的设置(有效负荷)创建新任务。

Connection
有关将CloudConvert帐户连接到Workfront Fusion的说明,请参阅本文中的将CloudConvert连接到Workfront Fusion
任务ID
输入或映射要从中创建新任务的任务ID。

其他

获取我的信息

检索有关当前用户的经过身份验证的帐户详细信息。

Connection
有关将CloudConvert帐户连接到Workfront Fusion的说明,请参阅本文中的将CloudConvert连接到Workfront Fusion

进行API调用

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

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

Connection
有关将[Fusion App]帐户连接到Workfront Fusion的说明,请参阅创建与Adobe Workfront Fusion的连接 — 基本说明
URL

输入相对于https://api.cloudconvert.com/的路径。 例如: /v2/tasks

有关可用端点的列表,请参阅CloudConvert API v2文档

方法
Headers

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

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

Workfront Fusion 2.0为您添加授权标头。

查询字符串

以标准JSON对象的形式添加API调用的查询。

例如: {"name":"something-urgent"}

Body
以标准JSON对象的形式添加API调用的正文内容。在JSON中使用条件语句(如if)时,请将引号放在条件语句之外。

示例: ​列表任务

以下API调用返回您CloudFront帐户中的所有任务:

URL: /v2/tasks

方法: GET

在包 > 正文 > 数据下的模块输出中可以找到搜索匹配项。

在我们的示例中,返回了6个任务:

故障排除 troubleshooting

请参阅下表以了解可能出现的错误及其解决方案:

错误

下面的步骤

输出文件大小超出方案所允许的限制。

请参阅文件大小限制。

您已超过最大转化时间。

免费的CloudConvert计划每天提供25分钟的转化时间。 如果您的使用情况超过了免费计划的限制,则可以切换到(预付)程序包或订阅。

无法读取帧大小:无法搜寻到1508。 /output/JLIADSA00137P0.mp3�:参数无效。

例如,将文件从MP3转换为WAV时会引发此错误。 请确保选择了正确的区域,因为它将查找文件的引用,而不仅仅是正确文件的引用。

RuntimeError:

超出最大重复数。

在CloudConvert仪表板的作业列表中找到相应的CloudConvert作业,并检查该作业的持续时间:

CloudConvert > Convert a File模块的超时设置为3分钟。 如果作业持续时间超过3分钟(可能由于CloudConvert服务临时过载),则模块会引发上述错误。

在这种情况下,请考虑以下选项之一:

- 在场景设置中启用 允许存储未完成的执行 选项以存储未完成的执行,以供以后手动解析。 或者,您可以附加一个错误处理路由到CloudConvert模块,并使用Break指令自动解决未完成的执行。- 禁用CloudConvert > 转换文件模块中的 下载文件选项。 在这种情况下,模块将不会等待转换结果。 要获得转换结果,请创建一个新方案并使用CloudConvert > 新建作业事件触发器。

CloudConvert连接器的工作流示例

INFO
示例: ​将视频从MOV转换为MP4格式
  1. 访问https://cloudconvert.com/video-converter

  2. 单击​ 选择文件 ​并选择您的示例MOV文件。

  3. 单击​ 转换为 ​旁边的下拉菜单并选择​ MP4

  4. 单击​ 扳手 ​图标。

  5. 根据需要配置MP4压缩设置。

  6. 单击​ 转换

  7. 转换完成后,单击​ 下载

  8. 查看转换后的视频。

  9. 重复步骤1至8,直到找到步骤5的最佳转化设置。

  10. 访问https://cloudconvert.com/api/v2/convert#convert-tasks

  11. 为​ input_format ​字段选择​ mov

  12. 为​ output_format ​字段选择​ mp4

  13. 所有可能参数(如video_codec、crf等)的列表。 将会出现。

  14. 在Workfront Fusion 2.0中,在您的方案中插入​ CloudConvert > 转换文件 ​模块。

  15. 打开模块的设置。

  16. 按如下所示配置模块:

  17. 确保在“转换和引擎特定选项”字段中包括所有设置:对于步骤5中的每个设置,请找到步骤13中的相应参数及其相应值。

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