meta-compile（元编译）

/meta-compile — генерация объектов метаданных из JSON DSL

Принимает JSON-определение объекта метаданных → генерирует XML + модули в структуре выгрузки конфигурации + регистрирует в Configuration.xml.

Параметры и команда

powershell.exe -NoProfile -File .claude/skills/meta-compile/scripts/meta-compile.ps1 -JsonPath "<json>" -OutputDir "<ConfigDir>"

OutputDir — директория, содержащая подпапки типов (Catalogs/, Documents/,...) и Configuration.xml.

Поддерживаемые типы (23)

Ссылочные

Catalog (Справочник), Document (Документ), Enum (Перечисление), ExchangePlan (ПланОбмена), ChartOfAccounts (ПланСчетов), ChartOfCharacteristicTypes (ПВХ), ChartOfCalculationTypes (ПВР), BusinessProcess (БизнесПроцесс), Task (Задача)

Регистры

InformationRegister (РегистрСведений), AccumulationRegister (РегистрНакопления), AccountingRegister (РегистрБухгалтерии), CalculationRegister (РегистрРасчёта)

Отчёты/Обработки

Report (Отчёт), DataProcessor (Обработка)

Сервисные

Constant (Константа), DefinedType (ОпределяемыйТип), CommonModule (ОбщийМодуль), ScheduledJob (РегламентноеЗадание), EventSubscription (ПодпискаНаСобытие), DocumentJournal (ЖурналДокументов), HTTPService (HTTPСервис), WebService (ВебСервис)

JSON DSL — краткий справочник

Полная спецификация: docs/meta-dsl-spec.md.

Корневая структура

{
  "type": "Catalog",
  "name": "Номенклатура",
  "synonym": "авто из name",
  ...type-specific...,
  "attributes": [...],
  "tabularSections": {...}
}

Реквизиты — shorthand

"ИмяРеквизита"                     — String без квалификаторов
"ИмяРеквизита: Тип"                — с типом
"ИмяРеквизита: Тип | req, index"  — с флагами

Типы: String(100), Number(15,2), Boolean, Date, DateTime, CatalogRef.Xxx, DocumentRef.Xxx, EnumRef.Xxx, ChartOfAccountsRef.Xxx, ChartOfCharacteristicTypesRef.Xxx, ChartOfCalculationTypesRef.Xxx, ExchangePlanRef.Xxx, BusinessProcessRef.Xxx, TaskRef.Xxx, DefinedType.Xxx.

Русские синонимы типов: Строка, Число, Булево, Дата, СправочникСсылка.Xxx, ДокументСсылка.Xxx, ПланСчетовСсылка.Xxx.

Флаги: req, index, indexAdditional, nonneg, master, mainFilter, denyIncomplete, useInTotals.

Примеры

Справочник

{ "type": "Catalog", "name": "Валюты" }

Перечисление

{ "type": "Enum", "name": "Статусы", "values": ["Новый", "Закрыт"] }

Константа

{ "type": "Constant", "name": "ОсновнаяВалюта", "valueType": "CatalogRef.Валюты" }

Определяемый тип

{ "type": "DefinedType", "name": "ДенежныеСредства", "valueTypes": ["CatalogRef.БанковскиеСчета", "CatalogRef.Кассы"] }

Общий модуль

{ "type": "CommonModule", "name": "ОбменДаннымиСервер", "context": "server", "returnValuesReuse": "DuringRequest" }

Шорткаты context: "server" → Server+ServerCall, "client" → ClientManagedApplication, "serverClient" → Server+ClientManagedApplication.

Регистр сведений

{
  "type": "InformationRegister", "name": "КурсыВалют", "periodicity": "Day",
  "dimensions": ["Валюта: CatalogRef.Валюты | master, mainFilter, denyIncomplete"],
  "resources": ["Курс: Number(15,4)", "Кратность: Number(10,0)"]
}

План обмена

{ "type": "ExchangePlan", "name": "ОбменССайтом", "attributes": ["АдресСервера: String(200)"] }

Журнал документов

{
  "type": "DocumentJournal", "name": "Взаимодействия",
  "registeredDocuments": ["Document.Встреча", "Document.ТелефонныйЗвонок"],
  "columns": [{ "name": "Организация", "indexing": "Index", "references": ["Document.Встреча.Attribute.Организация"] }]
}

HTTP-сервис

{
  "type": "HTTPService", "name": "API", "rootURL": "api",
  "urlTemplates": { "Users": { "template": "/v1/users", "methods": { "Get": "GET", "Create": "POST" } } }
}

Веб-сервис

{
  "type": "WebService", "name": "DataExchange", "namespace": "http://www.1c.ru/DataExchange",
  "operations": { "TestConnection": { "returnType": "xs:boolean", "handler": "ПроверкаПодключения", "parameters": { "ErrorMessage": { "type": "xs:string", "direction": "Out" } } } }
}

План счетов

{
  "type": "ChartOfAccounts", "name": "Хозрасчетный",
  "extDimensionTypes": "ChartOfCharacteristicTypes.ВидыСубконто", "maxExtDimensionCount": 3,
  "codeMask": "@@@.@@.@", "codeLength": 8,
  "accountingFlags": ["Валютный", "Количественный"],
  "extDimensionAccountingFlags": ["Суммовой", "Валютный"]
}

Бизнес-процесс

{ "type": "BusinessProcess", "name": "Задание", "attributes": ["Описание: String(200)"] }

Что генерируется

• {OutputDir}/{TypePlural}/{Name}.xml — метаданные объекта
• {OutputDir}/{TypePlural}/{Name}/Ext/ObjectModule.bsl — модуль объекта (Catalog, Document, Report, DataProcessor, ExchangePlan, ChartOfAccounts, ChartOfCharacteristicTypes, ChartOfCalculationTypes, BusinessProcess, Task)
• {OutputDir}/{TypePlural}/{Name}/Ext/RecordSetModule.bsl — модуль набора записей (4 типа регистров)
• {OutputDir}/{TypePlural}/{Name}/Ext/Module.bsl — модуль (CommonModule, HTTPService, WebService)
• {OutputDir}/{TypePlural}/{Name}/Ext/Content.xml — состав плана обмена (ExchangePlan)
• {OutputDir}/{TypePlural}/{Name}/Ext/Flowchart.xml — карта маршрута (BusinessProcess)
• Configuration.xml — автоматическая регистрация в <ChildObjects>

Верификация

/meta-info <OutputDir>/<TypePlural>/<Name>.xml    — проверка структуры