提示和表达式

介绍

配置不同的组件时，会发现所有这些组件之间共享一些功能。例如，提示播放，菜单，用户输入和记录组件，它们都使用一系列提示来定义播放给呼叫者的音频文件。配置任何这些组件时，可以使用提示集合编辑器来定义它们。

以相同的方式，当必须使用表达式设置组件属性时，可以使用表达式编辑器轻松创建此表达式。

提示类型

如前所述，许多CFD组件使用提示来执行所需的操作。当组件具有提示集合时，每个提示可以是以下类型之一：

音频文件：提示存储在wav文件中，文件名从文件列表中选择，或者您可以浏览在文件系统中查找。
动态音频文件：提示存储在wav文件中，但使用表达式动态创建文件名。
录制音频：提示存储为AudioId变量，其中包含以前从调用者录制的音频。

当使用动态音频文件提示时，创建文件名的表达式必须返回一个包含相对于项目音频文件夹的文件路径或文件的绝对路径的字符串。如果音频文件位于您的项目Audio文件夹中，那么您只需要通过其名称引用它，则不需要特殊的路径信息。项目音频文件夹是：

Windows：“C：\ ProgramData \ 3CX \ Instance1 \ Data \ Voiceapps \ PROJECT_NAME \ Audio”

Linux：“/ var / lib / 3cxpbx / Instance1 / Data / Voiceapps / PROJECT_NAME / Audio”

提示集合编辑器

提示集合编辑器允许您编辑要由特定目的的组件播放的提示。

在这里，您可以添加任何3种不同的提示类型，根据所选类型，您将需要使用表达式配置每个提示，或从列表或文件系统中选择wav文件。您还可以更改文件的顺序，向上或向下移动它们。

表达式编辑器

必须使用表达式设置许多组件属性。在这种情况下，当从配置对话框配置组件时，您将看到文本框右侧的按钮：

单击该按钮打开表达式编辑器。

表达式可以是常量字符串，C＃表达式，变量或内置函数。在CFD表达式中使用的可用内置函数的列表如下：

AND：在每个参数之间执行逻辑AND，返回一个布尔值作为结果。可以有2到20个参数。
OR：在每个参数之间执行逻辑或运算，结果返回一个布尔值。可以有2到20个参数。
NOT：接收一个单一的布尔参数，并返回另一个布尔值，这是所提供参数的否定。EQUAL：接收任何类型的两个参数，并返回一个布尔值，表示它们是否相等。
NOT_EQUAL：接收任何类型的两个参数，并返回一个布尔值，表示它们是否不相等。
GREAT_THAN：接收任何类型的两个参数，并返回一个布尔值，表示第一个是否大于第二个。
GREAT_THAN_OR_EQUAL：接收任何类型的两个参数，并返回一个布尔值，表示第一个是否大于或等于第二个。
LESS_THAN：接收任何类型的两个参数，并返回一个布尔值，表示第一个是否小于第二个。
LESS_THAN_OR_EQUAL：接收任何类型的两个参数，并返回一个布尔值，指示第一个是否小于或等于第二个。
CONCATENATE：连接每个字符串参数并返回生成的字符串。可以有2到20个参数。
TRIM：接收一个字符串并返回相同的字符串，去除前导和尾随的不可见字符（空格，新行等）
左：接收两个参数。第一个是要剪切的字符串。第二个是要剪切的字符数。返回一个字符串，它是原始字符串的前N个字符。
MID：接收三个参数。第一个是要剪切的字符串。第二个是切割必须开始的起始位置，使用基于零的索引。第三是要剪切的字符数。返回一个字符串，它是原始字符串的指定子字符串。
右：接收两个参数。第一个是要剪切的字符串。第二个是要剪切的字符数。返回一个字符串，它是原始字符串的最后N个字符。
REPLACE：接收三个参数。第一个是必须更换的字符串。第二个是找到的文本来替换。第三个是替换的文本。返回指定替换字符串。
REPLACE_REG_EXP：接收三个参数。第一个是必须更换的字符串。第二个是用于查找文本的正则表达式来替换。第三个是替换的文本。返回指定替换字符串。
UPPER：接收单个字符串参数，并返回另一个字符串，它是大写字母的原始字符串。
LOWER：接收单个字符串参数，并返回另一个字符串，该字符串是小写字母的原始字符串。
NOW：不接收任何参数，并将当前日期和时间作为DateTime对象返回。
LEN：接收单个字符串参数并返回其长度作为数字。
SUM：求和每个数值参数并返回结果。可以有2到20个参数。
NEGATIVE：返回接收到的单个数字参数的负数。
MULTIPLY：乘以每个数值参数并返回结果。可以有2到20个参数。
DIVIDE：接收两个数值参数，返回“first / second”。
ABS：返回接收到的单个数字参数的绝对正数。
GET_TABLE_ROW_COUNT：返回接收到的表的行数。该表是数据库查询的结果。
GET_TABLE_CELL_VALUE：接收三个参数。第一个是包含表的变量（数据库查询的结果）。第二个是使用基于零的索引的行标识符。第三个是使用基于零的索引的列标识符。从指定的表，在指定的行和列返回单元格的值。