Как работать с двоичными данными в 1С

Двоичные данные в 1С — это способ представить любой файл (картинку, PDF, архив, XML-документ) как последовательность байтов, с которой платформа умеет работать напрямую. Без этого механизма невозможно сохранить вложение в базу, передать файл через веб-сервис, сформировать отчёт в формате Excel или подписать документ электронной подписью. Разработчик сталкивается с двоичными данными постоянно, даже если не осознаёт этого.

Основной объект для работы с байтами — тип ДвоичныеДанные. Его можно получить из файла на диске, из потока в памяти, из строки в кодировке Base64 или из временного хранилища. Поверх него работают объекты ЧтениеДанных, ЗаписьДанных, Поток и ФайловыйПоток, которые позволяют читать и писать данные порциями, не загружая большие файлы целиком в память.

Типичные сценарии: загрузка картинки в справочник, выгрузка документа в PDF, обмен файлами с внешними системами через HTTP, распаковка архивов, полученных от контрагентов. В каждом случае есть свои ограничения по размеру, кодировке и месту хранения, которые важно учитывать заранее.

Что такое тип ДвоичныеДанные и когда он нужен

Тип ДвоичныеДанные — это неизменяемый объект, содержащий массив байтов. «Неизменяемый» означает, что после создания объект нельзя модифицировать: любая операция преобразования создаёт новый объект. Это важно при работе с большими файлами — каждое копирование удваивает потребление памяти.

Получить двоичные данные проще всего из файла:

ДД = Новый ДвоичныеДанные("C:\Docs\dogovor.pdf");
Размер = ДД.Размер(); // размер в байтах

У объекта всего два полезных свойства: метод Размер() и возможность записи через Записать(ИмяФайла). Всё остальное — чтение по частям, поиск, конкатенация — делается через потоки и объекты ЧтениеДанных/ЗаписьДанных.

Чтение и запись файлов на диске

Базовый цикл работы с файлом: прочитать файл в двоичные данные, выполнить операции, записать результат обратно. Запись выполняется методом Записать():

ДД = Новый ДвоичныеДанные("C:\Temp\input.xlsx");
// ... обработка ...
ДД.Записать("C:\Temp\output.xlsx");

На тонком и веб-клиенте прямой доступ к файловой системе сервера невозможен, а доступ к диску клиента требует расширения работы с файлами. Поэтому файлы с клиента передают на сервер через временное хранилище: ПоместитьВоВременноеХранилище() на клиенте, затем ПолучитьИзВременногоХранилища() в серверной процедуре, где уже создаётся объект ДвоичныеДанные из адреса хранилища.

Учитывайте, что конструктор Новый ДвоичныеДанные загружает файл целиком в оперативную память. Для файлов в сотни мегабайт это приводит к аварийному завершению рабочего процесса сервера. В таких случаях используйте файловые потоки.

Хранение двоичных данных в базе

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

СпрОбъект = Справочники.Файлы.СоздатьЭлемент();
СпрОбъект.Наименование = ИмяФайла;
СпрОбъект.ДанныеФайла = Новый ХранилищеЗначения(ДД, Новый СжатиеДанных(9));
СпрОбъект.Записать();

Обратное извлечение — метод Получить() у значения реквизита. Конструктор хранилища поддерживает сжатие данных, что заметно экономит место для текстовых и офисных файлов, но почти бесполезно для уже сжатых форматов (JPEG, ZIP, MP4).

Помните: хранение большого числа файлов внутри базы увеличивает её размер, замедляет резервное копирование и выгрузку в dt. Для массового хранения вложений рассмотрите тома на диске (механизм «Файлы в томах» в типовых конфигурациях) — там в базе остаётся только ссылка на файл.

Передача через Base64 и временное хранилище

Двоичные данные нельзя передать как текст напрямую — байты испортятся. Для обмена через XML, JSON, HTTP и веб-сервисы используется кодировка Base64, которая представляет байты в виде безопасной строки:

Строка64 = Base64Строка(ДД);
ДДОбратно = Base64Значение(Строка64);

Учитывайте, что Base64 увеличивает объём данных примерно на треть. Для обмена файлами по HTTP предпочтительнее передавать тело запроса как двоичные данные без кодирования — объекты HTTPЗапрос умеют работать с ДвоичныеДанные напрямую через УстановитьТелоИзДвоичныхДанных() и ПолучитьТелоКакДвоичныеДанные().

Временное хранилище — стандартный мост между клиентом и сервером. Адрес в хранилище действует ограниченное время (по умолчанию — время жизни формы или сеанса), поэтому извлекайте данные сразу и не передавайте адрес между сеансами.

ДД = ПолучитьИзВременногоХранилища(АдресХранилища);
Строка = Base64Строка(ДД);
ДД2 = Base64Значение(Строка);
ДД2.Записать(ИмяФайла);

Потоки и порционная обработка больших файлов

Объекты Поток, ФайловыйПоток и ПотокВПамяти позволяют читать и писать данные частями. Это единственный безопасный способ обработки файлов, размер которых сопоставим с объёмом доступной памяти:

Поток = ФайловыеПотоки.ОткрытьДляЧтения(ИмяФайла);
Буфер = Новый БуферДвоичныхДанных(1048576); // 1 МБ
Пока Поток.Прочитать(Буфер, 0, Буфер.Размер) > 0 Цикл
// обработка порции
КонецЦикла;
Поток.Закрыть();

Для разбора структуры бинарного файла (заголовки, числовые поля фиксированной длины) используйте ЧтениеДанных: он умеет читать целые числа заданного размера и порядка байтов, строки и буферы. Симметричный объект ЗаписьДанных формирует бинарные файлы по частям.

Типичные ошибки и проверка результата

Самая частая ошибка — попытка прочитать двоичные данные как текст через ЧтениеТекста или наоборот. Если файл текстовый (XML, CSV, log) — используйте текстовые объекты с явным указанием кодировки; если бинарный — только двоичные механизмы. Смешение приводит к порче данных из-за перекодировки.

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

После записи файла проверяйте результат: существование файла, его размер и, при необходимости, контрольную сумму. Для критичных обменов согласуйте с контрагентом проверку по хешу (MD5/SHA) — объект ХешированиеДанных позволяет вычислить хеш прямо из 1С.

FAQ: частые вопросы о двоичных данных в 1С