IngvarConsulting /mxl-info — Анализ структуры макета
MCP routing
- Preferred path: use MCP
unicatoolsunica.viewandunica.search. - Do not call internal MCP/CLI adapters directly. They are hidden behind
unicaand synchronized by the orchestrator. - Макет — узел логического дерева:
unica.view {at}по адресу<набор>:<Вид>.<Имя>.Template.<Макет>. Файлового селектора у чтения нет; путь, пришедший снаружи, переводит в адрес аварийныйunica.resolve.
Узел макета отдаёт компактную сводку: именованные области, параметры, наборы колонок. Читать тысячи строк XML не нужно.
Поддержка объекта-владельца приходит полем support; учитывай её состояние
перед правкой макета.
Адресация
| Что | Как |
|---|---|
| Имя набора исходников | unica.view {} |
| Адрес макета по имени | unica.search {corpus: "names", kind: "Template"} |
| Адрес по пути извне | unica.resolve {path} |
| Сам макет | unica.view {at: "<набор>:<Вид>.<Имя>.Template.<Макет>"} |
| Область макета | unica.view {at: "…Template.<Макет>.Area.<Область>"} |
| Содержимое ячеек области | unica.view {at: "…Area.<Область>.Body"} |
Поля узла
| Поле | Что содержит |
|---|---|
title |
Имя макета |
props.support |
Поддержка по Ext/ParentConfigurations.bin |
props.rows, props.columns |
Логическая высота и ширина по умолчанию |
props.columnSets |
Дополнительные наборы колонок: id и size |
ветвь Area |
Именованные области; счёт ветви равен их числу |
props.mergeCount, props.drawingCount |
Счётчики объединений и рисунков |
У узла области в props лежат kind (Rows, Columns, Rectangle,
Drawing), границы, columnsId, drawingId и contentCount — число непустых
ячеек. Ветвь Parameter перечисляет параметры области, ветвь Body — её
содержимое.
Пересечения строчных и колоночных областей для ПолучитьОбласть строятся из
ветви Area: возьми области kind: "Rows" и kind: "Columns" и перемножь
имена.
MCP вызов
Макет целиком
{
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": "unica.view",
"arguments": { "at": "main:Report.Продажи.Template.Печать" }
}
}
Одна область
{
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": "unica.view",
"arguments": { "at": "main:Report.Продажи.Template.Печать.Area.Шапка" }
}
}
Содержимое ячеек области
Текст ячеек — отдельный адрес, а не признак в аргументах: структурное чтение
области за текст не платит, а ветвь Body честно объявляет свою длину полем
contentCount.
{
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": "unica.view",
"arguments": { "at": "main:Report.Продажи.Template.Печать.Area.Шапка.Body" }
}
}
Каждая ячейка приходит в порядке чтения и несёт index, text и признак
template — стоят ли в ней подстановки [Параметр].
Чтение данных
Области отсортированы сверху вниз
Элементы ветви Area идут в порядке beginRow для строчных областей и
beginCol для колоночных, поэтому порядок совпадает с порядком в макете.
Параметры и detailParameter
Ветвь Parameter перечисляет параметры области. Параметры, пришедшие из
шаблонов ячеек, помечены суффиксом [tpl].
Параметры вне областей
Всё, что лежит за пределами именованных областей, собрано отдельно, а не растворено среди областей.