Подключайте редактор и хранилище после первичной проверки Документооборота. Сначала определите, где должны храниться вложения и куда разрешено передавать файлы на редактирование. Затем выберите сценарий в таблице и проверьте, что правки сохраняются новой версией в 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. Перед сменой рабочего редактора завершите открытые сеансы и сохраните действующие настройки в защищённом месте.
Подключите Яндекс.Диск
- Откройте форму создания приложения Яндекс 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 |
- В разделе Доступ к данным выдайте разрешения
cloud_api:disk.read,cloud_api:disk.writeиcloud_api:disk.info. После сохранения приложения возьмите идентификатор клиента и значение его секрета. - В системных настройках BPMSoft заполните
YandexDiskClientIdиYandexDiskClientSecret. ВOnlineEditServiceвыберите «Яндекс». - Под обычным сотрудником войдите в его учётную запись Яндекса и подтвердите доступ. После возврата в BPMSoft повторно откройте вложение. Проверьте сохранение правки. У каждого сотрудника должна быть своя учётная запись Яндекса.
Подключите OneDrive
- В Microsoft Entra откройте Регистрации приложений → Новая регистрация. Для коннектора, использующего адрес авторизации
login.microsoftonline.com/common, выберите учётные записи любого каталога организации. Личные учётные записи включайте при необходимости. Если организация разрешает только один каталог, согласуйте профиль коннектора с соответствующим адресом авторизации. - Добавьте платформу Web. Для корневой публикации .NET 8 укажите
https://bpm.example.org/rest/PtOauthService/OneDriveAuthCode. Для другой публикации укажите полный адрес, который формирует ваш коннектор. - Для Microsoft Graph добавьте делегированные разрешения
Files.ReadWrite.Allиoffline_access. Первое даёт доступ к файлам от имени вошедшего сотрудника, второе позволяет обновлять доступ. Предоставьте согласие администратора, если его требует политика каталога. - Создайте секрет клиента. В BPMSoft заполните
OneDriveClientIdидентификатором приложения иOneDriveClientSecretзначением секрета. ПроверьтеSmrOneDriveRedirectSuffixдля коннектора, который использует эту настройку. ВOnlineEditServiceвыберитеOneDrive. - Откройте вложение под сотрудником с доступным 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 и настройте доступ прокси к контейнеру по выделенному сетевому маршруту.
Проверьте сохранение
- Под обычным сотрудником откройте небольшое контрольное вложение DOCX из детали Файлы и ссылки. Для OAuth при первом открытии выполните вход, вернитесь к документу и при необходимости откройте редактор повторно.
- Вставьте узнаваемую строку, сохраните правку в редакторе и завершите сеанс. Если BPMSoft показывает действие завершения или сохранения, выполните его.
- Проверьте появление новой основной версии. Скачайте её из карточки документа и убедитесь, что строка сохранилась.
- Повторите проверку для каждого используемого сочетания редактора, формата и хранилища. Для совместной работы откройте файл двумя сотрудниками, завершите оба сеанса и проверьте итоговую версию.
Для совместной работы включите системную настройку Параллельное редактирование файла в облаке, если выбранный редактор и правила доступа организации допускают этот сценарий. Проверьте параллельное редактирование под двумя учётными записями.