Назначение компонента

Составной компонент SignButton служит для создания электронной подписи и отображения подписываемых данных

Настройка компонента

Настройка скрипта SignButton: в HBox → SignButton

Наименование Назначение Значение по умолчанию Параметр обязателен
Sign Type Выбор типа электронной подписи. Возможные варианты: CMS, CADES_BES, CADES_T, CADES_X_LONG_TYPE_1 - да
Selectable Component Объект для выбора подписываемого документа из списка. Необходим для получения id подписываемого документа, если не указана переменная процесса documentId в SignButtonRpcService. В случае, если указан и Document Id, и Selectable Component, то по приоритету будет взят id, выбранный пользователем из Selectable Component. - Обязательно заполнение либо Document Id, либо Selectable Component
Complete Task After Signing В случае значения true, после подписания текущий таск будет завершен - да
Navigate To Параметр для перенаправления пользователя после завершения текущего таска. Параметр не используется, если completeTaskAfterSigning = false - нет
Реализация провайдера электронной подписи Для использования конкретной реализации электронной подписи. Необходимо добавить соответствующий ts-файл в объект SignButton. На данный момент есть две реализации: EsmartPlugin.ts и CadesPluginApi.ts. При использовании EsmartPlugin.ts и типа подписи CADES_T необходимо указать системную переменную webbpm_components.electronic_sign.esmart_extension_url со ссылкой для расширения подписи “_dsig/ibs_dSig.asmxhttp://dsig.ibsdemo.ru/ibs” - да
Other Остальные параметры настраивать только в случае, если не устраивает стандартное устройство компонента

Настройка скрипта SignButtonRpcService: HBox → SignButton

Наименование Назначение Значение по умолчанию Параметр обязателен
Document Id Параметр необходим для получения Id подписываемого документа, если не указан параметр Selectable Component со списком записей. В случае, если указан и Document Id, и Selectable Component, то по приоритету будет взят id, выбранный пользователем из Selectable Component. - Обязательно заполнение либо Document Id, либо Selectable Component
Document Provider Провайдер подписываемых данных. Реализация класса ru.cg.webbpm.electronic_sign.DocumentProvider. - да
Document Dao Класс для сохранения и получения подписанных данных. Реализация класса ru.cg.webbpm.electronic_sign.DocumentDao - да

Сценарий использования кнопки подписи:

  1. Пользователь в процессе работы над документом или после его выбора в списке уже созданных нажимает на кнопку “Подписать”

  2. Если подходящий сертификат для подписания единственен, то окно выбора отображено не будет; в противном случае пользователь должен выбрать подходящий сертификат в окне “Выбор сертификата”.

  3. Пользователю выводится окно ввода пароля с возможностью отмены операции

  4. Происходит подписание документа, сохранение подписи в байтах в базе данных

КриптоПро

Для работы компоненты требуется установить КриптоПро CSP и КриптоПро ЭЦП Browser plug-in. Тестовый сертификат можно получить тут, при этом нужно установаить сертификат тестового центра как довереный корневой сертификат. Страница проверки работы плагина.

Esmart

Для работы компоненты требуется установить:

  • 32-битную firefox версии 38 - 52 (рекомендуется 52.5.2esr).
  • PKI Client и ESMART Token Web Плагин последних версий с официального сайта ESMART - demo.esmart.ru.