# Модуль «Массовое подписание»
> [HTML Version](cryptopro-mass-signing.html)
Модуль **Массовое подписание **позволяет сотрудникам обрабатывать группу документов в едином интерфейсе, не переходя в карточку каждого из них.
Для этого [администратор системы](360006871932.md#administrators) размещает специальный виджет на [странице](360009924451.md), [форме приложений](360029250931.md) или [задач](360012495611.md).
Например, внутри раздела для управления документооборотом компании можно создать отдельную страницу подписания. Пользователь выбирает на странице нужные записи приложений типа [Документ](360009923631.md), указывает сертификат электронной подписи и подписывает весь список файлов за одно действие.
**Особенности работы модуля**:
- объектом подписания может быть только файл из элемента приложения типа **Документ**. Подписывать [атрибуты](digital_signtature_in_apps.md#signed-object) элемента нельзя;
- поддерживается работа с электронными подписями от провайдеров [КриптоПро](electronic-signature.md) или [УЦ Контур](kontur.md).
## Настройка массового подписания
Чтобы включить массовое подписание для пользователей, администратор системы:
1. [Настраивает и включает модуль электронной подписи КриптоПро или УЦ Контур](#setup-module).
2. [Устанавливает модуль Массовое подписание](#setup-mass-signing).
3. [Настраивает виджет Массовое подписание](#setup-widget).
После этого сотрудники могут выбрать и подписать сразу несколько документов одним нажатием кнопки. Подробнее об этом читайте в [статье о работе пользователей с массовым подписанием документов](mass-signing-use.md).
### Шаг 1. Настроить и подключить модуль электронной подписи
Для использования модуля массового подписания предварительно установите модуль электронной подписи [КриптоПро](electronic-signature.md) или [УЦ Контур](kontur.md).
Вы можете работать с обоими провайдерами или только с одним из них. Для других провайдеров модуль массового подписания не поддерживается.
### Шаг 2. Установить и настроить модуль «Массовое подписание»
1. Перейдите в раздел **Администрирование > Модули**.
2. Нажмите **+ Модуль**, а затем **Скачать**.
3. В открывшемся каталоге [ELMA365 Store](https://store.elma365.ru/component/ext_c03587fd_399e_4289_9716_209f6a9f89f9-201) установите модуль **Массовое подписание**.
4. В зависимости от используемого в вашей компании провайдера электронной подписи выполните шаги:
- КриптоПро — достаточно установки модуля. Вы можете переходить к [настройке виджета Массовое подписание](#setup-widget);
- УЦ Контур — на открывшейся странице модуля введите данные для интеграции с этим провайдером:
- **Сервер Контур** — выберите, какой сервер использовать для массового подписания: **Продуктовый** для рабочего режима или **Тестовый** для проверки массового подписания;
- **API ключ Контур** — API-ключ, полученный от провайдера.
После этого вы сможете использовать в [дизайнере интерфейсов](interface_designer.md) виджет **Массовое подписание**.
### Шаг 3. Настроить виджет «Массовое подписание»
Вы можете добавить виджет **Массовое подписание** на [страницы](360009924451.md), [формы приложений](360029250931.md) или [задач](360012495611.md). Рассмотрим настройку виджета на примере его добавления на страницу системы:
1. Откройте раздел, в котором вы хотите разместить [страницу](360009924451.md) для массового подписания документов. На левой панели нажмите **+ Добавить**, выберите **Страницу**, заполните настройки и нажмите **Сохранить**.
2. Перейдите в [дизайнер интерфейсов страницы](360027211631.md#setting-in-designer). Для этого справа от названия страницы нажмите значок шестерёнки и выберите **Конструктор**.
3. Перед началом настройки виджета **Массовое подписание** добавьте в контекст страницы свойство, в котором пользователь будет выбирать элементы приложения для подписания. Для этого перейдите на вкладку **Контекст**, нажмите кнопку **+ Добавить** и заполните поля:
- **Отображаемое имя\*** — название поля для выбора элементов приложения, например **Документы**;
- **Тип\*** — [Произвольное приложение](360009707032.md#arbitrary-app) с возможностью выбора нескольких элементов.
4. Вернитесь на вкладку **Шаблон**.
5. На правой боковой панели выберите вкладку **Свойства**. Разместите созданные на шаге 3 свойство в шаблоне и в открывшемся окне настроек отметьте опцию **Обязательное поле**.
**(mass-signing-1.png)**
6. На правой боковой панели откройте вкладку **Виджеты** и перетащите на страницу виджет **Массовое подписание**. В открывшемся окне заполните параметры:
**(mass-signing-2.png)**
- **Документы для подписания** — укажите переменную, которая хранит список элементов для подписания. Доступна привязка переменных двух типов:
- **Произвольное приложение** — чтобы пользователи одним нажатием кнопки могли подписывать элементы из разных приложений типа **Документ**;
- **Приложение** — чтобы пользователи одним нажатием кнопки могли подписывать элементы из одного приложения типа **Документ**.
Для привязки переменной нажмите значок **(bind_table-icon.png)**, а затем ссылку **<Не установлено>** и укажите переменную. В нашем случае это переменная **Документы**, в которой будут содержаться элементы, выбранные пользователем на странице;
- **Провайдеры** — отметьте, какие провайдеры будут доступны при подписании документов через виджет. Вы можете указать КриптоПро и УЦ Контур. Если выбрать оба варианта, они отобразятся для пользователя на отдельных вкладках;
- **Отображение в строку** — при включённой опции элементы виджета будут размещены в одну строку, а при выключенной — друг под другом;
- **Надпись на кнопке подписания** — укажите название, которое отображается на кнопке массового подписания;
- **Надпись на поле выбора сертификата** — введите текст, который будет отображаться рядом с полем, в котором выбирается сертификат для подписания;
- **Подписание завершилось успешно** — поле можно оставить пустым, так как оно заполняется автоматически в ходе работы с виджетом. Оно показывает успешность подписания документов. Вы можете связать поле с переменной типа [Выбор «да/нет»](360009707032.md#yes_no) из контекста страницы, например, чтобы использовать значение настройки в пользовательском скрипте. Для этого нажмите значок **(bind_table-icon.png), **затем ссылку **<Не установлено> **и укажите переменную;
- **Ошибка при подписании** — поле можно оставить пустым, так как оно заполняется автоматически в ходе работы с виджетом. Оно показывает наличие ошибки при подписании. Вы можете связать поле с переменной типа **Выбор «да/нет»** из контекста страницы, например, чтобы использовать значение настройки в пользовательском скрипте. Для этого нажмите значок **(bind_table-icon.png), **затем ссылку **<Не установлено> **и укажите переменную;
- **Развернутая ошибка при подписании **— поле можно оставить пустым, так как оно заполняется автоматически в ходе работы с виджетом. В него записывается текст ошибки, возникшей при подписании. Вы можете связать поле с переменной типа [Строка](360009707032.md#string) из контекста страницы, например, чтобы использовать значение настройки в пользовательском скрипте. Для этого нажмите значок **(bind_table-icon.png), **затем ссылку **<Не установлено> **и укажите переменную.
7. Нажмите кнопку **Сохранить**.
Шаблон страницы с настроенным виджетом и свойством может выглядеть следующим образом:
**(mass-signing-3.png)**
После выполнения всех настроек нажмите кнопки **Сохранить **и **Опубликовать **на верхней панели дизайнера интерфейсов, чтобы виджет стал доступен пользователям.
##