关键字

本帮助页面上的信息同时适用于 CXone Studio 和 Desktop Studio。

关键字或命令是 Snippet 语言中语句语法的一部分。它们是为脚本中的特定用途而预定义的术语。编译器识别关键字并执行与其关联的行为。例如，当编译器看到 ASSIGN 关键字时，就会以关键字后指定的名称和值创建一个新变量。例如：ASSIGN varName = 1

由于关键字是保留术语，因此不得在脚本中用作对象或变量的标识符。

许多关键字也具有相同名称的 Studio 操作关闭 在 Studio 脚本中执行一个过程，如收集客户数据、播放消息或音乐或将联系人转接给坐席。。例如，有一个 IF 关键字和 IF 操作。两者在脚本中实现相同的行为。您可以将 Snippet 操作与自定义代码结合使用，以减少脚本中的操作数量。

Snippet 中的关键字

Snippet 支持以下关键字。每个关键字都有特定用途。关键字执行的行为类型有多个类别。下文将详细介绍每个关键字。

声明关键字

使用这些关键字，可以声明或创建新变量、对象和函数。

  • ASSIGN：此语句会创建一个变量并为其赋值。
  • DYNAMIC：此语句会创建一个动态数据对象。
  • FUNCTION：此语句会创建一个自定义函数。

选择关键字

使用这些关键字，脚本可以根据您指定的条件选择要执行的语句。您可以使用它们来控制脚本中的线性流程。

  • IF：此语句根据布尔表达式的值选择要执行的语句。
  • SELECT：此语句会执行一系列 CASE 语句中求值为 true 的第一条语句。
  • SWITCH：此语句将变量值与定义的 CASE 语句进行比较。它执行与之匹配的 CASE。

以下关键字从不单独使用。它们总是与选择关键字一起使用。

  • ELSE：此语句定义了布尔表达式求值为 false 时脚本要执行的操作。与 IF 一起使用。
  • CASE：此语句定义了一组可能执行的语句之一。与 SWITCH 或 SELECT 一起使用。
  • DEFAULT：此语句定义了在其他情况都无法执行时要执行的语句。与 SWITCH 或 SELECT 一起使用。

循环关键字

循环关键字允许重复执行一条语句或一系列语句，直到满足指定的结束条件。

以下关键字从不单独使用。它是循环语句代码块的可选部分：

BREAK：此语句会终止循环语句。

其他关键字

这些关键字在 Studio 脚本中有非常特殊的应用：

  • RETURN：此语句会结束一个函数。它可以将函数中的值传递到脚本中。
  • USES：此语句可使您包含 Web 服务代理 DLL，以便在代码片段中使用。
  • TRACE：此语句可使您在使用调试器工具时将文本输出到 Snippet editor 窗口的 Trace 面板中。

关键字语法

关键字必须作为该行的第一个单词或命令出现。然后是其他定义关键字作用和作用方式的单词或代码。例如，在创建新变量并为其赋值的 ASSIGN 关键字后，必须跟上新变量的名称和您希望它具有的值：

ASSIGN var1 = "my value"

关键字不区分大小写。例如：对于编译器来说，FOREACH 与 foreach 相同。

有些关键字需要嵌入代码才能使用。有关这些要求的信息，请参阅所用关键字的在线帮助页面。

代码片段编辑器中的关键字

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

  • 文本视图选项卡。这是一个自由格式的文本字段，您可以在其中手动输入代码。
  • 树视图选项卡。这是一个可用于构建代码的图形界面。此选项卡有一个列表，您可以从中选择关键字以将语句添加到代码片段。