version: "1.0.1" name: meta-operations description: "Use for создания и редактирования объектов метаданных 1С (23 типа: справочники, документы, регистры, перечисления и др.) через xml-gen meta. Helps добавлять реквизиты, ТЧ, измерения и валидировать объекты конфигурации."

Meta Operations

Когда применять

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

Команды

meta compile

xml-gen meta compile <meta.json> <output_dir>

JSON DSL:

{
  "type": "Catalog",
  "name": "Товары",
  "codeLength": 9,
  "descriptionLength": 150,
  "hierarchical": true,
  "attributes": [
    "Артикул: String(50)",
    "Цена: Number(15,2)",
    "Производитель: CatalogRef.Контрагенты"
  ],
  "tabularSections": [
    { "name": "Штрихкоды", "attributes": ["Штрихкод: String(13)"] }
  ]
}

Полные свойства Catalog: hierarchical, hierarchyType (HierarchyFoldersAndItems|HierarchyItemsOnly), limitLevelCount, levelCount, foldersOnTop, codeLength, codeType (String|Number), codeAllowedLength (Variable|Fixed), codeSeries (WholeCatalog|WithinOwnerSubordination|WithinSubordination), descriptionLength, autonumbering, checkUnique, defaultPresentation (AsDescription|AsCode), subordinationUse (ToItems|ToFolders|ToFoldersAndItems), quickChoice, choiceMode (BothWays|FromChoiceForm|QuickChoice), editType (InDialog|InList|BothWays), owners (массив строк, напр. ["Catalog.Контрагенты"]).

Флаг реквизита `multiLine` — делает строковое поле многострочным (<MultiLine>true</MultiLine>). В shorthand: "Описание: String(500) | multiline".

meta info

xml-gen meta info [--mode brief|overview|full] <objectPath>

meta edit

xml-gen meta edit <objectPath> --op <operation> "<value>"

Операции: add-attribute / add-dimension / add-resource / add-ts / add-ts-attribute / add-enumValue / add-form / add-template / add-command / remove-attribute / remove-ts / remove-enumValue / modify-attribute / add-property / modify-property

Shorthand формат:

ИмяРеквизита: ТипДанных | флаги >> after/before Якорь

Примеры: "Артикул: String(50)", "Сумма: Number(15,2) | nonneg", "Контрагент: CatalogRef.Контрагенты | indexing"

Предопределенные данные:

# Простой shorthand, батч через ;;
xml-gen meta edit src/xml/Catalogs/Товары.xml --op add-predefined \
  --value "Основной|Основной элемент|000000001;;Группа|Группа||folder"
 
# Полное JSON-дерево элементов, включая пустой Code, ChildItems и поля планов
xml-gen meta edit src/xml/ChartsOfAccounts/Основной.xml --op add-predefined \
  --value @predefined-items.json

add-predefined поддерживает Catalog, ChartOfAccounts, ChartOfCalculationTypes, ChartOfCharacteristicTypes. В shorthand формат: Имя[|Описание[|Код[|folder]]]; явно пустое третье поле (Имя|Описание|) создает <Code/>, а отсутствующее третье поле генерирует следующий код. JSON-файл может быть массивом или объектом { "items": [...] }; поля элемента: name, code, description, isFolder, childItems, types, accountType, offBalance, order, accountingFlags, extDimensionTypes, actionPeriodIsBase, displaced.

Состав плана обмена:

xml-gen meta edit src/xml/ExchangePlans/РИБ.xml --op add-exchange-content \
  --value "Catalog.Товары|Deny;;Document.Заказ|Allow"
 
xml-gen meta edit src/xml/ExchangePlans/РИБ.xml --op add-exchange-content \
  --value @exchange-content-items.json

add-exchange-content поддерживает только объекты ExchangePlan. Shorthand формат: Metadata[|AutoRecord]; если AutoRecord не указан, используется Deny. JSON может быть массивом или объектом { "items": [...] } с полями metadata и autoRecord.

meta validate

~40 проверок: структура XML, UUID, Properties, boolean-свойства, type-specific правила (22 типа), строгая enum-валидация (HierarchyType, SubordinationUse, ChoiceMode, EditType, CodeAllowedLength, CodeSeries, NumberAllowedLength, RegisterRecordsDeletion, RegisterRecordsWritingOnPost, Periodicity, RequireCalculationTypes и др.), файловая структура.

xml-gen meta validate <objectPath>

Инварианты компиляции:

• FillFromFillingValue / FillValue / DataHistory — только для реквизитов InformationRegister; для других регистров вызывают XSD-ошибку при загрузке.
• Имена реквизитов, совпадающие со стандартными, отклоняются при компиляции: Ref, Code, Description, Parent, Owner, IsFolder, DeletionMark, PostingMode, DataVersion, Predefined, PredefinedDataName, Posted, Date, Number (и русские синонимы: Ссылка, Код, Наименование, Родитель, Владелец, ЭтоГруппа, ПометкаУдаления, РежимПроведения, ВерсияДанных, Предопределенный, ИмяПредопределенныхДанных, Проведен, Дата, Номер).

meta remove

xml-gen meta remove <configDir> <Type.Name> [--dry-run] [--keep-files] [--force]

Алгоритм: поиск файлов → проверка ссылок в XML/BSL → удаление из Configuration.xml ChildObjects → удаление из подсистем → удаление файлов.

Русские синонимы типов

В shorthand: Справочник → Catalog, Документ → Document, Перечисление → Enum, РегистрСведений → InformationRegister и т.д.

Batch JSON-патч (meta edit --batch)

# Один объект
xml-gen meta edit <objectPath> --batch patch.json
 
# Мультиобъектный патч (ObjectPath внутри JSON)
xml-gen meta edit --batch multi-patch.json

Применять при: нескольких операциях разных типов к одному объекту за один вызов, генерации патчей агентом, воспроизводимых миграциях схемы.

Inline batch через `;;`:

xml-gen meta edit <objectPath> --op add-attribute "Цена: Number(15,2) ;; Вес: Number(10,3) | nonneg"

Подробная спецификация, полная структура JSON, позиционная вставка, мультиобъектные патчи — references/batch-patch.md.

Статус: --batch <file.json> и inline ;; реализованы в xml-gen (Java, транзакционно).

depends_on: [] metadata: category: 1c-development version: "1.1"