УсовершенствоватьПодпись
страницаПредусмотрено две одноименных функции: ЭлектроннаяПодпись.УсовершенствоватьПодпись для вызова с сервера ЭлектроннаяПодписьКлиент.УсовершенствоватьПодпись для вызова с клиента
1. Для вызова с клиента
Усовершенствует одну или несколько подписей до указанного типа.
Синтаксис
Процедура УсовершенствоватьПодпись(ОписаниеДанных, Форма, ОбработкаРезультата = Неопределено,
ПрерыватьОбработкуМассиваПриОшибке = Истина, ИгнорироватьСрокДействияСертификата = Ложь) ЭкспортПараметры
ОписаниеДанных— Структура:- ТипПодписи - ПеречислениеСсылка.ТипыПодписиКриптографии - тип подписи, до которого требуется усовершенствование. Если фактический ТипПодписи тот же или выше, тогда никаких действий произведено не будет.
- ДобавитьАрхивнуюМеткуВремени - Булево - если указано Истина и ТипПодписи указан архивная, и фактический ТипПодписи архивная, тогда будет добавлена метка времени.
- Подпись - ДвоичныеДанные - данные подписи.
- Строка - адрес временного хранилища, содержащего двоичные данные.
- Структура: ** ПодписанныйОбъект - ЛюбаяСсылка - ссылка на объект, подписи которого нужно усовершенствовать. ** ПорядковыйНомер - Число - порядковый номер подписи.
- Массив - значения указанного выше типа.
- Неопределено - все подписи объекта. ** Подпись - ДвоичныеДанные - (необязательный) данные подписи, если порядковый номер
подписи— число- Строка - адрес временного хранилища, содержащего двоичные данные подписи, если порядковый номер подписи - число.
- Массив из ДвоичныеДанные.
- Массив из Строка - как для строки указанной выше.
- Массив из Структура - как структура, указанная выше.
- Представление - ЛюбаяСсылка - (необязательный), если параметр не указан, тогда представление вычисляется по значению свойств Объект и ПорядковыйНомер.
- Строка
- Структура: ** Значение - ЛюбаяСсылка
- ОписаниеОповещения - для открытия. ** Представление - Строка - представление значения.
- СписокЗначений
- Массив - (необязательный) - произвольный список элементов или массив со значениями, как у описано выше, которые сможет открыть пользователь. Если не указан, то заполняется из свойств свойств Объект и ПорядковыйНомер.
Форма— ФормаКлиентскогоПриложения - форма, из которой нужно получить уникальный идентификатор, который будет использоваться при блокировке объекта.- УникальныйИдентификатор - уникальный идентификатор, который будет использоваться при блокировке объекта.
ПрерыватьОбработкуМассиваПриОшибке— Булево - по умолчанию Истина - при ошибке обработка следующих элементов будет прервана.ИгнорироватьСрокДействияСертификата— Булево - по умолчанию Ложь - не проверять срок действия сертификата подписи перед усовершенствованием.ОбработкаРезультата— ОписаниеОповещения - Требуется для нестандартной обработки результата, например, если не указана ссылка на объект и порядковый номер подписи. Структура:Успех = Булево - Истина, если все прошло успешно. Если Успех = Ложь, то частичное завершение
определяется по наличию свойства СвойстваПодписи. Если есть, то шаг выполнен.ТекстОшибки = Строка
СвойстваПодписей = Массив из Структура -
Подпись = ДвоичныеДанные - Подпись, которую надо усовершенствовать.
= Строка - адрес во временном хранилище.ПодписанныйОбъект - ЛюбаяСсылка - если есть.
ПорядковыйНомер - Число - если есть.
ТипПодписи - ПеречислениеСсылка.ТипыПодписиКриптографии - тип подписи,
если подпись не удалось усовершенствовать, но удалось определить тип.СрокДействияПоследнейМеткиВремени - Дата - срок действия,
если подпись не удалось усовершенствовать, но удалось определить срок действия.СвойстваПодписи = см. ЭлектроннаяПодписьКлиентСервер.НовыеСвойстваПодписи -
свойства усовершенствованной подписи (заполнены только изменившиеся).Ошибка = Строка - текст ошибки при попытке усовершенствования. Если произошла ошибка,
то структура не будет содержать свойств подписи, которую не удалось усовершенствовать. = Строка - адрес временного хранилища, содержащего массив указанный выше.
Пример вызова
ЭлектроннаяПодписьКлиент.УсовершенствоватьПодпись(ОписаниеДанных, Форма, ОбработкаРезультата, ПрерыватьОбработкуМассиваПриОшибке, ИгнорироватьСрокДействияСертификата)Доступность
Тонкий клиент, Толстый клиент
2. Для вызова с сервера
Усовершенствует подпись до переданного типа, если подпись позволяет. Добавляет архивную метку времени в архивную подпись (CAdES-A).
Синтаксис
Функция УсовершенствоватьПодпись(Подпись, ТипПодписи, ДобавитьАрхивнуюМеткуВремени = Ложь,
ДополнительныеПараметры = Неопределено) ЭкспортПараметры
Подпись— ДвоичныеДанные - двоичные данные электронной подписи.ТипПодписи— ПеречислениеСсылка.ТипыПодписиКриптографии - тип подписи, до которого требуется усовершенствование. Если фактический ТипПодписи тот же или выше, тогда никаких действий произведено не будет.ДобавитьАрхивнуюМеткуВремени— Булево - если указано Истина и фактический ТипПодписи архивная, тогда будет добавлена метка времени.ДополнительныеПараметры— Структура:- МенеджерКриптографии - Неопределено - получить менеджер криптографии для проверки
- МенеджерКриптографии - использовать указанный менеджер криптографии.
- ИгнорироватьСрокДействияСертификата - Булево - по умолчанию Ложь, не проверять срок действия сертификата подписи перед усовершенствованием.
- Неопределено - получить менеджер криптографии для проверки электронных подписей, как настроил администратор.
- МенеджерКриптографии - использовать указанный менеджер криптографии.
Возвращаемое значение
Структура:
- Успех - Булево - Истина, если усовершенствование прошло успешно или не требовалось.
- ТекстОшибки - Строка - заполнен, если Успех = Ложь.
- СвойстваПодписи - см. ЭлектроннаяПодписьКлиентСервер.НовыеСвойстваПодписи.
Пример вызова
Результат = ЭлектроннаяПодпись.УсовершенствоватьПодпись(Подпись, ТипПодписи, ДобавитьАрхивнуюМеткуВремени, ДополнительныеПараметры)Доступность
Сервер, Толстый клиент, Внешнее соединение