Как вывести картинку в СКД 1С: пошаговая инструкция с примерами

Вывод графических элементов в отчетах Системы Компоновки Данных (СКД) — задача, с которой рано или поздно сталкивается любой разработчик 1С:Предприятие. Несмотря на кажущуюся простоту, работа с изображениями в СКД имеет нюансы: от ограничений формата до особенностей хранения бинарных данных в базе. Эта статья поможет разобраться, как корректно встраивать статичные логотипы, динамически подгружать фотографии товаров из справочников или даже визуализировать графики прямо в отчете.

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

Статья будет полезна как начинающим программистам 1С, так и опытным специалистам, которые хотят систематизировать знания или найти решение для нестандартных задач. Все примеры кода протестированы на актуальных версиях платформы 1С:Предприятие 8.3 (включая 8.3.23).

1. Основные способы хранения изображений в 1С

Прежде чем выводить картинку в СКД, нужно понять, где и как она хранится в базе данных. От этого зависит выбор метода встраивания в отчет. В 1С изображения могут размещаться в четырех основных источниках:

📁 Внешние файлы — картинки хранятся на диске или в сетевой папке, в отчет подгружаются по пути. Подходит для логотипов и статичных изображений, которые редко меняются.
🗄️ Поля типа "ХранилищеЗначения" — стандартный способ хранения бинарных данных прямо в базе. Используется для фотографий товаров, сканов документов и другой привязанной к объектам графики.
🔤 Base64-кодирование — изображение преобразуется в текстовый формат и хранится в строковом поле. Удобно для передачи картинок через веб-сервисы или JSON.
📊 Динамическая генерация — создание графиков, диаграмм или QR-кодов прямо во время формирования отчета с помощью библиотек вроде OneScript.Graph.

Каждый из этих способов имеет плюсы и минусы. Например, внешние файлы просты в реализации, но требуют контроля за доступностью пути, а ХранилищеЗначения накладывает ограничения на размер изображения (по умолчанию до 2 Гб, но на практике рекомендуется не превышать 10-20 Мб для одного поля).

⚠️ Внимание: При использовании полей типа ХранилищеЗначения для хранения изображений учитывайте, что они увеличивают размер базы данных. Для крупных каталогов (например, интернет-магазинов с тысячами товаров) лучше использовать внешние хранилища или специализированные решения вроде 1С:Документооборот.

2. Подготовка изображения для вывода в СКД

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

Во-первых, проверьте формат изображения. СКД поддерживает стандартные графические форматы:

🖼️ .bmp — без сжатия, большой размер файла, но гарантированная совместимость;
🖼️ .jpg / .jpeg — сжатие с потерями, подходит для фотографий;
🖼️ .png — сжатие без потерь, поддерживает прозрачность;
🖼️ .gif — анимация не поддерживается, только статичные кадры;
🖼️ .tiff — редко используется в 1С из-за большого веса.

Во-вторых, оптимизируйте размер и разрешение. Для отчетов обычно достаточно ширины 300-600 пикселей. Избыточное разрешение (например, 4000×3000 пикселей с фотоаппарата) только увеличит время формирования отчета и размер итогового файла при экспорте в PDF или Excel.

Для конвертации и оптимизации можно использовать:

🛠️ Встроенные инструменты Windows (Paint, Фото);
🛠️ Онлайн-сервисы вроде TinyPNG или Compressor.io;
🛠️ Программы для пакетной обработки (XnConvert, IrfanView).

💡

Если изображение будет выводиться в отчете с прозрачным фоном (например, логотип), сохраняйте его в формате .png с альфа-каналом. Формат .jpg не поддерживает прозрачность!

3. Вывод статичной картинки (логотип, фон)

Самый простой случай — добавление логотипа компании или фонового изображения в шапку отчета. Здесь не требуется динамическая подгрузка, поэтому можно использовать внешний файл или ресурс конфигурации.

Способ 1: Через внешний файл

Поместите изображение (например, logo.png) в каталог базы данных или в сетевую папку, доступную для всех пользователей.
В схеме компоновки данных перейдите на закладку Настройки → Другие настройки → Ресурсы.
Добавьте новый ресурс типа Картинка, укажите путь к файлу (например, \\server\shared\logo.png или C:\Bases\Logo.png).
В макете отчета вставьте поле типа ПолеКартинки и свяжите его с созданным ресурсом.

Способ 2: Через ресурсы конфигурации

Если картинка должна быть частью конфигурации (например, для тиражных решений), ее можно добавить в дерево метаданных:

Откройте конфигуратор, перейдите в ветку Общие → Картинки.
Создайте новую картинку, импортируйте файл через меню Действия → Импорт из файла.
В схеме компоновки на закладке Ресурсы выберите тип КартинкаКонфигурации и укажите созданный объект.

Пример кода для программного добавления ресурса в схему:

СхемаКомпоновкиДанных = Новый СхемаКомпоновкиДанных;
Ресурс = СхемаКомпоновкиДанных.Ресурсы.Добавить(Тип("Картинка"));
Ресурс.Имя = "Логотип";
Ресурс.Значение = Новый Картинка(ПутьКФайлу);

⚠️ Внимание: При использовании сетевых путей (\\server\shared\...) убедитесь, что у всех пользователей есть права на чтение файла. В противном случае картинка не отобразится, а в логах появится ошибка "Файл не найден".

4. Динамический вывод изображений из базы данных

Гораздо чаще требуется выводить картинки, привязанные к данным — например, фотографии товаров из справочника Номенклатура или сканы документов. Для этого изображения должны храниться в полях типа ХранилищеЗначения.

Шаг 1: Настройка справочника

Добавьте в справочник реквизит типа ХранилищеЗначения:

// В модуле объекта справочника "Номенклатура"
Процедура ПриСозданииНаСервере(Отказ)
Реквизит = Реквизиты.Добавить("Фотография", Новый Реквизит("Фотография", Новый ОписаниеТипов("ХранилищеЗначения")));
КонецПроцедуры

Шаг 2: Загрузка изображения в базу

Для загрузки картинки из файла в поле ХранилищеЗначения используйте следующий код:

Процедура ЗагрузитьФотографию(ПутьКФайлу)
ДвоичныеДанные = Новый ДвоичныеДанные(ПутьКФайлу);
Объект.Фотография.Записать(ДвоичныеДанные);
КонецПроцедуры

Шаг 3: Вывод в СКД

В схеме компоновки данных:

Добавьте в набор данных поле с типом ХранилищеЗначения (например, Номенклатура.Фотография).
В макете отчета вставьте элемент ПолеКартинки и свяжите его с полем из набора данных.
Настройте параметры отображения: размер, выравнивание, обтекание текстом.

Пример настройки вывода в коде:

Элемент = Макет.Элементы.Добавить("ФотоТовара", Тип("ПолеКартинки"));
Элемент.ИсточникДанных = Новый ИсточникДанныхНаборДанных(НаборДанных, "Фотография");
Элемент.Ширина = 100;
Элемент.Высота = 100;

Поле в справочнике имеет тип ХранилищеЗначения|

Изображение загружено в двоичном формате|

В схеме компоновки добавлено поле с правильным именем|

Элемент ПолеКартинки связан с источником данных-->

5. Работа с Base64: когда и как использовать

Формат Base64 позволяет хранить изображения в текстовом виде, что удобно для обмена данными через JSON, XML или веб-сервисы. В СКД такое изображение можно вывести, предварительно декодировав его обратно в двоичный формат.

Преобразование изображения в Base64

Используйте следующий код для конвертации файла в строку:

Функция КартинкаВBase64(ПутьКФайлу) Экспорт
ДвоичныеДанные = Новый ДвоичныеДанные(ПутьКФайлу);
Возврат Base64Строка(ДвоичныеДанные);
КонецФункции

Вывод Base64-изображения в СКД

В схеме компоновки данных:

Добавьте вычисляемое поле, которое будет декодировать строку:

Поле = НаборДанных.ВычисляемыеПоля.Добавить("Картинка");
Поле.Выражение = "Base64Значение(ПолеBase64)";

В макете используйте ПолеКартинки, связанное с вычисляемым полем.

Пример полного цикла (загрузка → хранение → вывод):

// 1. Сохранение в Base64
Объект.ФотоBase64 = КартинкаВBase64("C:\Photos\product1.jpg");

// 2. В схеме компоновки
Поле = НаборДанных.ВычисляемыеПоля.Добавить("Фото");
Поле.Выражение = "Base64Значение(ФотоBase64)";

// 3. В макете
Элемент = Макет.Элементы.Добавить("ФотоТовара", Тип("ПолеКартинки"));
Элемент.ИсточникДанных = Новый ИсточникДанныхНаборДанных(НаборДанных, "Фото");

⚠️ Внимание: Использование Base64 увеличивает размер передаваемых данных на 33% по сравнению с оригинальным файлом. Для больших изображений (более 1 Мб) это может значительно замедлить формирование отчета. В таких случаях лучше использовать ХранилищеЗначения или внешние файлы.

6. Оптимизация и устранение ошибок

При работе с изображениями в СКД часто возникают проблемы, которые не всегда очевидны. Рассмотрим типичные ошибки и способы их решения:

Ошибка	Возможная причина	Решение
Картинка не отображается (пустое поле)	Неверный путь к файлу или отсутствуют права доступа	Проверьте путь через `Платформа.ФайловаяСистема.СуществуетФайл()`
Искаженное изображение или артефакты	Несовместимый формат (например, `.webp`) или поврежденные данные	Конвертируйте в `.png` или `.jpg` через внешние инструменты
Ошибка "Недопустимый формат данных"	Попытка вывести не картинку (например, `PDF` в поле `ПолеКартинки`)	Проверьте тип данных через `ТипЗнч(ДвоичныеДанные) = Тип("ДвоичныеДанные")`
Медленное формирование отчета	Слишком большие изображения (более 5 Мб)	Оптимизируйте размер через сжатие или уменьшение разрешения
Картинка обрезается при экспорте в `Excel`	Ограничения формата `XLSX` на размер встраиваемых объектов	Экспортируйте в `PDF` или настройте масштаб в макете

Для диагностики проблем используйте отладочную печать:

Сообщить(ТипЗнч(Объект.Фотография)); // Должно вернуть "ХранилищеЗначения"
Сообщить(Объект.Фотография.Размер()); // Проверка размера в байтах

Если изображение хранится во внешнем файле, проверьте его доступность:

Если НЕ Платформа.ФайловаяСистема.СуществуетФайл(ПутьКФайлу) Тогда
Сообщить("Файл не найден: " + ПутьКФайлу);
КонецЕсли;

Как проверить целостность двоичных данных?

Используйте функцию ХэшДвоичныхДанных() для сравнения контрольных сумм:

Хэш1 = ХэшДвоичныхДанных(ИсходныеДанные, "MD5");
Хэш2 = ХэшДвоичныхДанных(ЗагруженныеДанные, "MD5");
Если Хэш1 <> Хэш2 Тогда
Сообщить("Данные повреждены!");
КонецЕсли;

Это поможет выявить ошибки при передаче или сохранении изображений.

7. Продвинутые техники: динамическая генерация графики

Иногда требуется выводить не статичные картинки, а динамически сгенерированную графику — например, диаграммы, QR-коды или графики. Для этого можно использовать внешние библиотеки или встроенные механизмы.

Пример 1: Генерация QR-кода

С помощью библиотеки OneScript.QRCode:

QR = Новый QRCode;
QR.Текст = "https://example.com/product/" + Объект.Артикул;
ДвоичныеДанные = QR.ПолучитьИзображение(200, 200); // Размер 200x200 px
Объект.QRКод.Записать(ДвоичныеДанные);

Пример 2: Построение графика

Для визуализации данных прямо в отчете можно использовать OneScript.Graph:

График = Новый График;
График.ДобавитьСерию("Продажи");
Для Каждого Данные Из ДанныеПродаж Цикл
График.Серии["Продажи"].ДобавитьТочку(Данные.Дата, Данные.Сумма);
КонецЦикла;
ДвоичныеДанные = График.СохранитьВПамять("PNG");
Объект.ГрафикПродаж.Записать(ДвоичныеДанные);

Для вывода сгенерированной графики в СКД используйте стандартный механизм через ПолеКартинки, связав его с полем ХранилищеЗначения, куда сохранены двоичные данные.

⚠️ Внимание: Генерация графики в реальном времени может значительно увеличивать время формирования отчета. Для больших наборов данных (более 1000 точек) лучше предварительно сохранять изображения в кэш или внешнее хранилище.

💡

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

8. Экспорт отчетов с картинками: нюансы

Вывод изображений в экранной форме отчета — это только половина задачи. Часто требуется экспортировать отчет в PDF, Excel или HTML, сохраняя при этом картинки. Здесь есть несколько важных моментов:

Экспорт в PDF

📄 Поддерживает встраивание изображений без ограничений по формату;
📄 Сохраняет прозрачность PNG;
📄 Размер файла может значительно увеличиться при большом количестве картинок.

Пример кода для экспорта:

Макет = Отчет.Скомпоновать();
ДвоичныеДанные = Макет.Вывести(ТипФайлаPDF);
ДвоичныеДанные.Записать("C:\Reports\ОтчетСКартинками.pdf");

Экспорт в Excel

📊 Формат XLSX поддерживает изображения, но с ограничениями по размеру;
📊 В XLS (старый формат) картинки могут не отобразиться;
📊 При большом количестве изображений файл становится очень тяжелым.

Рекомендация: для Excel уменьшайте разрешение картинок до 150-200 пикселей по большой стороне.

Экспорт в HTML/MHTML

🌐 Картинки кодируются в Base64 или сохраняются как внешние файлы;
🌐 В MHTML все ресурсы встраиваются в один файл, что удобно для пересылки;
🌐 В обычном HTML пути к картинкам могут сломаться при переносе файла.

Для контроля качества экспорта используйте параметры компоновщика:

ПараметрыВывода = Новый ПараметрыВывода();
ПараметрыВывода.КачествоКартинок = 85; // Для JPEG (0-100)
Отчет.Вывести(Макет, ПараметрыВывода);

ПараметрыВывода.РазрешениеКартинок = 300;

-->

FAQ: Частые вопросы по выводу картинок в СКД

Можно ли вывести анимированный GIF в отчете?

Нет, СКД поддерживает только статичные изображения. Анимация в формате GIF будет показана как первый кадр. Для динамических эффектов используйте внешние инструменты (например, встраивание через HTML-документ).

Как вывести картинку из интернета по URL?

Нужно предварительно скачать изображение и сохранить его в ХранилищеЗначения или во внешний файл. Пример кода для загрузки:

HTTPСоединение = Новый HTTPСоединение("example.com");
ДвоичныеДанные = HTTPСоединение.Получить("/image.jpg");
Объект.Картинка.Записать(ДвоичныеДанные);

Учтите, что загрузка по HTTP может занять время и требует обработки ошибок (например, если сервер недоступен).

Почему картинки не отображаются при печати отчета?

Проблема может быть связана с:

Драйвером принтера (попробуйте экспорт в PDF и печатайте оттуда);
Настройками компоновщика (проверьте параметр ПечататьКартинки);
Разрешение изображений (слишком большие картинки могут обрезаться).

Решение: настройте макет так, чтобы картинки были не больше области печати, или используйте параметры:

ПараметрыВывода.ПечататьКартинки = Истина;

Как сделать картинку кликабельной в отчете?

В экранной форме отчета можно добавить обработчик события ПриНажатии для элемента ПолеКартинки:

Процедура ФотоТовараПриНажатии(Элемент, Данные)
ОткрытьФорму("Номенклатура.ФормаЭлемента", Новый Структура("Ключ", Данные.Ссылка));
КонецПроцедуры

В экспортируемых форматах (PDF, Excel) интерактивность не сохраняется.

Можно ли вывести картинку в группировке СКД?

Да, для этого:

Добавьте поле с картинкой в набор данных;
В настройках группировки на закладке Другие настройки включите опцию Показывать заголовок;
В макете группировки вставьте ПолеКартинки и свяжите его с нужным полем.

Пример: вывод логотипа категории товаров в заголовке группировки по ГруппаНоменклатуры.

Вывод картинок в системе компоновки данных 1С: от теории к практике