Чтение: формы и макеты
Инструменты чтения: управляемые формы, картинки, HTML-макеты, схемы компоновки данных и макеты табличных документов.
Эти инструменты читают управляемые формы, картинки и макеты: HTML, схемы компоновки данных и табличные документы. Два инструмента формируют изображение формы или макета табличного документа в PNG.
| Инструмент | Что возвращает |
|---|---|
edt_form_structure · edt_form_render · edt_picture_export |
Возвращают структуру управляемой формы, ее изображение и содержимое изображения конфигурации. Структура включает autoTitle и дерево элементов: поля, группы, таблицы, кнопки и декорации. Для элементов указываются привязки данных, статические visible/enabled/readOnly, обработчики, свойства полей ввода, связь команды с кнопкой и условное оформление. Также возвращаются реквизиты, команды, параметры и обработчики формы; у команды заголовок в title, подсказка в toolTip, а также отличные от значений по умолчанию actionPurpose, associatedTable, currentRowUse и selectedRowsUse. Форма рисуется в PNG так, как ее показывает клиент 1С, в интерфейсе “Версия 8.5” или “Такси”, в светлой или темной теме, на любой странице, с данными примера; снимок редактора форм EDT тоже доступен. Для CommonPicture возвращается содержимое Picture.zip. |
edt_read_html_template |
Точный UTF-8 текст и sourceHash существующей языковой версии общего или вложенного HTML-макета. Нужны явные templateFqn и language; возвращает доступные языки и разрешенный моделью путь. |
edt_read_dcs |
Читает точный текст макета схемы компоновки данных - XML схемы в формате конфигуратора - с путем и sourceHash. |
edt_read_spreadsheet |
Читает табличный макет – макет печатной формы – как ширины колонок и именованные области строк из ячеек: text, parameter или template, с bold, fontSize, align, border, colspan и wrap. Ответ служит входом edt_write_spreadsheet; unsupported называет то, что в файле есть, но в описание не входит, например картинки и цвета. |
edt_spreadsheet_render |
Рисует макет в PNG так, как его показывает редактор макетов: ширины колонок, текст, <Параметр> для параметра, жирность, выравнивание, рамки, объединения и имена областей. Платформа и экран не нужны. |
edt_form_identifiers проверяет визуальные ID формы без ее изменения; инструмент описан на
странице записи форм.
Предпросмотр управляемой формы
edt_form_render рисует форму так, как ее показывает клиент 1С (engine="client", по умолчанию).
Мост раскладывает форму штатным механизмом EDT и передает результат; обвязка edt-bridge-mcp
рисует его страницей HTML и сохраняет PNG, сделанный Chromium. Параметры:
interface–v85(“Версия 8.5”, по умолчанию) илиtaxi;theme–lightилиdark. Темной темы для “Такси” в платформе нет, такой вызов отклоняется.page– страница по имени или заголовку; страницы формы перечислены в ответе вpages.dataзадает данные примера:titleдля окна иpageTitlesдля заголовков открытой формы по имени страницы, включая счетчики, которые вычисляет конфигурация.valuesпо имени элемента или пути к данным. Значение2или"partial"задает третье состояние флажка или переключателя в “Версии 8.5”. Для плашек выбранных значений передается объект вида{"items":["Первый"],"more":2}.tablesпо имени таблицы.rowsпринимает списки в порядке колонок или объекты по имени колонки. Для ячеек используется тот же формат плашек._level,_openи_checkзадают состояние узлов дерева и отметок,currentвыбирает текущую строку по индексу,titleзадает подпись над таблицей.hiddenиshownсодержат имена элементов, видимость которых меняет код формы.disabledзадает имена недоступных полей и команд.messagesзадает важные сообщения. У сообщения естьtext,type(info,warning,successилиerror) и имя группыgroup. Без группы сообщение стоит под шапкой.
density–auto(вариант масштаба самой формы),normalилиcompact. Клиент может выбрать компактный масштаб и для формы с вариантом “Авто”; этот выбор делает сервер, в форме его нет, поэтому для такой формы передайтеdensity="compact".widthзадает ширину окна,height– высоту окна в “Версии 8.5” или минимальную высоту в “Такси”, в пикселях до масштабирования. Без этих параметров окно подстраивается под содержимое.scale– масштаб PNG в процентах, по умолчанию 150. Рядом с PNG по путиoutPathсохраняется HTML.
Подписи – на языке конфигурации, включая стандартные реквизиты и стандартные команды, с
синонимами, которые им дала конфигурация. Командные панели показывают то, что в них выводит
платформа (autoCommandBar), остальное уходит в меню “Еще”. Значки и шрифты – собственные
веб-клиента: отрисовка берет их из установленной на машине платформы 1С:Предприятие 8.5 (выбор –
platformPath или EDT_BRIDGE_PLATFORM) и хранит в кэше пользователя; в состав EDT-Bridge они не
входят. Без платформы форма рисуется системными шрифтами и простыми значками, об этом говорит
warnings. В warnings также названы виды элементов, для которых отрисовки пока нет, и ключи
data, которые ни с чем не совпали. Для PNG нужно дополнение web (pipx inject edt-bridge-mcp playwright, затем playwright install chromium).
Размеры и цвета отрисовки сняты с веб-клиента 8.5.1. Окно, которое клиент открывает меньше
формы, прокручивается; на рисунке форма целиком. Элементы, которые код формы добавляет или
заполняет при открытии, – это данные: передайте их в data. Обвязка читает модуль формы и
называет в warnings то, что решает код: элементы, которые он добавляет при открытии, раскладку,
разную для вариантов интерфейса, элементы, которым он задает видимость или выбор из списка. У поля
только для чтения нет кнопок выпадающего списка и календаря, у редактируемой даты есть календарь.
Чтобы сохранить снимок формы в интерфейсе “Версия 8.5”, укажите имя открытого проекта EDT и полное имя формы. В PowerShell передайте параметры через файл JSON.
$argumentsFile = Join-Path $env:TEMP 'edt-form-render.json'
$arguments = @{
projectName = 'Demo'
formFqn = 'Catalog.Products.Form.ItemForm'
interface = 'v85'
theme = 'light'
outPath = Join-Path $env:TEMP 'product-form.png'
}
$arguments | ConvertTo-Json | Set-Content -LiteralPath $argumentsFile -Encoding UTF8
edt-bridge-mcp call edt_form_render --json-file $argumentsFile
Команда сохраняет product-form.png и product-form.html во временном каталоге.
Пути к файлам возвращаются в pngPath и htmlPath.
engine="edt" возвращает снимок редактора форм EDT, как раньше; к нему относятся variant,
density, ratio, width и height. Он использует штатный отрисовщик EDT для TAXI и VERSION8_5. Чтобы включить
отрисовку и получение изображения из буфера, передайте JVM параметры
-DnativeFormLayoutRender=true и -DnativeFormBufferedLayoutRender=true. Для headless EDT
с GTK также нужен работающий графический сеанс, например X-сервер Xvfb.
При передаче дополнительных параметров JVM графической программе запуска 1cedt
используйте --launcher.appendVmargs, чтобы сохранить параметры из файла INI поставки.
Получение изображения подтверждают ok=true, pngPath и положительное значение fileBytes.
В diagnostics могут быть указаны платформа SWT, состояние графического сеанса, настройки
отрисовщика и этап отрисовки. Если EDT не вернула изображение, проверьте .metadata/.log
в рабочей области EDT или откройте предпросмотр формы в графическом режиме EDT. При аварии
нативного процесса в рабочем каталоге EDT также может появиться hs_err_pid*.log.
На EDT 2026.2.2 с платформой 8.5.1.1529 headless EDT под Windows с SWT win32 вернула PNG для
обоих вариантов. В проверенном профиле Linux с GTK и Xvfb графическая и headless EDT дошли
до нативного процесса SCom, который завершился с ошибкой при инициализации. В этом профиле
предпросмотр не получен. Команда edt-bridge-mcp test-form запускает основную форму собранного
EPF или ERF либо форму документа/справочника по внутренней навигационной ссылке в явно выбранной
файловой тестовой базе. JSON-сценарии проверяют представления полей, содержимое табличного
документа и число сообщений; reopen проверяет ту же цель в новой сессии. Подготовка окружения,
примеры и ограничения описаны в руководстве по проверке форм.