Как вывести картинку в отчете на СКД в 1С

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

Главная сложность в том, что СКД сама по себе не «рисует» картинки из произвольных полей запроса. Для вывода изображения нужно либо использовать оформление ячейки с типом «Картинка», либо формировать макет вручную в модуле объекта отчета, либо применять программную обработку результата компоновки. Ниже разобраны рабочие варианты с конкретными настройками.

Откуда СКД может взять картинку

Прежде чем настраивать отчет, определите источник изображения. От этого зависит весь сценарий. Типичные варианты: реквизит типа «ХранилищеЗначения» в справочнике (например, «ФайлКартинки» у номенклатуры), присоединенные файлы через механизм БСП (работа с файлами), картинка, встроенная в макет конфигурации, либо картинка, формируемая кодом (штрихкод, QR-код).

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

Вывод картинки из хранилища значений через настройки СКД

Самый простой сценарий — картинка хранится в реквизите справочника с типом «ХранилищеЗначения». Создайте набор данных с запросом, в котором выбирается это поле, например: ВЫБРАТЬ Номенклатура.Ссылка, Номенклатура.ФайлКартинки ИЗ Справочник.Номенклатура. Добавьте поле «ФайлКартинки» в ресурсы или в выбранные поля отчета.

Далее откройте закладку «Настройки» схемы компоновки и для нужного поля задайте параметр оформления «Тип макета области» — но чаще используется другой путь: в настройках отчета на закладке «Дополнительные настройки» или через «Оформление» конкретного поля укажите параметр «ТипМакета» со значением «Картинка» для области детальных записей. Альтернатива — собственный макет СКД, где ячейке назначается тип «Картинка» и параметр с именем поля.

Для собственного макета СКД порядок такой: на закладке «Макеты» создайте макет для группировки, в ячейке, где должна быть картинка, установите в свойстве «Тип заполнения» значение «Параметр», а в свойствах ячейки макета (через «Свойства» области) укажите, что это картинка. Значением параметра будет поле с хранилищем значений — СКД сама извлечет изображение и выведет его в табличный документ.

1. 1
   В запросе набора данных выберите поле типа «ХранилищеЗначения» с картинкой
2. 2
   Добавьте поле в выбранные поля или ресурсы отчета
3. 3
   На закладке «Макеты» создайте макет для детальной записи
4. 4
   В ячейке картинки задайте тип заполнения «Параметр» и имя поля
5. 5
   В свойствах области макета укажите, что ячейка содержит картинку
6. 6
   Сформируйте отчет и проверьте вывод изображения

Вывод картинки из присоединенных файлов БСП

В типовых конфигурациях (УТ, ERP, БП) картинки номенклатуры чаще всего хранятся как присоединенные файлы, а не в реквизите объекта. В запросе СКД вы можете выбрать только ссылку на файл, но не его содержимое. Поэтому изображение подставляется программно на этапе формирования результата.

Реализация: в модуле объекта отчета переопределите событие «ПриКомпоновкеРезультата». После выполнения компоновщика макета используйте процессор вывода в табличный документ «вручную»: обходите элементы результата, и когда встречаете элемент с нужной группировкой, получаете данные файла (например, через данные присоединенного файла из хранилища) и вставляете картинку в область табличного документа методом «Рисунки.Добавить» либо через область макета с картинкой.

Альтернатива без ручного обхода — сформировать результат компоновки стандартно, а затем пройтись по готовому табличному документу и вставить картинки в заранее зарезервированные ячейки. Это проще в сопровождении, но требует жесткой привязки к координатам или поиска ячеек по тексту, что ломается при изменении структуры отчета.

Процедура ПриКомпоновкеРезультата(ДокументРезультат, ДанныеРасшифровки, СтандартнаяОбработка)
    СтандартнаяОбработка = Ложь;
    КомпоновщикМакета = Новый КомпоновщикМакетаКомпоновкиДанных;
    Макет = КомпоновщикМакета.Выполнить(СхемаКомпоновкиДанных,
        КомпоновщикНастроек.ПолучитьНастройки(), ДанныеРасшифровки);
    ПроцессорКомпоновки = Новый ПроцессорКомпоновкиДанных;
    ПроцессорКомпоновки.Инициализировать(Макет);
    ПроцессорВывода = Новый ПроцессорВыводаРезультатаКомпоновкиДанныхВТабличныйДокумент;
    ПроцессорВывода.УстановитьДокумент(ДокументРезультат);
    ПроцессорВывода.Вывести(ПроцессорКомпоновки);
    // Далее — вставка картинок в ячейки ДокументРезультат
КонецПроцедуры

Картинка из макета конфигурации и генерируемые изображения

Логотип компании, водяной знак или пиктограмма, одинаковые для всех строк, хранятся в общем макете конфигурации с типом «Двоичные данные» или «Картинка». Для вывода такой картинки в шапке отчета создайте в СКД собственный макет заголовка: в ячейке макета укажите тип «Картинка» и выберите нужную картинку из конфигурации, либо вставьте её программно через Новый Картинка(ПолучитьОбщийМакет("Логотип")).

Штрихкоды и QR-коды — отдельный случай: картинка формируется на лету. В типовых конфигурациях есть готовые механизмы генерации штрихкодов (например, подключаемые компоненты печати штрихкодов). Сформированную картинку вставляют в табличный документ результата в событии «ПриКомпоновкеРезультата», по аналогии с присоединенными файлами.

Типовые ошибки и ограничения

Частая ошибка — попытка вывести в ячейку поле с хранилищем значений как обычный текст. В результате в отчете появляется пустая ячейка или служебное представление вместо изображения. Причина: ячейке не задан тип «Картинка», и СКД трактует значение как строку.

Вторая типичная проблема — картинка выводится только в первой строке группировки. Это происходит, когда поле картинки размещено в ресурсах без группировки или макет создан не для того уровня группировки. Проверьте, что макет оформляет именно детальные записи, а поле доступно на этом уровне.

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

Проверка результата

После настройки сформируйте отчет и проверьте несколько контрольных точек. Картинка должна отображаться в каждой строке, где у объекта есть изображение; строки без картинки должны выводиться без ошибок, с пустой ячейкой. Убедитесь, что при выгрузке отчета в Excel или PDF изображения сохраняются — для табличного документа 1С это обычно работает, но стоит проверить на реальных данных.

Дополнительно проверьте поведение при группировке и отборах: если пользователь меняет настройки отчета, картинки не должны «съезжать» или дублироваться. При программной вставке по координатам такая проверка обязательна — смена порядка колонок ломает привязку.

FAQ