====== Настройка сервиса для массового скачивания документов единым архивом ======
''Начиная с версии системы 3.23'' появилась возможность [[product:documents:downloading_doc|скачивания сразу нескольких документов]] из Объектов единым архивом.

===== Инструкция по развертыванию сервиса архивации =====
==== Требования к программному обеспечению ====
1. Для запуска сервиса архивации на сервере необходимо:
  * установить [[https://dotnet.microsoft.com/ru-ru/download/dotnet/3.1|.Net Core 3.1]];
  * для учетной записи, из-под которой запускается сервис архивации, необходимо настроить соответствующие права на папку, в которой будут писаться/удаляться файлы.
2. Необходимо установить архиватор [[https://www.7-zip.org/download.html|7-Zip]] для корректной распаковки скачанных архивов с документами. Чтобы скачанные архивы по умолчанию открывались через данную программу, необходимо убедиться, что файлы с расширением .zip ассоциированы с данным архиватором.

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

==== Развертывание в качестве локального сервиса ====
Для использования локального сервиса архивации (встроенного в Cистему), необходимо [[product:settings:system|настраивать]] его в конфигурационном файле ''client.config'' Системы.

<callout type="info" icon="true">Рекомендуется разворачивать сервис архивации файлов удаленно, т.е. на отдельном сервере, отличном от сервера, где установлена Система ADVANTA.</callout>

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

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

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

<callout type="warning" icon="true">Если ключ активации функционала не указан, то возможности массового скачивания нет, даже если [[product:access:list|право]] [[product:documents:downloading_doc|«Скачивание нескольких документов»]] явно разрешено.</callout>

Подробнее об отслеживании хода процесса скачивания документов единым архивом на странице [[product:settings:logs:procs_in_background#архивация_файлов|«Фоновые процессы»]].