Компонент Операция

Описание

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

Table 1. Системные характеристики

Индекс

219

Краткое название

operation

Типы сценариев

svc, chatbot

Стартовый модуль

r_script_component_operation_ivr

Режим

Асинхронный

Иконка

219

Характер разветвления

Разветвляющий, замыкающий

Свойства

Table 2. Свойства
Спецификация Описание

Название: Тип операции
Код: type
Усл. видимости: нет
По умолчанию: CRUD в домене

Выбор категории операций.
Возможные значения:

  • CRUD в домене (crud, 0) – Группа операции над сущностями доменов (чтение, создание, модификация, удаление). Операция возможна только над классами, управляемыми доменным центром (функциональные роли mdc, sdc).

  • Регистрар (registrar,5) - Данные из регистрара.

  • Привязка звонка (bindings, 1) – Проставление метки в контекст к текущему звонку. Особенность метки в том, что она переходит от одного звонка к другому при переключениях (SIP REFER).

  • Подтверждение оповещения (approve, 2) – Регистрация состояния успешного результата оповещения в канале для сервиса оповещений.

  • Управление звонком (callmanager, 3) – Группа операций логического управления звонками и конференциями.

  • Скачать запись разговора (records, 4) - Скачивает запись разговора с хранилища записей и размещает во временном каталоге сценария, записывая специальный путь к файлу в переменную с результатом.

Название: Домен
Код: crudDestTD
Усл. видимости: да
По умолчанию: Сценария

Выбор домена, в котором проводится операция.
Применяется для операций категории CRUD в домене.
Возможные значения:

  • Сценария (same, 0) – Домен текущего сценария.

  • Другой (specified, 1) – Указать домен.

Название: Имя домена
Код: crudDomain
Усл. видимости: да
По умолчанию: — 

Аргумент, содержащий имя домена для осуществления операции над сущностями. Допускается только указание доменов из дочернего дерева.
Применяется для операций категории CRUD в домене.

Название: Логин пользователя
Код: crudUser
Усл. видимости: да
По умолчанию: — 

Аргумент, содержащий логин пользователя в домене.
Применяется для операций категории CRUD в домене.

Название: Тип сущности
Код: crudObject
Усл. видимости: да
По умолчанию: — 

Аргумент, содержащий имя класса сущностей.
Применяется для операций категории CRUD в домене.

Название: Метод
Код: crudOperation
Усл. видимости: да
По умолчанию: Создать

Выбор операции.
Возможные значения:

  • Создать (create, 0) – Создание сущности.

  • Получить (read, 1) – Получение набора сущностей.

  • Обновить (update, 2) – Изменение сущности.

  • Удалить (delete, 3) – Удаление сущности.

Применяется для операций категории CRUD в домене.

Название: Данные
Код: crudData
Усл. видимости: да
По умолчанию: — 

Применяется для операций категории CRUD в домене.

Название: Фильтр
Код: crudFilter
Усл. видимости: да
По умолчанию: — 

Поисковый фильтр для операции получения сущностей категории CRUD в домене.
Указывается в виде JSON-структуры, содержащей объект. Порядок указания и применения (параметр filter).

Название: Сортировка
Код: crudSort
Усл. видимости: да
По умолчанию: — 

Режим сортировки для операции получения сущностей категории CRUD в домене.
Указывается в виде JSON-структуры, содержащей массив. Порядок указания и применения (параметр order).

Название: Доп.параметры
Код: crudParam
Усл. видимости: да
По умолчанию: — 

Дополнительные параметры операции выборки данных категории CRUD в домене.
Дополнительные поля: offset, limit и т.д. Порядок указания и применения.

Название: Поля
Код: crudFields
Усл. видимости: да
По умолчанию: — 

Маска выдачи объектов (поля) для операции получения сущностей категории CRUD в домене.
Указывается в виде JSON-структуры, содержащей объект. Порядок указания и применения (параметр mask).

Название: Тип сущности
Код: regType
Усл. видимости: да
По умолчанию: — 

Выбор из списка видов регистрируемых сущностей".
Возможные значения:

  • Пользователи (user, 1) – Регистрации подключений пользователей.

  • SIP-пользователи (sipuser, 2) – Регистрации подключений SIP-устройств.

Применяется для операций категории Регистрар.

Название: Метод
Код: regOperationU
Усл. видимости: да
По умолчанию: Получить вебсокет подключения

Выбор операции.
Возможные значения:

  • Получить вебсокет подключения (read_user_websock_connections, 1) – Получение массива данных о вебсокет-подключениях в виде JSON.

  • Получить регистрации (read_user_registrations, 2) – Получение массива данных о регистрацих по HTTP в виде JSON.

Применяется для операций категории Регистрар для выбранного типа сущностей Пользователи.

Название: Метод
Код: regOperationSU
Усл. видимости: да
По умолчанию: Получить регистрации

Выбор операции.
Возможные значения:

  • Получить регистрации (read_user_registrations, 1) – Получение массива данных о регистрацих устройств.

Применяется для операций категории Регистрар для выбранного типа сущностей SIP-пользователи.

Название: Учетная запись
Код: regAccU
Усл. видимости: да
По умолчанию: — 

Аргумент, содержащий логин или идентификатор сущностий. Если значение пустое, то вернутся все записи.
Применяется для операций категории Регистрар для выбранного типа сущностей Пользователи.

Название: Учетная запись
Код: regAccSU
Усл. видимости: да
По умолчанию: — 

Аргумент, содержащий логин или идентификатор сущностий. Если значение пустое, то вернутся все записи.
Применяется для операций категории Регистрар для выбранного типа сущностей SIP-пользователи.

Название: Фильтр
Код: regFilter
Усл. видимости: да
По умолчанию: — 

Поисковый фильтр для операции получения сущностей категории Регистрар.
Указывается в виде JSON-структуры, содержащей объект. Порядок указания и применения (параметр filter).

Название: Сортировка
Код: regSort
Усл. видимости: да
По умолчанию: — 

Режим сортировки для операции получения сущностей категории Регистрар.
Указывается в виде JSON-структуры, содержащей массив. Порядок указания и применения (параметр order).

Название: Поля
Код: regFields
Усл. видимости: да
По умолчанию: — 

Маска выдачи объектов (поля) для операции получения сущностей категории Регистрар.
Указывается в виде JSON-структуры, содержащей объект. Порядок указания и применения (параметр mask).

Название: Доп.параметры
Код: regParam
Усл. видимости: да
По умолчанию: — 

Дополнительные параметры операции выборки категории Регистрар.
Дополнительные поля: offset, limit и т.д. Порядок указания и применения.

Название: Метод
Код: bindingOperation
Усл. видимости: да
По умолчанию: Добавить

Выбор операции с метками контекста звонка.
Применяется для операций категории Привязка звонка.
Возможные значения:

  • Добавить (add, 0) – Добавляет метку.

  • Удалить (remove, 1) – Удаляет метку.

  • Изменить (setx, 2) – Заменяет метку на новую.

  • Очистить (cleanup, 3) – Очищает метку.

  • Проверить (contains, 4) – Проверяет наличие указанной метки и возвращает 1 или 0.

  • Получить (get, 5) – Возвращает метку.

Название: Метка
Код: bindingLabel
Усл. видимости: да
По умолчанию: — 

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

Название: Метод
Код: callmanagerOperation
Усл. видимости: да
По умолчанию: Поиск звонка

Выбор операции для управления звонком.
Применяется для операций категории Управление звонком.
Возможные варианты:

  • Поиск звонка (lookupcall, 9) – Возвращает идентификатор звонка (DialogId) по одному из ключевых значений: DialogId, InviteId, CallId одного из плеч, URI одного из плеч в формате <sip:Username@Domain> и др.

  • Поиск конференции (lookupconf, 10) – Возвращает идентификатор конференции (ConfId) по одному из ключевых значений: ConfId, номер комнаты, URI конференции.

  • Список звонков (listcalls, 11) – Возвращает список звонков в домене.

  • Список конференций (listconfs, 12) – Возвращает список идентификаторов конференций (ConfId) в домене.

  • Информация о звонке (getcall, 13) – Возвращает информацию о звонке.

  • Информация о конференции (getconf, 14) – Возвращает информацию о конференции.

  • Исходящий вызов (invite, 0) – Инициирует новый вызов от одного абонента к другому. Совершается сервисом IVR, который вызывает сначала одного абонента, а потом переключает его на другого с помощью SIP-запроса REFER.

  • Исходящий вызов от IVR (invitebyivr, 18) – Инициирует новый вызов и соединяет его с указанным сценарием IVR. Совершается сразу сервисом IVR. Абонент может быть указан как через номер, так и через учетную запись.

  • Завершение звонка (bye, 1) – Завершает указанный вызов или совокупность вызовов по указанному URI.

  • Уведомление (notify, 17) - Отправляет на устройство запрос NOTIFY с указанным в параметре event типом события (Например, расширение BroadSoft для управления устройством). Параметр callid указывает плечо, за которым находится конкретное устройство. Команда выполняется только если в соответствии с RFC3265 устройство сообщило о поддержке указанного типа событий (расширения). Опциональные параметры: body и contenttype.

  • Перевод на номер (refer, 2) – Осуществляет перевод абонента указанного звонка на указанный номер. Совершается сервисом IVR, который подменяет плечо (SIP-запрос INVITE+Replaces) и отправляет SIP-запрос REFER.

  • Перевод на IVR (refertoivr, 19) – Осуществляет перевод абонента указанного звонка на указанный сценарий IVR. Совершается сразу сервисом IVR, который подменяет плечо (SIP-запрос INVITE+Replaces).

  • Соединение (referreplaces, 3) – Осуществляет соединение абонентов двух разных звонков, отбивая оставшихся. Совершается сервисом IVR, который подменяет плечо (SIP-запрос INVITE+Replaces), после этого переводит на другого абоненета с помощью SIP-запроса REFER+Replaces.

  • Перевод на конференцию (referconf, 8) – Осуществляет переключение одного из абонентов указанного звонка на указанную конференцию. Если второй абонент держит конференцию на удержании, то ему остается нажать HOLD.

  • Преобразование в конференцию (switchconf, 4) – Осуществляет перевод обоих абонентов звонка в общую конференцию. Совершается сервисами IVR, каждый из которых подменяет отдельное плечо с помощью SIP-запроса INVITE+Replaces, и затем переводит на номер конференц-комнаты с помощью SIP-запроса REFER.

  • Остановка конференции (stopconf, 5) – Осуществляет завершение указанной конференции с автоматическим отключением всех участников.

  • Список участников (getparticipants, 15) – Возвращает список участников конференции.

  • Информация об участнике (getparticipant, 16) – Возвращает информацию об участнике конференции.

  • Присоединение участника (attachparticipant, 6) – Осуществляет исходящий вызов из указанной конференц на указанный номер.

  • Исключение участника (detachparticipant, 7) – Осуществляет отключение участника из конференции.

Название: Параметры (JSON)
Код: callmanagerParams
Усл. видимости: да
По умолчанию: — 

Параметры для операции управления звонком.
Значение для каждого из методов представляет собой JSON-структуру в виде объекта с содержанием, соответствущем API управления звонками и конференциями.
Применяется для операций категории Управление звонком.

Название: Домен
Код: selectorTD
Усл. видимости: да
По умолчанию: Сценария

Выбор домена, в котором проводится операция.
Применяется для операций категории Селекторные совещания.
Возможные значения:

  • Сценария (same, 0) – Домен текущего сценария.

  • Другой (specified, 1) – Указать домен.

Название: Имя домена
Код: selectorDestTD
Усл. видимости: да
По умолчанию: — 

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

Название: Логин пользователя
Код: selectorUser
Усл. видимости: да
По умолчанию: — 

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

Название: Метод
Код: selectorOperation
Усл. видимости: да
По умолчанию: Создание нового селектора

Выбор операции для управления селекторными совещаниями.
Применяется для операций категории Селекторные совещания. Соответствует API управления селектором.
Возможные варианты:

  • Создание нового селектора (createentity, 11) – Возвращает идентификатор селектора и статус.

  • Получение списка селекторов (readentitylist, 12) – Возвращает список селекторов.

  • Получение данных селектора (readentity, 13) – Возвращает информацию о конкретном селекторе.

  • Изменение данных селектора (updateentity, 14) – Заменяет переданные данные в селекторе. С помощью данного метода производится запуск и остановка селектора.

  • Удаление селектора (deleteentity, 15) – Удаляет селекторное совещание.

  • Добавление участника (createparticipant, 21) – Добавляет участника к выбранному селекторному совещанию. Возвращает идентификатор участника.

  • Получение списка участников (readparticipantlist, 22) – Возвращает список участников селекторного совещания.

  • Получение данных участника (readparticipant, 23) – Возвращает информацию участника совещания.

  • Изменение данных участника (updateparticipant, 24) – Изменение данных участника.

  • Удаление участника (deleteparticipant, 25) - Удаляет участника из селекторного совещания.

  • Создание нового голосования (createvotings, 41) – Создание нового голосования.

  • Получение списка голосований (readvotingslist, 42) – Получение списка голосований.

  • Получение данных голосования (readvotings, 43) – Получение данных голосования.

  • Изменение данных голосования (updatevotings, 44) – Изменение данных голосования.

  • Удаление голосования (deletevotings, 45) – Удаление голосования.

  • Получение топологии (readtopology, 33) – Возвращает информацию взаимодействия участников в селекторе.

  • Изменение топологии (updatetopology, 34) – Изменение топологии.

  • Сброс топологии в начальное состояние (deletetopology, 35) – Сброс топологии в начальное состояние.

Название: Параметры (JSON)
Код: selectorParams
Усл. видимости: да
По умолчанию: — 

Параметры для операции управления селекторными совещаниями.
Значение для каждого из методов представляет собой JSON-структуру в виде объекта с содержанием, соответствущем API управления селектором.

Для идентификации запросов необходимо задавать параметры id и/или idselector. На примере "Изменение данных участника": idselector - идентификатор селектора, а id - идентификатор участника.

Применяется для операций категории Селекторные совещания.

Название: Метод
Код: sipuserOperation
Усл. видимости: да
По умолчанию: Установка huntblock

Выбор операции.
Возможные значения:

  • Установка huntblock (huntblock, 0) – Установка huntblock.

  • Выборочный huntblock (huntblockpart, 1) – Выборочный huntblock.

Применяется для операции категории Управление sipuser.

Название: Логин или Id
Код: sipuserLoginOrId
Усл. видимости: да
По умолчанию: — 

Аргумент, содержащий логин или id сущности sipuser в домене.
Применяется для операции категории Управление sipuser.

Название: Тип таймаута
Код: sipuserHBStrat
Усл. видимости: да
По умолчанию: Заменить

Выбор операции.
Возможные значения:

  • Заменить (single_newexpire, 1) – Замена одиночного состояния на другое такое же с установкой нового таймера автоудаления.

  • Максимальный (single_maxexpire, 2) – Замена одиночного состояние на другое такое же с установкой таймера автоудаления на время равное max(остаток, новое время).

Применяется для операции категории Управление sipuser.

Название: Таймаут, сек.
Код: sipuserTTLSec
Усл. видимости: да
По умолчанию: — 

Время блокировки указанного sipuser для очередей huntq в секундах.

Применяется для операции категории Управление sipuser.

Название: Ханты
Код: sipuserHunts
Усл. видимости: да
По умолчанию: — 

Список кодов или идентификаторов объектов hunt (через запятую), к которым применяется выборочная блокировка указанного sipuser для очередей huntq.

Применяется для операций категории Управление sipuser с методом Выборочный huntblock.

Название: Комментарий
Код: sipuserComment
Усл. видимости: да
По умолчанию: — 

Комментарий блокировки указанного sipuser для очередей huntq.

Применяется для операции категории Управление sipuser.

Название: Ид хранилища
Код: recStorageId
Усл. видимости: да
По умолчанию: — 

Аргумент содержащий идентификатор/код хранилища.
Применяется для операции в категории Скачать запись разговора.

Название: Путь к записи в хранилище
Код: recPath
Усл. видимости: да
По умолчанию: — 

Аргумент, содержащий путь к файлу записи в хранилище.
Применяется для операции в категории Скачать запись разговора.

Название: Результат в переменную
Код: resultVariable
Усл. видимости: нет
По умолчанию: — 

Переменная для сохранения результата операции.

Название: Переход
Код: transfer``
Усл. видимости: нет
По умолчанию: — 

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

Название: Переход, время
Код: transferTimeout
Усл. видимости: нет
По умолчанию: — 

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

Название: Переход, ошибка
Код: transferError
Усл. видимости: нет
По умолчанию: — 

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

См. также