Как записать картинку в 1С: способы хранения и вывода изображений

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

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

Ниже разобраны все рабочие способы: от интерактивного прикрепления картинки в типовых конфигурациях до программной записи через встроенный язык, вывода на форму и в макет, а также типичные ошибки, из-за которых картинка «пропадает» или база начинает стремительно расти.

Как 1С хранит изображения: хранилище значений и двоичные данные

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

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

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

Как прикрепить картинку в типовой конфигурации без программирования

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

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

1. 1
   Откройте карточку объекта (товар, контрагент, документ)
2. 2
   Нажмите «Присоединенные файлы» или значок скрепки
3. 3
   Выберите «Добавить из файла» и укажите изображение
4. 4
   Для номенклатуры проверьте, что файл назначен основным изображением
5. 5
   Запишите объект и убедитесь, что картинка отображается в карточке

Программная запись картинки в реквизит объекта

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

ДвоичныеДанные = Новый ДвоичныеДанные("C:\Images\tovar1.jpg");
ТоварОбъект = СсылкаНаТовар.ПолучитьОбъект();
ТоварОбъект.ДанныеКартинки = Новый ХранилищеЗначения(ДвоичныеДанные, Новый СжатиеДанных(9));
ТоварОбъект.Записать();

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

Если картинка приходит извне не файлом, а строкой Base64 (например, из HTTP-сервиса или JSON), сначала выполняется декодирование: ДвоичныеДанные = Base64Значение(СтрокаBase64), дальше схема та же.

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

Как вывести картинку на форму

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

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

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

Вывод картинки в табличный документ и печатную форму

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

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

Конструктор Новый Картинка(ДвоичныеДанные) сам определяет формат по содержимому. Поддерживаются распространённые растровые форматы — PNG, JPEG, BMP, GIF. Если данные повреждены или это не изображение, платформа выдаст ошибку именно на этом этапе, поэтому при массовой печати полезна проверка на Неопределено и оборачивание в попытку.

Ограничения, объём базы и альтернативные варианты хранения

Главный риск хранения картинок в базе — неуправляемый рост объёма. Сотни фотографий товаров в исходном разрешении быстро превращают базу в многогигабайтную, что удлиняет резервное копирование, обновление и выгрузку в dt. Перед записью изображения стоит уменьшать до разумного размера — для карточки товара обычно достаточно разрешения порядка 800–1000 пикселей по большей стороне.

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

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

После записи убедитесь, что картинка действительно сохранилась: откройте объект в режиме предприятия и проверьте отображение, либо выполните обратное чтение — Получить() не должен вернуть Неопределено, а размер полученных двоичных данных должен быть больше нуля.

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

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