SNIPPET

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

Dependencies

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


通用	电子邮件	聊天	电话	语音信箱	工作项目	短信	数字

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

属性	说明
Caption	输入在脚本中唯一标识此操作的短语。标题显示在脚本画布上的操作图标下方。The default is the action name.
Data	包含在 Snippet Editor 窗口中添加的自定义代码。其中可以包括多条 ASSIGN 和 DYNAMIC 命令、各种流量控制语句以及内置和用户定义的函数。
MaxStringSize	设置 Data 属性中所有命令的最大字符串大小。选项包括：Limit2K、Limit4K、Limit8K、Limit16K、Limit32K。此限制适用于 Rest API 和 SOAP 的集成响应。

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

条件	说明
Default	除了脚本满足条件要求其接受其他分支的情况之外，所要采用的路径。如果未定义操作的其他分支，也会执行此操作。
OnError	操作无法正确执行时所采用的路径。例如，出现连接不良、语法错误等意外问题时。_ERR 变量以单个下划线字符填充，应包含对问题的简要解释。

在 Snippet 操作中使用 asjson() 函数，并将结果 JSON 存储在字符串变量中。当您需要传递 JSON 数据时，在其他 Studio 操作的属性中使用字符串变量。这种方法可避免保存脚本时出现验证错误的可能性。
如果您正在调整支持 ASR 允许联系人通过说话、按手机按键或两者的结合来响应录制的语音提示。的 IVR 自动电话菜单，允许呼叫者通过语音命令、按键输入或两者进行交互，以获得信息、路由呼入的语音呼叫或两者。系统，则可以在代码段中使用一组参数。
代码段语言提供关键字命令，允许您声明变量和对象、创建循环和迭代语句等。
Studio 具有内置的函数，可以在脚本中使用。
您可以创建自己的自定义函数以在代码段中使用。
您可以在 Snippet Editor 窗口中测试和调试代码片段。

The Snippet Editor window opens when you double-click on a Snippet action.

Snippet Editor操作中的窗口Snippet有两个选项卡。这两个选项卡都允许您创建相同类型的代码。您可以在选项卡之间来回切换并在任一位置编辑代码。这些选项卡分别是：

此示例并非完整的脚本。要使用此操作，需要额外的脚本编写工作。

In this simple example, the code in the Snippet is used to test whether a prospect can be created using information from a third-party system.

A script with two SNIPPET actions.