声明

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

语句定义脚本执行时的操作。这包括创建变量、分配新值、执行计算以及根据给定条件做出逻辑选择。有些语句只执行一项任务，如为变量赋值。其他语句则会影响脚本的流程。语句按逻辑顺序执行，但每次运行脚本时，顺序都可能发生变化。

代码片段中的语句由一行或多行代码组成。简单的一行语句可能会创建一个变量并为其赋值，如下所示：

ASSIGN firstName = "Beowulf"

复杂的语句可能有许多嵌套的行组，如下所示：

ASSIGN Names="Odin|Freya|Thor|Loki" ASSIGN SubCounter=1 FOREACH Name IN Names { IF Name = "Odin" | Name = "Freya" { ASSIGN NewNames[SubCounter]= "{Name}" ASSIGN SubCounter=SubCounter + 1 } }

如果代码片段中存在错误，则可以更改此代码片段中语句执行的逻辑顺序。当发生错误时，Snippet 操作立即终止。代码片段中的其余语句不会执行。而错误消息会保存在 _ERR 变量中，指示问题所在。

语句类型

您可以在代码片段中使用以下类型的语句：

  • 声明：使用声明语句声明或创建新变量、对象和函数。
  • 决策：使用决策语句可让代码片段根据您指定的条件选择要执行的任务。您可以使用它们来控制脚本中发生的事情的线性流程。
  • 循环：使用循环语句可让代码片段重复执行一项或一组任务，直到满足指定的结束条件。
  • 其他：这些语句允许您终止函数，在调试期间在 Snippet editor 窗口中显示结果，以及在代码片段中包含网络服务代理 DLL。

关键字

关键字是开始语句的命令。它们是预定义的保留术语。编译器识别关键字，然后执行与其关联的任务。

您能够在代码片段中使用的每种语句都有一个与其关联的关键字。例如，要声明变量，您可以使用 ASSIGN 关键字。或者，要生成选择语句，您可以使用 IF 关键字。该语句和关键字具有相同的名称，因此 IF 语句使用 IF 关键字。

描述了 Snippet 语言中可用的关键字以及与每个关键字相关的语句。此外还提供了完整的关键字列表。

语句语法

所有语句都以关键字开头，后面为定义语句功能的单词或代码。每个语句都有自己的语法。本页的语法摘要部分描述了如何阅读语句语法。

有些语句需要条件代码。此代码设置条件并定义满足或不满足条件时发生的情况。条件代码可以是单个语句，也可以是多个语句。它必须始终用大括号 ({ }) 括起来，即使它是单行也是如此。条件代码有时称为块。

当编译器遇到新行或左花括号时，它会识别出语句的结束。大括号的放置有些灵活。以下格式均有效：


IF x=1 {TRACE "one" } 

IF x=1 {TRACE "one" } IF x=2 {TRACE "two" }
IF x=1 {
  TRACE "one"
}


IF x=1
{
  TRACE "one"
}

当嵌入的代码需要多个语句时，请遵循以下规则：

  • 每行放置一个语句。
  • 如果需要多个语句，请将它们放在不同的行上。这会使阅读代码变得更加容易。
  • 需要自身嵌入代码的嵌入语句可以占用多行，其遵循使用大括号的有效格式。

语法摘要

在涵盖每种语句类型的在线帮助页面中，每种语句类型都有一个语法摘要。该摘要向您显示了此类语句所使用的格式。它向您显示哪些元素是必需的，哪些元素是可选的。它还展示了必须如何嵌套语法元素。

下表定义了语法摘要中的每个元素。并非所有语句都包含每个元素。解读语法摘要时，请密切注意元素的嵌套。

元素

详细信息
COMMAND

这是在该语句中使用的关键字的名称。将 COMMAND 替换为用于您正在创建的语句的关键字。

关键字不区分大小写。例如：对于编译器来说，FOREACH 与 foreach 相同。但是，在下次打开此代码片段时，Snippet 操作会自动将所有关键字转换为大写。

在该在线帮助中，关键字始终采用大写字母格式。
<required>

尖括号表示必要元素。括号内的文本指示元素的类型，例如表达式、变量或文字值。

例如，在 FOREACH 语句语法摘要中，有两个必要元素：

FOREACH <var> in <array> { ... [ BREAK]}

在脚本中永远不要以文字方式使用尖括号以及其中的文本。将该部分替换为其描述的代码元素。例如，将 <expression> 替换为 i = 0 等表达式。
[optional]

方括号表示可选元素。括号内的文本指示您可以使用的元素类型。例如，在 IF 语法摘要中，可选的 ELSE 子句括在方括号中：[ELSE { ... }。

如果使用可选元素，它必须显示在语法摘要中指示的相对于其他元素的位置。

在脚本中永远不要按字面意思使用方括号。
{ ... } 大括号表示可以使用代码块。

大括号与语法摘要中使用的尖括号和方括号不同。尖括号和方括号不应包含在代码中，但大括号必须以文字方式包含在代码中。但是，您应将语法摘要中的大括号内的省略号 (...) 替换为 Snippet 语句。
竖线 ( | )

竖线字符表示在哪里您可以选择在语句包含中的内容。例如，在 ASSIGN 语句的语法摘要中，竖线字符表示您可以选择用双引号将该值引起来：

ASSIGN <variable> = "<value>" | <value>

该语法的解释说明了该选择。
省略号 (...)

省略号表示以下两件事之一：

  • 代码在块中的位置（如果发现其位于大括号之间）。
  • 连续模式（如果发现其位于带有关键字的方括号之间）。

在 SELECT 语法摘要中可以找到用于指示连续模式的省略号示例：

SELECT <{ CASE <expression> [{ ... }] [CASE <expression> <{ ... }>] [CASE ...] [DEFAULT <{ ... }>] }>

[CASE ...] 表示您可以按照既定模式继续添加所需数量的 CASE 子句。

例如，此页面上使用的 IF 语句的语法摘要为：

IF <expression> <{ ... }>

此摘要表明：

  • 关键字是 IF。
  • 下一个元素是必要的表达式。
  • 最后一个元素是必要的代码块，必须用大括号括起来。

SWITCH 语句的语法摘要更加复杂：

SWITCH <var> <{CASE <literal> [{ ... }] [CASE <literal> [{ ... }]] [CASE ...] [DEFAULT [{ ... }]] }>

此摘要表明：

  • 关键字是 SWITCH。
  • 下一个元素是必要的变量名称。
  • 该代码块是必需的，并且必须包含带有文字值的 CASE 子句。
  • 必要的 CASE 子句可以包含可选的代码块。
  • SWITCH 语句的代码块可以包含遵循该摘要中建立的模式的附加可选 CASE 子句。
  • SWITCH 语句的代码块可以包含带有可选代码块的可选 DEFAULT 子句。