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

Синтаксис

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

Параметры

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

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

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

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

  СертификатыШифрования = Строка - адрес временного хранилища, содержащего массив, описанный ниже.

  = Массив - помещается перед началом шифрования и после этого не изменяется.

  Значение - Структура

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

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

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

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

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

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

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

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

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

Доступность

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