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

Другое · 7 мин

Вывод HTML на форму в 1С: способы и ограничения

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

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

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

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

Когда встроенное поле HTML подходит

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

Отличие управляемых и обычных форм

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

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

Управляемая формаЕсть встроенный HTML-элемент

Проверьте наличие поля HTML-документа в конфигураторе

Обычная формаОграниченные встроенные средства

Рассмотрите внешний браузер или отчёт

Веб-клиентБолее жёсткие ограничения

Тестируйте отображение до ввода в эксплуатацию

Как заполнить HTML-поле из модуля формы

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

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

Примерная последовательность действий

  1. Добавьте атрибут формы с типом, предназначенным для HTML-содержимого.
  2. Разместите соответствующий элемент на форме.
  3. В модуле формы сформируйте строку с HTML и присвойте её атрибуту перед открытием формы.
  4. Откройте форму и визуально проверьте отображение в каждом целевом клиенте.

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

Ограничения клиентов и безопасность

Не весь HTML, который корректно открывается в браузере, одинаково работает внутри 1С. Скрипты, внешние стили, ссылки на сторонние ресурсы и активные элементы могут быть заблокированы платформой или клиентом. Особенно это касается веб-клиента, где модель безопасности строже.

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

Альтернативы: внешний браузер и отчёты

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

Сравнение вариантов

Встроенное HTML-поле

Удобно для просмотра внутри формы, ограничено клиентом и платформой

Внешний браузер

Подходит для сложной разметки, требует отдельного действия

Отчёт или печатная форма

Надёжен для документов, менее удобен для быстрого просмотра на форме

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

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

Типичные ошибки
01
Прямое управление клиентским HTML-полем из серверного модуля без клиентского вызова
02
Использование скриптов и внешних ссылок без учёта ограничений веб-клиента
03
Отсутствие проверки кодировки, из-за которой русский текст отображается некорректно

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

После внедрения проверьте отображение на каждом поддерживаемом клиенте: толстом, тонком и веб, если они используются. Убедитесь, что разметка не ломается, картинки загружаются, а ссылки ведут на ожидаемые адреса. Обратите внимание на кодировку: русскоязычный текст может отображаться некорректно, если HTML сохранён в неподходящей кодировке.

Частые ошибки: попытка использовать серверный код для прямого управления клиентским элементом без вызова на клиенте, отсутствие проверки поддержки HTML-поля в веб-клиенте, вставка неэкранированных символов и использование внешних ресурсов, недоступных из сети пользователя.

Маршрут решения

Как выбрать действие

Управляемая форма и поддержка HTML-поля целевым клиентомИспользуйте встроенное поле HTML-документа
Веб-клиент или сложная активная разметкаОткрывайте HTML во внешнем браузере или используйте отчёт
Неизвестно, поддерживает ли клиент HTML-полеПроведите тестовое открытие на копии базы перед внедрением

Как выбрать подходящий способ

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

Граница безопасной самостоятельной работы — простая статическая разметка без скриптов и внешних ссылок, проверенная на целевых клиентах. Alles, что требует изменения конфигурации, работы с внешними компонентами или доступа к сетевым ресурсам, лучше согласовывать с администратором системы и тестировать на отдельной базе.

Итог

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

Выбор способа зависит от типа формы и клиента; встроенное HTML-поле подходит не всегда, а непроверенный активный HTML может быть небезопасен.

Нужно ли программирование для вывода HTML на форму?

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

Работает ли HTML-поле одинаково в веб-клиенте?

Не обязательно. Веб-клиент имеет более жёсткие ограничения по скриптам, стилям и внешним ресурсам, поэтому отображение нужно проверять отдельно для каждого целевого клиента.

Можно ли открывать произвольный HTML из интернета прямо на форме?

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

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

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

Нужно ли тестировать на копии базы?

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