Объектная модель > Основные механизмы > Signatures – подписи > Endorse – подписать с результатом «Согласовано»

Метод используется для подписания документа с результатом «Согласовано». Это означает, что согласующий ознакомился с документом и содержимое документа полностью устраивает его. При подписании последняя версия документа по умолчанию остается доступной для изменения.

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

Перегрузки

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

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

Синтаксис

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

Параметры

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Пример. Подписание последней версии документа с результатом «Согласовано»

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