Как включить интеграцию с Doc.one?
Вы можете включить интеграцию с Doc.one в разделе Администрирование — Приложения.
Подключение интеграции с Doc.one выполняется в два этапа:
- Создание учетной записи приложения Case.one (клиента) в Doc.one и получение данных клиента для подключения.
- Включение интеграции с Doc.one в разделе Администрирование — Приложения в Case.one.
Для получения параметров Name (Идентификатор приложения), Secret (Защитный ключ):
- Создайте клиента (учетную запись Case.one в Doc.one) с помощью пользователя Doc.one с ролью Администратор.
- Выполните скрипты в PowerShell для создания клиента через вызов метода API регистрации нового клиента (в параметрах метода необходимо передать полный адрес API аутентификации подключаемого клиента Doc.one).
- Скопируйте данные для подключения: Name (Идентификатор приложения), Secret (Защитный ключ). Данные можно получить по адресу https://ИНСТАНС DOC.ONE/oauth/clients после выполнения скриптов PowerShell или при наличии уже зарегистрированных клиентов.
Для включения интеграции в Case.one:
- Выберите пункт Приложения в меню раздела Администрирование.
- Нажмите кнопку Подключить.
- В открывшемся окне заполните следующие данные:
- URL Doc.one — адрес Doc.one (URL должен начинаться с http:// или https://)
- Идентификатор приложения
- Защитный ключ — защищенный ключ приложения
- Нажмите кнопку Сохранить. Выполнится проверка заполнения полей и попытка перейти в Doc.one для выполнения oAuth-авторизации:
- Если URL Doc.one не соответствует маске (не начинается с http:// или https://), отобразится ошибка
- Если пройдены проверки полей на стороне Case.one, данные будут отправлены в Doc.one, после чего выполнится авторизация уже на стороне Doc.one (подключение выполняется только от имени администратора аккаунта Doc.one)
При первом подключении интеграции отобразится окно авторизации — нажмите кнопку Authorize.
Особенности подключения и самой интеграции:
- Приложение перейдет в статус Подключено только после получения токена доступа от Doc.one.
- Подключение выполняется отдельно для каждого инстанса.
- Несколько инстансов Case.one могут быть подключены к одному аккаунту Doc.one.
- После выполнения подключения Doc.one кнопка Отключить не активна.
- После подключения все шаблоны из Doc.one будут переданы в Case.one (даже те, в которых нет ни одной переменной: например, вопрос, поле, блок). В дальнейшем — только в результате синхронизации по вебхукам.
- Редактор документа Doc.one (документы с расширением .docx) открывается в iframe в новой вкладке.
- Если пользователь не зарегистрирован в Doc.one, он будет создан автоматически.
Для отключения Doc.one необходимо в настройках БД изменить статус приложения Doc.one.