Веб-формы
Бипиум позволяет открывать карточку записи и создания новой записи в сторонних приложениях и сайтах. При этом открывается не весь интерфейс Бипиум, а только анкета записи — веб-форма.
Доступ к веб-формам
Бипиум принимает запросы только от авторизованных пользователей и перед отображением веб-формы проверяет права на доступ к данным. Об автоматической авторизации рассказано ниже.
Ссылку на веб-форму можно скопировать в окне доступа к каталогу или записи.
Типы веб-форм
Создание новой записи
Форма для создания новой записи в каталоге. Страница откроется, если у сотрудника есть право на создание записей в каталоге.
Адрес страницы:
http://ВАШДОМЕН.bpium.ru/?action=record-new&catalog=КАТАЛОГ
Параметры:
ВАШДОМЕН — адрес вашего Бипиума
КАТАЛОГ — номер (идентификатор) каталога
Пример:
http://test.bpium.ru/?action=record-new&catalog=7
Редактирование существующей записи
Форма для просмотра и изменения определённой записи в каталоге. Страница откроется, если у сотрудника есть право видеть эту запись или более высокая привилегия. Если у сотрудника есть право изменять запись — он сможет изменять данные записи.
Адрес страницы:
http://ВАШДОМЕН.bpium.ru/?action=record-open&catalog=КАТАЛОГ&record=ЗАПИСЬ
Параметры:
ВАШДОМЕН — адрес вашего Бипиума
КАТАЛОГ — номер (идентификатор) каталога
ЗАПИСЬ — номер (идентификатор) записи
Пример:
http://test.bpium.ru/?action=record-open&catalog=7&record=12
Стиль формы
В Бипиуме созданы 2 вида отображения веб-формы: в окне и во весь экран.
Форма в окне
Вид по умолчанию.
Форма во весь экран
Чтобы показать форму во весь экран, передайте параметр &screen=full
в конце адреса.
Пример:
http://test.bpium.ru/?action=record-new&catalog=7&screen=full
Автоматическая авторизация
Бипиум показывает веб-формы только авторизованным пользователям. Если сотрудник не авторизован, то его учётные данные можно передать автоматически — через адрес страницы (базовая авторизация через URL).
Формат:
http://ВАШДОМЕН.bpium.ru/?login=ЛОГИН&password=ПАРОЛЬ
Параметры:
ЛОГИН — адрес электронной почты для входа в Бипиум
ПАРОЛЬ — пароль для входа в Бипиум
ВАШДОМЕН — адрес вашего Бипиума
Вне зависимости от протокола автоматическая авторизация не работает в тегах <iframe>.
Если открыть страницу без авторизации, Бипиум покажет окно ввода логина и пароля.
Безопасность данных для формы создания записи
В Бипиуме привилегия «Создавать записи» включает право изменять все записи каталога. Это значит, что размещать форму на сайте без дополнительной настройки не безопасно.
Для защиты данных настройте права пользователя: 1. Удобнее всего для таких запросов завести отдельного сотрудника 2. Не давайте права этому сотруднику (и его правовым группам) на каталог и отдел 3. Создайте правовой вид, в который не попадёт ни одна запись каталога (с помощью невыполнимых условий фильтра). Сохраните вид и дайте право этому пользователю «создавать записи». Таким образом, пользователь не сможет видеть записи каталога, но сможет создавать новые.
Пример размещения формы на сайте
Для размещения формы на сайте вставьте этот код в то место страницы, в котором вы хотите показать форму.
Укажите домен, каталог и авторизационные данные. Не забудьте, что код веб-страниц открытый и любой посетитель сможет увидеть ваши авторизационные данные. Поэтому для размещения используйте данные специального пользователя и настройте его права.
Last updated