一、任务类型清单
| 类型 | 适用场景 | 详细文档 |
| Notebook 任务 | 引用 Studio Notebook 文件，运行 Python + Spark 代码。 | Notebook 任务 |
| Python File 任务 | 引用 Studio Python 文件，运行单文件 Python 代码。 | Python File 任务 |
| Ray 任务 | 提交 Ray 作业（zip 包）到 Ray 集群。 | Ray 任务 |
| SQL 任务 | 引用 Studio SQL 文件，运行 Spark SQL。 | SQL 任务 |
| 离线数据接入任务 | 引用数据接入模块的离线同步任务。 | 离线数据同步任务 |
| IF ELSE 条件任务 | 按条件分支控制下游执行链路。 | IF ELSE 条件任务 |
| For Each 循环任务 | 按数据集循环执行内部任务。 | For Each 循环任务 |
| 嵌套工作流任务 | 在当前工作流中调用另一个工作流。 | 嵌套工作流 |
| 质量监控任务 | 引用数据质量任务，执行规则检查。 | 质量监控任务 |
二、通用配置项
无论选择哪种任务类型，以下配置项的交互与规则一致。各任务类型文档不再重复展开，仅说明本类型独有的字段。
三、任务名称
| 项目 | 规则 |
| 字符集 | 中英文、数字、下划线 _、短横线 – |
| 长度 | 1–512 字符 |
| 唯一性 | 同工作流内任务名不可重复 |
| 校验 | 输入空格自动转下划线；含非法字符或重名时输入框下方红字提示 |
四、上游依赖任务（多任务场景）
| 字段 | 说明 | 是否必填 |
| 上游依赖任务 | 多选下拉，选项为当前工作流内的其他任务。新建任务时自动选中画布上当前选中的任务。 | 否（仅多任务场景显示） |
| 运行条件（触发规则） | 单选 / 高级模式 | 是 |
五、运行条件（触发规则）
控制任务在何种上游状态组合下触发。简单模式下拉选项：
| 选项 | 触发条件 | 上游不满足时下游状态 |
| 全部成功（默认） | 所有上游均成功 | 上游失败 / 排除运行 |
| 全部失败 | 所有上游均失败或上游失败 | 排除运行 |
| 全部完成 | 所有上游到达终态（成功 / 失败 / 上游失败 / 排除运行） | 等待上游 |
| 全部完成且至少一个成功 | 所有上游完成 + 至少一个成功 | 排除运行 |
| 全部完成且至少一个失败 | 所有上游完成 + 至少一个失败 | 排除运行 |
| 全部排除运行 | 所有上游均被排除运行 | 排除运行 |
| 全部完成且没有失败 | 所有上游完成且无失败 | 上游失败 |
| 没有失败且至少一个成功 | 无失败且至少一个成功 | 排除运行 |
| 没有排除运行 | 所有上游都已实际运行（成功 / 失败 / 上游失败） | 排除运行 |
| 至少一个失败 | 任一上游失败立即触发 | 直到失败前等待上游；全部完成无失败 → 排除运行 |
| 至少一个成功 | 任一上游成功立即触发 | 直到成功前等待上游；全部完成无成功 → 排除运行 |
| 至少一个完成 | 任一上游到达终态立即触发 | 等待上游 |
六、高级模式
支持组合多个 {上游任务} = {状态集合} 表达式，用 任意一个 / 全部 来判断。例如：
task_A = 成功、失败 且 task_B = 成功
·上游任务：单选下拉，选项为「上游依赖任务」中已选的任务，每个上游任务在配置中只能出现一次。
·运行条件：多选下拉，可选状态为 成功 / 失败 / 上游失败 / 排除运行。
·条件连接：下拉选择 且 / 或，默认 或。
七、任务运行状态：排除运行
不满足运行条件的任务进入「排除运行」终态，与「跳过运行」（工作流并发不足整体被跳过）不同：
| 状态 | 说明 | 终态 |
| 排除运行（Excluded） | 因不满足任务运行条件，或上游为分支节点且本节点不在分支命中的链路上 | 是 |
| 跳过运行（Skipped） | 工作流整体因并发限制被跳过 | 是 |
排除运行的错误码为 ExecutionConditionsNotMet，运行详情页提示形如「当前任务运行条件为 ${具体运行条件}，不满足运行条件，因此排除运行。」
八、分支节点与运行条件的优先级
当上游存在分支节点（IF ELSE / For Each 等）时，分支判断优先级高于运行条件：
·若不命中分支：本任务直接置「排除运行」，不再判断运行条件。
·若命中分支：按本任务配置的运行条件继续判断是否触发。
九、描述
·支持任意符号。
·字符超过自动停止输入。
·选填。
十、参数
任务参数详细规则见 任务参数配置。每个任务的参数面板包括：
| 来源 | 行为 |
| 工作流下发参数 | 工作流参数自动下发到任务，参数名置灰、参数值不可改，需在工作流参数中修改。 |
| 任务参数 | 在任务上新增参数。当与工作流参数同名时，任务参数优先级更高（任务参数 > 工作流参数）。 |
参数命名、取值规则：
| 项目 | 规则 |
| 参数名 | 所有语言、大小写、数字、_、-，最长 128 字符 |
| 参数值 | 字符串，最长 2048 字符 |
十一、监控指标
监控指标详细规则见 工作流与任务的告警 的「步骤 4：配置监控指标」。简表：
| 指标 | 用途 | 默认值 |
| 运行时长 | 任务运行持续时长 | 00h00m00s（不生效） |
| 等待时长 | 等待上游 / 资源的时长 | 00h00m00s（不生效） |
| 完成时间 | 完成时间点（仅周期运行） | 空（不生效） |
十二、告警配置
告警规则集中维护在 工作流与任务的告警。本节仅说明入口：任务配置面板 → 告警配置 > 配置告警。
十三、失败与超时策略（重试）
控制任务在执行失败或超时后的处理方式。
| 参数 | 说明 | 默认值 |
| 执行失败后重试 | 是否在失败时自动重试。 | 勾选 |
| 超时后行为 | 直接置失败 / 触发重试 | 直接置失败 |
| 最大重试次数 | 1–999 | 4 次（共 5 次执行） |
| 重试间隔 | 数值 + 单位（秒 / 分钟 / 小时），单位最大值 9999。 | 5 分钟 |
提示：保存后，任务配置面板用自然语言展示策略，例如：「执行失败后重试，最多重试次数 4 次，重试之间等待 5 分钟。」
十四、任务保存
| 操作 | 说明 |
| 创建任务 | 新建任务时按钮文案。 |
| 保存任务 | 编辑已存在任务时按钮文案。 |
| 离开未保存 | 弹窗提示：取消 / 放弃更改 / 保存并继续。 |
十五、任务版本
任务保存时自动生成版本记录，每个任务最多保留 1000 个版本。重跑或运行均使用 最新代码、最新非依赖关系配置；如运行过程中修改了依赖关系，按修改前的依赖关系继续执行。详见 工作流与任务的运维操作 的「重跑与运行逻辑」。
十六、共享数据接入与计算资源
| 资源类型 | 说明 |
| 计算资源 | 由各任务类型独立选择；通常为 Spark / Ray 资源组。详见 计算资源概述。 |
十七、相关文档
·工作流概述
·参数配置
·工作流与任务的告警