Comment on page
Компонент Bpium в Oktell
Компонент доступен в Oktell начиная с версии 2.13 от 23.12.2015.
В коммуникационную платформу Oktell встроен мощный механизм пользовательских скриптов — сценариев. Они выполняют различные действия при внешних событиях или по расписанию. Сценарии состоят из связанных компонентов, каждый из которых имеет свойства. Благодаря простой настройке сценариев в графическом редакторе, провести интеграцию сможет любой штатный специалист компании.

В сценариях Oktell несколько десятков компонентов: логических операций, компонентов для работы с телефонией, почтой, месенджерами, базами данных и файловой системой. Один из компонентов — «Запрос к Bpium».
Компонент позволяет работать с записями в Бипиуме:
- находить записи с определёнными свойствами
- получать конкретные записи по номеру
- создавать новые записи
- изменять записи
- удалять записи
Прежде чем начать использовать компонент в сценариях, настройте соединение Oktell с Бипиумом. Зайдите в общие настройки Oktell и укажите адрес вашего домена в Bpium, электронную почту и пароль пользователя, под которым Oktell будет обращаться к Бипиуму. Перед этим добавьте пользователя в качестве сотрудника в Бипиуме, или введите ваши авторизационные данные.

Формат указания домена: вашдомен.bpium.ru, либо полный адрес с указанием протокола и порта: https://вашдомен.ru.
После авторизации Oktell запросит у Бипиума структуру данных: секции, каталоги и виды. Если вы измените структуру данных в Бипиуме, то Oktell её обновит спустя несколько часов. Чтобы провести принудительную синхронизацию нажмите кнопку:

Свойства компонента Bpium

Работа с записями каталогов.
Находит и возвращает одну доступную запись, удовлетворяющую условиям поиска. Если требуется вернуть несколько — организуйте цикл в сценариях.
Раздел «Запрос»
- Секция: список доступных отделов в Бипиуме.
- Каталог: список доступных каталогов выбранного отдела.
- Вид: список доступных видов выбранного каталога.
- Сортировать по: поле каталога, по которому будет произведена сортировка.
- Очередность: порядок сортировк и.
- Содержит текст: быстрый поиск по текстовым полям каталога.
- Режим фильтра: список установленных фильтров:
- Без фильтра — не использовать фильтр
- Значение полей — включает режим задания фильтров в форме в свойстве «Условия фильтра»
- GET-параметры — расширенное задание фильтров согласно API
- Условия фильтра: форма для установки значений фильтра по полям каталога.
- Порядковый номер: номер записи в выборке, которую нужно вернуть. Используется для получения записей в цикле. по умолчанию возвращает первую (нулевую) запись.
- Сохранение полей: форма для назначения в какие переменные сценария сохранить значения полей записи.
Раздел «Подключение»
- Таймаут: время ожидания ответа. Если Бипиум не ответит за указанное время, компонент продолжит работу сценария по ветке таймаут. Измеряется в секундах.
Раздел «Результат»
- Ответ в переменную: запись в JSON-формате согласно API (метод Record/GET). Для получения значений полей записи используйте компонент сценариев «Парсер».
- Код ошибки в переменную: возврат кода ошибки, в случае её возникновения
- Переход: указание компонента, к которому перейдёт сценарий в случае успешного выполнения запроса.
- Переход, таймаут: указание компонента, к которому перейдёт сценарий в случае не выполнения запроса по таймауту.
- Переход, ошибка: указание компонента, к которому перейдёт сценарий в случае не выполнения запроса по ошибке.
Возвращает метаданные каталога: описание структуры полей и возможных значений.
Раздел «Запрос»
- Секция: список доступных отделов в Бипиуме.
- Каталог: список доступных каталогов выбранного отдела.
Раздел «Результат»
- Ответ в переменную: список полей каталога в JSON-формате согласно API (метод Catalog/GET). Для получения структуры отдельных полей и их свойств используйте компонент сценариев «Парсер».
Остальные параметры идентичны запросу метода «Найти запись».
Возвращает запись по её идентификатору.
Раздел «Запрос»
- Секция: список доступных отделов в Бипиуме.
- Каталог: список доступных каталогов выбранного отдела.
- ID записи: идентификатор (ID) записи в Бипиуме.
- Сохранение полей: форма для назначения в какие переменные сценария сохранить значения полей записи.
Раздел «Результат»
- Ответ в переменную: запись в JSON-формате согласно API (метод Record/GET). Для получения значений полей записи используйте компонент сценариев «Парсер».
Остальные параметры идентичны запросу метода «Найти запись».
Изменяет запись по её идентификатору.
Раздел «Запрос»
- Секция: список доступных отделов в Бипиуме.
- Каталог: список доступных каталогов выбранного отдела.
- ID записи: идентификатор (ID) записи в Бипиуме.
- Режим задания свойств: способ передачи значения полей:
- Значения полей — назначение значений через форму в свойстве «Поля»
- JSON-объект — передача значений через JSON согласно API
- Поля: форма для назначения значений полей из переменных. Если у поля не стоит галочка, то значение поля не будет изменено при сохранении.
- Данные записи (JSON): расширенный способ передачи значений полей через JSON-структуру согласно API.
Раздел «Результат»
- Ответ в переменную: ответ на запрос в JSON-формате согласно API (метод Record/PATCH).
Остальные параметры идентичны запросу метода «Найти запись».
Создает новую запись в каталоге.
Раздел «Результат»
- ID записи в переменную: возвращает идентификатор (ID) созданной записи в случае успеха.
- Ответ в переменную: ответ на запрос в JSON-формате согласно API (метод Record/POST).
Остальные параметры идентичны запросу метода «Изменить запись».
Удаляет запись по её идентификатору.
Раздел «Запрос»
- Секция: список доступных отделов в Бипиуме.
- Каталог: список доступных каталогов выбранного отдела.
- ID записи: идентификатор (ID) записи в Бипиуме.
Раздел «Результат»
- Ответ в переменную: ответ на запрос в JSON-формате согласно API (метод Record/DELETE).
Остальные параметры идентичны запросу метода «Найти запись».
Last modified 5yr ago