Компоненты служебных сценариев — различия между версиями

Материал из Oktell
Перейти к: навигация, поиск
м (Коммутатор)
 
Строка 294: Строка 294:
 
* a_callername - CallerName используемый при дозвоне до абонентов группы А. По умолчанию пусто.
 
* a_callername - CallerName используемый при дозвоне до абонентов группы А. По умолчанию пусто.
 
* a_music - мелодия ожидания для абонентов группы А. По умолчанию [[Музыкальное_сопровождение#Alternative|альтернативная мелодия]].
 
* a_music - мелодия ожидания для абонентов группы А. По умолчанию [[Музыкальное_сопровождение#Alternative|альтернативная мелодия]].
* a_queuepriority - приоритет очереди при вызове внутренних абонентов группы А. По умолчанию [[Настройка_менеджера_очередей#DefaultPriorityInt|стандартный приоритет внутренних вызовов]].
+
* a_queuepriority - приоритет очереди при вызове внутренних абонентов группы А. По умолчанию [[Менеджер_очередей#DefaultPriorityInt|стандартный приоритет внутренних вызовов]].
 
* a_usequeue - разрешение/запрет использования очереди при вызове внутренних абонентов группы А. По умолчанию разрешено.
 
* a_usequeue - разрешение/запрет использования очереди при вызове внутренних абонентов группы А. По умолчанию разрешено.
* a_timeoutsec - максимально допустимое время ожидания ответа абонента группы А (в соответствии с настройкой [[Настройка_менеджера_очередей#QueueLimitIvr|активации ограничения при переключении из IVR вовнутрь]]).
+
* a_timeoutsec - максимально допустимое время ожидания ответа абонента группы А (в соответствии с настройкой [[Менеджер_очередей#QueueLimitIvr|активации ограничения при переключении из IVR вовнутрь]]).
 
* b_callerid - аналогично a_callerid
 
* b_callerid - аналогично a_callerid
 
* b_callername - аналогично a_callername
 
* b_callername - аналогично a_callername
Строка 334: Строка 334:
 
<div id="CliProcess"></div>
 
<div id="CliProcess"></div>
 
[[Файл:cli_svcs_exec.png|left]]
 
[[Файл:cli_svcs_exec.png|left]]
 +
 
===Запуск процесса на клиенте===
 
===Запуск процесса на клиенте===
  

Текущая версия на 12:20, 31 марта 2023

Техническая документация / Call-центр или Администрирование / Сценарии / Служебные сценарии / Компоненты служебных сценариев


В данном разделе в справочном порядке приведены лишь узкоспециализированные компоненты, доступные только служебным сценариям. Остальные компоненты являются общими для всех типов сценариев и описаны выше в разделе Общие компоненты сценариев




Cl cc scr i91.png

Сохранение контента

Компонент служит для сохранения переданного ему на старт контента в файл. Сбор таких файлов может быть необходим для последующих задач обработки и тарификации. Файлы могут быть сохранены в текстовом и xml виде. Их дальнейшую обработку может взять на себя или отдельный процесс, или служебный сценарий с таймерной активацией.


Свойства:

Контент Переменная, содержащая переданный в сценарий контент. Заполняется в компоненте «Старт».
Тип файла Текст / XML.
Файл Аргумент, определяющий путь к файлу. Доступна генерация случайных имен (включающих время).
Добавлять в конец Да/нет. Определяет способ формирования файла. Включение режима дописывает в конец к выбранному файлу информацию. Работает только при сохранении в текстовые файлы. Актуально только при настройке записи в один и тот же файл с целью избежания затирания предыдущей информации.

Поле доступно только при выборе значения «Текст» в свойстве «Тип файла».

Имя файла в переменную В указанную переменную будет занесено название файла (или путь), в который было произведено сохранение.
Возвращать полный путь Да/нет. При выборе пункта «Да» в переменную будет сохранен полный путь, иначе только имя файла.
Переход Компонент, на который передается управление.
Имя Название компонента для отображения в визуальной среде и выбора в списке.



Cl cc scr i92.png

Парсинг контента

С версии 100120 ликвидирован. Контент преобразован к XML-виду, парсинг его необходимо осуществлять компонентом Разбор текста


Компонент служит для принятия решения в сценарии на основе содержащейся в контенте информации. Производит выделение из контента интересующего значения, такого как номер линии, время звонка и др.


Свойства:

Контент Переменная, содержащая переданный в сценарий контент. Заполняется в компоненте «Старт».
Параметр Одна из множества содержащихся в контенте величин:
  • Направление звонка;
  • Время начала;
  • Время окончания;
  • Идентификатор линии;
  • Номер линии;
  • Идентификатор цепочки коммутаций;
  • Номер абонента (CallerId);
  • Внешний номер;
  • Количество коммутаций;
  • Количество коммутаций с оператором;
  • Количество коммутаций с IVR;
  • Общее время в секундах;
  • Обработка в задаче;
  • Идентификатор проекта;
  • Идентификатор задачи;
  • Имя задачи;
  • Код задачи;
  • Время в задаче в секундах;
  • Время начала задачи;
  • Код абонента в списке задачи;

Тип возвращаемого значения строковый или числовой.

Переменная Переменная, в которую производится выгрузка значения.
Переход Компонент, на который передается управление.
Имя Название компонента для отображения в визуальной среде и выбора в списке.



Script IVR call.png

Дозвон

Служебный сценарий не связан ни с какой линией, однако он может инициировать звонок на внешнее направление. Компонент позволяет осуществить вызов абонента и в зависимости от свойств либо дождаться ответа абонента и передать управление линией в сценарий IVR, либо запустить набор во внешнюю сеть и сразу же передать инициативу во внешний управляющий модуль (например менеджер задач) с моментальным переходом к следующему компоненту сценария, либо запустить набор и дождаться ответа, после чего передать инициативу во внешний управляющий модуль (например конференцию при вызове внутренних).

В ходе дозвона во внешнюю сеть производится поиск свободной внешней линии в соответствии с установленным списком, резервирование, набор номера. Далее в случае передачи управления внешней линией в сценарий IVR осуществляется ожидание ответа в течение установленного интервала времени (по умолчанию 40 секунд) и дальнейший запуск указанного обслуживающего сценария. В случае передачи управления в вышестоящий менеджер, ожидание ответа абонента осуществляется уже в нем, а сценарий после отправки номера на набор сразу сразу переходит к следующему компоненту.

Использование в режиме вышестоящего управляющего модуля происходит при активации режима набора номеров через сценарий в сервисе автодозвона, в голосовых задачах, в конференции. Например, может стоять задача жесткой маршрутизации звонков. В задаче указывается перечень равноправных линий, однако мобильные номера необходимо набирать через GSM-шлюз, внутригородские через городскую АТС, междугородние через SIP-соединения или через городскую АТС с использованием городской IP-телефонии. Для решения этой задачи может быть организован служебный сценарий, который в соответствии с переданным на его старт номером осуществляет маршрутизацию, выбор направлений, преобразование номера в команду, резервирование и отправку строки-команды на набор. Сценарий устанавливается как способ набора номеров в задачах (могут быть установлены различные сценарии в разных задачах) или при автодозвоне. После отправки команды-номера на набор управляющий модуль берет на себя задачу ожидания ответа линии, а сценарий либо завершается, либо производит дальнейшие необходимые действия, связанные с контекстом своего исполнения. Естественно, сценарий для определения способа маршрутизации и преобразования может использовать всю доступную информацию: время, номер, задача/пользователь, информация во внешних источниках (web, БД) и т.д. В компоненте устанавливается список внешних линий и направлений, отсортированных в соответствии с приоритетом выделения. Может быть задействован дополнительный фильтр по правам внешнего объекта (задачи или пользователя), то есть могут быть исключены те линии, которые не присутствуют в ресурсах инициирующей дозвон задачи или в правах инициирующего автодозвон пользователя. Преобразование номера в команду может быть произведено направлением, в котором зарезервирована свободная линия. Также преобразование может быть выполнено предварительно в текущем сценарии, а на набор передано без изменений.

Использование в режиме вышестоящего управляющего модуля с ожиданием в сценарии требуется при реализации приглашений внутренних номеров в конференцию через служебный сценарий (задается в общих настройках), а также при активации режима набора внутренних номеров в автодозвоне через служебный сценарий (задается в общих настройках). При этом в самом служебном сценарии может происходить набор как внешних, так и внутренних номеров - важно только, чтобы в качестве значения свойства «Обслуживание» был выбран режим «управляющий модуль с ожиданием в сценарии».


В одном обработчике сценария может быть успешно выполнено сколько угодно компонентов «Дозвон» с режимом обслуживания в IVR, но только один с режимом обслуживания в вышестоящем управляющем модуле. Остальные будут фильтроваться.

В случае ожидания в сценарии и обслуживания в вышестоящем управляющем модуле - может быть использовано множество компонентов с последовательно неудачными ответами и только один удачный, после чего будет включена фильтрация.


Свойства:

Номер/команда Аргумент, определяющий номер, по которому производить дозвон.

В качестве номера может быть принята команда (строка, содержащая DTMF символы и командные спец. символы w, q, z, {, }). Подробнее о командах в разделе Администрирование. Направления.

При звонке через sip-шлюз без регистрации возможно указывать в качестве номера URI (sip:username@domain). В этом случае несмотря на настройки звонок будет отправлен на указанный в URI адрес. То же самое в обязательном порядке касается шлюзов межсерверного взаимодействия.

Среда Внешняя сеть / Внутренний номерной план.

Определяет в каком направлении осуществлять вызов. При вызове внутреннего абонента осуществляется его соединение с указанным IVR сценарием. При вызове внешнего абонента существуют разновидности (свойство «Обслуживание»).

Обслуживание IVR / Управляющий модуль / Управляющий модуль с ожиданием в сценарии.

Вариант использования компонента в режиме набора номера. Различие в режимах описано выше.

Тип команды Доступно только в режиме набора номера во внешнюю сеть.

Определяет способ преобразования номера в команду, отсылаемую на набор. По умолчанию без преобразования.

  • Без преобразования. Отправляет номер как есть в зарезервированную линию.
  • Использовать команду направления. Если зарезервированная линия взята из направления, и в нем настроено преобразование номера, то перед отправкой на набор номер будет преобразован в строку-команду по указанной в направлении схеме.Подробно здесь.

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

Тип вызова Доступно только в режиме набора номера во внешнюю сеть.

Обычный / экстренный / интерком. Набор в экстренном режиме при отсутствии свободных линий среди назначенных будет производить разрыв активных коммутаций с целью освобождения внешней линии для совершения этого звонка.

ВНИМАНИЕ! Значение «экстренный» следует выставлять в сценарии набора экстренных номеров. В других случаях рекомендуется оставлять тип со значением по умолчанию «обычный». Возможны вариации, но их следует тщательно продумывать во избежание незапланированных разрывов.

Подробно об экстренных номерах в разделах Администрирование. Внутренние номера. Экстренные и Администрирование. Общие настройки. Экстренные номера.

Интерком-вызов имеет отличие от обычного, если функция поддерживается конечным устройством. В противном случае вызов будет происходить в обычном режиме. При интерком-вызове телефонное устройство снимает трубку автоматически сразу же после поступления звонка.

Линии, направления Осуществляет выбор линий и направлений для осуществления звонка во внешнюю сеть

На вкладке «Список объектов» предоставляется возможность указать явно последовательность существующих в системе линий и направлений для осуществления звонка. Можно отключить использование некоторых элементов, а для выбранных установить последовательность поиска свободной линии. Поиск свободной будет осуществляться в соответствии с установленной последовательностью. По каждому направлению анализируются все линии, входящие в его состав. Если линия присутствует в нескольких направлениях, то при обнаружении ее свободной и установленном в компоненте режиме преобразования номера в соответствии с командой направления, будет применена команда того направления, которое в перечислении находится выше по приоритету. На вкладке «Аргумент» возможно динамическое указание линии через ее код или Guid-идентификатор в строковом представлении. Также здесь может быть указан идентификатор или код направления, потока или шлюза. В этом случае будут последовательно перебираться все линии указанного объекта до обнаружения свободной и готовой к совершению вызова. Режим введен для использования совместно со шлюзами с динамической регистрацией потоков и компонентом сценариев Регистрация потока.

Идентификатор выбранной линии в переменную Устанавливает строковую переменную, в которую происходит сохранение GUID-идентификатора выбранной для звонка линии. Если звонок не произведен, в переменную заносится пустота.
Фильтровать по правам Доступно только при наборе номера во внешнюю сеть в режиме обслуживания в управляющем модуле.

Да/нет. При задействовании режима в случае, если осуществляется обработка канала пользователя системы, может быть осуществлена дополнительная фильтрация перечисленных в компоненте линий в соответствии с настройками прав выхода на внешние линии для пользователя. По умолчанию «Да» - фильтровать.

CallerId Подставляемый для звонка номер. При отсутствии или некорректном значении будет взят номер по умолчанию для канала.
CallerName Подставляемый для звонка имя.
Сценарий IVR Доступно только в режиме обслуживания в IVR (внешние и внутренние вызовы).

Название сценария, который будет запущен после снятия трубки абонентом.

Очередь ожидания Активировать ли очередь ожидания для внутреннего переключения в случае, если номер занят.

Поле доступно только при выборе значения «Внутренний номерной план» в свойстве «Среда».

Параметр запуска IVR Доступно только в режиме обслуживания в IVR (внешние и внутренние вызовы).

Параметр, который будет передан на старт сценария IVR.

Время ожидания, сек Аргумент определяет, сколько секунд необходимо ожидать соединения перед отбоем.
Код отказа SIP в переменную Доступно только в режиме обслуживания в IVR или ожидания ответа в сценарии.

Переменная сценария, куда сохраняется числовой код отказа SIP (например 486 или 500).

Переход Компонент, на который передается управление в случае успешного выполнения поставленной задачи (в соответствии с режимом - либо ответ абонента и соединение со сценарием IVR, либо отправка команды на набор и передача линии на обслуживание в управляющий модуль).
Переход, занято Доступно только в режиме обслуживания в IVR (внешние и внутренние вызовы).

Компонент, на который передается управление, если номер занят. Свойство доступно только если установлен режим обслуживания в сценарии IVR.

Переход, не отвечает Доступно только в режиме обслуживания в IVR (внешние и внутренние вызовы).

Компонент, на который передается управление, если время ожидания ответа истекло. Свойство доступно только если установлен режим обслуживания в сценарии IVR.

Переход, линия не найдена Доступно только в режиме обслуживания в IVR (внешние вызовы).

Компонент, на который передается управление, если не обнаружена доступная для совершения вызова внешняя линия из списка направлений.

Переход, ошибка Доступно только в режиме обслуживания в IVR (внешние и внутренние вызовы).

Компонент, на который передается управление, если в ходе проверки корректности установки свойств, набора номера, ожидания событий или передачи управления возникли сбои.

Имя Название компонента для отображения в визуальной среде и выбора в списке.



Cl cc scr i94.png

Коммутатор

Компонент осуществляет вызов двух абонентов и соединяет их между собой в коммутацию. Имеет возможность вызывать сразу группу, из которых в качестве абонента принимается первый ответивший. Поддерживает вызовы внутренних пользователей, внешних номеров, быстрых и экстренных номеров, внутренних номеров, IVR-сценариев. При вызове внешних номеров использует сценарий набора внешних/быстрых номеров, если тот установлен в разделе общих настроек.


Свойства:

Детальная настройка Да/нет.

Позволяет включить режим детальной настройки параметров вызова с помощью XML. По умолчанию «Нет».

Абоненты А Недоступно, если включена детальная настройка.

Аргумент, определяющий первого абонента предстоящей коммутации. В качестве абонента может выступать ключ пользователя (идентификатор, имя, логин), ключ линии (идентификатор, номер), внутренний стандартный номер, быстрый/экстренный номер, внешний номер, а также любая их комбинация через запятую. В случае указания группы или нескольких абонентов в предстоящей коммутации будет участвовать первый ответивший абонент среди перечисленных.

Абоненты Б Недоступно, если включена детальная настройка.

Аргумент, определяющий второго абонента предстоящей коммутации. Указание аналогично абоненту А.

Последовательность Недоступно, если включена детальная настройка.
  • Сначала А, потом Б. Система вызывает абонентов А, дожидается ответа первого из них, обрывает дозвон до остальных, после чего запускает дозвон до абонентов Б.
  • Сначала Б, потом А. Наоборот.
  • Одновременно А и Б. Система вызывает одновременно всех абонентов, при этом гарантирует соединение одного из группы А с одним из группы Б.

На время ожидания запускается альтернативная мелодия.

CallerId для А Недоступно, если включена детальная настройка.

Аргумент, определяющий CallerId, с указанием которого осуществляется вызов абонентов группы А

CallerId для Б Недоступно, если включена детальная настройка.

Аргумент, определяющий CallerId, с указанием которого осуществляется вызов абонентов группы Б

Запись Недоступно, если включена детальная настройка.

Параметр, определяющий необходимость записи. По умолчанию выбран вариант «Согласно настройкам», при котором используется стандартная процедура поиска правил записи для звонка. Также доступны варианты «Записывать» и «Не записывать», производящие соответствующие безусловные действия.

Параметры Доступно, если включена детальная настройка.

Аргумент (по умолчанию выражение), определяющий все параметры осуществления коммутации. При начальной настройке выражение содержит полный перечень возможных тегов, часть из которых может быть удалена безболезненно. Обязательны к указанию только группы абонентов (agroup и bgroup) и режим (mode). Установке/изменению доступны:

  • taskid - идентификатор задачи.
  • taskcode - код задачи.
  • sessionid - идентификатор цепочки коммутаций.
  • projectid - идентификатор проекта.
  • mode - последовательность вызова (0 - А, затем Б; 1 - Б, затем А; 2 - одновременно).
  • svcownertext - владелец для служебных сценариев дозвона.
  • agroup - перечень абонентов группы А. Каждый в отдельном теге.
  • a - отдельный абонент из группы А.
  • bgroup - перечень абонентов группы Б. Каждый в отдельном теге.
  • b - отдельный абонент из группы Б.
  • a_callerid - CallerId используемый при дозвоне до абонентов группы А.
  • a_callername - CallerName используемый при дозвоне до абонентов группы А. По умолчанию пусто.
  • a_music - мелодия ожидания для абонентов группы А. По умолчанию альтернативная мелодия.
  • a_queuepriority - приоритет очереди при вызове внутренних абонентов группы А. По умолчанию стандартный приоритет внутренних вызовов.
  • a_usequeue - разрешение/запрет использования очереди при вызове внутренних абонентов группы А. По умолчанию разрешено.
  • a_timeoutsec - максимально допустимое время ожидания ответа абонента группы А (в соответствии с настройкой активации ограничения при переключении из IVR вовнутрь).
  • b_callerid - аналогично a_callerid
  • b_callername - аналогично a_callername
  • b_music - аналогично a_music
  • b_queuepriority - аналогично a_queuepriority
  • b_usequeue - аналогично a_usequeue
  • b_timeoutsec - аналогично a_timeoutsec
  • recordmode - режим записи (0 - согласно настройкам; 1 - да; 2 - нет)
Переход Компонент, на который передается управление после успешного завершения работы компонента.
Ожидать отчета
  • Да, полный отчет. Компонент ожидает коммутации или неудачи, после чего сохраняет отчет в переменную.
  • Да, только результат. Компонент ожидает коммутации или неудачи, после чего сохраняет результат в переменную.
  • Нет. Компонент осуществляет корректность настройки и запускает вызов абонентов, после чего возвращает управление по успешной ветке. Ошибка возможна лишь в случае некорректного задания настроек или недоступности всех абонентов хотя бы одной из групп.
Отчет в переменную Доступно, если активировано ожидание отчета или результата.

Переменная, в которую сохраняется результат в зависимости от выбранного типа.

  • только результат (1-коммутация/0-неудача)
  • полный отчет в XML структуре (коммутация/неудача, описание абонента А, описание абонента Б, осуществляется ли запись, в какой каталог, в какой файл, время начала, идентификатор цепочки).
Переход Компонент, на который передается управление после успешного завершения работы компонента.
Переход, ошибка Доступно, если не активировано ожидание отчета или результата.

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

Имя Название компонента для отображения в визуальной среде и выбора в списке.


Cli svcs exec.png

Запуск процесса на клиенте

Запускает процесс на клиенте. Может запускать исполняемое приложение с обменом данными через консоль, а также открывать указанный документ в сопоставленном ему операционной системой приложении. На рабочем месте пользователя могут быть запущены внешние программы-подсказки, анализаторы, web-сценарии, не требующие связи со сценарием после запуска и пр. При этом служебный сценарий может дожидаться завершения работы запущенного таким образом приложения перед продолжением работы.


Свойства:

Ключ пользователя Аргумент, определяющий пользователя, на рабочем месте которого будет запущен процесс. В качестве ключа может выступать идентификатор пользователя, его имя или логин.
Файл Строковый аргумент, определяющий имя или путь к файлу, который необходимо запустить.
Путь Относительный/абсолютный. Определяет, какой путь будет подставляться впереди к имени файла. Относительный – от папки запуска приложения Oktell.
Параметры командной строки Строковый аргумент, определяющий параметры запуска для командной строки, если необходимо.
Режим запуска Определяет способ исполнения указанного файла
  • С помощью оболочки. В качестве файла можно указывать документы - их открытие будет осуществляться автоматически в зарегистрированных приложениях, однако становится недоступным использование консоли для ввода/вывода.
  • Скрыть окно. Приложение не отображает свое консольное окно.
  • Не скрывать окно. Приложение ведет себя стандартным образом.
Контроль запуска Да/нет. При выборе «да» производится асинхронный запуск указанного приложения и мгновенный возврат управления по ветке «успех». При выборе «нет» запуск производится в синхронном режиме. Управление в сценарий возвращается после непосредственного выполнения команды и получения кода возврата. В зависимости от успешности запуска возврат происходит по ветке «успех» или «неудача».

ВНИМАНИЕ! Некоторые программы могут запускаться достаточно долго, это неизбежно будет сказываться при выборе «да» на задержке выполнения других компонентов служебного сценария.

Ожидание завершения Да/нет. При выборе «да» запуск указанного приложения будет произведен в синхронном режиме вне зависимости от установки свойства «контроль запуска», управление в сценарий будет передано только после того, как запущенный процесс окончит работу и завершится. В этом случае выход происходит по ветке «успех». Если при запуске возникают ошибки, возврат происходит по ветке «неудача». Значение «да» может быть использовано при специфической интеграции компонентов сценария с различными внешними приложениями в случае, когда после выполнения приложений сценарий должен получить доступ к результатам.
Консольный ввод/вывод Доступно только при ожидании завершения процесса, запущенном в обычном режиме (не с помощью оболочки).
  • Нет.
  • Только ввод. Позволяет передать произвольные текстовые данные в консоль приложения сразу после старта.
  • Только вывод. Позволяет считать произвольные текстовые данные из консоли приложения сразу после завершения.
  • Ввод и вывод. Позволяет передать и считать данные.
Консольный ввод Доступно только при ожидании завершения процесса, запущенном в консольном режиме (не с помощью оболочки).

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

ВНИМАНИЕ! При передаче сложных данных для простоты реализации чтения из консоли рекомендуется компоновать данные общим размером в самом начале.

Консольный вывод в переменную Доступно только при ожидании завершения процесса, запущенном в консольном режиме (не с помощью оболочки).

Строковая переменная, в которую полностью сохраняется консольный вывод исполненного приложения.

Переход, успех Если приложение успешно стартовало.
Переход, неудача Если файл не найден, отсутствует доступ, или по другой причине не удалось запустить приложение.
Имя Название компонента для отображения в визуальной среде и выбора в списке.