К статье
Практический материал

Другое · 7 мин

Как вывести картинку в HTML в 1С

Как вставить картинку в HTML-документ в 1С: способы источников, base64, тег img, проверка отображения и типичные ошибки в разных клиентах.

В 1С картинка в HTML чаще всего нужна в печатных формах, письмах, внешних обработках и веб-интерфейсах. Источник изображения определяет, увидят ли его пользователи в тонком, веб- или мобильном клиенте.

Основной способ вывода — тег img. Недостаточно просто прописать src: файл должен быть доступен со стороны клиента, иначе вместо рисунка появится значок сбоя или пустое место.

Когда картинка в HTML нужна в 1С

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

Разные клиенты 1С по-разному обращаются к ресурсам. Толстый клиент иногда может открыть файл по сетевому пути, а тонкий и веб-клиент рассчитывают на URL, доступный из браузера. Мобильный клиент имеет ещё более строгие требования к доступности и размеру изображений.

Способы указания источника картинки

Внешняя ссылка

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

Встроенный base64

Изображение можно кодировать в строку base64 и вставлять напрямую в атрибут src через схему data:. Такой HTML не зависит от внешних ссылок и работает даже без доступа к сети. Минус — размер документа растёт, а большие изображения заметно увеличивают вес письма или печатной формы.

Локальный и сетевой путь

Указание пути вроде C:\images\logo.png работает только там, где у клиента есть прямой доступ к этому диску. В веб-клиенте такой путь обычно бесполезен, потому что браузер не имеет доступа к локальной файловой системе сервера или пользователя.

Порядок вставки картинки
  1. 1
    Определите источник картинки
  2. 2
    Подготовьте URL или закодируйте изображение в base64
  3. 3
    Напишите тег img с src и alt
  4. 4
    Откройте документ в нужном клиенте
  5. 5
    Проверьте, что изображение отображается

Тег img и его атрибуты

Минимальная запись выглядит так:

<img src="https://example.com/logo.png" alt="Логотип">
. Атрибут alt нужен для доступности и отображения, если картинка не загрузилась. Ширину и высоту можно задать через width, height или CSS, но лучше не растягивать маленькое изображение, иначе оно потеряет качество.

Если источник требует авторизации, браузер может не отобразить картинку без ввода логина и пароля. В веб-клиенте также возможны ограничения на смешанное содержимое, когда страница открыта по HTTPS, а картинка подгружается по HTTP. Такие ситуации проявляются как пустое место вместо рисунка.

Подготовка картинки внутри 1С

Изображение часто хранится в справочниках, документах или хранилище значений. Перед вставкой в HTML его нужно получить в виде массива байтов, определить MIME-тип и, если используется встраивание, преобразовать в base64. 1С предоставляет средства для работы с двоичными данными, но конкретные методы зависят от конфигурации и версии платформы.

Не стоит вставлять в HTML необработанный файл напрямую из информационной базы без проверки формата. Если расширение не соответствует содержимому, клиент может не распознать изображение. Перед массовой рассылкой рекомендуется проверить отображение на представительном наборе клиентов.

Отображение в разных клиентах

Толстый клиент чаще гибче в работе с файлами, но даже там сетевые пути могут быть недоступны на других компьютерах. Тонкий и веб-клиент полагаются на HTTP-доступ, поэтому внешние ссылки должны быть открыты для браузера пользователя. Мобильные клиенты могут ограничивать размер встроенных изображений и блокировать загрузку по медленным соединениям.

Типичные ошибки
01
Указали локальный путь к файлу вместо URL или base64
02
Забыли альтернативный текст и размер, что ломает вёрстку
03
Использовали слишком большое изображение для письма

При отправке писем через 1С важно учитывать, что почтовые клиенты получателей часто блокируют внешние изображения по соображениям безопасности. Встроенный base64 надёжнее для оформления, но увеличивает размер сообщения. Для больших файлов лучше использовать ссылку на общедоступное хранилище.

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

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

ИсточникКогда подходитОграничение
Внешняя ссылкаОбщий доступ для всех пользователейТребуется сетевой доступ и отсутствие блокировок
Встроенный base64Письма и автономные формыУвеличивает размер HTML-документа
Локальный или сетевой путьТолько при прямом доступе клиента к файлуНе работает в веб- и мобильных клиентах
Контрольные точки

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

Отображение картинки
Норма

Изображение открывается в целевом клиенте

Тревожный признак

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

Безопасная самостоятельная работа

Изменение шаблонов и обработок в 1С лучше проводить на копии конфигурации или в отдельной базе. Перед внесением правок создайте резервную копию, особенно если работаете с типовыми объектами. Неправильно составленный HTML может привести к ошибкам при печати или отправке документов.

Если после изменений форма перестала открываться или печатная форма выдаёт ошибку, верните предыдущую версию и проверьте синтаксис тега img. Не добавляйте в HTML сторонние скрипты и подключения к незнакомым ресурсам: это создаёт риски для данных и безопасности пользователей.

Альтернативы и границы применения

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

Не используйте HTML-вставки там, где достаточно обычного поля картинки в форме 1С. Тег img оправдан, когда нужна точная вёрстка, отправка по почте или публикация во внешнем интерфейсе. В остальных случаях встроенные средства платформы надёжнее и проще в поддержке.

Итог

Что важно запомнить

Картинку в HTML в 1С выводят через тег img с доступным источником; локальный путь сервера не подходит для тонкого и веб-клиентов, а большие base64-изображения увеличивают размер документа.

Нужно ли кодировать картинку в base64?

Не обязательно. Base64 удобен, когда изображение должно быть встроено в документ и не зависеть от внешних ссылок, например в письмах. Для больших картинок или множества получателей лучше использовать ссылку на общедоступный ресурс.

Почему локальный путь к файлу не работает?

Тонкий и веб-клиент запускаются на стороне пользователя или сервера приложений, а не имеют прямого доступа к локальным папкам рабочей станции. Поэтому путь вида C:\images\file.png чаще всего приводит к отсутствию изображения.

Что делать, если картинка отображается не у всех?

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

Можно ли использовать картинку из информационной базы напрямую?

Можно, но предварительно нужно получить её в виде двоичных данных и определить формат. Для вставки в HTML обычно требуется преобразование в подходящий источник: URL или base64-строку.