Workiva支持中心

重要提示： 点击这些选项卡中的任何一个 取消 将关闭命令配置对话框。自上次点击 “保存 ”按钮以来所做的任何更改都将被丢弃且无法恢复

修改命令选项卡

修改命令 选项卡允许您设置运行此命令时要考虑或排除哪些字段。

要修改此命令：

1. 选择 “修改命令 ”选项卡。
2. （可选）在 名称中，修改提供的默认名称。
3. （可选）在 描述中，输入命令配置为执行的操作的有用描述。

4. 在 命令属性下，选择适合此命令的 Workday 连接 和连接类型（CloudRunner 或 GroundRunner）。

   注： CloudRunner 是默认选择，但使用 GroundRunner 也可以建立连接。有关安装和使用 GroundRunner 的信息，请参阅 Workiva 支持页面 安装和管理 GroundRunner。

5. 选择要使用的输入文件 。
   这是一个包含源数据的.csv文件。您可以在 Workiva 文档中找到此文件的模板。

   注意：如果您使用的是 EIB 模板（见下文）， 则CSV 文件的标题必须与模板文件中定义

   的字段匹配。
6. 在 预算配置下，输入与计划结构关联的 预算结构 ID ，以及与财务计划名称关联的 自定义预算 ID 。

7. 选择要使用的导入模式。

   导入模式	行为
   仅增量添加	新增行并更新现有行。不会删除任何内容。
   全部替换	删除整个现有预算计划，并完全替换为您文件中的数据。
   增量添加和删除	同步系统以匹配上传的文件。添加新行、更新现有行，并删除系统中上传文件中缺失的任何行。
   全部替换为句号	仅擦除并替换上传文件中指定时间段内的 数据。保留其他月份/期间的数据。

8. （可选）输入 备注 ，描述命令的用途。

9. 选择此节点完成后要触发的操作。

   命令	描述
   自动完成	选中后，业务流程将自动处理。这意味着系统将自动批准所有申请，自动跳过所有审核和待办事项，自动屏蔽所有通知。
   提交	标记（选中）后，该链会自动提交操作。

最后一个字段和复选框仅用于使用EIB模板。如果您未使用 EIB 模板文件，则可以忽略这两项。

注：EIB 模板必须是一个 XML 文件，其中定义了完成进口预算操作所需的字段。如果指定，则此数据优先于“预算配置”数据。

1. 如果您使用 EIB 模板文件导入预算数据，请在 EIB 模板文件 字段中输入文件名。
2. （可选）选中 忽略警告 复选框，即可忽略所有关于缺少可选字段的警告。
   模板文件将包含可选字段，因此，如果未选择此选项，则当字段不存在时，该命令将报错。
   此选项仅适用于使用EIB模板的进口预算流程。

通知选项卡

通知 选项卡允许您设置当满足某个条件时要发送的通知电子邮件。

要建立通知：

1. 选择 “通知 ”选项卡。
2. 点击 新通知。
3. 点击 电子邮件。
   

4. 填写通知面板上的字段。 

   

   通知面板字段

   字段名称	支持的价值观和行动
   条件	支持的条件有： 成功: 命令已正确完成。 错误: 命令执行失败。 警告：这表明预期结果受到了影响，但可能存在一些未解决的情况导致结果如此。查看命令的输出日志，以获取有关触发此问题的更具体原因。  暂停 是该命令的一种状态。如果命令处于“暂停”状态，则会发送通知。这与暂停通知无关。 始终发送: 始终发送消息。
   收件人	邮件要发送到的电子邮件地址（必须是完整的电子邮件地址）。点击此字段将打开一个下拉列表，其中列出了工作区中所有有效的电子邮件地址。无法提供其他电子邮件地址。
   主旨	邮件主题。默认情况下使用 Chain.Environment、 Chain.Name和 Command Name 变量，后跟选定的条件，但您可以根据需要输入自己的文本。
   附件	这样就可以将文件附加到电子邮件中。从配置对话框左侧的 选择变量 窗格中列出的文件中选择文件。
   附件名称	这是要分配给文件的名称（包括扩展名，例如 .txt 或 .csv）。
   邮件正文	邮件正文中将显示的文本。支持基本的HTML格式设置。

5. 点击 保存。

要发送其他电子邮件通知，请点击当前通知下方的 新通知 ，然后重复这些步骤。

有关通知的更多信息，请参阅 Workiva 支持页面 管理链和命令通知。

跳过条件选项卡

跳过条件 选项卡允许您指定一个条件，该条件将导致命令被跳过，以及如果命令被跳过将会发生什么。

要为此命令设置跳过条件：

1. 选择 “跳过条件 ”选项卡。
2. 单击 跳过条件 字段，然后选择触发条件。
   选项如下：
   • 成功（命令已正确完成）。
   • 错误（命令执行失败）。

   • 警告（这表明预期结果受到了影响，但可能存在导致结果出现的特殊情况。请查看命令的输出日志，以了解触​​发此问题的更具体原因。）

     

3. 创建规则以确定跳过命令时会发生什么。
   1. 选择 AND 或 OR。默认情况下，第一条指令以 AND开头。

   2. 单击 +RULE，然后选择要测试的数据类型。选项包括
      String （默认）、 Integer、 Date、 Float和 JSON。

      

   3. 请输入测试所采用的标准。

   4. 选择测试值。选项如下：

      选项	结果
      空白	结果为空（空集）。
      不为空	结果不为空集。
      包含	结果包含特定值。选中此项会打开一个辅助字段，供您输入要匹配的字符串。
      匹配正则表达式	结果与指定的正则表达式匹配。选择此项将打开一个辅助字段，供您输入正则表达式。
      以……开始	结果以特定字符串开头。选中此项会打开一个辅助字段，供您输入字符串。
      以……结尾	结果以特定字符串结尾。选中此项会打开一个辅助字段，供您输入字符串。
      = （等于）	结果与特定值相符。选中此项将打开一个辅助字段，供您输入值。
      != （不等于）	结果与指定值不匹配。选中此项将打开一个辅助字段，供您输入值。
      小于	结果小于特定值。选中此项将打开一个辅助字段，供您输入值。
      > （大于）	结果不仅仅是一个具体的数值。选中此项将打开一个辅助字段，供您输入值。
      <= （小于或等于）	结果小于或等于特定值。选中此项将打开一个辅助字段，供您输入值。
      >= （大于或等于）	结果大于或等于特定值。选择此项会打开一个辅助字段，供您输入要考虑的值。

4. 如果只有一个条件，请点击 保存。
5. 如果您有多个条件，请再次单击 +RULE 添加单个条件，或 单击 +GROUP 将条件作为一个组进行评估。

笔记

• 条件按其列出的顺序（从上到下）进行评估。将分组条件作为一个整体进行评估，然后按照该组在列表中出现的顺序评估评估结果。
• 没有办法重新排列条件；如果您想更改条件的顺序，则必须按照您希望的评估顺序重新创建列表。
• 有关跳过条件的更多信息，请参阅 Workiva 社区页面 跳过条件：不可跳过，但绝对值得考虑！ 和 Workiva 支持页面 管理链中的命令。

动态输出选项卡

动态输出 选项卡允许您指定规则，从命令的输出中提取值或值列表，然后可以在链中稍后使用这些值或值列表。您可以使用以下两种方法之一向命令添加多个动态输出：

• 精确匹配——提取值开头或结尾的特定文本。
• 正则表达式——用于根据特定模式或序列匹配值。

要设置动态输出规则，请完成以下步骤。

1. 选择 “动态输出 ”选项卡。
2. 单击 +添加动态输出。这将显示动态输出配置面板。
   
3. 请为此输出输入一个 名称 。
4. 在 原始输出中，选择要转换的输出。
5. 配置输出结果的获取和存储方式。以下字段均为选填项。
   • 匹配文本 字段可以包含要匹配的文本或正则表达式。
   • 要与提供的文本完全匹配，请在 匹配类型中选择“完全匹配”。
   • 要使用正则表达式，请在 匹配类型中选择“正则表达式 (regex)”。
   • 在 匹配结果中，输入结果文本的显示方式。
     例如，如果结果是用括号括起来的数字，您可以输入 $0 来显示包括括号在内的整个匹配值，或者 输入 $1 来仅显示不带括号的匹配数字。
   • 要仅匹配输出中特定行的文本，请在“要检查的行”中输入以逗号分隔的行号或行号范围。要包含一系列行，请使用破折号（-），因此 1-10 仅返回第 1 行到第 10 行的内容。要分隔行或范围，请使用逗号（,），因此 1-10, 13 仅返回第 1 行到第 10 行和第 13 行的内容。
6. 在 输出类型中，选择是要返回单个输出还是输出列表。
7. 选中或清除 区分大小写 和 修剪匹配项 复选框，以获得所需的结果。
8. 点击 保存。
9. （可选）点击 测试 查看是否得到预期结果。

如果要创建额外的动态输出，请点击 +添加动态输出。这将显示附加动态输出的动态输出配置面板。

有关使用动态运算符的更多信息，请参阅 Workiva 支持页面 管理命令的动态输出。

错误操作选项卡

错误操作 选项卡允许您指定在处理命令时发生错误时要执行的操作。

要设置此命令出错时要执行的操作：

1. 选择 “错误操作 ”选项卡。
2. 在 错误操作下，选择命令失败时您希望链执行的操作。
   • 要遵循链式分支逻辑，请选择 继续链。
   • 要暂时停止链式调用（例如，为了解决问题），请选择 暂停链式调用。
     问题解决后，要重新启动链，请选择链中的命令，然后单击 恢复。
   • 要完全停止链式调用，请选择 退出链式调用。
3. 如果命令运行时间超过预期，要停止该命令，请在 超时条件下输入任务运行的最大时间（以秒为单位）。
4. 如果数据源不稳定或不可用，要重试命令，请输入要尝试的重试次数以及每次尝试之间要等待的秒数。
   

5. 在 错误条件下，选择要忽略的错误。

   条件	描述
   无效参数	选中此项后，命令将忽略任何无效参数。
   普遍失败	标记此行会导致即使该命令可能失败，链式执行也会继续。

6. 要根据命令的输出设置命令的状态，请单击 输出解释左侧的绿色圆圈加号。
7. 点击 +规则 并定义规则（或规则组）以解释输出状态。
   
   如果要指定其他条件，请点击蓝色圆圈加号，添加其他条件定义字段。
   条件按其列出的顺序（从上到下）进行评估。将分组条件作为一个整体进行评估，然后按照该组在列表中出现的顺序评估评估结果。

注意：条件顺序无法更改 ；如果要更改条件顺序，则必须

8. 在 日志解释下，选择是否根据特定输出使命令失败。
   • 要 不 根据特定输出使命令失败，请选择 不解释。
   • 如果发现特定输出，则要使命令失败，请选择 如果发现输出则失败，然后输入要扫描的输出。
   • 如果找不到特定输出，则要使命令失败，请选择 如果找不到输出则失败，然后输入要扫描的输出。
   • 用 分隔多行文本 \n。
9. 点击 保存。

迭代器选项卡

“迭代器 ”选项卡允许您设置迭代（循环或重复）Get Workers 命令的规则。

注： 此选项卡默认处于禁用状态。

要设置迭代规则，请完成以下步骤。

1. 选择 “迭代器 ”选项卡。
2. 通过切换选项卡顶部的开关来启用迭代器。
   
   这样做会将选项卡标题（迭代器）旁边的图标从深灰色变为蓝色，并显示迭代器配置面板。标签标题旁边的标记也会变成绿色。
   

3. 选择要使用的 修饰符类型 。
   选项为 列表 （默认）和 重复直到。

   • 选择 列表 会使命令重复执行：
     • 静态值列表，例如区域或实体。这也可以是一个数字，例如“3”。
     • 动态或可变的值列表，例如来自作为工作区资源上传的文件或链中较早命令的输出。
   • 选择 重复直到 将使命令重复执行，直到满足指定的条件。

   注意： 每个命令最多只能执行 1000 次迭代

   。
4. 输入控制迭代的规则。
   有关使用迭代器的更多信息，包括如何指定迭代器，请参阅 Workiva 支持页面 将迭代器与命令和命令组一起使用。
5. 点击 保存。