Компоненты служебных сценариев — различия между версиями
Peter (обсуждение | вклад) |
Peter (обсуждение | вклад) |
||
| Строка 1: | Строка 1: | ||
| − | |||
[[Служебные_сценарии|Наверх]] | [[Служебные_сценарии|Наверх]] | ||
| Строка 6: | Строка 5: | ||
| − | + | __TOC__ | |
| − | + | ||
| + | |||
| + | |||
| + | [[Файл:cl_cc_scr_i91.png|left]] | ||
| + | ===Сохранение контента=== | ||
Версия 12:07, 12 сентября 2012
В данном разделе в справочном порядке приведены лишь узкоспециализированные компоненты, доступные только служебным сценариям. Остальные компоненты являются общими для всех типов сценариев и описаны выше в разделе Общие компоненты сценариев
Сохранение контента
Компонент служит для сохранения переданного ему на старт контента в файл. Сбор таких файлов может быть необходим для последующих задач обработки и тарификации. Файлы могут быть сохранены в текстовом и xml виде. Их дальнейшую обработку может взять на себя или отдельный процесс, или служебный сценарий с таймерной активацией.
Свойства:
| Контент | Переменная, содержащая переданный в сценарий контент. Заполняется в компоненте «Старт». |
| Тип файла | Текст / XML. |
| Файл | Аргумент, определяющий путь к файлу. Доступна генерация случайных имен (включающих время). |
| Добавлять в конец | Да/нет. Определяет способ формирования файла. Включение режима дописывает в конец к выбранному файлу информацию. Работает только при сохранении в текстовые файлы. Актуально только при настройке записи в один и тот же файл с целью избежания затирания предыдущей информации.
Поле доступно только при выборе значения «Текст» в свойстве «Тип файла». |
| Имя файла в переменную | В указанную переменную будет занесено название файла (или путь), в который было произведено сохранение. |
| Возвращать полный путь | Да/нет. При выборе пункта «Да» в переменную будет сохранен полный путь, иначе только имя файла. |
| Переход | Компонент, на который передается управление. |
| Имя | Название компонента для отображения в визуальной среде и выбора в списке. |
Парсинг контента
С версии 100120 ликвидирован. Контент преобразован к XML-виду, парсинг его необходимо осуществлять компонентом Разбор текста
Компонент служит для принятия решения в сценарии на основе содержащейся в контенте информации. Производит выделение из контента интересующего значения, такого как номер линии, время звонка и др.
Свойства:
| Контент | Переменная, содержащая переданный в сценарий контент. Заполняется в компоненте «Старт». |
| Параметр | Одна из множества содержащихся в контенте величин:
Тип возвращаемого значения строковый или числовой. |
| Переменная | Переменная, в которую производится выгрузка значения. |
| Переход | Компонент, на который передается управление. |
| Имя | Название компонента для отображения в визуальной среде и выбора в списке. |
Дозвон
Служебный сценарий не связан ни с какой линией, однако он может инициировать звонок на внешнее направление. Компонент позволяет осуществить вызов абонента и в зависимости от свойств либо дождаться ответа абонента и передать управление линией в сценарий IVR, либо запустить набор во внешнюю сеть и сразу же передать инициативу во внешний управляющий модуль (например менеджер задач) с моментальным переходом к следующему компоненту сценария, либо запустить набор и дождаться ответа, после чего передать инициативу во внешний управляющий модуль (например конференцию при вызове внутренних).
В ходе дозвона во внешнюю сеть производится поиск свободной внешней линии в соответствии с установленным списком, резервирование, набор номера. Далее в случае передачи управления внешней линией в сценарий IVR осуществляется ожидание ответа в течение установленного интервала времени (по умолчанию 40 секунд) и дальнейший запуск указанного обслуживающего сценария. В случае передачи управления в вышестоящий менеджер, ожидание ответа абонента осуществляется уже в нем, а сценарий после отправки номера на набор сразу сразу переходит к следующему компоненту.
Использование в режиме вышестоящего управляющего модуля происходит при активации режима набора номеров через сценарий в сервисе автодозвона, в голосовых задачах, в конференции. Например, может стоять задача жесткой маршрутизации звонков. В задаче указывается перечень равноправных линий, однако мобильные номера необходимо набирать через GSM-шлюз, внутригородские через городскую АТС, междугородние через SIP-соединения или через городскую АТС с использованием городской IP-телефонии. Для решения этой задачи может быть организован служебный сценарий, который в соответствии с переданным на его старт номером осуществляет маршрутизацию, выбор направлений, преобразование номера в команду, резервирование и отправку строки-команды на набор. Сценарий устанавливается как способ набора номеров в задачах (могут быть установлены различные сценарии в разных задачах) или при автодозвоне. После отправки команды-номера на набор управляющий модуль берет на себя задачу ожидания ответа линии, а сценарий либо завершается, либо производит дальнейшие необходимые действия, связанные с контекстом своего исполнения. Естественно, сценарий для определения способа маршрутизации и преобразования может использовать всю доступную информацию: время, номер, задача/пользователь, информация во внешних источниках (web, БД) и т.д. В компоненте устанавливается список внешних линий и направлений, отсортированных в соответствии с приоритетом выделения. Может быть задействован дополнительный фильтр по правам внешнего объекта (задачи или пользователя), то есть могут быть исключены те линии, которые не присутствуют в ресурсах инициирующей дозвон задачи или в правах инициирующего автодозвон пользователя. Преобразование номера в команду может быть произведено направлением, в котором зарезервирована свободная линия. Также преобразование может быть выполнено предварительно в текущем сценарии, а на набор передано без изменений.
Использование в режиме вышестоящего управляющего модуля с ожиданием в сценарии требуется при реализации приглашений внутренних номеров в конференцию через служебный сценарий (задается в общих настройках), а также при активации режима набора внутренних номеров в автодозвоне через служебный сценарий (задается в общих настройках). При этом в самом служебном сценарии может происходить набор как внешних, так и внутренних номеров - важно только, чтобы в качестве значения свойства «Обслуживание» был выбран режим «управляющий модуль с ожиданием в сценарии».
В одном обработчике сценария может быть успешно выполнено сколько угодно компонентов «Дозвон» с режимом обслуживания в IVR, но только один с режимом обслуживания в вышестоящем управляющем модуле. Остальные будут фильтроваться.
В случае ожидания в сценарии и обслуживания в вышестоящем управляющем модуле - может быть использовано множество компонентов с последовательно неудачными ответами и только один удачный, после чего будет включена фильтрация.
Свойства:
| Номер/команда | Аргумент, определяющий номер, по которому производить дозвон.
В качестве номера может быть принята команда (строка, содержащая DTMF символы и командные спец. символы w, q, z, {, }). Подробнее о командах в разделе Администрирование. Направления |
| Среда | Внешняя сеть / Внутренний номерной план.
Определяет в каком направлении осуществлять вызов. При вызове внутреннего абонента осуществляется его соединение с указанным IVR сценарием. При вызове внешнего абонента существуют разновидности (свойство «Обслуживание»). |
| Обслуживание | IVR / Управляющий модуль / Управляющий модуль с ожиданием в сценарии.
Вариант использования компонента в режиме набора номера. Различие в режимах описано выше. |
| Тип команды | Доступно только в режиме набора номера во внешнюю сеть.
Определяет способ преобразования номера в команду, отсылаемую на набор. По умолчанию без преобразования.
В некоторых случаях преобразование номера в команду может быть произведено предварительно в самом сценарии, или вовсе команда как итог может быть указана в таблице абонентов (номер в чистом виде - частный случай команды). В этом случае дополнительно преобразовывать команду не следует, и стоит оставить режим "без преобразования". Конечный режим реализации зависит от задач и целей. |
| Тип вызова | Доступно только в режиме набора номера во внешнюю сеть.
Обычный / экстренный / интерком. Набор в экстренном режиме при отсутствии свободных линий среди назначенных будет производить разрыв активных коммутаций с целью освобождения внешней линии для совершения этого звонка. ВНИМАНИЕ! Значение «экстренный» следует выставлять в сценарии набора экстренных номеров. В других случаях рекомендуется оставлять тип со значением по умолчанию «обычный». Возможны вариации, но их следует тщательно продумывать во избежание незапланированных разрывов. Подробно об экстренных номерах в разделах Администрирование. Внутренние номера. Экстренные и Администрирование. Общие настройки. Экстренные номера. Интерком-вызов имеет отличие от обычного, если функция поддерживается конечным устройством. В противном случае вызов будет происходить в обычном режиме. При интерком-вызове телефонное устройство снимает трубку автоматически сразу же после поступления звонка. |
| Линии, направления | Осуществляет выбор линий и направлений для осуществления звонка во внешнюю сеть
На вкладке «Список объектов» предоставляется возможность указать явно последовательность существующих в системе линий и направлений для осуществления звонка. Можно отключить использование некоторых элементов, а для выбранных установить последовательность поиска свободной линии. Поиск свободной будет осуществляться в соответствии с установленной последовательностью. По каждому направлению анализируются все линии, входящие в его состав. Если линия присутствует в нескольких направлениях, то при обнаружении ее свободной и установленном в компоненте режиме преобразования номера в соответствии с командой направления, будет применена команда того направления, которое в перечислении находится выше по приоритету. На вкладке «Аргумент» возможно динамическое указание линии через ее код или Guid-идентификатор в строковом представлении. Также здесь может быть указан идентификатор или код направления, потока или шлюза. В этом случае будут последовательно перебираться все линии указанного объекта до обнаружения свободной и готовой к совершению вызова. Режим введен для использования совместно со шлюзами с динамической регистрацией потоков и компонентом сценариев Регистрация потока. |
| Идентификатор выбранной линии в переменную | Устанавливает строковую переменную, в которую происходит сохранение GUID-идентификатора выбранной для звонка линии. Если звонок не произведен, в переменную заносится пустота. |
| Фильтровать по правам | Доступно только при наборе номера во внешнюю сеть в режиме обслуживания в управляющем модуле.
Да/нет. При задействовании режима в случае, если осуществляется обработка канала пользователя системы, может быть осуществлена дополнительная фильтрация перечисленных в компоненте линий в соответствии с настройками прав выхода на внешние линии для пользователя. По умолчанию «Да» - фильтровать. |
| CallerId | Подставляемый для звонка номер. При отсутствии или некорректном значении будет взят номер по умолчанию для канала. |
| CallerName | Подставляемый для звонка имя. |
| Сценарий IVR | Доступно только в режиме обслуживания в IVR (внешние и внутренние вызовы).
Название сценария, который будет запущен после снятия трубки абонентом. |
| Очередь ожидания | Активировать ли очередь ожидания для внутреннего переключения в случае, если номер занят.
Поле доступно только при выборе значения «Внутренний номерной план» в свойстве «Среда». |
| Параметр запуска IVR | Доступно только в режиме обслуживания в IVR (внешние и внутренние вызовы).
Параметр, который будет передан на старт сценария IVR. |
| Время ожидания, сек | Аргумент определяет, сколько секунд необходимо ожидать соединения перед отбоем. |
| Переход | Компонент, на который передается управление в случае успешного выполнения поставленной задачи (в соответствии с режимом - либо ответ абонента и соединение со сценарием IVR, либо отправка команды на набор и передача линии на обслуживание в управляющий модуль). |
| Переход, занято | Доступно только в режиме обслуживания в IVR (внешние и внутренние вызовы).
Компонент, на который передается управление, если номер занят. Свойство доступно только если установлен режим обслуживания в сценарии IVR. |
| Переход, не отвечает | Доступно только в режиме обслуживания в IVR (внешние и внутренние вызовы).
Компонент, на который передается управление, если время ожидания ответа истекло. Свойство доступно только если установлен режим обслуживания в сценарии IVR. |
| Переход, линия не найдена | Доступно только в режиме обслуживания в IVR (внешние вызовы).
Компонент, на который передается управление, если не обнаружена доступная для совершения вызова внешняя линия из списка направлений. |
| Переход, ошибка | Доступно только в режиме обслуживания в IVR (внешние и внутренние вызовы).
Компонент, на который передается управление, если в ходе проверки корректности установки свойств, набора номера, ожидания событий или передачи управления возникли сбои. |
| Имя | Название компонента для отображения в визуальной среде и выбора в списке. |
Коммутатор
Компонент осуществляет вызов двух абонентов и соединяет их между собой в коммутацию. Имеет возможность вызывать сразу группу, из которых в качестве абонента принимается первый ответивший. Поддерживает вызовы внутренних пользователей, внешних номеров, быстрых и экстренных номеров, внутренних номеров, IVR-сценариев. При вызове внешних номеров использует сценарий набора внешних/быстрых номеров, если тот установлен в разделе общих настроек.
Свойства:
| Детальная настройка | Да/нет.
Позволяет включить режим детальной настройки параметров вызова с помощью XML. По умолчанию «Нет». |
| Абоненты А | Недоступно, если включена детальная настройка.
Аргумент, определяющий первого абонента предстоящей коммутации. В качестве абонента может выступать ключ пользователя (идентификатор, имя, логин), ключ линии (идентификатор, номер), внутренний стандартный номер, быстрый/экстренный номер, внешний номер, а также любая их комбинация через запятую. В случае указания группы или нескольких абонентов в предстоящей коммутации будет участвовать первый ответивший абонент среди перечисленных. |
| Абоненты Б | Недоступно, если включена детальная настройка.
Аргумент, определяющий второго абонента предстоящей коммутации. Указание аналогично абоненту А. |
| Последовательность | Недоступно, если включена детальная настройка.
На время ожидания запускается альтернативная мелодия. |
| CallerId для А | Недоступно, если включена детальная настройка.
Аргумент, определяющий CallerId, с указанием которого осуществляется вызов абонентов группы А |
| CallerId для Б | Недоступно, если включена детальная настройка.
Аргумент, определяющий CallerId, с указанием которого осуществляется вызов абонентов группы Б |
| Запись | Недоступно, если включена детальная настройка.
Параметр, определяющий необходимость записи. По умолчанию выбран вариант «Согласно настройкам», при котором используется стандартная процедура поиска правил записи для звонка. Также доступны варианты «Записывать» и «Не записывать», производящие соответствующие безусловные действия. |
| Параметры | Доступно, если включена детальная настройка.
Аргумент (по умолчанию выражение), определяющий все параметры осуществления коммутации. При начальной настройке выражение содержит полный перечень возможных тегов, часть из которых может быть удалена безболезненно. Обязательны к указанию только группы абонентов (agroup и bgroup) и режим (mode). Установке/изменению доступны:
|
| Переход | Компонент, на который передается управление после успешного завершения работы компонента. |
| Ожидать отчета | * Да, полный отчет. Компонент ожидает коммутации или неудачи, после чего сохраняет отчет в переменную.
|
| Отчет в переменную | Доступно, если активировано ожидание отчета или результата.
Переменная, в которую сохраняется результат в зависимости от выбранного типа.
|
| Переход | Компонент, на который передается управление после успешного завершения работы компонента. |
| Переход, ошибка | Доступно, если не активировано ожидание отчета или результата.
Компонент, на который передается управление после неудачи запуска. Ограничивается только начальной проверкой, корректным заданием настроек. |
| Имя | Название компонента для отображения в визуальной среде и выбора в списке. |
