Workiva 支持中心

命令是基于与数据源的连接在链中执行的任务。对于更复杂的链，这可能包括由各种条件触发的命令。

注意： 添加链之前，请确保您的组织 设置了与数据源启用命令所需的连接 。

要串行运行特定命令 --一条接一条，每条命令都要等待前一条命令执行完毕--或同时并行运行 ，或在多条命令中的一条命令失败时让一条命令链失败， 将它们 组合在一起。

在命令链中添加命令

1. 在链中，选择要执行的命令：
   • 要将新命令添加到链中，请在 可用连接器下，单击其连接，然后将命令移动到它在链中应该出现的位置。
   • 要复制现有命令，请选择其节点，单击 Copy  file_copy ，然后将新节点移动到它在链中应该出现的位置。

   提示： 要将命令添加为链的第一个节点，请将其移动到 开始。

2. 要将命令链接到链中的上一个和下一个节点，请单击并拖动节点端口之间的线。

   注： 要改变节点在链中的位置，先将其与其他节点解除链接，然后将其移动到应该出现的位置。要同时移动多个节点，请在选择节点时按住 SHIFT 。

3. 选择新节点，然后单击 编辑  创  建。
4. 输入命令参数：
   • 在 基本信息下，输入唯一的名称和描述，以帮助识别命令及其意图。
   • 如果想屏蔽敏感数据 输出，请切换眼睛图标 。
   • 要多次运行命令，请为列表中的每个项目启 用 Iterator repeat， 和 输入迭代值。
   • 在 命令属性下，根据连接器输入命令的输入，。
5. 单击 保存。

只运行单个命令或命令组

为便于在构建链时进行测试和快速迭代，您可以在链中执行单个命令或命令组。

1. 在 Chain Builder中，从 Chains 标签，从链的菜单中选择 Execute  flight_takeoff 。
2. 对于要运行的命令或组，单击 执行此命令  play_circle_outline。
3. 单击 运行链。

跳过命令

要开发分支逻辑，或作为开发链的一部分，您可能需要跳过一条命令来强制执行特定的结果。您还可以设置条件逻辑，根据设定的规则自动返回特定结果。

1. 在链中，选择命令节点，单击 编辑  创  建 ，然后选择 跳过 skip_next。
2. 选择在跳过该命令时，是自动返    回 info  check_circle, warning  warning, 还  是 error  error 的结果。
3. 若要仅在满足特定条件时跳过命令，请指定何时。将条件逻辑构建为一个组，在其中添加规则和其他规则组，每个规则组都用 AND 或 OR 布尔值连接。
   • 如果所有条件都必须为真才能跳过，则选择 AND。
   • 如果只有一个条件必须为真才能跳过，则选择 OR。

   您可以根据各种数据类型添加规则：

   数据类型	描述
   字串	两个或更多字符
   整数	任何整数、非十进制数值
   日期	任何日期字符串或日期变量
   浮动	任何数值
   JSON	JavaScript 对象符号；使用 变量转换 来解析对象

   要验证数据是否符合跳过命令的标准，可将其与运算符和值配对：

   • 是否空白 或 是否不空白
   • 包含
   • 匹配 RegExp, 表示正则表达式
   • 以 或 开头，以
   • = 或 !=
   • < 或 >
   • <= 或 >=
4. 单击 保存。

管理命令的错误处理

检测或忽略命令的错误：

1. 在链中，单击命令节点，单击 编辑  创  建，并选择 错误处理  警  告。
2. 在 错误操作  重复下 ，选择命令失败时的操作。
   
   • 要遵循链式分支逻辑，请选择 继续链式分支。
   • 要暂时停止链（如纠正问题），请选择 Pause chain。要在问题解决后重新启动链，请选择链中的命令，然后单击 Resume。
   • 要完全停止连锁，请选择 退出连锁。
3. 要在命令超时时停止命令，请在 超时条件下  警报，输入最大持续时间（以秒为单位）。
   
4. 要在数据源断断续续或不可用时重试命令，请输入重试次数和两次重试之间的等待秒数。
5. 在 错误条件  priority_high下 ，选择要忽略的任何错误，如创建已存在的文件夹时。
6. 要根据输出设置命令的状态，请单击 输出解释下的添加 ，然后定义解释其状态的规则或规则组。例如，通过 命令详情 输出中的Status 变量，可以设置一条规则，在命令成功时发出警告。
   
7. 在 Log interpretation下，选择是否根据命令是否导致特定输出而使其失败。
   • 要 而不是 根据特定输出结果使命令失败，请选择不解释。
   • 要在发现特定输出时使命令失败，请选择 "发现输出时失败"，然后输入要扫描的输出。
   • 要在未找到特定输出 时使命令失败，请选择 "Fail if output(s) not found"（如果未找到输出则失败），然后输入要扫描的输出。
   • 多行文字需要用 \n 分隔。
8. 单击 保存。

查看命令输出

从 Monitor flight_takeoff，您可以预览通过 CloudRunner 运行的命令的输出。 

1. 在 Chain Builder中，从 Monitor打开要预览输出的运行，然后选择命令。
2. 在 输出 选项卡上，单击 预览输出 可见性 以查看输出。
   

注意： ，您只能预览通过 CloudRunner 运行的命令输出， ，而不能 GroundRunner。

从命令链中删除命令

要从命令链中删除命令，请单击其节点，单击 删除  删除，然后单击 删除。

注： 为确保链的逻辑性，如果命令的父级有多个同级分支，则不能删除该命令。