Сохранение двоичных данных в файл 1С: от простого к сложному

Работа с двоичными данными в 1С:Предприятие — одна из самых востребованных задач при интеграции с внешними системами, обработке вложений в документах или генерации отчетов в форматах PDF, Excel или изображений. Однако стандартные механизмы платформы не всегда интуитивно понятны: где-то требуется использовать ДвоичныеДанные, где-то — работать с потоками (Поток), а в некоторых случаях проще обойтись встроенными функциями без программирования.

В этой статье мы разберем 5 способов сохранения двоичных данных в файл — от ручных действий через интерфейс до автоматизированных решений на встроенном языке. Особое внимание уделим нюансам работы с большими файлами (от 100 МБ), кодировками и ограничениями платформы 1С:Предприятие 8.3. Если вы ищете способ экспорта вложений из справочников, генерации QR-кодов или сохранения отчетов в PDF — здесь найдете готовые решения с примерами кода.

1. Сохранение двоичных данных через интерфейс 1С (без программирования)

Не все задачи требуют написания кода. Если вам нужно сохранить вложение из документа или справочника (например, скан договора или фотографию товара), это можно сделать вручную за 3 клика:

• 📁 Откройте карточку документа/справочника с вложением (например, ДоговорыКонтрагентов → выберите нужный договор).
• 🖼️ Найдите поле с типом ХранилищеЗначения или ДвоичныеДанные (часто называется "Файлы", "Вложения", "Изображение").
• 💾 Кликните правой кнопкой по файлу → выберите Сохранить как... (в некоторых конфигурациях опция может называться "Экспортировать").

Этот метод подходит для единичных операций, но имеет ограничения:

• ❌ Нет возможности пакетного сохранения (придется повторять для каждого файла).
• ❌ Не работает, если поле с данными скрыто или доступно только для чтения.
• ❌ Нельзя автоматизировать (например, сохранять все вложения по расписанию).

2. Использование метода Записать() для объекта ДвоичныеДанные

Самый универсальный способ программного сохранения — работа с объектом ДвоичныеДанные. Этот метод подходит для любых типов файлов: от текстовых TXT/CSV до бинарных PDF, ZIP или изображений. Основное преимущество — простота кода и минимальные требования к правам пользователя.

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

// Получаем двоичные данные из поля "ФайлДоговора" справочника "ДоговорыКонтрагентов"
ДвоичныеДанные = Справочники.ДоговорыКонтрагентов.НайтиПоНаименованию("Договор №123").ФайлДоговора;

// Сохраняем в файл на рабочем столе пользователя
ИмяФайла = "C:\Users\" + ПользовательИнформация.ИмяПользователя() + "\Desktop\Договор_123.pdf";
ДвоичныеДанные.Записать(ИмяФайла);

// Проверяем результат
Если НЕ ФайлСуществует(ИмяФайла) Тогда
Сообщить("Ошибка сохранения файла!", СтатусСообщения.Важное);
КонецЕсли;

Ключевые моменты:

• 🔹 Метод .Записать() перезаписывает файл без предупреждения. Если нужно избежать потери данных, предварительно проверьте существование файла с помощью ФайлСуществует().
• 🔹 Путь к файлу должен быть доступен для записи. В корпоративных сетях часто блокируются системные папки (C:\Program Files).
• 🔹 Для больших файлов (>50 МБ) лучше использовать потоки (см. следующий раздел) — это снизит нагрузку на память.

3. Работа с потоками: сохранение больших файлов

Когда размер двоичных данных превышает 50–100 МБ, метод .Записать() может вызывать ошибки переполнения памяти или подвисания 1С. В таких случаях рекомендуется использовать объекты Поток и ПотокВФайл, которые обрабатывают данные порциями.

Пример оптимизированного кода для сохранения большого файла (например, архива базы данных):

// Получаем двоичные данные (например, из HTTP-запроса или хранилища)
ДвоичныеДанные = ПолучитьБольшойФайлИзИсточника(); // Ваша функция

// Создаем поток для записи
ИмяФайла = "D:\Backups\database_backup.zip";
ПотокЗаписи = Новый ПотокВФайл(ИмяФайла, Истина); // Истина = перезаписать если существует

// Создаем поток для чтения исходных данных
ПотокЧтения = Новый ПотокВПамяти(ДвоичныеДанные);

// Копируем данные порциями (буфер 1 МБ)
Буфер = Новый БуферДвоичныхДанных(1024 * 1024); // 1 MB
Пока ПотокЧтения.Прочитать(Буфер) > 0 Цикл
ПотокЗаписи.Записать(Буфер);
КонецЦикла;

// Закрываем потоки
ПотокЗаписи.Закрыть();
ПотокЧтения.Закрыть();

Сообщить("Файл успешно сохранен: " + ИмяФайла);

Преимущества этого подхода:

• 📈 Минимальное потребление памяти (данные обрабатываются порциями).
• 🛡️ Возможность отмены операции (например, по таймауту или по запросу пользователя).
• 🔄 Поддержка прогресс-бара (можно отслеживать процент выполнения).

⚠️ Внимание: При работе с потоками всегда закрывайте их явно (.Закрыть()), иначе файл может остаться заблокированным или сохраненным не полностью. В 1С:Предприятие 8.3.20+ для этого можно использовать конструкцию Попытка...Исключение с гарантированным закрытием.

В корпоративных средах часто требуется сохранять файлы не на локальный диск, а в сетевую папку (например, \\server\shared\documents) или облачное хранилище (Yandex.Disk, Google Drive). Для этого в 1С есть два подхода:

ИмяФайла = "\\server\shared\documents\contract_001.pdf";
ДвоичныеДанные.Записать(ИмяФайла);

// Получаем токен доступа к Yandex.Disk (заранее сохранен в настройках)
Токен = Константы.ТокенYandexDisk.Получить();

// Формируем запрос на загрузку
Запрос = Новый HTTPЗапрос("https://cloud-api.yandex.net/v1/disk/resources/upload");
Запрос.УстановитьЗаголовок("Authorization", "OAuth " + Токен);
Запрос.УстановитьТекст("path=/backups/database_2026.zip&overwrite=true");

// Получаем URL для загрузки
Ответ = Новый HTTPСоединение().Получить(Запрос);
ДанныеОтвета = JSON.Прочитать(Ответ.ПолучитьТекст());
URLЗагрузки = ДанныеОтвета.href;

// Загружаем файл
ЗапросФайла = Новый HTTPЗапрос(URLЗагрузки);
ЗапросФайла.УстановитьЗаголовок("Content-Type", "application/zip");
ЗапросФайла.УстановитьBodyИзДвоичныхДанных(ДвоичныеДанные);
ОтветЗагрузки = Новый HTTPСоединение().ОтправитьДляЗаписи(ЗапросФайла);

Если ОтветЗагрузки.КодСостояния = 201 Тогда
Сообщить("Файл успешно загружен в облако!");
Иначе
Сообщить("Ошибка: " + ОтветЗагрузки.ПолучитьТекст());
КонецЕсли;

// URL файла (например, PDF с отчетом)
URL = "https://example.com/reports/monthly_2026.pdf";

// Создаем HTTP-запрос
Запрос = Новый HTTPЗапрос(URL);
Соединение = Новый HTTPСоединение();
Ответ = Соединение.Получить(Запрос);

// Проверяем успешность запроса
Если Ответ.КодСостояния <> 200 Тогда
Сообщить("Ошибка скачивания: код " + Ответ.КодСостояния);
Возврат;
КонецЕсли;

// Сохраняем двоичные данные ответа в файл
ДвоичныеДанные = Ответ.ПолучитьBodyКакДвоичныеДанные();
ИмяФайла = "C:\Reports\monthly_2026.pdf";
ДвоичныеДанные.Записать(ИмяФайла);

Сообщить("Файл успешно скачан и сохранен!");

Соединение.ИгнорироватьОшибкиСертификата = Истина;

// Код для регламентного задания: сохранение вложений из документов "ЗаказыПокупателей"
Выборка = Документы.ЗаказыПокупателей.Выбрать();
Пока Выборка.Следующий() Цикл
Если ЗначениеЗаполнено(Выборка.Вложения) Тогда
Каталог = "D:\Exports\Orders\" + Формат(Выборка.Дата, "ДФ=yyyy-MM-dd") + "\";
СоздатьКаталоги(Каталог); // Создаем папку если не существует

Для Каждого Файл Из Выборка.Вложения Цикл
ИмяФайла = Каталог + Файл.Имя;
Файл.Данные.Записать(ИмяФайла);
КонецЦикла;
КонецЕсли;
КонецЦикла;

Попытка
ДвоичныеДанные.Записать(ИмяФайла);
Исключение
Сообщить("Ошибка: " + ОписаниеОшибки() + "|" + ИнформацияОбОшибке(), СтатусСообщения.Важное);
// Запись в журнал регистрации для анализа
ЖурналРегистрации.ЗаписатьСобытие("ОшибкаСохраненияФайла", УровеньЖурналаОшибка, , ОписаниеОшибки());
КонецПопытки;

Картинка = Справочники.Номенклатура.НайтиПоНаименованию("Товар1").Картинка;
Картинка.ПолучитьДвоичныеДанные().Записать("C:\Images\Товар1.jpg");

Справочники.Номенклатура.НайтиПоНаименованию("Товар1").Картинка.Записать("C:\Images\Товар1.jpg");

// Двоичные данные → Base64
Base64Строка = Base64Строка(ДвоичныеДанные);

// Base64 → Двоичные данные
ДвоичныеДанныеВосстановленные = Base64Значение(Base64Строка);

Макет = Документы.ЗаказПокупателя.СправкаРасчеты.ПолучитьМакет("МакетОтчета");
ТабДок = Новый ТабличныйДокумент;
ТабДок.Вывести(Макет);

// Сохраняем без диалога
ТабДок.Сохранить("C:\Reports\order_123.pdf", ТипФайлаТабличногоДокумента.PDF, Ложь);

ИмяВременногоФайла = ПолучитьИмяВременногоФайла("pdf");
ДвоичныеДанные.Записать(ИмяВременногоФайла);
// Работаем с файлом...
// Удаляем после использования
УдалитьФайлы(ИмяВременногоФайла);