version: "1.0.1" name: extension-operations description: "Use for создания расширений конфигурации (CFE), заимствования объектов, генерации перехватчиков методов и анализа состава расширения. Helps управлять CFE через xml-gen extension init/borrow/diff/validate."

Extension Operations (CFE)

Работа с расширениями конфигурации 1С.

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

Команды

extension init

Создать расширение конфигурации.

xml-gen extension init <output_dir> <Name> [--config-path <configPath>] [--purpose Patch|Customization|AddOn] [--prefix <Prefix>]

Параметры (позиционные):

• <output_dir> — каталог, куда будет создано расширение (первый позиционный аргумент)
• <Name> — имя расширения (второй позиционный аргумент)

Параметры (флаги):

• --config-path — путь к базовой конфигурации (для чтения CompatibilityMode, DefaultLanguage и Language UUID). Без него — [WARN] Language ExtendedConfigurationObject set to zeros.
• --purpose — назначение (по умолчанию: Customization)
• --prefix — префикс имён (по умолчанию: из имени с суффиксом _)

Антипаттерн (старый синтаксис): --name <Name> и --config <Path> НЕ работают — CLI принимает имя и output как позиционные, а флаг для базовой конфигурации называется --config-path.

extension borrow

Заимствование объекта из базовой конфигурации.

xml-gen extension borrow <extensionPath> <configPath> "<objectSpec>"

Формат objectSpec:

• Catalog.Товары — заимствовать объект
• Catalog.Товары.Form.ФормаЭлемента — заимствовать форму
• Справочник.Товары — русские синонимы поддерживаются
• Catalog.Товары ;; Document.Заказ — batch (разделитель ;;)

extension diff

Анализ расширения: состав, перехватчики, проверка переноса.

xml-gen extension diff <extensionPath> <configPath> [--mode A|B]

• Mode A (по умолчанию): список объектов [BORROWED]/[OWN], BSL-перехватчики, анализ форм.
• Mode B: поиск &ИзменениеИКонтроль, проверка #Вставка/#КонецВставки, сверка с базовой конфигурацией.

extension borrow --borrow-main-attribute

Без флага заимствованная форма не имеет DataPath — form-edit упадёт при попытке вывести реквизит расширения.

# Реквизиты, уже выведенные на форме (рекомендуется)
xml-gen extension borrow <extPath> <configPath> "Catalog.Номенклатура.Form.ФормаЭлемента" --borrow-main-attribute form
 
# Все реквизиты и табличные части объекта
xml-gen extension borrow <extPath> <configPath> "Catalog.Номенклатура.Form.ФормаЭлемента" --borrow-main-attribute all

• form — только реквизиты, уже выведенные на форме (оптимально в большинстве случаев).
• all — все реквизиты объекта (нужно, если планируешь выводить реквизиты, которых на форме ещё нет).

Типовой сценарий: borrow с --borrow-main-attribute form → добавить реквизит → form-edit.

Важно: если объект уже заимствован — CLI добавляет недостающее, не перезаписывает.

extension patch-method

Генерация перехватчика метода в модуле расширения.

xml-gen extension patch-method <extPath> \
  --module "Catalog.X.Form.Y" \
  --method "ПриЗаписи" \
  --type Before|After|Instead|ModificationAndControl \
  [--config <configPath>]

Параметры:

• <extPath> — путь к каталогу расширения
• --module — путь к модулю в формате Тип.Имя.ТипМодуля или Тип.Имя.Form.ИмяФормы
• --method — имя перехватываемого метода типовой конфигурации
• --type — тип перехвата (см. таблицу)
• --config — путь к базовой конфигурации (обязателен для ModificationAndControl)

Типы перехвата:

Маппинг ModulePath → BSL-файл:

Аналогично для Report, DataProcessor и других типов объектов.

Имя процедуры-перехватчика формируется с NamePrefix расширения: Расш1_ПриЗаписи (читается из Configuration.xml расширения).

`ModificationAndControl`: CLI читает тело оригинального метода из --config и вставляет его с маркерами #Вставка/#КонецВставки. Требует --config.

При существующем файле: дописывает процедуру в конец модуля, не перезаписывает.

extension validate

Валидация расширения (9 проверок).

xml-gen extension validate <extensionPath>

Проверки: MetaDataObject/Configuration, InternalInfo (7 ClassId), Properties (ObjectBelonging, Name, Purpose, Prefix), enum-значения, ChildObjects, DefaultLanguage, файлы языков, каталоги объектов, заимствованные объекты (ObjectBelonging=Adopted + ExtendedConfigurationObject).

Ключевые концепции CFE

• ObjectBelonging: Adopted — заимствованный объект; отсутствие атрибута — собственный.
• ID-диапазоны: Base 1–999999, Extension 1000000+.
• BSL-перехватчики: декораторы &Перед, &После, &Вместо, &ИзменениеИКонтроль над процедурой с префиксом расширения.
• Маркеры переноса: #Вставка / #КонецВставки (или #Область <Префикс>_Вставка).
• Русские синонимы: Справочник → Catalog, Документ → Document, РегистрСведений → InformationRegister, ОбщийМодуль → CommonModule и др. — поддерживаются во всех командах.

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