Объектная модель > Основные механизмы > Signatures – подписи > Approve

Метод используется для подписания документа с результатом «Утверждено». Это означает, что подписывающий ознакомился с документом и содержимое документа полностью устраивает его. Подписать документ ЭП с результатом «Утверждено» могут сотрудники, для которых настроено право подписи. Как правило, это руководители наших организаций. При подписании последняя версия становится недоступной для изменения, а на значке документа появится дополнительный значок .

Если требуется подписание сертификатом в серверном коде, то на компьютере с установленным веб-сервером помимо сертификатов из цепочки доверия и криптопровайдера установите закрытый ключ ЭП.

Перегрузки

У метода 24 перегрузки. Описание перегрузок см. в редакторе кода с помощью горячих клавиш CTRL+SPACE. Подробнее о вызове списка для автодополнения кода (Intellisense) см. в разделе «Горячие клавиши».

С помощью перегрузок метода можно подписать сущность или сразу список сущностей. Например, при помощи перегрузки Approve(IEntity entity, string comment) можно подписать документ с результатом «Утверждено» и добавить комментарий. А при помощи перегрузки Approve(IEnumerable<IEntity> entities, string comment) подписать список документов.

Синтаксис

public static bool Approve(IEntity entity, ICertificate certificate, string comment);

Параметры

entity/entities – подписываемая сущность/список подписываемых сущностей;

certificate – сертификат для подписания:

•если параметр не указан и у пользователя нет зарегистрированных сертификатов, то устанавливается простая подпись;

•если параметр не указан и у пользователя есть один зарегистрированный сертификат, то подписание выполняется им;

•если параметр не указан и у пользователя зарегистрировано несколько сертификатов, то:

•при подписании в клиентском коде система предлагает выбрать один из сертификатов;

•подписание в серверном коде не выполняется, метод возвращает значение false;

•если нужно установить простую подпись при наличии зарегистрированных сертификатов, то в качестве параметра необходимо передать null;

comment – комментарий к электронной подписи;

substitutedUser – замещаемый пользователь, от имени которого устанавливается подпись;

childEntities – строки свойства-коллекции, которые подписываются. Если список не означен, строки свойства-коллекции не подписываются.

Примечание. В зависимости от перегрузки количество параметров может изменяться.

Возвращаемое значение

True, если подписание успешно, иначе – false.

Пример. Подписание последней версии документа простой подписью

// Подписать последнюю версию документа простой подписью.
if (_obj.HasVersions)
  Signatures.Approve(_obj.LastVersion, null, "Документ подписан простой подписью");