注意
云点播【托管模式】功能将逐步调整下线，存量用户仍可继续使用。新用户请使用【点播模式】。

综述

工作流（Workflow）是预先编排好的一系列任务流程。云点播【托管模式】监听特定对象存储路径，在文件上传监听路径后触发消息通知，按照预设的工作流程执行转码、截图、审核等任务动作。每个动作都可以实现多任务并发，一进多出。以下我们将通过一个具体示例来阐明工作原理。

下图阐释了一个样例文件sample.mp4从本机上传至对象存储桶的监听路径后触发工作流事件的完整流程。

1. 用户本机的文件sample.mp4通过SDK、用户控制台或第三方S3工具上传至媒体存储。在文件完成传输完成后，媒体存储根据工作流的配置判断后，会生成一个事件通知。判断的依据主要为：
   （1）该文件是否上传至工作流配置的监听路径下。注意，如果文件实际上传路径深于监听路径，也是可以触发事件的。例如监听目录为input/，而文件实际上传至input/path1/path2/sample.mp4。
   （2）该文件的扩展名是否在工作流支持的文件类型范围内。注意，媒体存储仅判断该文件扩展名是否在支持列表内（不区分大小写）。因此如果文件不包含扩展名，或者扩展名不正确，均不能正常触发工作流事件。
   （3）该工作流是否已经启用。
2. 云点播接收到媒体存储的事件通知后，会根据监听路径匹配的工作流配置，产生特定的处理指令发送给各功能模块。
3. 各功能模块在完成任务后，会执行以下操作（1）将执行产生的数据文件（视频、截图等）回写至工作流配置的输出路径下；（2）按照工作流（或全局回调）配置的回调路径，将任务结果（JSON格式）以HTTP POST方法发送至指定回调地址。
4. 用户接收回调事件后处理后续业务流程。

新建工作流

前提条件

• 已开通云点播产品。
• 已开通至少一个点播区域。
• 已经完成至少一个存储桶的托管。

操作步骤

进入云点播控制台，选择左侧导航栏的【托管模式】–【工作流设置】可打开工作流的配置页面（如下图所示）。

列表中展示各字段说明

当用户点击该页面左上角的【新建工作流】时，可进入工作流新建页面。创建一条合法工作流，总共有两个步骤：

步骤一：输入设置

在该页面，您需要填入以下内容：

需填入数据字段说明

                    
注意
                    
该页面配置的信息在工作流完成后输入部分的信息不可再修改，请注意确保信息准确。
请注意本步骤配置的输入路径不要跟下一步的输出路径重复，否则可能造成循环触发造成您的经济损失。
托管存储区+存储桶+输入路径的组合在租户级别全局唯一，因此不允许出现多条工作流中出现这三个参数完全一致的情况。
                    
                  
                  

步骤二：动作设置

在步骤一配置完成后，点击【下一步】进入动作设置的配置页面。

在该页面，您可以为工作流配置转码、截图、审核、拼接四种动作。当上一步的输入路径写入文件后，这里配置的动作会并行触发。您可以根据这个机制，实现一次写入，所有动作同步完成的效果，提升处理效率。除了审核动作外，其他动作都支持配置0-N条平行子配置，但这四个动作中至少需要配置一个。在每个动作的左上角，点击【添加配置】均可增加一条相关配置，具体的配置说明可参考以下表格。

转码动作配置

截图动作配置

审核动作配置

拼接动作配置

最后点击【完成】按钮后，即可完成对当前工作流的创建。需要注意的是，新创建的工作流默认处于禁用状态，您需要在【工作流设置】页面点击【启用】激活当前工作流。

删除工作流

前提条件

• 已开通云点播产品。
• 已开通至少一个点播区域。
• 已经完成至少一个存储桶的托管。
• 使用主账号登陆用户控制台。

操作步骤

进入云点播控制台，选择左侧导航栏的【托管模式】–【工作流设置】可打开工作流的配置页面（如下图所示）。在该页面选择一条工作流配置，如果当前工作流处于【启用】状态，您需要首先在操作栏点击【更多】-【停用】将该工作流置于停用状态，然后点击随后出现的【删除】按钮，即可删除该工作流。当该工作流删除后，与之相关的各类公共模版的关联检查也随之解除，您可以自行删除关联的公共模版。

修改工作流

前提条件

• 已开通云点播产品。
• 已开通至少一个点播区域。
• 已经完成至少一个存储桶的托管。
• 至少创建了一条工作流。
• 使用主账号登陆用户控制台。

操作步骤

进入云点播控制台，选择左侧导航栏的【托管模式】–【工作流设置】可打开工作流的配置页面（如下图所示）。在该页面选择一条工作流配置，如果当前工作流处于【启用】状态，您需要首先在操作栏点击【停用】将该工作流置于停用状态，然后点击随后出现的【修改】按钮，即可修改该工作流。修改操作与新建操作流程步骤基本一致，此处不再赘述。需要注意一点，已经创建的工作流不允许修改步骤一中的输入部分，请在创建工作流时确保这部分内容的正确性。