Расшифровывает данные, возвращает их и помещает в объект, если указано. Общий подход к обработке значений свойств с типом ОписаниеОповещения в параметре ОписаниеДанных. При выполнении обработки оповещения в нее передается структура параметров, в которой всегда есть свойство "Оповещение" типа ОписаниеОповещения, обработку которого нужно выполнить для продолжения. Кроме того, в структуре всегда есть свойство ОписаниеДанных, полученное при вызове процедуры. При вызове оповещения в качестве значения должна передаваться структура. Если в процессе асинхронного выполнения возникает ошибка, тогда в эту структуру нужно вставить свойство ОписаниеОшибки типа Строка.

Синтаксис

Процедура Расшифровать(ОписаниеДанных, Форма = Неопределено, ОбработкаРезультата = Неопределено) Экспорт

Параметры

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

  Массив из Структура - массив сертификатов шифрования

  Отпечаток - Строка - отпечаток сертификата в формате строки Base64.

  Представление - Строка - сохраненное представление субъекта,

  полученное из двоичных данных сертификата.

  Сертификат - ДвоичныеДанные - содержит выгрузку сертификата,

  который использовался для шифрования.

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

  Успех - Булево - Истина, если все прошло успешно. Если Успех = Ложь, то частичное завершение

  определяется по наличию свойства РасшифрованныеДанные. Если есть, то шаг выполнен.

  Отказ - Булево - Истина, если пользователь отменил операцию интерактивно.

  ВыбранныйСертификат - Структура - содержит свойства сертификата:

  Ссылка - СправочникСсылка.СертификатыКлючейЭлектроннойПодписиИШифрования - ссылка на сертификат.

  Отпечаток - Строка - отпечаток сертификата в формате строки Base64.

  Данные - Строка - адрес временного хранилища, содержащего двоичные данные сертификата.

  РасшифрованныеДанные = ДвоичныеДанные - результат расшифровки.

  При передаче параметра НаборДанных, свойство нужно проверять в нем. = Строка - адрес временного хранилища, содержащего результат расшифровки.

Пример вызова

ЭлектроннаяПодписьКлиент.Расшифровать(ОписаниеДанных, Форма, ОбработкаРезультата)

Доступность

Тонкий клиент, Толстый клиент