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

Материал из Oktell
Перейти к: навигация, поиск

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


Cl cc scr i91.png

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

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

Свойства:


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

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

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


Cl cc scr i92.png

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

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


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

Свойства:


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

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

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


Cl cc scr i39.png

Дозвон

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

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

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

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


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

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


Свойства:


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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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