Перейти к содержимому
EDT-Bridge
Русский
Esc
↑↓navigate↵open⌘Jpreview
На этой странице

Чтение: формы и макеты

Инструменты чтения: управляемые формы, картинки, 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 проверяет ту же цель в новой сессии. Подготовка окружения, примеры и ограничения описаны в руководстве по проверке форм.

Последнее обновление 22 ноября 2026 г.

Эта страница была полезной?