/meta-remove — удаление объекта метаданных

Безопасно удаляет объект из XML-выгрузки конфигурации. Перед удалением проверяет ссылки на объект в реквизитах, коде и других метаданных. Если ссылки найдены — удаление блокируется.

Использование

/meta-remove <ConfigDir> -Object <Type.Name>

Параметры

Параметр Обязательный Описание

ConfigDir да Корневая директория выгрузки (где Configuration.xml)

Object да Тип и имя объекта: Catalog.Товары , Document.Заказ и т.д.

DryRun нет Только показать что будет удалено, без изменений

KeepFiles нет Не удалять файлы, только дерегистрировать

Force нет Удалить несмотря на найденные ссылки

Команда

powershell.exe -NoProfile -File .claude/skills/meta-remove/scripts/meta-remove.ps1 -ConfigDir "<путь>" -Object "Catalog.Товары"

Что делает

• Находит файлы объекта: {TypePlural}/{Name}.xml и {TypePlural}/{Name}/

• Проверяет ссылки (блокирует при наличии, если нет -Force ):

• XML-типы в реквизитах других объектов: CatalogRef.Имя , DocumentRef.Имя и т.д.

• BSL-код: Справочники.Имя , Catalogs.Имя , вызовы общих модулей

• Журналы документов, подписки на события, определяемые типы

• Удаляет из Configuration.xml: убирает из <ChildObjects>

• Очищает подсистемы: рекурсивно удаляет из <Content>

• Удаляет файлы: XML-файл и каталог объекта

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

Catalog, Document, Enum, Constant, InformationRegister, AccumulationRegister, AccountingRegister, CalculationRegister, ChartOfAccounts, ChartOfCharacteristicTypes, ChartOfCalculationTypes, BusinessProcess, Task, ExchangePlan, DocumentJournal, Report, DataProcessor, CommonModule, ScheduledJob, EventSubscription, HTTPService, WebService, DefinedType, Role, Subsystem, CommonForm, CommonTemplate, CommonPicture, CommonAttribute, SessionParameter, FunctionalOption, FunctionalOptionsParameter, Sequence, FilterCriterion, SettingsStorage, XDTOPackage, WSReference, StyleItem, Language

Вывод (объект без ссылок)

=== meta-remove: Catalog.Устаревший ===

[FOUND] Catalogs/Устаревший.xml [FOUND] Catalogs/Устаревший/ (8 files)

--- Reference check --- [OK] No references found

--- Configuration.xml --- [OK] Removed <Catalog>Устаревший</Catalog> from ChildObjects [OK] Configuration.xml saved

--- Subsystems --- [OK] Removed from subsystem 'Справочники'

--- Files --- [OK] Deleted directory: Catalogs/Устаревший/ [OK] Deleted file: Catalogs/Устаревший.xml

=== Done: 4 actions performed (1 subsystem references removed) ===

Вывод (объект со ссылками — блокировка)

=== meta-remove: Catalog.Валюты ===

[FOUND] Catalogs/Валюты.xml [FOUND] Catalogs/Валюты/ (4 files)

--- Reference check --- [WARN] Found 3 reference(s) to Catalog.Валюты:

    Documents/СчетНаОплату.xml
      pattern: CatalogRef.Валюты
    InformationRegisters/КурсыВалют.xml
      pattern: CatalogRef.Валюты
    CommonModules/РаботаСВалютами/Ext/Module.bsl
      pattern: Справочники.Валюты

[ERROR] Cannot remove: object has 3 reference(s). Use -Force to remove anyway, or fix references first.

Код возврата: 0 = успешно, 1 = ошибки или найдены ссылки.

Проверяемые ссылки

Категория Паттерны поиска

XML-типы реквизитов CatalogRef.Name , DocumentRef.Name , EnumRef.Name и др.

BSL-код (рус.) Справочники.Name , Документы.Name , Перечисления.Name и др.

BSL-код (англ.) Catalogs.Name , Documents.Name , Enums.Name и др.

Общие модули Name. (вызовы методов), <Handler>Name. , <MethodName>Name.

Ссылки из Configuration.xml, ConfigDumpInfo.xml и подсистем НЕ считаются блокирующими — они очищаются автоматически.

Примеры

Проверка ссылок + dry run

... -ConfigDir C:\WS\tasks\cfsrc\acc_8.3.24 -Object "Catalog.Устаревший" -DryRun

Удалить объект без ссылок

... -ConfigDir C:\WS\tasks\cfsrc\acc_8.3.24 -Object "Catalog.Устаревший"

Принудительно удалить несмотря на ссылки

... -ConfigDir C:\WS\tasks\cfsrc\acc_8.3.24 -Object "Catalog.Устаревший" -Force

Только дерегистрировать (файлы оставить)

... -ConfigDir C:\WS\tasks\cfsrc\acc_8.3.24 -Object "Report.Старый" -KeepFiles

Удалить общий модуль

... -ConfigDir src -Object "CommonModule.МойМодуль"

Когда использовать

• Рефакторинг: удаление неиспользуемых объектов

• Очистка: удаление временных/тестовых объектов

• Перенос: удаление объекта перед пересозданием с другой структурой