流水线预置 选择器 任务，支持通过人工决策的方式决定流水线继续向下运行的路径，增强流水线的决策编排能力。本文为您介绍如何在流水线中使用选择器。

背景信息

选择器需要与同一阶段中的下游任务一起配合使用。下游任务的执行条件与选择器的人工决策选项匹配时，则执行，不匹配时不执行。本示例以选择器和两个命令执行任务为例说明使用流程。

使用限制

选择器与待选择的下游任务必须处于同一阶段中，否则无法生效。

操作步骤

1. 配置 选择器 任务。

   1. 创建或编辑流水线时，在 流程编排 页签，单击 添加任务，弹出 添加任务 抽屉。任务模板选择 流程控制 > 选择器。

   2. 按要求配置选择器任务，配置完成后单击确定。

      

      配置项	说明
      任务名称	默认为选择器，支持自定义任务名称。
      上游任务	展示当前任务的上游串行任务名称。无上游任务时展示为-。
      操作人	选择人工决策的决策人。设置多个决策人时，决策人之间为或签，即任一人决策均可。
      选项	设置选择器的选项。支持添加多个。选项值将作为按钮名称显示在流水线运行详情中，供决策人进行选择。 请注意将选项值与下游任务的执行条件进行一一绑定。
      超时时间	设置选择器任务的自动超时时间。选择器任务运行时长超过超时时间后自动失败。
      任务输出	本预置任务无产物输出。
      高级设置	Webhook 通知：支持通过 Webhook 和飞书机器人两种方式推送任务维度的消息，帮助您及时掌握任务动态。

2. 在同一阶段中，配置选择器的下游任务。配置完成后单击 确定。
   步骤 1 中选择器配置了 2 个选项，故需要添加 2 个下游任务。本文添加 2 个命令执行任务与选择器的选项值进行一一绑定。

   • 添加命令执行1，执行内容为echo hello function 1，并在 高级设置 > 选择器条件 选择 功能1，将此任务与选择器的 功能1 绑定。
   • 添加命令执行2，执行内容为echo hello function 2，并在 高级设置 > 选择器条件 选择 功能2，将此任务与选择器的 功能2 绑定。

3. 单击 保存，保存流水线。

运行说明

流水线运行至选择器任务时，会进入等待中状态，等待决策人决策选择器的执行路径。

• 选择 功能1，则流水线将执行 命令执行1。

• 选择 功能2，则流水线将执行 命令执行2。

• 选择 拒绝，则流水线将终止执行，流水线状态为运行失败。

如下图所示，本示例选择了 功能2，流水线执行 命令执行2，成功打印出hello function 2。