Двоичные данные в 1С 8.3

Двоичные данные платформы 1С:Предприятие – это универсальный объект встроенного языка программирования для работы с файлами. Благодаря объекту ДвоичныеДанные можно любой файл представить в виде последовательности байт. Объект доступен в тонком клиенте, веб-клиенте, мобильном клиенте, на сервере, толстом клиенте, внешнем соединении, мобильном приложении (клиент/сервер).

Объект сериализуется

Данный объект может быть сериализован в/из XML, может использоваться в реквизитах управляемой формы, а также он может быть сериализован в/из XDTO. Тип XDTO, соответствующий данному объекту, определяется в пространстве имен {http://www.w3.org/2001/XMLSchema}. Имя типа XDTO может быть любым из перечисленных: base64Binary, hexBinary.

Благодаря тому, что двоичные данные доступны и на клиенте, и на сервере, мы можем смело передавать файл в виде двоичных данных с клиента на сервер, однако рекомендованный «шаблон» для передачи файла – использовать хранилище значений.

Задачи, для решения которых можно использовать двоичные данные:

• Хранение файлов в базе данных (с использованием ХранилищеЗначения);
• Передача файла с клиента на сервер;
• Передача файлов при работе с протоколом HTTP;
• Передача вложений при работе с электронными письмами;
• Криптография;
• Представления файла в виде текста (с использованием Base64).

Работа с двоичными данными:

&НаКлиенте
Процедура ПередатьФайлНаСервер()
 	Диалог = Новый ДиалогВыбораФайла(РежимДиалогаВыбораФайла.Открытие);
 	Диалог.МножественныйВыбор = Ложь;
 	Если Диалог.Выбрать() ТОгда
      	         БинДанные = Новый ДвоичныеДанные(Диалог.ПолноеИмяФайла);

      	         АдресВременногоХранилища = ПоместитьВоВременноеХранилище(БинДанные, ЭтаФорма.УникальныйИдентификатор);
      	         ОбработкаФайлаНаСервере(АдресВременногоХранилища);
 	КонецЕсли;
КонецПроцедуры
&НаСервереБезКонтекста
Процедура ОбработкаФайлаНаСервере(АдресВХ)
 	БинДанные = ПолучитьИзВременногоХранилища(АдресВХ);
 	Если БинДанные <> Неопределено Тогда
      	         //БинДанные.Записать("Путь файла на сервере");
 	КонецЕсли;
КонецПроцедуры

Данный пример кода показывает, как прочитать двоичные данные и передать их с клиента на сервер, используя объект ДвоичныеДанные.

Примеры по работе с двоичными данными

Самый очевидный пример, где применяются двоичные данные, – сохранение файла в базе данных. Для хранения файла в виде двоичных данных необходимо в объекте добавить реквизит с типом «ХранилищеЗначений». Далее представлен пример кода по работе с реквизитом (заполнение значения и получение значения).

Заполнение:

ПутьКФайлу = "";
БинДанные = Новый ДвоичныеДанные(ПутьКФайлу);
Объект.Файл = Новый ХранилищеЗначения(БинДанные);

Получение (фрагмент кода, выполняемый на сервере):

БинДанные = Объект.Файл.Получить();
Если БинДанные <> Неопределено Тогда
 	// БинДанные.Записать(Имя Файла);
 	// или
 	// Поток = БинДанные.ОткрытьПотокДляЧтения();
КонецЕсли

Рассмотрим еще один пример: скачивание картинки из интернета и отображение ее на управляемой форме. Для этого также добавляем реквизит с типом ХранилищеЗначения, в котором будет помещаться картинка в двоичном формате.

Функция, скачивающая картинку из интернета:

Функция СкачатьКартинку(URL)
 	
 	СтруктураURI = ОбщегоНазначенияКлиентСервер.СтруктураURI(URL);
 
 	ФайлОтвет = ПолучитьИмяВременногоФайла();
 	HTTPСоединение = Новый HTTPСоединение(СтруктураURI.ИмяСервера);
 	HTTPЗапрос = Новый HTTPЗапрос(СтруктураURI.ПутьНаСервере);
 	Ответ = HTTPСоединение.Получить(HTTPЗапрос, ФайлОтвет);  
 	
 	Если Ответ.КодСостояния = 200 Тогда
      	Возврат Новый ДвоичныеДанные(ФайлОтвет);
 	КонецЕсли;
КонецФункции

Использование функции:

БинДанные = СкачатьКартинку("url картинки");
СпрОбъект.Аватар = Новый ХранилищеЗначения(БинДанные);
СпрОбъект.Записать();

Теперь у нас в реквизите «Аватар» лежат двоичные данные картинки. Чтобы картинку вывести на управляемую форму, необходимо добавить реквизит формы «Тип строка», перекинуть его на форму (drag-and-drop), либо создать самостоятельно элемент формы, указав в поле «Путь к данным» наш реквизит «Картинка», после чего изменить вид на «Поле картинки».

По событию ПриСозданииНаСервере

СпрОбъект = РеквизитФормыВЗначение("Объект");
Картинка = ПолучитьНавигационнуюСсылку(СпрОбъект, "Аватар");

Готово, на форме у нас картинка.

Подпишитесь на свежие статьи и новости
из мира 1С для ИТ-Директоров

Узнать преимущества подписки

Telegram канал Email рассылка

Узнайте почему нужно подписаться

Подпишитесь на свежие статьи и новости
из мира 1С для ИТ-Директоров

IT специалист Бухгалтер Финансист Руководитель/Собственник HR специалист

Подписаться

Нажимая на кнопку «Подписаться» вы соглашаетесь на обработку персональных данных

Двоичные данные и потоки

Говоря о двоичных данных, стоит упомянуть о возможности работы с потоками. Она появилась относительно недавно, а именно в версии 8.3.9. Чтобы потоком можно было читать из двоичных данных, применяется метод ОткрытьПотокДляЧтения. Допустим, у нас в базе данных лежит заархивированный xml-файл (как хранить файлы в базе данных рассматривалось ранее). Нам нужно вывести пользователю содержимое этого файла, или у вас настроен какой-то обмен, и вы передаете файлы в заархивированном виде (для экономии трафика).

Последовательность действий при работе с двоичными данными без использования потоков:

• Получить двоичные данные из базы;
• Записать их во временный файл;
• Разархивировать;
• Удалить временный файл;
• Прочитать разархивированный файл.

Последовательность действий при работе с потоками:

• Получить двоичные данные из базы;
• Открыть поток для чтения;
• Разархивировать;
• Прочитать разархивированный файл.

Пример кода без использования потоков:

Процедура ОбработкаФайлаНаСервере(АдресВХ)
 	БинДанные = ПолучитьИзВременногоХранилища(АдресВХ);
 	ВрФайл = ПолучитьИмяВременногоФайла("zip");
 	Если БинДанные <> Неопределено Тогда  	
      	БинДанные.Записать(ВрФайл);
      	ПолучитьФайлыАрхива(ВрФайл);
      	УдалитьФайлы(ВрФайл);
 	КонецЕсли;
КонецПроцедуры
 
Функция ПолучитьФайлыАрхива(ВрФайл)
 	Результат = Новый Массив();
 	
 	ЧтениеZipФайла = Новый ЧтениеZipФайла(ВрФайл);
 	ЧтениеZipФайла.ИзвлечьВсе("Путь к каталогу", РежимВосстановленияПутейФайловZIP.Восстанавливать);
 	ЧтениеZipФайла.Закрыть();    
КонецФункции

Пример кода по работе с потоком:

Процедура ОбработкаФайлаНаСервере(АдресВХ)
 	БинДанные = ПолучитьИзВременногоХранилища(АдресВХ);
 	Если БинДанные <> Неопределено Тогда  	
      	ПолучитьФайлыАрхива(БинДанные);
 	КонецЕсли;
КонецПроцедуры
 
Функция ПолучитьФайлыАрхива(БинДанные)
 	Результат = Новый Массив();
 	
 	ЧтениеZipФайла = Новый ЧтениеZipФайла(БинДанные.ОткрытьПотокДляЧтения());
 	ЧтениеZipФайла.ИзвлечьВсе("Путь к каталогу", РежимВосстановленияПутейФайловZIP.Восстанавливать);
 	ЧтениеZipФайла.Закрыть();    
КонецФункции

Если диск у вас на SSD, рекомендую использовать потоки не только в примере с архивацией, а везде, где это возможно. Да, в данном примере все же происходит запись на диск (разархивация), но будем надеяться, когда-нибудь 1С реализует метод двоичных данных ОткрытьПотокДляЗаписи.

Работа с Base64

Base64 – это стандарт, позволяющий кодировать двоичные данные в виде строки (для кодирования используется 64 символа таблицы ASCII, отсюда и название). Тип ДвоичныеДанные сериализуем, то есть его можно представить в виде XML, для этого применяется объект встроенного языка СериализаторXDTO. После сериализации данные представлены одним узлом base64Binary, содержимое которого есть последовательность байт, закодированная в формате Base64.

xmlns:xsi="">http://www.w3.org/2001/XMLSchema-instance">

строка в Base64

Платформа 1С также позволяет кодировать двоичные данные, не прибегая к сериализации. Для этого есть две функции:

<Строка> = Base64Строка(<ДвоичныеДанные>)

и

<ДвоичныеДанные> = Base64Значение(<Строка>)

Они преобразуются в Base64 и обратно в двоичные данные.

Если у вас остались вопросы по работе с двоичными данными в среде 1С:Предприятие, обратитесь к нашим специалистам и получите консультацию по 1С 8.3 или воспользуйтесь услугами по сопровождению 1С.