Работа с графическим редактором сценариев

Общая логика обработки сценариев Аксател

В Аксател реализовано два типа сценариев:
IVR сценарии - сценарии, участвующие в SIP диалогах и являющиеся одной из сторон разговора

SVC сценарии - сервисные сценарии, выполняющие определённые действия и запускаемые по расписанию или по событиям.
Все сценарии выполняются обработчиком, который является интерпретатором визуального кода в исполняемые действия. Каждый запуск сценария создает новый исполняемый экземпляр со своим идентификатором.
Сценарий состоит из компонентов. Обработчик сценариев включает в себя алгоритмы реализации функциональности компонентов.
Процесс работы обработчика сценария можно представить в следующей последовательности действий:
1.          загружает сценарий,
2.          создает области данных для хранения объявленных переменных,
3.          отыскивает в сценарии компонент Старт с типом основной ветки,
4.          сопоставляет с компонентом алгоритм его работы,
5.          передает управление алгоритму компонента, передавая на вход параметры для компонента из сценария и накопленный контекст,
6.          направляет полученные во время работы компонента события в его очередь обработки и передает ему управление на обработку этой очереди,
7.          обрабатывает ответ компонента:
     a.           продолжение работы компонента;
     b.          откладывание обработки очередного события;
     c.           завершение работы компонента. По завершении работы компонента тот возвращает:
          i.            идентификатор следующего компонента, тогда процесс повторяется с новым          компонентом начиная с этапа его поиска в сценарии, расширяясь накопленным контекстом;
          ii.          код следующего сценария (при необходимости запустить вложенный / асинхронный сценарий);
         iii.        ошибка, тогда сценарий завершается и, возможно, производится запуск ветки пост-обработки;
         iv.        команда возврата к предыдущему сценарию, тогда восстанавливается контекст предыдущего сценария и позиция в нем;
         v.           команда остановки, тогда сценарий завершается, и, возможно, производится запуск ветки пост-обработки;
Выполнение компонента может протекать синхронно и асинхронно.
В любой момент времени обработчик может получить извне команду на завершение. В этом случае выполнение основной ветки сценария прерывается и при наличии соответствующей ветки пост-обработки управление передается на нее.
Компонент при завершении работы на основании полученного результата выбирает для передачи управления ту или иную ветку перехода. Большинство компонентов разделяют успешные и неуспешные результаты работы, сопоставляя им различные ветки перехода. Если ветка перехода не задана, то переход осуществляется по основной ветке (переход по-умолчанию). Если переход по-умолчанию не задан, то происходит остановка выполнения сценария с ошибкой "Нет перехода" и возможный запуск пост-обработки.
Возможные варианты пост обработки определены в компоненте Старт. Выполнение ветки пост-обработки при завершении уже не предполагает переключения на другую ветку.
При запуске сценария на его вход могут передаваться начальные значения
определенные в сценарии в рамках Web интерфейса Администрирования

 передаваемые из родительского сценария дочернему (имеют приоритет над определенными через Гуи-интерфейс)
В компоненте Старт всем объявленным переменным без установленных значений могут быть присвоены дефолтные нулевые значения. Это делается для того, чтобы не вызвать ошибок при работе с переменными без значений.
IVR сценарии
Сценарии голосовой обработки (IVR) используются как виртуальный SIP-телефон. По таблице маршрутизации IVR сценарий обслуживается как Код абонентских функций и может иметь множество номеров.
Каждый сценарий является стороной А или стороной В разговора.
IVR сценарий может быть запущен:
 через таблицу маршрутизации. Выступает в качестве стороны В 
 через Дозвон до абонента. Выступает в качестве стороны А 
 переводом из другого IVR сценария. Обслуживание разговора передается от одного сценария к другому без использования SIP Re-invite или других SIP взаимодействий.
Служебные сценарии
Служебные сценарии - это алгоритмы обработки данных без обязательной привязки в каким либо активностям. Служебные сценарии могут быть запущены следующими способами:
Ручной запуск сценария из part_title

Периодический запуск с помощью служебных задач

Асинхронный запуск из других сценариев

В качестве обработчика сообщений и запросов с внешних каналов

 В качестве контекстного сценария параллельно каждому звонку
Переменные сценариев
Переменные сценария – это области данных, сохраняющие значения для работы компонентов сценариев и взаимодействия сценария с внешней средой.
Переменные объявляются при редактировании сценария. Область данных выделяется только в момент выполнения сценария.
 Переменные могут передаваться между сценариями. Идентификатором переменной служит ее название.
Области видимости
Область видимости
Описание
Локальные
Доступны только конкретному экземпляру сценария. Значения хранятся в его стеке. Передаются вложенным синхронным и асинхронным сценариям.
Сессионные
Доступны внутри всех сценариев сессии. Логика обработки идентична Локальным.
Сценарные
Доступны всем экземплярам конкретного сценария (по коду сценария) в рамках сайта.
Сайтовые доменные
Доступны всем сценариям текущего домена, исполняемым внутри одного сайта.
Сайтовые общие
Доступны всем сценариям всех доменов, исполняемым внутри одного сайта.
Глобальные доменные
Доступны всем сценариям текущего домена, исполняемым на любом сайте, где обслуживается домен.
Глобальные общие
Доступны всем сценариям всех доменов, исполняемым на любом сайте, где обслуживается домен. Использование этой переменной не рекомендуется и дополнительно регламентируется переключателем Разрешить использование глобальной переменной при создании дочернего домена.
При сохранении в переменную, слишком большого значения, оно размещается в файловой системе (категория :SYNC), а вместо переменной автоматически размещается путь к файлу.
Типы значений
Тип значения
Описание
Число
Целое число или число с десятичной точкой.
Строка
Строковое значение. Хранится в виде структуры, содержащей значение и кодировку.
Дата-время
Строковое значение в формате RFC3339.
​
Преобразование значений
В операциях, где важна синхронизация типов значений, значения автоматически преобразовываются из одного типа в другой. В случае возникновения ошибок преобразования поведение зависит от конкретной операции.
Начальные значения
Использование переменных в Выражениях невозможно до присвоения им значений. По-умолчанию все переменные создаются с пустым значением.
Присвоение значений переменным
при старте сценария
–      определенные в сценарии в рамках Web интерфейса Администрирования начальных значений

–     передаваемые из родительского сценария дочернему (имеют приоритет над определенными через Web-интерфейс). Синхронизация по имени переменной
–     в компоненте Старт могут быть присвоены дефолтные нулевые значения (переключатель Инициализировать переменные)
во время работы сценария
–    компонентом Присвоение в режимах одиночного и множественного присвоения
Зарегистрированные локальные переменные при запуске сценария создаются с пустыми значениями. Их использование в выражениях невозможно до присвоения значений.
В компоненте Старт допускается установить режим присвоения начальных значений по умолчанию.
Начальные значения локальных переменных могут быть также установлены при запуске обработчика сценария из настроек сущности конкретного сценария (поле opts.variables), назначены из родительских процессов, скопированы из родительских сценариев и т.д.
Переменные с областью видимости, отличной от локальной, создаются только в момент непосредственного присвоения значений внутри сценария.
Аргументы сценариев
Компоненты сценариев оперируют аргументами. Аргументом сценария называется некий объект, значение которого может быть вычислено в любой момент в ходе выполнения сценария по запросу активного компонента.
Вычисление значения аргумента производится по мере необходимости выполнения компонентов. Результат вычисления подставляется в качестве значения соответствующего свойства компонента.
Типы аргументов
1.          Фиксированное значение (константа);
2.          Переменная;
3.          Выражение (арифметические и строковые операции с переменными, константами и функциями от них).
4.          Шаблон
Типы значений
Значение аргумента может принадлежать к одному из типов:
Число (целое или десятичное);
Строка;
Дата/время.
Приведение типов
При сопоставлении значений аргументов, происходит их приведение к одному типу по следующему правилу:
Если типы значений совпадают, то приведения не производится.

Если оба значения могут быть представлены в виде чисел, производится приведение к числам.

Если оба значения могут не могут быть представлены в виде чисел, то производится приведение к строке.
Выражения сценариев
Выражение – это заданная в компоненте сценария последовательность арифметических или строковых действий, оперирующая константами, переменными и функциями от них. Выражение используется для подстановки в качестве аргумента в значение компонентов сценария.
Результат выражения может иметь тип сроки, числа и даты (в формате RFC3339).
Значения типа bool на выходе автоматически преобразуются к строке true или false. С помощью функции ifelse(bool,any,any) результат можно привести к другим значениям, например числам 0 или 1.
Чтобы в качестве аргумента выражения использовать значение переменной, следует указать ее имя в квадратных скобках, например [var_i].
Для явного указания строки следует заключать текст в кавычки. В противном случае, сначала будут вычислены все арифметические комбинации, доступные для расчета. В приведенных примерах 2.3 и 2.4 результат будет разный (у 2.3 результат начинается с "5", а у 2.4 с "23").
Разбиение на строки производится с помощью функции endline().
Примеры выражений
Примеры числовых выражений
 1.1. [var_num_1] + 1
 1.2. 2 ^ [var_num_2] * ( Log10 ( [var_num_3] ) + 2 )
 1.3. sin ( len ( [var_string_1] ) )
Примеры строковых выражений
 2.1. [var_string_1] + [var_string_2]
 2.2. "Кусок текста" + [var_string_1]
 2.3. 2 + 3 + [var_string_1]
 2.4. "2" + "3" + [var_string_1]
 2.5. SubStr ( [var_string_1], 1, Length ( [var_string_1] ) - 1 )
 2.6. If ( num([a]) > 5, "больше", "меньше")
Операции
Операции над аргументами
Функция
Тип значения
Описание
+
num | str
Если аргументы могут быть приведены к числам, то результатом является сумма двух чисел. Иначе аргументы они приводятся к строке и сцепляются.
++
str
Приводит аргументы к строке и сцепляет их.
-
num
Если аргументы могут быть приведены к числам, то результатом является их разность. Иначе операция завершается с ошибкой.
*
num
Если аргументы могут быть приведены к числам, то результатом является их произведение. Иначе операция завершается с ошибкой.
/
num
Если аргументы могут быть приведены к числам, то результатом является их частное. Иначе операция завершается с ошибкой.
div
int
Если аргументы могут быть приведены к целым числам, то результатом является целая часть их частного. Иначе операция завершается с ошибкой.
rem
int
Если аргументы могут быть приведены к целым числам, то результатом является остаток от деления. Иначе операция завершается с ошибкой.
==
bool
Приводит значения аргументов к одному типу и сравнивает их. Равенство.
/=
bool
Приводит значения аргументов к одному типу и сравнивает их. Неравенство.
> 
bool
Приводит значения аргументов к одному типу и сравнивает их. Больше.
>=
bool
Приводит значения аргументов к одному типу и сравнивает их. Больше или равно.
< 
bool
Приводит значения аргументов к одному типу и сравнивает их. Меньше.
=<
bool
Приводит значения аргументов к одному типу и сравнивает их. Меньше или равно.
Шаблоны
Приложение редактора сценариев позволяет задавать выражения с помощью шаблонов.
Шаблон представляет собой строку, в которую в фигурных скобках входят вычислимые выражения. При этом переход между вкладками задания шаблона и задания выражения производит автоматическое взаимное преобразование.
Пример записи одного вычисления на закладке Выражение и Шаблон:
Закладка выражения
"abc."+str([var])+".def"+endline()+replace([var],";",".")+substring([var2],3,5)+"zzz" "abc." + str([var]) + ".def" + endline() + replace([var],";",".") + substring([var2],3,5) + "zzz""abc."+str([var])+".def"+endline()+replace([var],";",".")+substring([var2],3,5)+"zzz"

 Закладка шаблона
abc.str([var]).defreplace([var1],";",".")+substring([var2],3,5)zzz  abc.{str([var])}.def
      {replace([var1],";",".") + substring([var2],3,5)}zzzabc.str([var]).defreplace([var1],";",".")+substring([var2],3,5)zzz
Функции сценариев
Функции используются при создании выражений и шаблонов. Позволяют вычислять специфические значения и проводить операции над системой.
Каталог функций
Не все функции доступны в каждом Продукте.
Ниже приведен полный список функций системы по всем Продуктам.
Математические функции
Функция
Параметры
Описание
abs
num
Абсолютное значение числа
acos
num
Арккосинус числа
asin
num
Арксинус числа
atan
num
Арктангенс числа
atan2
num, num
Арктангенс частного двух чисел
ceil
num
Ближайшее сверху целое число
cos
num
Косинус числа
cosh
num
Гиперболический косинус числа
erf
num
Функция ошибки (интеграл вероятности)
erfc
num
Дополнительная функция ошибок
exp
num
Экспонента числа
floor
num
Ближайшее снизу целое число
lg
num
Десятичный логарифм числа
ln
num
Натуральный логарифм числа
log
num, num
Логарифм одного числа по основанию другого
log10
num
Десятичный логарифм числа
log2
num
Двоичный логарифм числа
max
num, num
Максимальное из двух чисел
min
num, num
Минимальное из двух чисел
pow
num, num
Результат возведения одного числа в степень другого
random
​
Случайное десятичное число от 0 до 1
random
int
Случайное целое число от 0 до указанного целого числа
random
int, int
Cлучайное целое число в диапазоне между двумя целыми числами
round
num
Результат округления числа до целого
sin
num
Синус числа
sinh
num
Гиперболический синус числа
sqr
num
Квадрат числа
sqrt
num
Квадратный корень числа
tan
num
Тангенс числа
tanh
num
Гиперболический тангенс числа
trunc
num
Результат отбрасывания дробной части числа
Строковые функции
Функция
Параметры
Описание
concat
str,str
Возвращает результат сцепления двух строк.
equal
str,str
Результат сравнения двух строк: 0 или 1
indexof
str,str,int
Возвращает индекс позиции первого вхождения подстроки (п2) в строку (п1), начиная с указанной позиции (п3). Возвращает 0, если вхождений не обнаружено.
left
str,int
Возвращает левую часть строки не более чем указанной длины.
len
str
Возвращает длину строки в символах.
lower
str
Возвращает строку в нижнем регистре.
modify_json
str,json,json
Возвращает измененную json-структуру. Подробнее в Функция modify json
newid
​
Возвращает сгенерированный UUID-идентификатор.
regexreplace
str,str,str
Возвращает результат замены с помощью регулярного выражения. п1 - значение, п2 - паттерн, п3 - замена.
regexreplaceg
str,str,str
Возвращает результат замены с помощью регулярного выражения с опцией global. п1 - значение, п2 - паттерн, п3 - замена.
remove
str,int
Возвращает строку после удаления из нее подстроки с указанной позиции (п2) до конца.
remove
str,int,int
Возвращает строку после удаления из нее подстроки с указанной позиции (п2) указанной длины (п3).
replace
str,str,str
Возвращает результат замены в строке (п1) вхождения (п2) на значение (п3).
reverse
str
Возвращает перевернутую строку.
right
str,int
Возвращает правую часть строки не более чем указанной длины.
rstr
str,str
Возвращает индекс позиции последнего вхождения подстроки (п2) в строку (п1). Возвращает 0, если вхождений не обнаружено.
str
str,str
Возвращает индекс позиции первого вхождения подстроки (п2) в строку (п1). Возвращает 0, если вхождений не обнаружено.
substr
str,int
Возвращает подстроку с указанной позиции (п2) до конца.
substr
str,int,int
Возвращает подстроку с указанной позиции (п2) не более чем указанной длины (п3).
trim
str
Возвращает строку, избавленную от пустых символов в начале и в конце (пробел, табуляция и т.д.).
trimend
str
Возвращает строку, избавленную от пустых символов в конце (пробел, табуляция и т.д.).
trimstart
str
Возвращает строку, избавленную от пустых символов в начале (пробел, табуляция и т.д.).
upper
str
Возвращает строку в верхнем регистре.
Функции по работе с датами/временем
Функция
Параметры
Описание
date
​
Возвращает текущую дату в локальном часовом поясе сервера без указания часового пояса. Формат YYYY-MM-DD.
date
dt
Возвращает дату из указанной даты/времени.
dateadd
atom,int,dt
Возвращает дату после добавления указанного количества (п2) указанных единиц времени (п1) к указанной дате/времени (п3). Параметр указывается в виде атома (не строки), например dateadd('mi',120,"2019-10-06T13:05:28")
Возможные виды единиц по убыванию:
yy, yyyy, q, qq, m, mm, ww, wk, d, dd, h, hh, mi, n, s, ss, ms
datediff
atom,dt,dt
Возвращает число указанных единиц времени между двумя датами. Параметр указывается в виде атома (не строки), например datediff('dd',"2019-10-06","2019-10-05")
Возможные виды единиц по убыванию:
yy, yyyy, q, qq, m, mm, ww, wk, d, dd, h, hh, mi, n, s, ss, ms
dateformat
str, dt
Возвращает строку с представление даты (п2) по указанному формату (п1). Например: yyyy-MM-dd. Возможные значения форматирующей строки:
yyyy, yy, MM, d, dd, h, HH, MMM, mm, ss, ffff, fff, ff, f, zzz.
datetime
int,int,int
Возвращает дату/время на основе переданных п1 - года, п2 - месяца, п3 - дня.
datetime
int,int,int,int,int
Возвращает дату/время на основе переданных п1 - года, п2 - месяца, п3 - дня, п4 - часа, п5 - минуты.
datetime
int,int,int,int,int,int
Возвращает дату/время на основе переданных п1 - года, п2 - месяца, п3 - дня, п4 - часа, п5 - минуты, п6 - секунды.
datetime
int,int,int,int,int,int,int
Возвращает дату/время на основе переданных п1 - года, п2 - месяца, п3 - дня, п4 - часа, п5 - минуты, п6 - секунды, п7 - миллисекунды.
datetime
str
Возвращает дату/время, сформированную по строке. Строка может содержать различные представления даты/времени, в том числе и RFC3339.
datetimelocal
dt
Возвращает дату/время приведенную к локальному часовому поясу сервера. Числовые значения даты/времени не изменяются, однако абсолютная точка времени может быть сдвинута после изменения тайм-зоны на локальную.
datetimeutc
dt
Возвращает дату/время приведенную к UTC. Числовые значения даты/времени не изменяются, однако абсолютная точка времени может быть сдвинута после изменения тайм-зоны на нулевую.
day
dt
Возвращает текущий день (1-31) указанной даты/времени.
dayofweek
dt
Возвращает номер дня недели (1-7) для указанной даты/времени.
dayofyear
dt
Возвращает номер дня в году для указанной даты/времени.
hour
dt
Возвращает текущий час (0-23) указанной даты/времени.
isleapyear
int
Возвращает true, если указанная дата/время представляет високосный год.
localtoutc
dt
Возвращает UTC дату/время для указанной даты/времени, рассматриваемой в локальном часовом поясе сервера.
millisecond
dt
Возвращает текущую миллисекунду (0-999) указанной даты/времени.
minute
dt
Возвращает текущую минуту (0-59) указанной даты/времени.
month
dt
Возвращает текущий месяц (1-12) указанной даты/времени.
now
​
Возвращает текущую дату и время в локальном часовом поясе сервера в формате RFC3339. Например, 2019-10-06T16:43:30.46+03:00.
nowgregsecond
​
Возвращает количество секунд по григорианскому календарю, с 0 года н.э.
nowtick
​
Возвращает число, представляющее абсолютное значение в миллисекундах с 01.01.1970 года до текущего времени сервера.
nowutc
​
Возвращает текущую дату и время в UTC в формате RFC3339.
second
dt
Возвращает текущую секунду (0-59) указанной даты/времени.
ticktolocal
int
Возвращает дату в локальном часовом поясе сервера по абсолютному значению tick.
ticktoutc
int
Возвращает дату в UTC по абсолютному значению tick.
time
​
Возвращает текущее время в локальном часовом поясе сервера без указания часового пояса. Формат HH:mm:ss.fff.
time
dt
Возвращает время из указанной даты/времени.
utctolocal
dt
Возвращает локальную дату/время для указанной даты/времени, рассматриваемой как UTC.
valid_date
dt
Возвращает true, если указанная строка содержит корректную дату/время, иначе false.
weekofyear
dt
Возвращает номер недели в году для указанной даты/времени.
year
dt
Возвращает текущий год указанной даты/времени.
Функции преобразования
Функция
Параметры
Описание
base64decode
str
Возвращает строку, полученную в результате распаковки из Base-64 представления.
base64encode
str
Возвращает строку, полученную в результате упаковки в Base64 представление.
char
str
Возвращает строку с одним символом по его числовому коду.
dechex
int
Возвращает строку с HEX-представлением числа.
escape
str
Возвращает строку, полученную в результате преобразования к escape-последовательности. Применяется для вставки в JSON.
hexdec
str
Возвращает число на основе его HEX-представления.
htmldecode
str
Возвращает строку, раскодированную c помощью Unicode Hex Character Code
htmlencode
str
Возвращает строку, закодированную c помощью Unicode Hex Character Code.
ifelse
bool,any,any
Если значение первого параметра true, то возвращает п2, иначе возвращает п3.
num
str
Преобразует строку к числу. При неудаче завершается с ошибкой.
numval
str
Преобразует строку к числу, отрезая с конца неподходящие символы. В пределе возвращает 0.
str
int
Преобразует числовое значение к строке.
translit
str
Возвращает результат транслитерации строки.
unescape
str
Возвращает строку, полученную в результате распаковки из escape-последовательности. Применяется для очистки после JSON.
urldecode
str
Возвращает строку, раскодированную с помощью UrlEncode.
urlencode
str
Возвращает строку, закодированную с помощью UrlEncode.
Хеш-суммы
Функция
Параметры
Описание
adler32
any
Хеш от любого значения по алгоритму Adler-32.
adler32
num,any
Новое значение хеша от предыдущего значения, скомбинированного с новой порцией. п1 - предыдущее значение хеша, п2 - новая порция данных. По алгоритму Adler-32.
crc32
any
Хеш от любого значения по алгоритму CRC32 (IEEE 802.3).
crc32
num,any
Новое значение хеша от предыдущего значения, скомбинированного с новой порцией. п1 - предыдущее значение хеша, п2 - новая порция данных. По алгоритму CRC32 (IEEE 802.3).
md5
str
Хеш от строки по алгоритму MD5.
phash2
any
Хеш-сумму от любого значения по внутреннему алгоритму.
Функции по работе с файловыми путями
Функция
Параметры
Описание
filedir
str
Возвращает название каталога. Для пути к файлу - это имя каталога, для пути к каталогу - это название родительского каталога.
fileext
str
Возвращает расширение файла, выделенное из указанного пути.
filename
str
Возвращает имя файла, выделенное из указанного пути.
gs_domain
​
Возвращает :GLOBALSHARE_DOMAIN_DATA - префикс категории сетевого межсайтового каталога текущего домена.
gs_public
​
Возвращает :GLOBALSHARE_PUBLIC - префикс категории сетевого межсайтового каталога общего назначения.
gs_script
​
Возвращает :GLOBALSHARE_SCRIPT_DATA - префикс категории сетевого межсайтового каталога текущего сценария (по коду).
makepath
str,str
Возвращает путь, сформированный в результате сцепки двух частей.
makepath
str,str,str
Возвращает путь, сформированный в результате сцепки трех частей.
pathtype
str
Возвращает тип пути (префикс категории из указанного пути).
relpath
str
Возвращает относительный путь (указанный путь без префикса категории).
ss_domain
​
Возвращает :SITESHARE_DOMAIN_DATA - префикс категории сетевого внутрисайтового каталога текущего домена.
ss_public
​
Возвращает :SITESHARE_PUBLIC - префикс категории сетевого внутрисайтового каталога общего назначения.
ss_script
​
Возвращает :SITESHARE_SCRIPT_DATA - префикс категории сетевого внутрисайтового каталога текущего сценария (по коду).
syn_domain
​
Возвращает :SYNC_DOMAIN_DATA префикс категории синхронизирующегося каталога данных домена.
syn_media
​
Возвращает :SYNC_COMMON - префикс категории синхронизирующегося каталога общего назначения.
syn_script
​
Возвращает :SYNC_SCRIPT_DATA префикс категории синхронизирующегося каталога данных текущего сценария (по коду).
syn_script_media
​
Возвращает :SYNC_SCRIPT_STATIC префикс категории синхронизирующегося каталога статических файлов сценария (по коду).
temp
​
Возвращает :TEMP - префикс временного локального каталога сценария.
Служебные функции
Функция
Параметры
Описание
getscriptref
​
Возвращает строку с идентификатором текущего обработчика сценариев. По этому идентификатору обработчику могут отправлять сообщения другие обработчики сценариев, например с помощью компонента Взаимодействие сценариев.
startparam
int
Возвращает значение входного параметра с указанным индексом. Сценарии могут принимать до 20 входных параметров.
Функции Доступа
Функция
Параметры
Описание
check_variable
str
Возвращает true, если переменная c указанным именем существует и содержит значение.
get_variable_id
str
Возвращает строку с идентификатором переменной по её имени.
get_variable_orig
str
Возвращает значение переменной по её имени, причем, если значение строковое, то оно возвращается в исходной кодировке без преобразования.
get_variable_value
str
Возвращает значение переменной по её имени.
var
str
Возвращает значение переменной по её имени.
Функции конфигурации
Функция
Параметры
Описание
wsurl
​
Возвращает URL ближайшего доступного сервера с логической ролью ws. В формате proto://ip-address:port.
Константы
Функция
Параметры
Описание
e
​
Возвращает число e (2.718281828459045).
phi
​
Возвращает число phi (1.618033988749895).
pi
​
Возвращает число pi (3.141592653589793).
Символы
Функция
Параметры
Описание
dblquot
​
Возвращает строку с символом двойной кавычки.
​
endline
​
Возвращает строку с символом конца строки.
quot
​
Возвращает строку с символом кавычки.
tab
​
Функции сценариев IVR
Функция
Примечание
Описание
calledext()
только для вызовов, поступивших в IVR
Возвращает строку с расширением КАФ, по которому звонок поступил в IVR.
callednum()
только для вызовов, поступивших в IVR
Возвращает строку с набранным абонентом номером.
callid()
​
Возвращает строку со значением заголовка CallId плеча b2b - ivr текущего разговора
huntid()
только для сценариев Прекоммутации и Ожидания в очереди обработки очередей
Возвращает строку с идентификатором сущности hunt-группы, на которую направлен вызов.
huntobjid
только для сценариев Прекоммутации и Ожидания в очереди обработки очередей
Возвращает строку с идентификатором текущего абонента очереди hunt-группы.
ivrparam(str)
только для вызовов, поступивших в IVR.
Возвращает значение указанного параметра из заголовка X-R-Ivr, который формируется ролью b2b. Например, from, to, by.
q_displayname
только для сценария Прекоммутации обработки очередей
Возвращает displayname абонента, ожидающего коммутации с вызываемым оператором
q_domain
только для сценария Прекоммутации обработки очередей
Возвращает domain абонента, ожидающего коммутации с вызываемым оператором
q_username
только для сценария Прекоммутации обработки очередей
Возвращает username абонента, ожидающего коммутации с вызываемым оператором
queueestimatedsec()
только для сценария Ожидания в очереди обработки очередей
Предполагаемое время ожидания в очереди
queueposition()
только для сценария Ожидания в очереди обработки очередей
Возвращает текущую позицию в очереди.
queuepriority()
только для сценария Ожидания в очереди обработки очередей
Возвращает текущее числовое значение приоритета в очереди.
queuepriority(int)
только для сценария Ожидания в очереди обработки очередей
Устанавливает новое числовое значение приоритета в очереди, автоматически производится перемещение.
queuerescount()
только для сценария Ожидания в очереди обработки очередей
Возвращает количество операторов в хант-группе.
queuerescount(str)
только для сценария Ожидания в очереди обработки очередей
Возвращает количество операторов в хант-группе, находящихся в указанном в переменной str состоянии. Возможные варианты:
 online
free
queuestate()
только для сценария Ожидания в очереди обработки очередей
Возвращает строку с названием состояния ожидания в очереди.
r_number
только для сценария Прекоммутации обработки очередей
Возвращает строку с номером оператора
remotenum()
​
Возвращает строку с номером абонента, сформированным в результате применения правил представления.
Переменные
В этом блоке находятся все объявленные в сценарии переменные. В Выражения сценариев они добавляется в [ и ] Например, переменная ABC в Выражение (и шаблоны) будет добавлена как [ABC]
Дополнительная информация
Функция modify json
modify_json(п1 str,п2 json,п3json)
Применяет поисковый запрос (п1) к значению (п2), обнаруженный элемент подвергает модификации согласно опциям (п3) и возвращает общий результат.
Пример:
modify_json(
   "\"chat\"/0/\"msgs\"",
   "{\"chat\":[{\"msgs\":[{\"txt\":\"abc\"}]}]}",
   "{\"action\":\"append\",\"value\":{\"txt\":\"zcv\"}}"
 )
Опции представлены в виде json-объекта с обязательным ключом action. Возможные варианты:
append - для массива. Добавляет новый элемент в конец. В опциях значение элемента по ключу value.

prepend - для массива. Добавляет новый элемент в начало. В опциях значение элемента по ключу value

insert - для массива. Добавляет новый элемент в указанную позицию. В опциях значение элемента по ключу value, позиция по ключу index.

 replace - для массива. Заменяет элемент в указанной позиции на новый. В опциях значение нового элемента по ключу value, позиция по ключу index.

replace_auto - для массива. Заменяет все элементы массива на указанное значение. В опциях значение по ключу value.

delete - для массива. Удаляет элемент из указанной позиции. В опциях значение позиции по ключу index.

 keystore - для объекта. Сохраняет элемент по указанному ключу, в зависимости от наличия ключа добавляет или изменяет значение. В опциях значение элемента по ключу value, значение ключа по ключу key.

keyreplace - для объекта. Заменяет элемент по указанному ключу, а если ключ отсутствует, то оставляет без изменений. В опциях значение элемента по ключу value, значение ключа по ключу key.

keyinsert - для объекта. Сохраняет элемент по указанному ключу, если он отсутствует, а иначе завершается с ошибкой. В опциях значение элемента по ключу value, значение ключа по ключу key.

keydelete - для объекта. Удаляет элемент по указанному ключу. В опциях значение ключа по ключу key.
Примеры.
Исходная переменная x
{
 "name": "Андрей Васильев",
 "id": "1377340472378151"
 }
Пример 1. Keyinsert
Добавлено в json ключа "channel" со значением "test".
modify_json(
     "",
     [x],
     "{\"action\":\"keyinsert\", \"key\":\"channel\", \"value\":\"\\\"test\\\"\"}"
 )
Результат
{
 "channel":"test",
 "name":"Андрей Васильев",
 "id":"1377340472378151"
 }
Если Key channel существует до выполнения modify_json, то результат будет Ошибка
Пример 2. Keyreplace
Заменена значения у поля name.
modify_json(
     "",
     [x],
     "{\"action\":\"keyreplace\", \"key\":\"name\", \"value\":\"\\\"test\\\"\"}"
 )
Результат
{
 "name":"test",
 "id":"1377340472378151"
 }


Взаимодействие сценариев
Каждый сценарий в процессе своего выполнения может запускать другие сценарии в двух режимах
Вложенное (синхронное) выполнение. Родительский сценарий ждет завершения дочернего для продолжения своей работы.

Асинхронное выполнение. Родительский сценарий не ждет завершения дочернего, а продолжает свою работу.
Варианты вызова сценариев
IVR → IVR
Вызов дочернего IVR осуществляется через Запуск сценария по имени или по коду. Вызов возможен только во Вложенном (синхронном) режиме. Все Локальные переменные родительского IVR наследуются дочерним сценарием. Для возврата управления в родительский IVR, дочерний сценарий необходимо завершить компонентом Стоп с включенным признаком возврата управления. Вместе с управлением в родительский вернутся изменения в значениях локальных переменных, если таковые были сделаны в дочернем сценарии.
Обычно применяется для
разбиения больших сценариев на более понятные;
для выделения идентичной логики несколькими сценариями;
IVR → Служебный сценарий
Вызов служебного сценария из IVR-сценария осуществляется через Запуск сценария по имени или по коду. Вызов возможен только в Асинхронном служебном режиме. Все Локальные переменные родительского IVR наследуются служебным сценарием.
Обычно применяется для асинхронной обработки данных, полученных из IVR сценария (которая может занять длительное время и не должна влиять на голосовое взаимодействие с абонентом)
Служебный → IVR сценарий
Для вызова IVR-сценария из служебного сценария используется Исходящий звонок. Происходит инициация исходящего звонка от имени IVR на указанный номер и при поднятии трубки запускается указанный IVR сценарий.
Обычно используется для автоматических задач дозвона и оповещения.
Служебный → Служебный сценарий
Для вызова служебного сценария из служебного сценария используется Запуск сценария . Вызов возможен в обоих режимах - вложенного и асинхронного.
В режиме вложенного будет ожидать завершения вызываемого сценария. Локальные переменные наследуются в дочерний.
В режиме асинхронного запускает параллельное выполнение сценария. Родительский сценарий не ждет завершения дочернего. Даже если родительский сценарий завершится, асинхронный служебный сценарий продолжит свою работу пока не завершится сам.
 Используется для параллельной обработки больших объемов данных.
Все сценарии настраиваются в модуле Редактор сценариев (scripteditor). Модуль предоставляет возможность с помощью графического интерфейса визуально программировать сценарии и имеет все требуемые компоненты для решения большинства задач.
Общий вид раздела
​
Верхняя панель
​
Название
Описание
Имя сценария
Отображается имя сценария
Код сценария
Отображается заданный код сценария
Тип сценария
​
 - Служебный сценарий
​
 - IVR сценарий
Сохранить
Сохранение сценария
Для запуска сценария или отмены изменений в информационной панели нажмите на 
​
Затем выберите нужно действие в контекстном меню выбора.
Меню выбора действия
​
Основное окно
Отображается последовательность выполнения компонентов сценария и условные переходы между ними.
​
Правила хорошего тона
Графический интерфейс создания сценариев предоставляет удобный и легкий в использовании инструментарий, отражающий концепцию Low-Code/No-Code. Но с другой стороны "некрасивое" рисование сценария приведет к сложностям дальнейшей модификации и понимания. Поэтому мы рекомендуем придерживаться следующих правил:
1.          Разбивать сценарии по функциональному предназначению. Можно все активности свести в один громоздкий сценарий, но стоимость любого изменения и возможной ошибки будет пропорционально количеству компонент.
2.          Названия сценариев должны быть "говорящими".
a.           Префикс должен отражать прямое предназначение, проект, другую классификацию.
b.          Основная часть имени должна нести смысловую нагрузку
c.           Постфикс можно использовать на номер версии, дату последнего релиза и т.п.
3.          Коды сценариев должны быть максимально сжатыми и отвечать единым правилам наименования. В пределе Код и Наименования могут совпадать, но обычно код меньше по количеству символов.
4.          Планарность самого рисунка. Пересекаемые линии переходов сильно усложняют чтение картинки. Рекомендуется избегать пересечений или минимизировать их смысловое влияние на чтение сценария
5.          Использование Комментарий где можно выделить отдельно значимый блок. В описании указать что это за блок, какие функции он выполняет и в дальнейшем вести changeLog изменений в нем
6.          Оптимизация количества компонент. Не рекомендуется более 100 компонент в одном сценарии. Рекомендация крайне условная, но ей можно придерживаться при формальной оценке сложности сценария.
7.          У компонент тоже должны быть "говорящие" названия. Не "Присвоение 3" (по пиктограмме видно что это Присвоение, а "i+1" или "увеличение счетчика i".
8.          Названия переменных так же важны. Не рекомендуется плодить множество переменных, но и ограничений нет. Используйте переменные и их наименования чтобы облегчить восприятие сценария.
9.          После компонента Старт задать все начальные значения, которые являются константами и не получаются из Дефолтных значений объекта или из других переменных.
10.      Отладочные компоненты настроены не на константы, а на переменные, которые можно изменить в начале сценария. Например пользователь у компонента Уведомление.
11.      Нет брошенных веток. Каждая ветка завершается компонентом Стоп или Отбой или другим конечным компонентом.
12.      При необходимости отладочных данных в работающем сценарии записывать их в Лог-файлы через Уведомление. После можно будет собрать логи и проанализировать выпонение разных экземпляров.
13.      Использование компонента SQL-запрос только там, где данные принадлежат Аксател (а не другой системе) или в случае, если сторонняя ИС не может предоставить WebService API доступ к данным.
Рекомендации по этапам работы над сценариями
Этап проектирования архитектуры разбиения ответственности за реализацию по сценариям.
Этап проектирования структуры сценария
–            входные - выходные данные,
–            протоколы взаимодействия,
–            основные блоки и алгоритмы внутри сценария
Этап разработки.
Этап отладки.
Этап приведения сценария в состояние релиза
Этап оценки качества. Рекомендуем на этот этап привлекать инженера, кто не задействован в текущем проекте. Цель этапа - оценить читаемость сценария и насколько сторонний инженер сможет в нем разобраться через месяц-год.
IVR-сценарии и Служебные сценарии имеют как общие компоненты так и уникальные. Также набор компонент может отличаться между Продуктами.
Далее приведен полный список компонентов и их свойств, которые могут быть в любых типах сценариев во всех Продуктах.
​
​
​
​Каталог функций​
​
​
Speech analytics
Блок "Компоненты"
Last modified 1yr ago
Copy link
On this page
Общая логика обработки сценариев Аксател
IVR сценарии
Служебные сценарии
Переменные сценариев
Области видимости
Типы значений
Аргументы сценариев
Типы аргументов
Типы значений
Приведение типов
Выражения сценариев
Примеры выражений
Операции
Шаблоны
Функции сценариев
Каталог функций
Взаимодействие сценариев
Варианты вызова сценариев
Верхняя панель
Основное окно
Правила хорошего тона