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

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

Настройка хранилища файлов

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

Выберите хранилище

Хранилище Когда использовать Что проверить
База данных BPMSoft Основной вариант без отдельного файлового сервиса. Место в БД, время резервного копирования и восстановления, поиск и редактирование используемых форматов.
Внешняя папка Для части крупных вложений на установке on-site. Доступ процесса BPMSoft, порог размера и резервное копирование папки.
S3 Для внешнего объектного хранения в поддерживающей его версии BPMSoft. Доступ к двум бакетам, срок хранения удалённых объектов и восстановление.
Nextcloud Для хранения в Nextcloud. OAuth и доступ к файлам. Для редактирования через Nextcloud дополнительно проверьте ONLYOFFICE.
SharePoint Online Для хранения на сайте SharePoint и работы с его редактором. Авторизацию Microsoft Entra, права на целевой сайт и сохранение версии.

Полнотекстовый поиск по содержимому вложений проверяйте для файлов в БД. Совместимость онлайн-редактирования зависит от формата и места хранения. Для файлов во внешней папке онлайн-редактирование, блокировка и расширенный предпросмотр недоступны.

Оставьте хранение в базе данных

В Дизайнере системы → Системные настройки проверьте, что в Активном хранилище содержимого файлов (ActiveFileContentStorage) выбрано штатное значение хранения в БД и выключено Хранить файлы во внешней папке (IsStoreFilesInExternalFolder). Загрузите небольшое вложение, скачайте его и откройте из новой сессии. Если меняете рабочее хранилище, дополнительно скачайте ранее загруженный файл.

Настройте внешнюю папку

  1. Создайте папку вне корня сайта. На Windows задайте права изменения файлов учётной записи пула приложений IIS, под которой работает BPMSoft. На Linux задайте права записи, чтения и прохода в каталог учётной записи службы BPMSoft. Для сетевой папки проверьте доступ этой учётной записи с каждого узла приложения. Не используйте диск, подключённый только в интерактивном сеансе администратора.
  2. Укажите путь в PathToExternalFolder. В MaxDBStoringFileSize укажите порог в Мбайт. Вложения больше порога сохраняются в папке, меньше порога — в БД.
  3. Включите IsStoreFilesInExternalFolder. Загрузите два контрольных файла по разные стороны порога. У файла из папки на детали Файлы и ссылки появится значок папки. Проверьте скачивание обоих файлов.
  4. Добавьте папку в регламент резервного копирования вместе с БД.

Подключите S3

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

  1. Создайте два закрытых бакета. Первый хранит действующие вложения, второй — удалённые. Выдайте отдельной учётной записи приложения доступ к этим бакетам для операций загрузки, чтения, переноса и удаления. Задайте срок хранения удалённых объектов не короче срока хранения резервных копий БД.
  2. Сохраните резервную копию ConnectionStrings.config. В существующий раздел connectionStrings добавьте запись, подставив конечную точку S3, ключи и имена бакетов. В XML-атрибуте заменяйте специальные символы, например амперсанд на &, а двойную кавычку на ". Ограничьте доступ к файлу конфигурации.
<add name="s3Connection"
     connectionString="ServiceUrl=https://s3.example.org; AccessKey=ACCESS_KEY; SecretKey=SECRET_KEY; ObjectBucketName=ACTIVE_BUCKET; RecycleBucketName=DELETED_BUCKET;" />
  1. Примените конфигурацию перезапуском приложения в согласованное окно. На странице дополнительной функциональности включите UseBaseEntityFileDeleteListener для обработки удаления файлов вместе с записью. В ActiveFileContentStorage выберите Хранилище S3.
  2. Загрузите и скачайте вложение. Удалите контрольную запись с вложением и проверьте перенос объекта из основного бакета в бакет удалённых файлов. Проверьте доступ к старому вложению из прежнего хранилища.

Подключите Nextcloud

  1. В Nextcloud откройте Параметры сервера → Безопасность → Клиенты OAuth 2.0. Создайте клиента для BPMSoft. Для корневой публикации .NET 8 укажите URI возврата https://bpm.example.org/rest/PtOauthService/NextCloudAuthCode. Для публикации .NET Framework с префиксом /0 укажите https://bpm.example.org/0/rest/PtOauthService/NextCloudAuthCode. Имя, префикс и путь должны совпадать с запросом вашего подключения.
  2. В BPMSoft заполните NextCloudClientId идентификатором клиента, NextCloudClientSecret его секретом и NextCloudSiteUrl адресом Nextcloud. Нажмите Авторизоваться в настройке адреса, войдите в Nextcloud под учётной записью для этого подключения и предоставьте доступ.
  3. В ActiveFileContentStorage выберите NextCloud. Загрузите контрольный файл, проверьте его наличие в Nextcloud и скачайте из карточки BPMSoft.
  4. Для редактирования установите приложение ONLYOFFICE в Nextcloud и в его настройках укажите HTTPS-адрес сервера ONLYOFFICE Docs и общий секрет JWT, согласованный для этого подключения. Проверьте доступ Nextcloud и браузера к Docs и доступ Docs к Nextcloud. Если имена для внутреннего и внешнего трафика различаются, заполните соответствующие адреса в дополнительных настройках коннектора.
  5. Откройте контрольный файл из Nextcloud в ONLYOFFICE и сохраните правку. Затем включите NextCloudOnlyOfficeEditing в BPMSoft и повторите проверку сохранения из карточки.

Подключите SharePoint Online

  1. В центре администрирования SharePoint подготовьте целевой сайт. Сохраните его полный URL. Проверьте, что учётная запись для подключения может загрузить, изменить и скачать файл на этом сайте.
  2. В Microsoft Entra зарегистрируйте приложение в каталоге этого сайта. Сохраните идентификаторы приложения и каталога. В разделе Аутентификация добавьте платформу Web и URI возврата. Для корневой публикации .NET 8 используйте https://bpm.example.org/rest/PtOauthService/SharePointAuthCode. При публикации с префиксом укажите адрес, который формирует коннектор.
  3. В Разрешениях API выберите Office 365 SharePoint Online и добавьте делегированные разрешения, которые запрашивает ваш коннектор. Для коннектора, запрашивающего AllSites.FullControl и offline_access, согласуйте эти разрешения с администратором Microsoft Entra и проверьте права учётной записи на целевой сайт. AllSites.FullControl даёт приложению широкий доступ от имени вошедшего пользователя в пределах его прав, поэтому используйте отдельную учётную запись для подключения. Разрешения Microsoft Graph для OneDrive не предоставляют доступ коннектору, который обращается к SharePoint API. Создайте секрет клиента и сохраните его значение и срок действия.
  4. В BPMSoft заполните SharePointClientId, SharePointTenantId, SharePointClientSecret и SharePointSiteUrl. Проверьте SmrSharePointRedirectSuffix, если его использует ваш коннектор. В настройке адреса нажмите Авторизоваться и завершите вход в Microsoft.
  5. В ActiveFileContentStorage выберите SharePoint. Загрузите контрольный DOCX, проверьте его наличие на целевом сайте, откройте из карточки в браузере и сохраните правку. Проверьте новую версию и скачивание из BPMSoft.

Проверьте эксплуатацию

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

Настройте поиск по содержимому вложений

Для раздела с хранением файлов в БД откройте Настройка вида → Настроить полнотекстовый поиск, установите флажок Использовать поиск в разделе, укажите язык и сохраните. Дождитесь индексации. Проверьте поиск по фразе внутри нового и ранее загруженного файла. Повторите настройку для каждого нужного раздела.

Для индексации PDF на PostgreSQL и Linux получите у поддержки продуктовый комплект обработки PDF для вашей ОС, разрядности и версии BPMSoft. Разместите каталог tessdata в корне приложения. Для .NET 8 дополнительно примените библиотеки из каталога Search_Linux+Windows комплекта по схеме размещения вашей версии. Проверьте отдельно PDF с текстовым слоем и скан, если используется распознавание. Для каждого файла найдите фразу из содержимого, которой нет в имени файла или полях карточки.

Настройте блокировку при работе с файлами

В системной настройке Максимальное время блокирования файла задайте предел и права изменения. Проверьте выполнение преднастроенного процесса Разблокирование файлов с истекшим временем блокирования. При штатном расписании он проверяет файлы каждые пять минут, поэтому освобождение может произойти при следующем запуске после истечения предела.

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

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