调用决策表操作

使用任务中的“呼叫决策表”操作来选择并执行管理员先前在 Genesys Cloud 中配置的基于规则的决策表。当您调用决策表时，您会将相关的输入和输出 JSON 模式带入流程。Architect 将这些 JSON 模式作为自定义 JSON 数据类型进行处理，这些数据类型仅适用于调用决策表操作。但是，在将“呼叫决策表”操作添加到流程后，您还可以使用自定义 JSON 数据类型更新数据操作。 

决策表允许管理员定义输入和输出标准，如果输入值满足设定的标准，决策表就会产生输出。流程作者可以调用决策表，定义输入值，然后使用决策表生成的输出 JSON 对象在流程中进一步处理。有关决策表的更多信息，请参阅关于基于规则的决策。  

笔记：基于规则的决策需要支付使用费，按照您调用执行 API 的次数进行计量。有关详细信息，请参阅基于规则的决策定价。

  1. 在 Architect 主页上，单击或将鼠标悬停在 “ 流程” 菜单上，然后选择所需的流程类型。
  2. 创建新流程或选择现有流程。 流程的配置页面随即打开。
  3. 选择任务，然后单 击单击以打开。 任务编辑器随即打开。
  4. 从任务编辑器工具箱中展开数据类别并拖动呼叫决策表操作到任务编辑器中的所需位置。
  5. 在姓名盒子为该操作输入一个有意义的名称。此名称将成为任务工作流中“调用决策表”操作的名称。
  6. 从决策表列表中，选择所需的决策表。
  7. 根据所选决策表的规则模式，定义输入，输出， 和故障输出用于在运行时执行的操作。
    笔记：出现的输入属性来自为决策表创建的输入模式。
  8. 继续按照流程设计构建任务，包括呼叫决策表成功和失败路径。

姓名 描述
名称字段 为呼叫决策表操作输入一个独特的名称。您在此处输入的标签将成为任务序列中显示的操作名称。
决策表

单击此列表末尾的箭头并选择适当的决策表。要缩小选择范围，请输入相应决策表的前几个字母。

您可以选择任何已发布的决策表，无论该决策表属于哪个部门。但是，如果您的决策表具有队列数据类型，则您只能在适用的部门中使用队列。
输入

定义操作在运行时执行的输入值。根据管理员在 Genesys Cloud 中配置决策表的方式，这些选项会有所不同，并且可能是可选的。

选择标准或者JSON在标准和 JSON 编辑模式之间切换。

  • 标准：允许您在提供的输入字段中定义输入值。出现的字段来自为决策表创建的输入模式。 
  • JSON ：允许您使用 JSON 属性直接定义输入值。在这种模式下，您可以访问 Architect 的自定义 JSON 编辑器及其工具来定义输入值。编辑器显示模式类型（无论是输入还是输出）以及决策表。有关使用自定义 JSON 编辑器的更多信息，请参阅架构自定义 JSON 编辑器。

标准和 JSON 编辑模式都允许文字和表达式作为输入值。如果您在 JSON 模式下未设置某个属性及其值，则标准模式下的相应字段将显示未指定值。 

注释：

  • 当您在编辑模式之间切换时，Architect 会保留现有值。如果在切换模式时出现任何验证错误，Architect 会提醒您并提供恢复到以前有效值或取消切换模式的选项。 
  • 如果自定义 JSON 数据具有任何复杂的值结构（例如集合），则无法切换回标准编辑模式。
  • 将整个输入对象从文字模式切换到表达式模式会重置输入数据。在表达式模式下，访问自定义 JSON 编辑器的选项也会消失。
输出

选择现有变量或输入新变量来分配决策表返回的输出 JSON 对象。 

笔记：Architect 将决策表返回的整个 JSON 对象分配给变量，从而允许您使用点符号访问 JSON 值。例如，如果您将变量命名为Task.output，您可以使用更新数据操作使用变量表达式，Task.output.<JSON property name> 。

空值处理

下表显示了 Architect 作为输入发送的 Null 值如何根据决策表规则进行验证：

在 Architect 中输入值 编辑模式 决策表中的映射值
没有价值 标准

空

空白文字值

笔记：这仅适用于字符串数据类型。
  • 标准
  • JSON
 空字符串

未设置
  • 标准
  • JSON
 空

空
  • 标准
  • JSON
 空

“调用决策表”操作支持以下输入和输出变量的数据类型：
  • 标准数据类型
    • 布尔值：布尔表达式只能有两个值之一：真或假。 
    • 日期：日期值是符合日期数据 XML 标准所规定格式的字符串，类似于 ISO 8601。
    • 日期和时间：DateTime 值是符合日期数据 XML 标准所规定格式的字符串，类似于 ISO 8601。 
    • 枚举：枚举是可选选项的预定义列表。
      笔记：Architect 本身将枚举值作为字符串处理。当您为调用决策表操作定义枚举输入值时，您必须使用在决策表使用的规则模式中的枚举选项下配置的项目键。请勿使用物品标签。类似地，如果规则与输入值匹配，并且结果为枚举类型，则 Architect 会在输出变量中返回 Item Key。
    • 整数：整数是一个整数，例如 987 或 5。
    • 数字：数字包括任何数值，包括小数。
    • 细绳：这是一个标准文本字符串或一系列自定义的字母、数字和符号字符。
  • 平台数据类型
    • 队列：队列是交互的等待线。在 Architect 中，队列表达式将工作项路由到合格的队列。队列由 Genesys Cloud 管理员建立和配置。

姓名 描述
输出失敗

当“调用决策表”操作采取失败路径时，这些输出允许流程作者映射任何产生的 errorType 和 errorMessage 变量的结果。故障输出可帮助您预测潜在问题并有效地管理它们，从而提高流程的弹性。

  • 错误类型： 包含错误类型或类别的非空字符串。
  • 错误消息 未本地化的失败消息。 字符串可以为空或 NOT_SET。

注意： 将鼠标悬停在信息图标上旁边错误类型显示允许的 errorType 值的列表。

选择要分配给“呼叫决策表”操作返回的失败数据值的变量。

您可以使用以下 errorType 值：

  • ActionInvocationLimitExceeded:如果流程已成功运行“调用决策表”操作五次，则该操作的任何后续调用都会走失败路径。
  • 执行超出容量错误：当流程执行新发布或很少使用的决策表时，Genesys Cloud 首先准备决策表并对其进行优化以供使用。虽然这个准备过程通常非常快，但在此阶段发出的执行请求可能会偶尔出现错误。在正常生产负载期间通常不会发生该错误。
    如果发生此错误，流程必须重新尝试执行。建议您配置足够的重试次数来处理它。决策表准备好后，Architect 可以毫无问题地执行它。
  • 常规执行错误：执行期间发生一般错误。 
  • 无效请求：该请求的格式不正确，无法执行。例如，发生 HTTP 400 错误。

注意：单击 失败输出旁边的箭头 ，然后展开或折叠变量列表。

小路 描述
成功

完成的成功路径表示系统在此过程中没有遇到错误。 它不是衡量系统是否接收的数据是预期结果或功能的度量标准。
失败

此路径表示尝试完成操作时出现错误，或者处理“调用决策表”操作的结果时出现问题。将适当的操作拖到失败路径下方。