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

Вывод изображений из 1С:Предприятие в HTML-документы или веб-интерфейсы — типичная задача при разработке отчётов, печатных форм или интеграции с внешними системами. Проблема в том, что 1С не работает с графикой напрямую как веб-браузер: здесь нет тега <img src="..."> в привычном виде. Картинки хранятся в базе как двоичные данные, и их нужно правильно извлечь, преобразовать и вставить в HTML.

В этой статье разберём все актуальные способы вывода изображений из 1С в HTML — от простого экспорта через временные файлы до динамической генерации через HTTP-сервисы и WebKit. Каждый метод проиллюстрирован рабочими примерами кода на встроенном языке 1С 8.3, с учётом нюансов работы с разными форматами (.jpg, .png, .bmp) и ограничениями платформы.

Особое внимание уделим типичным ошибкам: почему картинка не отображается в отчёте, как избежать проблем с кодировкой при передаче через Base64, и что делать, если изображение "билдится" в PDF, но не показывается в браузере. В конце статьи — FAQ с ответами на частые вопросы и чек-лист для проверки вашего кода.

1. Способ №1: Вывод через временный файл

Самый простой и надёжный метод — сохранить картинку из 1С во временный файл на диске, а затем ссылаться на него в HTML через тег <img>. Подходит для отчётов, которые генерируются на сервере и открываются локально (например, через ПечатьHTML).

Алгоритм:

Получаем двоичные данные картинки из справочника или документа.
Сохраняем их во временный файл с расширением .png или .jpg.
Формируем HTML-код с ссылкой на этот файл.
После использования удаляем временный файл.

Пример кода:

// Получаем картинку из справочника "Номенклатура"
Картинка = Справочники.Номенклатура.НайтиПоНаименованию("Товар1").ПолучитьКартинку();

// Создаём временный файл
ИмяФайла = КаталогВременныхФайлов() + "temp_image.png";
Картинка.Записать(ИмяФайла);

// Формируем HTML
HTMLТекст = "<html><body><img src='" + ИмяФайла + "' width='200'></body></html>";

// Выводим результат (например, в поле HTML-документа)
ЭлементыФормы.ПолеHTML.Значение = HTMLТекст;

⚠️ Внимание: Временные файлы накапливаются на сервере, если их не удалять. Используйте УдалитьФайлы(ИмяФайла) после формирования отчёта или реализуйте механизм автоматической очистки по расписанию.

Плюсы метода:

🔹 Простота реализации — не требует дополнительных компонент.
🔹 Работает в любых конфигурациях, включая базовые версии.
🔹 Поддерживает все форматы изображений, которые умеет читать 1С.

Минусы:

🔸 Не подходит для веб-клиента — путь к временному файлу будет невалидным.
🔸 Требует прав на запись в каталог временных файлов.

2. Способ №2: Кодирование в Base64 для встраивания в HTML

Если нужно передать картинку "внутри" HTML-кода (например, для отправки по почте или отображения в веб-клиенте), используйте кодирование в Base64. Этот метод преобразует двоичные данные изображения в текстовый формат, который можно вставить прямо в тег <img> через схему data:.

Формат ссылки:

<img src="data:image/png;base64,ЗДЕСЬ_ЗАКОДИРОВАННЫЕ_ДАННЫЕ">

Пример кода на 1С:

// Получаем картинку
Картинка = Документы.ЗаказПокупателя.ТекущийДокумент().ПолучитьИзображение();

// Кодируем в Base64
Завод = Новый ЗаводБезопасныхСтрок();
Base64Данные = Завод.ЗакодироватьСтрокуВBase64(Картинка.ПолучитьДвоичныеДанные());

// Формируем HTML
HTMLТекст = "<img src='data:image/png;base64," + Base64Данные + "'>";

Важные нюансы:

🔹 Указывайте правильный MIME-тип (image/png, image/jpeg).
🔹 Base64 увеличивает размер данных на ~33% — не используйте для больших изображений.
🔹 В 1С 8.3.20+ для кодирования можно использовать СтрокаBase64 из глобального контекста.

⚠️ Внимание: Некоторые почтовые клиенты (например, Outlook) могут блокировать отображение встроенных через Base64 изображений в письмах. Для рассылок лучше использовать прикреплённые файлы.

💡

Если картинка не отображается в браузере, проверьте её MIME-тип. Например, для .jpg используйте data:image/jpeg;base64,..., а не data:image/jpg;base64,... — последний вариант может не поддерживаться.

3. Способ №3: Использование HTTP-сервиса 1С

Для динамической выдачи изображений в веб-приложениях (например, при интеграции с сайтом) оптимально использовать HTTP-сервис. Этот метод позволяет получать картинки по URL, генерируемому 1С, без сохранения во временные файлы.

Алгоритм работы:

Создаём HTTP-сервис в конфигурации 1С.
Реализуем обработчик, который по идентификатору возвращает двоичные данные изображения.
В HTML вставляем тег <img src="http://ваш_сервер/hs/image?id=123">.

Пример кода для HTTP-сервиса:

Функция ПолучитьИзображение(Запрос) Экспорт
// Получаем ID картинки из параметров запроса
ID = Число(Запрос.Параметры.Получить("id"));

// Ищем картинку в базе (пример для справочника "Картинки")
Картинка = Справочники.Картинки.НайтиПоКоду(ID);
Если Картинка.Пустая() Тогда
Возврат Новый HTTPСервисОтвет(404, "Изображение не найдено");
КонецЕсли;

// Возвращаем двоичные данные с правильным MIME-типом
Ответ = Новый HTTPСервисОтвет(200);
Ответ.Заголовки.Вставить("Content-Type", "image/png");
Ответ.УстановитьТелоИзДвоичныхДанных(Картинка.Картинка.ПолучитьДвоичныеДанные());

Возврат Ответ;
КонецФункции

Преимущества метода:

🔹 Нет необходимости сохранять файлы на диск.
🔹 Картинки динамически подгружаются при обращении.
🔹 Можно реализовать кеширование на стороне сервера.

Ограничения:

🔸 Требует настройки IIS/Apache для публикации HTTP-сервиса.
🔸 Нужно контролировать доступ к сервису (авторизация, ограничение по IP).

Как опубликовать HTTP-сервис в 1С

Предприятие 8.3:

1. В конфигураторе откройте ветку "HTTP-сервисы".

2. Создайте новый сервис и укажите пространство имён (например, "/hs").

3. Добавьте обработчик для метода GET с именем "image".

4. Опубликуйте сервис через "Администрирование → Публикация на веб-сервере".

5. Убедитесь, что в настройках веб-сервера разрешён доступ к папке публикации.

4. Способ №4: Вывод через WebKit (для управляемых форм)

Если вам нужно отобразить картинку в управляемой форме 1С (например, в поле ПолеHTMLДокумента), можно использовать встроенный механизм WebKit. Этот метод подходит для толстого и тонкого клиента, но не работает в веб-клиенте.

Пример добавления изображения в поле HTML:

// Получаем картинку из реквизита формы
Картинка = Объект.КартинкаТовара;

// Преобразуем в Base64 (как в Способе №2)
Завод = Новый ЗаводБезопасныхСтрок();
Base64Данные = Завод.ЗакодироватьСтрокуВBase64(Картинка.ПолучитьДвоичныеДанные());

// Формируем HTML с встроенной картинкой
HTMLТекст = "<!DOCTYPE html>
<html>
<head><meta charset='utf-8'></head>
<body>
<h2>Карточка товара</h2>
<img src='data:image/png;base64," + Base64Данные + "' style='max-width: 300px;'>
</body>
</html>";

// Отображаем в поле формы
ЭлементыФормы.ПолеHTML.Значение = HTMLТекст;

Особенности работы с WebKit:

Параметр	Значение
Поддерживаемые форматы	`PNG`, `JPEG`, `GIF`, `BMP`
Макс. размер изображения	Ограничен памятью клиента (рекомендуется < 5 МБ)
Работа в веб-клиенте	❌ Нет
Работа в мобильном приложении	⚠️ Частично (зависит от версии)

⚠️ Внимание: При использовании WebKit в тонком клиенте большие изображения (> 2 МБ) могут вызывать зависание интерфейса. Оптимизируйте размер картинок перед выводом.

5. Способ №5: Экспорт в PDF с картинками

Если конечная цель — сформировать документ с изображениями (например, прайс-лист или каталог), удобно использовать механизм экспорта в PDF через ТабличныйДокумент или ТекстовыйДокумент. 1С умеет встраивать картинки прямо в PDF без промежуточных файлов.

Пример кода для добавления изображения в табличный документ:

// Создаём табличный документ ТабДок = Новый ТабличныйДокумент; // Добавляем картинку из справочника Картинка = Справочники.Номенклатура.НайтиПоНаименованию("Товар1").Картинка; ТабДок.ВставитьКартинку(1, 1, Картинка); // Экспортируем в PDF

ТабДок.Записать("C:\Temp\Прайс.pdf", ТипФайлаТабличногоДокумента.PDF);

Нюансы работы с PDF:

🔹 Картинки в PDF сжимаются автоматически, но качество может упасть.
🔹 Для многократного использования одного изображения (например, логотипа) сохраните его в ХранилищеДополнительнойИнформации.
🔹 В 1С:Предприятие 8.3.21+ поддерживается прозрачность PNG в PDF.

Если PDF генерируется для печати, проверьте настройки принтера: некоторые драйверы некорректно обрабатывают встроенные изображения. В таких случаях помогает экспорт в XPS с последующей конвертацией в PDF.

Сжать изображения до разумного размера (макс. 1000px по ширине)|Убедиться, что формат картинки — PNG или JPEG|Проверить права на запись в целевую папку|Отключить "Оптимизировать для веба" в настройках PDF (если важно качество)-->

6. Типичные ошибки и их решения

Даже опытные разработчики сталкиваются с проблемами при выводе изображений из 1С. Вот самые распространённые ошибки и способы их исправления:

Ошибка	Причина	Решение
Картинка не отображается в HTML	Неверный путь к файлу или MIME-тип	Проверьте существование файла и правильность тега `<img>`. Для `Base64` укажите корректный `data:image/...`.
Искажённые цвета в PDF	1С конвертирует цветовую модель при экспорте	Сохраните картинку в `RGB` (не `CMYK`) перед загрузкой в базу.
Ошибка "Неверный формат потока"	Повреждённые двоичные данные	Проверьте, что картинка корректно записана в базу (например, через `Картинка.Записать()` и `Картинка.Прочитать()`).
Медленная загрузка в веб-клиенте	Большой размер `Base64`-картинки	Сожмите изображение до 800px по большей стороне или используйте HTTP-сервис.

Ещё одна частая проблема — кэширование картинок в браузере. Если вы обновляете изображение в 1С, но в HTML по-прежнему видна старая версия, добавьте к URL случайный параметр:

<img src="image.png?ver=12345">

где 12345 — текущее время или хэш данных.

💡

Всегда проверяйте, что картинка физически существует в базе, перед попыткой её вывода. Используйте конструкцию Если Не Картинка.Пустая() Тогда..., чтобы избежать ошибок.

7. Оптимизация изображений для 1С

Перед загрузкой картинок в базу 1С рекомендуется их оптимизировать. Это уменьшит размер базы, ускорит генерацию отчётов и снизит нагрузку на сеть при работе с HTTP-сервисами. Основные правила:

🔹 Используйте PNG для изображений с прозрачностью или небольшим количеством цветов (логотипы, схемы).
🔹 Для фотографий выбирайте JPEG с качеством 70-80%.
🔹 Уменьшайте разрешение до необходимого (например, для отчётов хватит 800px по большей стороне).
🔹 Удаляйте EXIF-метаданные (они увеличивают размер файла на 10-30%).

Пример кода для сжатия изображения перед сохранением в 1С:

// Функция для сжатия JPEG (требует внешнюю компоненту или COM-объект) Функция СжатьИзображение(ИсходнаяКартинка, Качество = 80) Экспорт // Здесь должен быть код работы с внешней библиотекой (например, ImageMagick или GDI+) // Для упрощения вернём исходную картинку Возврат ИсходнаяКартинка; КонецФункции // Пример использования ОригинальнаяКартинка = Новый Картинка(ПутьКФайлу); СжатаяКартинка = СжатьИзображение(ОригинальнаяКартинка, 75);

Объект.Картинка = СжатаяКартинка;

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

🔹 Внешние обработки с подключением ImageMagick или GraphicsMagick.
🔹 COM-объекты (например, WIA.ImageFile в Windows).
🔹 Онлайн-сервисы (например, TinyPNG) через HTTP-запросы.

⚠️ Внимание: Детали интеграции с внешними библиотеками зависят от версии 1С и операционной системы. Перед использованием проверьте совместимость в базе знаний ИТС.

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

Можно ли вывести SVG из 1С в HTML?

Да, но с оговорками. 1С не умеет напрямую работать с SVG как с картинкой, но вы можете:

Сохранить SVG-файл как текст в реквизит типа Строка.
Вставить его содержимое прямо в HTML через тег <svg>...</svg>.

Пример:

HTMLТекст = "<html><body>" + Объект.SVGКод + "</body></html>";

Почему в отчёте картинка отображается разбитой на пиксели?

Это типичная проблема при экспорте в PDF через ТабличныйДокумент. Причины:

Слишком высокое разрешение исходного изображения (например, 3000x4000 px).
Неправильные настройки DPI при экспорте (по умолчанию 1С использует 72 DPI).

Решение: уменьшите изображение до 1000-1500 px по большей стороне или настройте параметры экспорта:

ПараметрыЭкспорта = Новый ПараметрыЭкспортаТабличногоДокументаВPDF();

ПараметрыЭкспорта.КачествоИзображений = КачествоИзображенийPDF.Высокое;

Как вывести картинку из 1С в Telegram-бот?

Для отправки изображений через Telegram API:

Сохраните картинку во временный файл (как в Способе №1).
Используйте метод sendPhoto с передачей файла:

HTTPЗапрос = Новый HTTPЗапрос("https://api.telegram.org/botТОКЕН/sendPhoto");
HTTPЗапрос.Заголовки.Вставить("Content-Type", "multipart/form-data");
HTTPЗапрос.ДобавитьПараметрКакФайл("photo", ИмяФайла);
Ответ = HTTPЗапрос.Выполнить();

Для Base64 используйте параметр photo с данными в формате data://image/png;base64,....

Можно ли анимировать картинки в отчётах 1С?

Нет, в стандартных механизмах 1С (HTML, PDF, табличные документы) анимация не поддерживается. Альтернативы:

Для управляемых форм: используйте ПолеHTMLДокумента с JavaScript-анимацией.
Для веб-клиента: встраивайте GIF через Base64 (см. Способ №2).
Для печатных форм: анимация невозможна — используйте статичные изображения.

Как вывести картинку из 1С в Excel?

Для вставки изображений в Excel через 1С:

Сохраните картинку во временный файл.
Используйте COM-объект Excel.Application:

Excel = Новый COMОбъект("Excel.Application");
Книга = Excel.Workbooks.Add();
Лист = Книга.Worksheets(1);
Лист.Shapes.AddPicture(ИмяФайла, 0, 1, 100, 100, 100, 100); // Последние 4 параметра — координаты и размер

Для 1С:Предприятие 8.3.20+ можно использовать ЗаписьДанныхXDTO для экспорта в XLSX с картинками.

Как вывести картинку из 1С в HTML: все рабочие методы с примерами