Как вывести HTML-документ в 1С

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

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

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

Способы вывода HTML в 1С: что выбрать

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

Поле HTML-документа опирается на браузерный движок, встроенный в платформу (в тонком и веб-клиенте поведение может отличаться от толстого клиента). Это важно учитывать: разметка, корректно отображающаяся в одном клиенте, в другом может выглядеть иначе, поэтому лучше использовать простой, валидный HTML без экзотических конструкций.

Вывод HTML через поле HTML-документа на форме

Создайте в конфигураторе форму объекта или произвольную форму и добавьте реквизит формы типа «Строка» (неограниченная длина). Затем перетащите реквизит в дерево элементов формы и измените вид поля на «Поле HTML-документа». После этого вывод сводится к присваиванию строки с разметкой.

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

Обработка кликов по ссылкам

Поле HTML-документа поддерживает событие ПриНажатии, которое срабатывает при клике по ссылке. В обработчике можно перехватить переход и выполнить произвольный код вместо открытия адреса — например, открыть карточку элемента справочника по ссылке вида «v8:Справочник.Товары.Код».

Для этого в обработчике события установите параметр отказа от стандартной обработки и разберите значение гиперссылки. Это стандартный приём для построения интерактивных дашбордов внутри 1С: HTML рисует интерфейс, а клики обрабатываются встроенным языком.

Загрузка HTML из файла или из интернета

Если разметка хранится во внешнем файле, прочитайте её объектом ЧтениеТекста с указанием кодировки — для HTML это чаще всего UTF-8. Неверная кодировка — самая частая причина «кракозябр» вместо кириллицы.

&НаСервере
Функция ПрочитатьHTMLИзФайла(ПутьКФайлу)
	Чтение = Новый ЧтениеТекста(ПутьКФайлу, КодировкаТекста.UTF8);
	Результат = Чтение.Прочитать();
	Чтение.Закрыть();
	Возврат Результат;
КонецФункции

Для загрузки страницы из интернета используйте HTTPСоединение и HTTPЗапрос. Полученное тело ответа — это и есть HTML-строка, которую можно вывести в поле документа. Учитывайте, что внешние ресурсы страницы (картинки, CSS) могут не загрузиться, если нет доступа к сети с компьютера пользователя или если веб-клиент блокирует смешанное содержимое.

Программная работа с объектом ДокументHTML

Объект ДокументHTML предназначен для чтения и записи HTML-файлов средствами платформы. В связке с ПостроительDOM он позволяет разобрать документ в дерево элементов и программно извлечь нужные данные — например, таблицы из присланной поставщиком HTML-спецификации.

Для записи HTML в файл используется ЗаписьHTML. Типовой сценарий: сформировать строку разметки, создать ДокументHTML через ЧтениеHTML и сохранить на диск. Это удобно для выгрузки отчётов, которые потом открываются в браузере без 1С.

1. 1
   Сформируйте строку с HTML-разметкой
2. 2
   Создайте ЧтениеHTML и установите строку через УстановитьСтроку
3. 3
   Постройте ДокументHTML через ПостроительDOM
4. 4
   Создайте ЗаписьHTML, откройте файл и вызовите Записать
5. 5
   Откройте файл в браузере и проверьте результат

Вывод HTML на печать и сохранение в PDF

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

Табличный документ поддерживает метод Записать с типом файла PDF, что полностью закрывает задачу формирования печатных форм без внешних компонентов. Но помните: произвольная HTML-вёрстка в табличный документ не конвертируется автоматически — макет нужно строить средствами 1С.

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

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

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

FAQ