Как вывести картинку в 1С: форма, печать, отчёт

Вывод картинки в 1С — задача с несколькими разными сценариями: показать фото товара на форме элемента справочника, вставить логотип в печатную форму счёта, отобразить изображение в отчёте или в табличном документе. В каждом случае используются свои механизмы платформы, и универсального «одного способа» нет.

Ключевой момент — откуда берётся изображение. Картинка может храниться в базе данных (в реквизите типа «ХранилищеЗначения»), лежать в файле на диске, быть частью библиотеки картинок конфигурации или размещаться в макете. От источника зависит и код, и способ настройки.

Материал ориентирован на управляемые формы (такси-интерфейс), которые используются в актуальных конфигурациях вроде «1С:Бухгалтерия», «1С:Управление торговлей» и «1С:ERP». Отдельно разобраны печатные формы и отчёты на СКД, где вывод картинки устроен иначе.

Откуда 1С может взять картинку: четыре источника

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

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

Как вывести картинку на форме элемента справочника

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

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

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

Загрузка новой картинки делается через диалог выбора файла и метод НачатьПомещениеФайла: выбранный файл помещается во временное хранилище, затем на сервере его двоичные данные записываются в реквизит-хранилище объекта. После записи адрес обновляется, чтобы пользователь сразу увидел новое изображение.

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

Вывод картинки без изменения конфигурации

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

Второй вариант — расширение конфигурации. Через расширение можно добавить реквизит формы, элемент «Поле картинки» и обработчики, не снимая конфигурацию с поддержки. Это безопаснее прямой доработки: обновления типовой версии не затрут ваш код, а само расширение легко отключить при проблемах.

Как вставить картинку в печатную форму

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

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

ОбластьСтрока = Макет.ПолучитьОбласть("Строка");
ТабличныйДокумент.Вывести(ОбластьСтрока);
Рисунок = ТабличныйДокумент.Рисунки.Найти("ФотоТовара");
Если Рисунок <> Неопределено Тогда
    ДанныеКартинки = Выборка.ДанныеКартинки.Получить();
    Если ДанныеКартинки <> Неопределено Тогда
        Рисунок.Картинка = Новый Картинка(ДанныеКартинки);
    КонецЕсли;
КонецЕсли;

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

Картинка в отчёте на СКД и в динамическом списке

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

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

Типичные ошибки и как их избежать

Самая частая ошибка — вывод картинки в тонком клиенте с использованием пути к файлу на сервере. Код «Новый Картинка("C:\Images\photo.jpg")» сработает только если файл доступен именно с той машины, где выполняется код. В клиент-серверном режиме серверный код не видит диск пользователя, и наоборот. Правильный путь — передача двоичных данных через временное хранилище.

Вторая группа проблем — производительность и объём. Хранение фото по несколько мегабайт в базе без сжатия быстро раздувает её, а вывод полноразмерных изображений в списках тормозит интерфейс. Третья ошибка — отсутствие проверки на Неопределено: если картинки у объекта нет, обращение к данным хранилища без проверки приводит к ошибкам или пустым рамкам на форме.

Как проверить результат

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

Для печатной формы сформируйте документ с картинкой и без неё, выведите на предпросмотр и в PDF. Убедитесь, что рисунок не искажён, не обрезан и не сдвигает соседние области. Если форма используется в файловом и клиент-серверном режимах, проверьте оба — поведение при работе с файлами в них различается.

Частые вопросы