SNIPPET

本帮助页面适用于 CXone Studio此信息也可用于Desktop Studio

允许您向脚本中添加自定义代码。

依赖关系

  • 此操作中使用的代码必须使用 Snippet 编写,这是一种由 NICE CXone 开发的内部脚本语言。Studio 技术参考指南提供了有关在代码片段中编写脚本的详细信息。
  • 动态数据对象的属性不得命名为 __type (带两个下划线)。这个词是在从动态对象解析 JSON 时保留的。
  • 您可以使用Snippet操作进行 API 调用。最大响应大小为 32 KB。这与 REST API 操作中的响应大小限制一致。严格执行该限制是为了防止群集不稳定和中断。如果可以,请改用 REST API 操作。它具有相同的限制,但可以处理更繁重的负载。如果您必须使用 SNIPPET 操作,请按照以下提示减小返回数据的大小:
    • 筛选 API 响应中的数据。例如,如果使用 NICE 报告 API 获取联系人,则可以按联系人的 startDateendDate 筛选结果。此 API 调用还允许返回并限制最大项目数。请参阅脚本集成随附的 API 文档,以确定可以使用的筛选。

    • 更新 API 请求,仅返回需要的数据。例如,如果使用 NICE 报告 API 获取联系人,则可以使用 contactIdagentId 字段仅返回相关数据。请参阅脚本集成随附的 API 文档,以确定可以使用的数据限制。

    • 如果无法执行上述任一选项,请构建中间件。

支持的脚本类型

其中一条分支线通向其他三个正方形的正方形。

通用

Email 聊天 电话 语音信箱 工作项目 短信 数字

输入属性

这些属性定义操作在执行时使用的数据。

属性

说明

添加 说明文字

输入在脚本中唯一标识此操作的短语。标题显示在脚本画布上的操作图标下方。

Data

包含在 Snippet editor 窗口中添加的自定义代码。其中可以包括多条 ASSIGNDYNAMIC 命令、各种流量控制语句以及内置和用户定义的函数

Max String Size

设置 Data 属性中所有命令的最大字符串大小。选项包括:Limit2KLimit4KLimit8KLimit16KLimit32K。此限制适用于 Rest API 和 SOAP 的集成响应。

结果分支条件

结果分支条件允许您在脚本中创建分支,以在执行操作时处理不同的结果。

条件

说明

Default

除了脚本满足条件要求其接受其他分支的情况之外,所要采用的路径。如果未定义操作的其他分支,也会执行此操作。

错误

操作无法正确执行时所采用的路径。例如,出现连接不良、语法错误等意外问题时。_ERR 变量以单个下划线字符填充,应包含对问题的简要解释。

提示和技巧

Snippet Editor 窗口

选择 Snippet 操作并单击该操作属性中的打开编辑器后,Snippet editor 窗口就会打开。

脚本示例

这是一个示例,说明如何在脚本中使用此操作。它并不是一个完整的脚本。可能还需要编写其他脚本。

在此简单示例中,Snippet 中的代码用于测试是否可以使用来自第三方系统的信息创建潜在客户。

具有两个 SNIPPET 操作的脚本。

下载此脚本。