mirror of
https://github.com/Nikolay-Shirokov/cc-1c-skills.git
synced 2026-07-22 04:31:02 +03:00
139 lines
7.5 KiB
Markdown
139 lines
7.5 KiB
Markdown
---
|
||
name: meta-compile
|
||
description: Создать объект метаданных 1С. Используй когда нужно создать или добавить справочник, документ, регистр, перечисление, константу, общий модуль, обработку, отчёт и др.
|
||
argument-hint: <JsonPath> <OutputDir>
|
||
allowed-tools:
|
||
- Bash
|
||
- Read
|
||
- Write
|
||
- Glob
|
||
---
|
||
|
||
# /meta-compile — генерация объектов метаданных из JSON
|
||
|
||
Принимает JSON-определение объекта → генерирует XML + модули в структуре выгрузки конфигурации и
|
||
регистрирует объект в `Configuration.xml`.
|
||
|
||
`ConfigDumpInfo.xml` намеренно не трогается: это служебный файл версий объектов, которым управляет
|
||
платформа (для инкрементальной выгрузки).
|
||
|
||
## Порядок работы
|
||
|
||
1. Составь JSON по синтаксису ниже → запиши во временный файл.
|
||
2. Запусти скрипт.
|
||
3. Изменить созданный объект — `/meta-edit`; проверить — `/meta-validate`.
|
||
|
||
```powershell
|
||
python ".codeassistant/skills/meta-compile/scripts/meta-compile.py" -JsonPath "<json>" -OutputDir "<ConfigDir>"
|
||
```
|
||
|
||
| Параметр | Описание |
|
||
|----------|----------|
|
||
| `JsonPath` | Путь к JSON-файлу |
|
||
| `OutputDir` | Корень выгрузки конфигурации (где `Configuration.xml`, `Catalogs/`, `Documents/`, …) |
|
||
|
||
## Формат JSON
|
||
|
||
**Один объект** `{ ... }` или **массив** объектов `[{ ... }, { ... }]` (batch — несколько объектов за прогон).
|
||
|
||
```json
|
||
{ "type": "Catalog", "name": "Номенклатура", "...свойства типа...": "..." }
|
||
```
|
||
|
||
`type` и `name` — обязательные. Остальное — по типу (см. индекс ниже). `synonym` по умолчанию выводится из
|
||
`name` (CamelCase → слова через пробел); можно задать явно строкой или мультиязычно: `"synonym": { "ru": "…", "en": "…" }`.
|
||
|
||
## Реквизиты (shorthand)
|
||
|
||
Массивы `attributes`, `dimensions`, `resources` и колонки в `tabularSections` задаются строками:
|
||
|
||
```
|
||
"Имя" → String(10)
|
||
"Имя: Тип" → с типом
|
||
"Имя: Тип | req, index" → с флагами
|
||
```
|
||
|
||
**Типы:** `String(100)`, `String(10, fixed)` (фикс. длина), `Number(15,2)`, `Boolean`, `Date`, `DateTime`,
|
||
`Time`, ссылочные `CatalogRef.Xxx` / `DocumentRef.Xxx` / `EnumRef.Xxx` / `DefinedType.Xxx` и т.п.
|
||
Составной тип — через `+`: `"Значение: String + Number(15,2) + CatalogRef.Контрагенты"`.
|
||
|
||
**Флаги** (после `|`, через запятую):
|
||
|
||
| Флаг | Значение | Где |
|
||
|------|----------|-----|
|
||
| `req` | обязательное заполнение | attributes, dimensions, resources |
|
||
| `index` | индексировать | attributes, dimensions |
|
||
| `indexAdditional` | индекс с доп. упорядочиванием | attributes |
|
||
| `multiline` | многострочное поле | attributes |
|
||
| `nonneg` | неотрицательное (Number) | attributes, resources |
|
||
| `master` | ведущее измерение | dimensions (регистры) |
|
||
| `mainFilter` | основной отбор | dimensions (регистры) |
|
||
| `denyIncomplete` | запрет незаполненных | dimensions |
|
||
| `useInTotals` | использовать в итогах | dimensions (регистр накопления) |
|
||
|
||
Реквизиту нужны свойства сверх shorthand (значение заполнения, параметры выбора, формат, подсказка, …) —
|
||
задаётся **объектной формой**, см. `reference/attributes.md`.
|
||
|
||
## Табличные части
|
||
|
||
```json
|
||
"tabularSections": { "Товары": ["Номенклатура: CatalogRef.Номенклатура", "Количество: Number(15,3)"] }
|
||
```
|
||
|
||
Ключ — имя ТЧ, значение — массив колонок (shorthand) ЛИБО объект со свойствами ТЧ (см. `reference/attributes.md`).
|
||
|
||
## Индекс: свойства по типам
|
||
|
||
Для каждого типа — свой reference-файл со свойствами, дефолтами и допустимыми значениями:
|
||
|
||
| Тип(ы) | Файл |
|
||
|--------|------|
|
||
| Catalog (справочник) | `reference/catalog.md` |
|
||
| Document, DocumentJournal, Sequence, DocumentNumerator | `reference/document.md` |
|
||
| InformationRegister, AccumulationRegister, AccountingRegister, CalculationRegister | `reference/registers.md` |
|
||
| ChartOfAccounts, ChartOfCharacteristicTypes, ChartOfCalculationTypes | `reference/charts.md` |
|
||
| ExchangePlan | `reference/exchangeplan.md` |
|
||
| BusinessProcess, Task | `reference/process.md` |
|
||
| Report, DataProcessor | `reference/report-dataprocessor.md` |
|
||
| CommonModule, ScheduledJob, EventSubscription | `reference/code.md` |
|
||
| HTTPService, WebService | `reference/web.md` |
|
||
| Enum, Constant, DefinedType | `reference/simple.md` |
|
||
| FunctionalOption, FilterCriterion, SettingsStorage, CommonForm, CommonPicture, CommonTemplate, служебные | `reference/other-types.md` |
|
||
|
||
Кросс-типовые детали:
|
||
- **`reference/attributes.md`** — объектная форма реквизита и колонки ТЧ (значение заполнения, параметры
|
||
выбора, формат, подсказка, границы, …) + свойства самой ТЧ.
|
||
- **`reference/blocks.md`** — блоки объекта: представления, команды (+ характеристики/стандартные реквизиты).
|
||
|
||
Эта инструкция и reference-файлы — полная документация. Не ищи примеры XML в выгрузках конфигураций.
|
||
|
||
## Примеры
|
||
|
||
Справочник с реквизитами:
|
||
```json
|
||
{ "type": "Catalog", "name": "Организации", "descriptionLength": 100,
|
||
"attributes": ["ИНН: String(12)", "КПП: String(9)", "Директор: CatalogRef.ФизическиеЛица"] }
|
||
```
|
||
|
||
Документ с движениями и ТЧ:
|
||
```json
|
||
{ "type": "Document", "name": "ПриходнаяНакладная",
|
||
"registerRecords": ["AccumulationRegister.ОстаткиТоваров"],
|
||
"attributes": ["Организация: CatalogRef.Организации", "Контрагент: CatalogRef.Контрагенты"],
|
||
"tabularSections": { "Товары": ["Номенклатура: CatalogRef.Номенклатура", "Количество: Number(15,3)", "Цена: Number(15,2)"] } }
|
||
```
|
||
|
||
Регистр сведений:
|
||
```json
|
||
{ "type": "InformationRegister", "name": "КурсыВалют", "periodicity": "Day",
|
||
"dimensions": ["Валюта: CatalogRef.Валюты | master, mainFilter, denyIncomplete"],
|
||
"resources": ["Курс: Number(15,4)", "Кратность: Number(10,0)"] }
|
||
```
|
||
|
||
Batch:
|
||
```json
|
||
[ { "type": "Enum", "name": "Статусы", "values": ["Новый", "Закрыт"] },
|
||
{ "type": "Catalog", "name": "Валюты" },
|
||
{ "type": "Constant", "name": "ОсновнаяВалюта", "valueType": "CatalogRef.Валюты" } ]
|
||
```
|