mxl-info

Name: mxl-info
Author: Nikolay-Shirokov

487stars90forks

How to install mxl-info?

nikolay-shirokov/cc-1c-skills/mxl-info

$npx -y skills add Nikolay-Shirokov/cc-1c-skills --skill mxl-info

Installs into the current project.

Summary

Анализ структуры макета табличного документа (MXL) — области, параметры, наборы колонок. Используй при разработке печати — получить области и заполняемые параметры макета

Files · 1

View on GitHub

SKILL.md

1	# /mxl-info — Анализ структуры макета
2
3	Читает Template.xml табличного документа и выводит компактную сводку: именованные области, параметры, наборы колонок. Заменяет необходимость читать тысячи строк XML.
4
5	## Использование
6
7	```
8	/mxl-info <TemplatePath>
9	/mxl-info <ProcessorName> <TemplateName>
10	```
11
12	## Параметры
13
14	\| Параметр \| Обязательный \| По умолчанию \| Описание \|
15	\|---------------\|:------------:\|--------------\|------------------------------------------\|
16	\| TemplatePath \| нет \| — \| Прямой путь к Template.xml \|
17	\| ProcessorName \| нет \| — \| Имя обработки (альтернатива пути) \|
18	\| TemplateName \| нет \| — \| Имя макета (альтернатива пути) \|
19	\| SrcDir \| нет \| `src` \| Каталог исходников \|
20	\| Format \| нет \| `text` \| Формат вывода: `text` или `json` \|
21	\| WithText \| нет \| false \| Включить статический текст и шаблоны \|
22	\| MaxParams \| нет \| 10 \| Макс. параметров в списке на область \|
23	\| Limit \| нет \| 150 \| Макс. строк вывода (защита от переполнения) \|
24	\| Offset \| нет \| 0 \| Пропустить N строк (для пагинации) \|
25
26	Укажите либо `-TemplatePath`, либо оба `-ProcessorName` и `-TemplateName`.
27
28	## Команда
29
30	```powershell
31	powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/mxl-info.ps1" -TemplatePath "<путь>"
32	```
33
34	Или по имени обработки/макета:
35	```powershell
36	powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/mxl-info.ps1" -ProcessorName "<Имя>" -TemplateName "<Макет>" [-SrcDir "<каталог>"]
37	```
38
39	Дополнительные флаги:
40	```powershell
41	... -WithText # включить текстовое содержимое ячеек
42	... -Format json # JSON-вывод для программной обработки
43	... -MaxParams 20 # показать больше параметров на область
44	... -Offset 150 # пагинация: пропустить первые 150 строк
45	```
46
47	## Чтение вывода
48
49	### Области — сортировка сверху вниз
50
51	Области перечислены в порядке документа (по позиции строки), а не по алфавиту. Это соответствует порядку вывода областей в коде заполнения — сверху вниз.
52
53	```
54	--- Named areas ---
55	Заголовок Rows rows 1-4 (1 params)
56	Поставщик Rows rows 5-6 (1 params)
57	Строка Rows rows 14-14 (8 params)
58	Итого Rows rows 16-17 (1 params)
59	```
60
61	Типы областей:
62	- Rows — горизонтальная область (диапазон строк). Получение: `Макет.ПолучитьОбласть("Имя")`
63	- Columns — вертикальная область (диапазон колонок). Получение: `Макет.ПолучитьОбласть("Имя")`
64	- Rectangle — фиксированная область (строки + колонки). Обычно использует отдельный набор колонок.
65	- Drawing — именованный рисунок/штрихкод.
66
67	### Пересечения
68
69	Когда есть области и Rows, и Columns (этикетки, ценники), скрипт выводит пары пересечений:
70
71	```
72	--- Intersections (use with GetArea) ---
73	ВысотаЭтикетки\|ШиринаЭтикетки
74	```
75
76	В BSL: `Макет.ПолучитьОбласть("ВысотаЭтикетки\|ШиринаЭтикетки")`
77
78	### Параметры и detailParameter
79
80	Параметры перечислены по областям. Если у параметра есть `detailParameter` (расшифровка), он показан ниже:
81
82	```
83	--- Parameters by area ---
84	Поставщик: ПредставлениеПоставщика
85	detail: ПредставлениеПоставщика->Поставщик
86	Строка: НомерСтроки, Товар, Количество, Цена, Сумма, ... (+3)
87	detail: Товар->Номенклатура
88	```
89
90	Это означает: параметр `Товар` отображает значение, а при клике открывает `Номенклатура` (объект расшифровки).
91
92	### Параметры из шаблонов (суффикс `[tpl]`)
93
94	Некоторые параметры встроены в шаблонный текст: `"Инв № [ИнвентарныйНомер]"`. Они заполняются через fillType=Template, а не fillType=Parameter. Скрипт всегда извлекает их и помечает суффиксом `[tpl]`:
95
96	```
97	НумерацияЛистов: Номер [tpl], Дата [tpl], НомерЛиста [tpl]
98	```
99
100	В BSL шаблонные параметры заполняются так же, как обычные:
101	```bsl
102	Область.Параметры.Номер = НомерДокумента;
103	Область.Параметры.Дата = ДатаДокумента;
104	```
105
106	Числовые подстановки вроде `[5]`, `[6]` (ссылки на сноски в официальных формах) игнорируются.
107
108	### Текстовое содержимое (`-WithText`)
109
110	Показывает статический текст (надписи, заголовки) и шаблонные строки с подстановками `[Параметр]`:
111
112	```
113	--- Text content ---
114	ШапкаТаблицы:
115	Text: "№", "Товар", "Ед. изм.", "Кол-во", "Цена", "Сумма"
116	Строка:
117	Templates: "Инв № [ИнвентарныйНомер]"
118	```
119
120	- Text — статические надписи (fillType=Text). Полезно для понимания назначения колонок.
121	- Templates — текст с подстановками `[ИмяПараметра]` (fillType=Template). Параметр внутри `[]` заполняется программно.

People who liked this also viewed

6 picks

Type

mxl-info

487stars90forks

View on GitHub

How to install mxl-info?

nikolay-shirokov/cc-1c-skills/mxl-info

$npx -y skills add Nikolay-Shirokov/cc-1c-skills --skill mxl-info

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# /mxl-info — Анализ структуры макета
2
3	Читает Template.xml табличного документа и выводит компактную сводку: именованные области, параметры, наборы колонок. Заменяет необходимость читать тысячи строк XML.
4
5	## Использование
6
7	```
8	/mxl-info <TemplatePath>
9	/mxl-info <ProcessorName> <TemplateName>
10	```
11
12	## Параметры
13
14	\| Параметр \| Обязательный \| По умолчанию \| Описание \|
15	\|---------------\|:------------:\|--------------\|------------------------------------------\|
16	\| TemplatePath \| нет \| — \| Прямой путь к Template.xml \|
17	\| ProcessorName \| нет \| — \| Имя обработки (альтернатива пути) \|
18	\| TemplateName \| нет \| — \| Имя макета (альтернатива пути) \|
19	\| SrcDir \| нет \| `src` \| Каталог исходников \|
20	\| Format \| нет \| `text` \| Формат вывода: `text` или `json` \|
21	\| WithText \| нет \| false \| Включить статический текст и шаблоны \|
22	\| MaxParams \| нет \| 10 \| Макс. параметров в списке на область \|
23	\| Limit \| нет \| 150 \| Макс. строк вывода (защита от переполнения) \|
24	\| Offset \| нет \| 0 \| Пропустить N строк (для пагинации) \|
25
26	Укажите либо `-TemplatePath`, либо оба `-ProcessorName` и `-TemplateName`.
27
28	## Команда
29
30	```powershell
31	powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/mxl-info.ps1" -TemplatePath "<путь>"
32	```
33
34	Или по имени обработки/макета:
35	```powershell
36	powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/mxl-info.ps1" -ProcessorName "<Имя>" -TemplateName "<Макет>" [-SrcDir "<каталог>"]
37	```
38
39	Дополнительные флаги:
40	```powershell
41	... -WithText # включить текстовое содержимое ячеек
42	... -Format json # JSON-вывод для программной обработки
43	... -MaxParams 20 # показать больше параметров на область
44	... -Offset 150 # пагинация: пропустить первые 150 строк
45	```
46
47	## Чтение вывода
48
49	### Области — сортировка сверху вниз
50
51	Области перечислены в порядке документа (по позиции строки), а не по алфавиту. Это соответствует порядку вывода областей в коде заполнения — сверху вниз.
52
53	```
54	--- Named areas ---
55	Заголовок Rows rows 1-4 (1 params)
56	Поставщик Rows rows 5-6 (1 params)
57	Строка Rows rows 14-14 (8 params)
58	Итого Rows rows 16-17 (1 params)
59	```
60
61	Типы областей:
62	- Rows — горизонтальная область (диапазон строк). Получение: `Макет.ПолучитьОбласть("Имя")`
63	- Columns — вертикальная область (диапазон колонок). Получение: `Макет.ПолучитьОбласть("Имя")`
64	- Rectangle — фиксированная область (строки + колонки). Обычно использует отдельный набор колонок.
65	- Drawing — именованный рисунок/штрихкод.
66
67	### Пересечения
68
69	Когда есть области и Rows, и Columns (этикетки, ценники), скрипт выводит пары пересечений:
70
71	```
72	--- Intersections (use with GetArea) ---
73	ВысотаЭтикетки\|ШиринаЭтикетки
74	```
75
76	В BSL: `Макет.ПолучитьОбласть("ВысотаЭтикетки\|ШиринаЭтикетки")`
77
78	### Параметры и detailParameter
79
80	Параметры перечислены по областям. Если у параметра есть `detailParameter` (расшифровка), он показан ниже:
81
82	```
83	--- Parameters by area ---
84	Поставщик: ПредставлениеПоставщика
85	detail: ПредставлениеПоставщика->Поставщик
86	Строка: НомерСтроки, Товар, Количество, Цена, Сумма, ... (+3)
87	detail: Товар->Номенклатура
88	```
89
90	Это означает: параметр `Товар` отображает значение, а при клике открывает `Номенклатура` (объект расшифровки).
91
92	### Параметры из шаблонов (суффикс `[tpl]`)
93
94	Некоторые параметры встроены в шаблонный текст: `"Инв № [ИнвентарныйНомер]"`. Они заполняются через fillType=Template, а не fillType=Parameter. Скрипт всегда извлекает их и помечает суффиксом `[tpl]`:
95
96	```
97	НумерацияЛистов: Номер [tpl], Дата [tpl], НомерЛиста [tpl]
98	```
99
100	В BSL шаблонные параметры заполняются так же, как обычные:
101	```bsl
102	Область.Параметры.Номер = НомерДокумента;
103	Область.Параметры.Дата = ДатаДокумента;
104	```
105
106	Числовые подстановки вроде `[5]`, `[6]` (ссылки на сноски в официальных формах) игнорируются.
107
108	### Текстовое содержимое (`-WithText`)
109
110	Показывает статический текст (надписи, заголовки) и шаблонные строки с подстановками `[Параметр]`:
111
112	```
113	--- Text content ---
114	ШапкаТаблицы:
115	Text: "№", "Товар", "Ед. изм.", "Кол-во", "Цена", "Сумма"
116	Строка:
117	Templates: "Инв № [ИнвентарныйНомер]"
118	```
119
120	- Text — статические надписи (fillType=Text). Полезно для понимания назначения колонок.
121	- Templates — текст с подстановками `[ИмяПараметра]` (fillType=Template). Параметр внутри `[]` заполняется программно.

People who liked this also viewed

6 picks

Type