Документооборот для BPMSoft

  1. Главная
  2. Документы
  3. Документооборот для BPMSoft
  4. Установка продукта Документооборот для BPMSoft
  5. Дополнительные подключения
  6. Онлайн-редакторы и хранилища файлов

Онлайн-редакторы и хранилища файлов

Подключайте редактор и хранилище после первичной проверки Документооборота. Сначала определите, где должны храниться вложения и куда разрешено передавать файлы на редактирование. Затем выберите сценарий в таблице и проверьте, что правки сохраняются новой версией в BPMSoft.

Выберите способ редактирования

Способ Что настроить Где обрабатывается файл
Р7 Офис Сервер документов Разверните сервер и подключите Р7. В OnlineEditService выберите R7Office. На сервере Р7.
ONLYOFFICE Docs Разверните сервер и подключите ONLYOFFICE. В OnlineEditService выберите OnlyOffice. На сервере ONLYOFFICE Docs.
Яндекс.Диск Зарегистрируйте OAuth-приложение, заполните параметры подключения ниже и выберите «Яндекс» в OnlineEditService. В Яндекс.Диске сотрудника.
Microsoft 365 через OneDrive Зарегистрируйте приложение в Microsoft Entra, заполните параметры подключения ниже и выберите OneDrive в OnlineEditService. В OneDrive сотрудника.
ONLYOFFICE через Nextcloud Подключите хранилище Nextcloud и его коннектор ONLYOFFICE. Включите NextCloudOnlyOfficeEditing. Файл хранится в Nextcloud и обрабатывается подключённым к нему сервером ONLYOFFICE Docs.
Редактор SharePoint Online Подключите хранилище SharePoint. Проверьте открытие файла под сотрудником с правами на целевой сайт. На подключённом сайте SharePoint.

OnlineEditService задаёт сервис по умолчанию. Сценарии SharePoint и Nextcloud с ONLYOFFICE зависят от активного хранилища. Сотрудники также могут редактировать DOCX в настольном Microsoft Word через Informer, если этот способ настроен на рабочих местах.

Для закрытого контура сначала проверьте размещение хранилища, редактора и браузерных ресурсов по сетевой схеме. Для облачных вариантов согласуйте передачу содержимого файлов и требуемые разрешения OAuth. Перед сменой рабочего редактора завершите открытые сеансы и сохраните действующие настройки в защищённом месте.

Подключите Яндекс.Диск

  1. Откройте форму создания приложения Яндекс OAuth и создайте приложение Для авторизации пользователей с платформой Веб-сервисы. В поле Redirect URI укажите полный адрес возврата. Замените bpm.example.org именем своей BPMSoft.
Публикация URI возврата
.NET 8 в корне сайта https://bpm.example.org/rest/PtOauthService/YandexDiskAuthCode
.NET Core с префиксом /0 https://bpm.example.org/0/rest/PtOauthService/YandexDiskAuthCode
.NET Framework https://bpm.example.org/0/ServiceModel/PtOauthService.svc/YandexDiskAuthCode
  1. В разделе Доступ к данным выдайте разрешения cloud_api:disk.read, cloud_api:disk.write и cloud_api:disk.info. После сохранения приложения возьмите идентификатор клиента и значение его секрета.
  2. В системных настройках BPMSoft заполните YandexDiskClientId и YandexDiskClientSecret. В OnlineEditService выберите «Яндекс».
  3. Под обычным сотрудником войдите в его учётную запись Яндекса и подтвердите доступ. После возврата в BPMSoft повторно откройте вложение. Проверьте сохранение правки. У каждого сотрудника должна быть своя учётная запись Яндекса.

Подключите OneDrive

  1. В Microsoft Entra откройте Регистрации приложений → Новая регистрация. Для коннектора, использующего адрес авторизации login.microsoftonline.com/common, выберите учётные записи любого каталога организации. Личные учётные записи включайте при необходимости. Если организация разрешает только один каталог, согласуйте профиль коннектора с соответствующим адресом авторизации.
  2. Добавьте платформу Web. Для корневой публикации .NET 8 укажите https://bpm.example.org/rest/PtOauthService/OneDriveAuthCode. Для другой публикации укажите полный адрес, который формирует ваш коннектор.
  3. Для Microsoft Graph добавьте делегированные разрешения Files.ReadWrite.All и offline_access. Первое даёт доступ к файлам от имени вошедшего сотрудника, второе позволяет обновлять доступ. Предоставьте согласие администратора, если его требует политика каталога.
  4. Создайте секрет клиента. В BPMSoft заполните OneDriveClientId идентификатором приложения и OneDriveClientSecret значением секрета. Проверьте SmrOneDriveRedirectSuffix для коннектора, который использует эту настройку. В OnlineEditService выберите OneDrive.
  5. Откройте вложение под сотрудником с доступным OneDrive. Войдите в Microsoft и предоставьте запрошенный доступ. При необходимости после возврата откройте вложение повторно. Проверьте сохранение правок и повторную работу после обновления доступа.

В списке приложений Яндекс OAuth можно открыть настройки уже созданного приложения.

Если авторизация не возвращается в BPMSoft, сравните весь URI с зарегистрированным значением, включая схему, имя, порт, префикс и путь. При ошибке invalid_client проверьте идентификатор приложения, срок действия и значение секрета. Запишите владельца и срок замены секрета в регламенте подключения.

Опубликуйте контейнерный редактор по HTTPS

В контейнерном примере ONLYOFFICE сервис принимает HTTP только на локальном порту узла редактора. Для пакетной установки Р7 настройка HTTPS приведена в инструкции Р7. HTTPS завершает обратный прокси на этом же узле. Для каждого редактора выделите своё DNS-имя и сертификат. Проверьте, что прокси передаёт имя сайта, схему HTTPS и WebSocket-соединения.

Если на узле редактора работает NGINX, администратор может добавить следующий виртуальный сервер в конфигурацию NGINX. Замените имя, пути сертификатов и порт. В примере ONLYOFFICE используется порт 8081. Блок map разместите в контексте http один раз.

map $http_upgrade $office_connection_upgrade {
    default upgrade;
    '' close;
}

server {
    listen 443 ssl;
    server_name office.example.org;
    ssl_certificate /etc/nginx/tls/office.fullchain.pem;
    ssl_certificate_key /etc/nginx/tls/office.key;

    location / {
        proxy_pass http://127.0.0.1:8081;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-Host $host;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection $office_connection_upgrade;
        proxy_read_timeout 3600s;
    }
}

На Linux с правами администратора проверьте синтаксис и примените конфигурацию. Вторая команда выполнится только при успешной проверке.

sudo nginx -t && sudo systemctl reload nginx

Проверьте цепочки доверия к сертификатам в браузере, на сервере BPMSoft и внутри контейнера редактора. Если HTTPS проходит через другой прокси, используйте те же требования к имени, схеме и WebSocket и настройте доступ прокси к контейнеру по выделенному сетевому маршруту.

Проверьте сохранение

  1. Под обычным сотрудником откройте небольшое контрольное вложение DOCX из детали Файлы и ссылки. Для OAuth при первом открытии выполните вход, вернитесь к документу и при необходимости откройте редактор повторно.
  2. Вставьте узнаваемую строку, сохраните правку в редакторе и завершите сеанс. Если BPMSoft показывает действие завершения или сохранения, выполните его.
  3. Проверьте появление новой основной версии. Скачайте её из карточки документа и убедитесь, что строка сохранилась.
  4. Повторите проверку для каждого используемого сочетания редактора, формата и хранилища. Для совместной работы откройте файл двумя сотрудниками, завершите оба сеанса и проверьте итоговую версию.

Для совместной работы включите системную настройку Параллельное редактирование файла в облаке, если выбранный редактор и правила доступа организации допускают этот сценарий. Проверьте параллельное редактирование под двумя учётными записями.

Статьи

Был ли данный материал полезен вам? Да Нет