参数编辑器

使用参数编辑器可以创建规则参数，可以在规则条件和操作中选择使用这些参数。

Important

在版本 9.0.0 中，不支持将参数映射到事实模型。

在详细信息部分中，每个参数包含相同的字段：

名称—参数的名称 说明—参数的简要说明。 类型—参数类型。有关类型的详细信息，请参阅以下主题。

参数名称

构建规则模板时，参数名称中的下划线 (_) 字符具有特殊含义。在规则表达式需要参数的其他实例的情况下，它用于指定参数的索引。最常见的示例是范围定义。

例如，假设您需要创建一个条件，必须检查任务的到期日期是在 date1 到 date2 范围内，还是在 date3 到 date4 范围内。您可以创建一个条件，例如：

Due is in "{dueDT1}" to "{dueDT2}" or in "{dueDT3}"  to "{dueDT4}")

但这需要在参数部分中定义 4 个类型为 InputDate 的参数。这种方法可能会变得效率低下，尤其是如果条件/操作的发生不止一次。

更好的解决方案是使用下划线和索引方法：

Due is in "{dueDT_1}" to "{dueDT_2}" or in "{dueDT_3}" to "{dueDT_4}"

使用这种方法，您只需要指定一个参数，名称为 dueDT 且类型为 InputDate。

参数类别

配置部分包含取决于参数类型的信息。从下拉列表中选择一种类型后，将显示与该类型相关的不同字段。

参数主要有八个类别：

• 字符串
• 整数
• 数值型
• 日期
• 时间
• 布尔型
• 日历
• Configuration Server

输入值

布尔型、整数、数值型、字符串、日期和时间只是简单参数，规则作者可以基于定义的参数类型为其提供值。这些参数也可以有限制。例如，可以将整数值限制在定义的范围内。

匹配模式

对于类型为字符串的输入值参数，可以输入一个必须遵循的匹配模式。输入 Javascript 正则表达式以定义匹配模式。例如，邮政编码参数可能具有匹配模式：

>^\d{5}$|^\d{5}-\d{4}$ 

这代表一个 5 位数的邮政编码。电话号码参数可能具有匹配模式：

^\(?(\d{3})\)?[- ]?(\d{3})[- ]?(\d{4})$

这代表格式为 (xxx)-xxx-xxxx 的 10 位数电话号码。

自定义工具提示

使用自定义工具提示可以在定义所有“输入值”参数时输入有用的工具提示文本（布尔型参数类型除外，该参数不需要工具提示）。如果您选中使用自定义工具提示，则在规则条件或操作中使用此参数时，您在工具提示字段中输入的文本将显示在 GRAT 中。如果您未选中使用自定义工具提示，则 GRAT 会显示自动生成的工具提示；例如，{age} 是 1 和 99 之间的整数。

支持的正则表达式模式应符合浏览器的 Javascript 引擎，可能会因浏览器版本而略有不同。

日历

日历参数向 GRAT 指示它应显示与正在编辑的规则包关联的业务日历下拉列表。然后，规则作者可以选择其中一个日历。

示例： 可以在规则中使用日历参数来动态分配日历，如下所示：

Assign business calendar "{businessCalendar}"

定义日历参数时，模板设计者只需提供参数名称并选择日历类型。不需要其他配置。

Configuration Server

通过 Configuration Server 参数，规则作者可以从值的下拉列表中选择单个值。例如，可以将 Configuration Server 参数配置为从 Configuration Server 数据库中提取座席组列表。将从 Configuration Server 填充列表。Configuration Server 参数要求您选择对象类型：

• 座席
• 座席组
• 座席技能
• 业务属性
• 业务上下文
• 分机
• 外部路由点
• 交互队列
• 媒体类型
• 位置
• 位置组
• 路由点
• 交换机
• T-Server
• 虚拟路由点

选择业务属性会提示您从 Configuration Manager 中定义的列表中选择业务属性的名称。

选择业务上下文会提示您输入与此参数有关的业务上下文级别。在此，业务上下文是指 Configuration Server 中业务结构文件夹下的层次结构级别。

数据库

通过数据库参数，规则作者可以从值的下拉列表中选择单个值。例如，可以将数据库参数配置为从数据库中提取订单类型列表。该列表由数据库查询填充。数据库参数需要配置文件名称（包含数据库连接信息的 Configuration Server 脚本对象的名称）、查询类型（单值或列表，取决于要在 GRAT 中显示的内容）以及要执行的 SQL 查询。

注意：规则作者登录 GRAT 时将获取值列表。如果用户登录 GRAT 后从外部系统更新了任何值，则用户必须单击“注销”按钮，然后再次登录以查看任何更改。

示例

若要使用数据库参数，必须先在 Configuration Server 中为租户配置了参数配置文件。这是一个脚本对象，用于指定 JDBC 驱动程序以及执行查询所需的数据库 URL、用户名和密码。请参考 Genesys Rules System Deployment Guide，以了解配置这些配置文件的信息。此脚本对象的名称用作数据库参数的配置文件名称。

要从数据库获取值，必须指定有效的 SQL Select 语句。例如，要获取列的所有值，请使用以下形式的 select 语句：

SELECT column_name FROM table_name

对于动态数据库参数，可以配置参数以从两个不同的数据库列中检索名称（规则评估请求中包含的内部值）和标签（在编写使用此参数的规则时显示给规则作者的信息）。

数据库配置文件参数属性

属性	强制性/可选	说明
驱动程序	强制性	将要使用的 jdbc 驱动程序名称。例如，com.mysql.jdbc.Driver
url	强制性	数据库的 URL，采用适用于要使用的 jdbc 驱动程序的正确格式。
用户名	强制性	连接到数据库的有效用户名。
密码	强制性	用户连接到数据库所需的密码。
初始尺寸	可选	连接池的初始尺寸。默认值为 5。
最大尺寸	可选	连接池的最大尺寸。默认值为 30。
等待时间	可选	等待获得连接的最长时间（以毫秒为单位）。默认值为 5000。

通常，不需要设置或更改可选值。

在模板开发中，您只能使用 SQL SELECT 语句配置数据库参数。配置后，任何其他类型的语句都将失败。

运行

操作参数由用户通过 Genesys Administrator Extension 创建，并在部署后作为列表类型的事务对象的选项存储在 Genesys Configuration Server 数据库中。在规则执行时，规则引擎评估包含操作参数的规则时，会从 Configuration Server 获取关联的事务对象选项的当前值。规则开发人员确定从哪个事务对象以及该对象的哪个选项中提取操作参数的值，然后规则作者将此参数用作条件或操作的一部分。

示例 可以定义称为 waitTimeThreshold 的操作参数。如果呼叫者等待座席的时间超过此阈值，则可以执行某些其他操作。

并非像下面这样在规则中为阈值指定值：

When 

Caller’s wait time is greater than 30 seconds 

Then 

Offer a callback

而是规则作者可以指定：

When 

Caller’s wait time is greater than {waitTimeThreshold} 

Then

Offer a callback

用户可以使用 Genesys Administrator Extension 随时更改 {waitTimeThreshold} 的值，该值将立即生效，而无需修改和重新部署规则包。

例如，在定义映射时使用以下条件：

Queue(waitTime >  {waitTimeThreshold} )

要配置操作参数，您需要两个 ID：

• 列表 ID，与存储操作参数的事务对象名称相对应
• 参数 ID，与该事务对象的选项名称相对应。

该选项值包含操作参数的实际值，该参数在评估规则时由规则引擎检索。操作参数始终存储为列表类型的事务对象，但是该列表对象中选项的精确配置取决于操作参数的配置方式。

Warning

在配置“操作参数”时，请勿在语言表达式或规则语言映射中将变量用双引号或单引号引起来。例如，使用操作参数 {opParmEwtThreshold} 的条件应配置如下：

• 语言表达式—估计的等待时间大于 {opParmEwtThreshold}
• 规则语言映射—CallInfo ( ewt > Integer.parseInt({opParmEwtThreshold}))

请注意，{opParmEwtThreshold} 周围没有单引号或双引号

有关其他示例，请参阅 GRAT 随附的“操作参数”示例模板和规则包（在 examples 文件夹中）。

请参考 Genesys Administrator Extension 帮助，以了解有关操作参数的常规信息。

选择枚举

选择枚举参数与枚举链接。这为规则作者提供了一个可供选择的特定列表。

Web 服务

通过 Web 服务参数，规则作者可以从值的下拉列表中选择单个值。例如，可以将 Web 服务参数配置为从外部 Web 服务中提取股票代码列表。该列表由 Web 服务查询填充。Web 服务参数需要配置文件名称（包含 Web 服务连接信息的 Configuration Server脚 本对象的名称）、查询类型（单值或列表）以及要执行的 XPath 查询。另外，Web 服务参数要求输入一些协议设置，特别是 HTTP 方法、路径和消息正文。

注意：规则作者登录 GRAT 时将获取值列表。如果用户登录 GRAT 后从外部系统更新了任何值，则用户必须单击“注销”按钮，然后再次登录以查看任何更改。

示例

与数据库参数类似，还必须先创建好参数配置文件。此配置文件将包含诸如服务器的地址（主机和端口）、服务路径以及任何其他必要的 HTTP 设置之类的信息。请参考 Genesys Rules System Deployment Guide，以了解配置这些配置文件的信息。

要从服务获取值，必须为服务指定有效的消息。该消息必须是恒定不变的。换句话说，不会发生任何变量替换。

注意：无法为 HTTP GET 请求发送消息。请求中的所有信息都是通过查询字符串和/或标题提供的。

例如，要获取旧金山的天气预报，可以对 Weather Underground REST 服务进行以下请求：

http://api.wunderground.com/auto/wui/geo/ForecastXML/index.xml?query=94129

但是，这是完整的请求。必须在配置文件中指定主机 (api.wunderground.com) 和基本路径 (/auto/wui/geo/ForecastXML/)。

要定义参数以发出此请求，配置文件名称必须引用上述正确的信息。另外，协议设置必须指定 GET 作为方法，以及 index.xml?query=94129 作为路径。此请求不需要任何消息。

要从结果中获取值，必须指定有效的 XPath 表达式。Web 服务必须以 XML 或 JSON 返回结果。有关 XPath 表达式的详细信息，请参阅 XPath 规范。

例如，为了从先前描述的请求中获得预测高点，可以使用以下 XPath 表达式：

//high/fahrenheit/text()

在 Configuration Server 中，Web 服务脚本必须有一个名为 webservice 的部分。下表列出了可以为 Web 服务参数指定的属性。

Web 服务配置文件参数属性

属性	强制性/可选	说明
主机	强制性	服务的主机。
基本路径	强制性	访问服务的基本路径。
协议	可选	默认值为 http。
端口	可选	默认值为 80。
标头	可选	服务所需的任何自定义 HTTP 标头。
参数	可选	调整连接所需的任何自定义 HTTP 设置。

通常，不需要设置或更改参数值。标头和参数按照以下格式列出：

key:value[,key:value]

您不能指定值中包含","的标题或参数。如果您要向服务发送消息，则应该在标头中指定 Content-Type，因为它定义了与服务器的整体消息交互。可以包括一个可选的字符集。例如，Content-Type:applicaton/json;charset=UTF-8。

Important

在模板开发中，您必须完全定义要发送的消息，并且消息必须恒定不变。没有变量替换。XPath 查询用于将值从服务器的响应中拉出。响应必须采用 XML 或 JSON 格式，否则将无法正常工作。必须为响应指定有效的 XPath 查询。这完全取决于您与之交互的服务。

Important

该消息在每个会话中仅发送到服务器一次。这样做是出于性能原因，而且响应中的值预计是相对恒定的。

在模板开发中，参数的路径已添加到脚本中的 base_path 中。例如，如果脚本包含：

host = api.wunderground.com 
base_path = /auto/wui/geo/ForecastXML/

并且 GRDT 指定：

query type = List
XPath Query = //high/fahrenheit/text()
HTTP Method = GET
path = index.xml?query=66062
message (not set)

则发送的消息是：

GET /auto/wui/geo/ForecastXML/index.xml?query=66062 HTTP/1.1

这将返回本周华氏高点：

81
77
81
81
83
85

Workforce Management

使用 Workforce Management (WFM) 参数，规则作者可以从活动（代表可以联系座席的联络中心任务的 WFM 数据库对象）和多站点活动（在多个物理站点执行的活动集合）的下拉列表中选择一个值，该值从 Genesys Workforce Management Server 中动态检索。Workforce Management 参数需要 WFM 配置文件（数据收集类型的 Configuration Server 脚本对象）。

Important

规则作者登录 GRAT 时将获取值列表。如果用户登录 GRAT 后从外部系统更新了任何值，则用户必须单击“注销”按钮，然后再次登录以查看任何更改。

示例

活动是构建预测和计划时使用的主要计划对象。活动可以与单个 WFM 站点对象相关联，也可以在 WFM 业务部门级别创建多站点活动，这样可汇总来自多个 WFM 站点的多个“子”活动信息。因此，在为规则作者提供从 WFM Server 动态获取的 WFM 活动列表时，WFM 活动或多站点活动的名称分别以 WFM 站点或 WFM 业务单位的名称为前缀。

例如，如果 WFM 配置具有以下结构：

名称为‘ACME’的业务单元

• 站点名称为‘旧金山’
• 活动名称为‘争议’
• 活动名称为‘帐单查询’
• 站点名称为‘芝加哥’
• 活动名称为‘争议’
• 活动名称为‘地址更改’
• 多站点活动名称为‘开票’（由旧金山站点的‘帐单查询’和芝加哥站点的‘地址更改’组成）
• 多站点活动名称为‘争议’（由旧金山站点的‘争议’和芝加哥站点的‘争议’组成）

在规则中使用规则操作“分配 WFM 活动”时，规则作者将在下拉列表中看到以下项目：

业务单元ACME:开票 业务单元ACME:争议 站点芝加哥:地址更改 站点芝加哥:争议 站点旧金山：帐单查询 站点旧金山：争议

Important

业务单位和站点的名称分别以‘业务单元’和‘站点’为前缀，以帮助规则作者理解上下文。

在 Configuration Server 中，Workforce Management 脚本必须有一个名为 wfm 的部分。下表列出了可以为 Workforce Management 参数指定的属性。

Workforce Management 配置文件参数属性

属性	强制性/可选	说明
wfmCfgServerApplName	强制性	WFM 服务器的 Configuration Server 应用程序名称。
wfmCfgServerUserName	强制性	Configuration Server 用户名。
wfmCfgServerPassword	强制性	Configuration Server 密码。
wfmServerUrl	强制性	WFM Server 的 URL。

在模板开发中配置“Workforce Management”类型的新参数时，只需命名该参数，然后从下拉列表中选择 WFM 配置文件（刚创建的脚本对象）。当作者使用此参数时，GRAT 将从 WFM Server 获取 WFM 活动的当前列表，并将向规则作者显示。