Просмотр исходного текста страницы Компоненты служебных сценариев

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


[[Файл:cl_cc_scr_i91.png|left]] 
===Сохранение контента===


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

'''Свойства''':


{| border="1" cellpadding="20" cellspacing="0"
|Контент
|Переменная, содержащая переданный в сценарий контент. Заполняется в компоненте «Старт».
|-
|Тип файла
|Текст / XML.
|-
|Файл
|Аргумент, определяющий путь к файлу. Доступна генерация случайных имен (включающих время).
|- 
|Добавлять в конец
|Да/нет. Определяет способ формирования файла. Включение режима дописывает в конец к выбранному файлу информацию. Работает только при сохранении в текстовые файлы. Актуально только при настройке записи в один и тот же файл с целью избежания затирания предыдущей информации.
Поле доступно только при выборе значения «Текст» в свойстве «Тип файла».
|- 
|Имя файла в переменную
|В указанную переменную будет занесено название файла (или путь), в который было произведено сохранение. 
|-
|Возвращать полный путь
|Да/нет. При выборе пункта «Да» в переменную будет сохранен полный путь, иначе только имя файла.
|-
|Переход
|Компонент, на который передается управление.
|-
|Имя
|Название компонента для отображения в визуальной среде и выбора в списке.
|}


[[Файл:cl_cc_scr_i92.png|left]] 
===Парсинг контента===

 
<span style="color:red;"> С версии 100120 ликвидирован. Контент преобразован к XML-виду, парсинг его необходимо осуществлять компонентом [[Общие компоненты сценариев|Разбор текста]]


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

'''Свойства''':


{| border="1" cellpadding="20" cellspacing="0"
|Контент
|Переменная, содержащая переданный в сценарий контент. Заполняется в компоненте «Старт».
|-
|Параметр
|Одна из множества содержащихся в контенте величин:
* Направление звонка; 
* Время начала; 
* Время окончания; 
* Идентификатор линии; 
* Номер линии; 
* Идентификатор цепочки коммутаций; 
* Номер абонента (CallerId); 
* Внешний номер; 
* Количество коммутаций; 
* Количество коммутаций с оператором; 
* Количество коммутаций с IVR; 
* Общее время в секундах; 
* Обработка в задаче; 
* Идентификатор проекта; 
* Идентификатор задачи; 
* Имя задачи; 
* Код задачи; 
* Время в задаче в секундах; 
* Время начала задачи; 
* Код абонента в списке задачи; 
Тип возвращаемого значения строковый или числовой.
|- 
|Переменная
|Переменная, в которую производится выгрузка значения.
|-
|Переход
|Компонент, на который передается управление.
|-
|Имя
|Название компонента для отображения в визуальной среде и выбора в списке.
|}

 

[[Файл:cl_cc_scr_i39.png|left]] 
===Дозвон===

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

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

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

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


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

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

 
'''Свойства''':


{| border="1" cellpadding="20" cellspacing="0"
|Номер/команда
|Аргумент, определяющий номер, по которому производить дозвон. 
В качестве номера может быть принята команда (строка, содержащая DTMF символы и командные спец. символы w, q, z, {, }). Подробнее о командах в разделе [[Линии|Администрирование. Направления]]
|-
|Среда
|Внешняя сеть / Внутренний номерной план.
Определяет в каком направлении осуществлять вызов. При вызове внутреннего абонента осуществляется  его соединение с указанным IVR сценарием. При вызове внешнего абонента существуют разновидности (свойство «Обслуживание»).
|-
|Обслуживание
|IVR / Управляющий модуль / Управляющий модуль с ожиданием в сценарии. 
Вариант использования компонента в режиме набора номера. Различие в режимах описано выше.
|-
|Тип команды
|Доступно только в режиме набора номера во внешнюю сеть.
Определяет способ преобразования номера в команду, отсылаемую на набор. По умолчанию без преобразования.
* Без преобразования. Отправляет номер как есть в зарезервированную линию. 
* Использовать команду [[Линии|направления]]. Если зарезервированная линия взята из направления, и в нем  настроено преобразование номера, то перед отправкой на набор номер будет преобразован в строку-команду по указанной в направлении схеме.[[Линии|Подробно здесь]].  
В некоторых случаях преобразование номера в команду может быть произведено предварительно в самом сценарии, или вовсе команда как итог может быть указана в таблице абонентов (номер в чистом виде - частный случай команды). В этом случае дополнительно преобразовывать команду не следует, и стоит оставить режим "без преобразования". Конечный режим реализации зависит от задач и целей.
|-
|Тип вызова
|Доступно только в режиме набора номера во внешнюю сеть.
Обычный / экстренный.
Набор в экстренном режиме при отсутствии свободных линий среди назначенных будет производить разрыв активных коммутаций с целью освобождения внешней линии для совершения этого звонка.

<span style="color:red;">ВНИМАНИЕ! Значение «экстренный» следует выставлять в [[Экстренные номера|сценарии набора экстренных номеров]]. В других случаях рекомендуется оставлять тип со значением по умолчанию «обычный». Возможны вариации, но их следует  тщательно продумывать во избежание незапланированных разрывов.

Подробно об экстренных номерах в разделах [[Внутренние номера|Администрирование. Внутренние номера. Экстренные]] и [[Экстренные номера|Администрирование. Общие настройки. Экстренные номера]].
|- 
|Линии, направления
|Осуществляет выбор линий и направлений для осуществления звонка во внешнюю сеть

На вкладке «Список объектов» предоставляется возможность указать явно последовательность существующих в системе линий и [[Линии|направлений]] для осуществления звонка. Можно отключить использование некоторых элементов, а для выбранных установить последовательность поиска свободной линии. 
Поиск свободной будет осуществляться в соответствии с установленной последовательностью. По каждому направлению анализируются все линии, входящие в его состав. Если линия присутствует в нескольких направлениях, то при обнаружении ее свободной и установленном в компоненте режиме преобразования номера в соответствии с командой направления, будет применена команда того направления, которое в перечислении находится выше по приоритету.
На вкладке «Аргумент» возможно динамическое указание линии через ее код или Guid-идентификатор в строковом представлении. Также здесь может быть указан идентификатор или код направления, потока или шлюза. В этом случае будут последовательно перебираться все линии указанного объекта до обнаружения свободной и готовой к совершению вызова. Режим введен для использования совместно со [[Свойства компонентов|шлюзами с динамической регистрацией потоков]] и компонентом сценариев [[Общие компоненты сценариев|Регистрация потока]].
|-
|Идентификатор выбранной линии в переменную
|Устанавливает строковую переменную, в которую происходит сохранение GUID-идентификатора выбранной для звонка линии. Если звонок не произведен, в переменную заносится пустота.
|-
|Фильтровать по правам
|Доступно только при наборе номера во внешнюю сеть в режиме обслуживания в управляющем модуле.
Да/нет. При задействовании режима в случае, если осуществляется обработка канала пользователя системы, может быть осуществлена дополнительная фильтрация перечисленных в компоненте линий в соответствии с настройками [[Права|прав выхода на внешние линии]] для пользователя. По умолчанию «Да» - фильтровать.
|-
|CallerId
|Подставляемый для звонка номер. При отсутствии или некорректном значении будет взят номер по умолчанию для канала.
|- 
|Сценарий IVR
|Доступно только в режиме обслуживания в IVR (внешние и внутренние вызовы).
Название сценария, который будет запущен после снятия трубки абонентом.
|-
|Очередь ожидания
|Активировать ли очередь ожидания для внутреннего переключения в случае, если номер занят.
Поле доступно только при выборе значения «Внутренний номерной план» в свойстве «Среда».
|-
|Параметр запуска IVR
|Доступно только в режиме обслуживания в IVR (внешние и внутренние вызовы).
Параметр, который будет передан на старт сценария IVR.
|-
|Время ожидания, сек
|Аргумент определяет, сколько секунд необходимо ожидать соединения перед отбоем.
|- 
|Переход
|Компонент, на который передается управление в случае успешного выполнения поставленной задачи (в соответствии с режимом - либо ответ абонента и соединение со сценарием IVR, либо отправка команды на набор и передача линии на обслуживание в управляющий модуль). 
|-
|Переход, занято
|Доступно только в режиме обслуживания в IVR (внешние и внутренние вызовы).
Компонент, на который передается управление, если номер занят.
Свойство доступно только если установлен режим обслуживания в сценарии IVR.
|-
|Переход, не отвечает
|Доступно только в режиме обслуживания в IVR (внешние и внутренние вызовы).
Компонент, на который передается управление, если время ожидания ответа истекло.
Свойство доступно только если установлен режим обслуживания в сценарии IVR.
|- 
|Переход, линия не найдена
|Доступно только в режиме обслуживания в IVR (внешние вызовы).
Компонент, на который передается управление, если не обнаружена доступная для совершения вызова внешняя линия из списка направлений.
|-
|Переход, ошибка
|Доступно только в режиме обслуживания в IVR (внешние и внутренние вызовы).
Компонент, на который передается управление, если в ходе проверки корректности установки свойств, набора номера, ожидания событий или передачи управления возникли сбои.
|-
|Имя
|Название компонента для отображения в визуальной среде и выбора в списке.
|}