Интеграция с Doc.one

Как включить интеграцию с Doc.one?

Вы можете включить интеграцию с Doc.one в разделе АдминистрированиеПриложения.


Подключение интеграции с Doc.one выполняется в два этапа:

  1. Создание учетной записи приложения Case.one (клиента) в Doc.one и получение данных клиента для подключения.
  2. Включение интеграции с Doc.one в разделе Администрирование Приложения в Case.one.

Для получения параметров Name (Идентификатор приложения), Secret (Защитный ключ):

  1. Создайте клиента (учетную запись Case.one в Doc.one) с помощью пользователя Doc.one с ролью Администратор.
  2. Выполните скрипты в PowerShell для создания клиента через вызов метода API регистрации нового клиента (в параметрах метода необходимо передать полный адрес API аутентификации подключаемого клиента Doc.one).
  3. Скопируйте данные для подключения: Name (Идентификатор приложения), Secret (Защитный ключ). Данные можно получить по адресу https://ИНСТАНС DOC.ONE/oauth/clients после выполнения скриптов PowerShell или при наличии уже зарегистрированных клиентов.

Для включения интеграции в Case.one:

  1. Выберите пункт Приложения в меню раздела Администрирование.
  2. Нажмите кнопку Подключить.
  3. В открывшемся окне заполните следующие данные:
    • URL Doc.one — адрес Doc.one (URL должен начинаться с http:// или https://)
    • Идентификатор приложения
    • Защитный ключ — защищенный ключ приложения
  4. Нажмите кнопку Сохранить. Выполнится проверка заполнения полей и попытка перейти в 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.