CloudConvert模块

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

Adobe Workfront 计划*
Pro 或更高
Adobe Workfront 许可证*
Plan, Work
Adobe Workfront Fusion 许可证**

当前许可证要求:无Workfront Fusion许可证要求。

旧版许可证要求:Workfront Fusion用于工作自动化和集成

产品

当前产品要求:如果您有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帐户并打开您的Dashboard。

  2. 打开​ Authorization>API Keys ​部分。

  3. 单击 Create New API key

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

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

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

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

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

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

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

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

映射切换

常见任务

Capture a Website

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

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

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

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

(可选)定义请求标头。

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

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

Convert a file

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

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

    输入要转换的文件的URL。

  • Headers

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

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

Create an Archive

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

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

URL

输入要存档的文件的URL。

Headers

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

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

Merge Files

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

Connection
有关将CloudConvert帐户连接到Workfront Fusion的说明,请参阅本文中的将CloudConvert连接到Workfront Fusion
Input Files
指定要合并的文件。
Upload a File
从上一个模块中选择源文件,或映射源文件的名称和数据。
Import a file from URL

URL

输入要存档的文件的URL。

Headers

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

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

Optimize a File

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

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

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

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

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

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

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

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

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

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

    • 合并字体和子集字体

    • 将颜色转换为CMYK

  • Archive:针对归档目的进行优化

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

    • 智能压缩图像

    • 合并字体和子集字体

  • Scanned images:优化扫描的图像

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

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

  • maximal size reduction:优化以实现最大尺寸缩减

    • 使用最大可能的压缩

    • 可能会降低视觉质量

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

任务

Create a Job (advanced)

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

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

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

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

  • Execute a Command

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

  • Export a File to Temporary URL

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

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

Delete a Job

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

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

Get a Job

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

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

List Jobs

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

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

New Job Event

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

NOTE
  • 由Create a Job (advanced)模块创建的作业包含​ 多个 ​任务。
  • 创建​ 单个 ​任务或任务完成或失败时,也会触发New Job Event触发器。
Webhhook name
输入webhook名称。
Connection
有关将CloudConvert帐户连接到Workfront Fusion的说明,请参阅本文中的将CloudConvert连接到Workfront Fusion
Output Format
选择您希望以PNG、JPG还是PDF格式保存捕获的网站。
Event
选择在创建、完成或失败作业或任务时是否触发该模块。
NOTE
  • 如果使用数组聚合器(例如,要转换的文件具有多种不同格式),请使用Add a task对话框中的​ I don’t know the input format ​选项。 否则,将返回错误。

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

    跨作业 链接名称 >

任务

Cancel a Task

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

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

Delete a Task

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

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

Download a File

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

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

Get a Task

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

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

List Tasks

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

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

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

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

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

Retry a Task

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

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

其他

Get My Info

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

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

Make an API Call

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

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

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

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

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

Method
Headers

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

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

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

Query String

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

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

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

示例: ​列表任务

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

URL: /v2/tasks

方法: GET

API示例输入

在Bundle > Body > data下的模块输出中可以找到搜索匹配项。

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

API示例输出

故障排除 troubleshooting

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

错误
下面的步骤
The output file size exceeds the limit allowed for your scenario.
请参阅文件大小限制。
You have exceeded the maximum conversion time.
免费的CloudConvert计划每天提供25分钟的转化时间。 如果您的使用情况超过了免费计划的限制,则可以切换到(预付)程序包或订阅。
Failed to read frame size: Could not seek to 1508. �/output/JLIADSA00137P0.mp3: Invalid argument.
例如,将文件从MP3转换为WAV时会引发此错误。 请确保选择了正确的区域,因为它将查找文件的引用,而不仅仅是正确文件的引用。

RuntimeError:

Maximum number of repeats exceeded.

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

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

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

  • 在场景设置中启用 Allow storing of Incomplete Executions 选项以存储未完成的执行,以供以后手动解析。 或者,您可以附加一个错误处理路由到CloudConvert模块,并使用Break指令自动解决未完成的执行。
  • 在CloudConvert > Convert a file模块中禁用 Download a file选项。 在这种情况下,模块将不会等待转换结果。 要获得转换结果,请创建一个新方案并使用CloudConvert > New Job Event触发器。

CloudConvert连接器的工作流示例

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

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

  3. 单击​ Convert to ​旁边的下拉菜单并选择​ MP4

  4. 单击​ wrench ​图标。

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

  6. 单击 Convert

  7. 转换完成后,单击​ Download

  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 > Convert a File ​模块。

  15. 打开模块的设置。

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

    CloudConvert示例

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

recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3