Настройка сервиса для массового скачивания документов единым архивом

Начиная с версии системы 3.23 появилась возможность скачивания сразу нескольких документов из Объектов единым архивом.

Инструкция по развертыванию сервиса архивации

Требования к программному обеспечению

1. Для запуска сервиса архивации на сервере необходимо:

  • установить .Net Core 3.1;
  • для учетной записи, из-под которой запускается сервис архивации, необходимо настроить соответствующие права на папку, в которой будут писаться/удаляться файлы.

2. Необходимо установить архиватор 7-Zip для корректной распаковки скачанных архивов с документами. Чтобы скачанные архивы по умолчанию открывались через данную программу, необходимо убедиться, что файлы с расширением .zip ассоциированы с данным архиватором.

Развертывание в качестве внешнего сервиса

  1. Перейти в папку DocumentsArchivingService.
  2. В папке Config настроить конфигурационный файл client.config сервиса архивации.
  3. Из командной строки установить SL.DocumentsArchiving.Service.exe (содержится в папке DocumentsArchivingService) по команде install, после чего запустить его по команде run.

Развертывание в качестве локального сервиса

Для использования локального сервиса архивации (встроенного в Cистему), необходимо настраивать его в конфигурационном файле client.config Системы.

Рекомендуется разворачивать сервис архивации файлов удаленно, т.е. на отдельном сервере, отличном от сервера, где установлена Система ADVANTA.

Принципы настройки сервиса архивирования файлов

Для настройки сервиса для массового скачивания документов единым архивом необходимо:

1. Обязательно предусмотреть возможность выноса сервиса архивации файлов на отдельный сервер.

2. Предусмотреть конфигурационный файл client.config для настройки:

  • метода сжатия (по умолчанию используется обычный метод сжатия);
  • лимита по максимальному количеству скачиваемых документов (по умолчанию лимит - 500 файлов);
  • лимита на общий максимальный размер скачиваемых документов (по умолчанию лимит - 2000 Мб);
  • места для архивации;
  • лимита на максимальное количество одновременных формирований архивов файлов для скачивания (по умолчанию максимум одновременных архиваций - 3);
  • лимита времени для хранения успешно сформированного архива (по умолчанию лимит - 168 часов);
  • лимита на максимальное количество символов в самом длинном пути формируемого архива (по умолчанию лимит - 200 символов);
  • лимита на минимальное количество несокращаемых символов в названии корневого объекта архива - объекта, с карточки которого открыта страница «Документы» (по умолчанию лимит - 30 символов);
  • лимита на минимальное количество несокращаемых символов в названии узла дерева формируемого архива (по умолчанию лимит - 6 символов);
  • ключа активации функционала.
Если ключ активации функционала не указан, то возможности массового скачивания нет, даже если право «Скачивание нескольких документов» явно разрешено.

Подробнее об отслеживании хода процесса скачивания документов единым архивом на странице «Фоновые процессы».