agentleFS
Nikolay-ShirokovNikolay-Shirokov/cc-1c-skills/.claude/skills/cfe-borrow/SKILL.md

cfe-borrow

Skill789 starsChanged 6 months agoMITView on GitHub

Заимствование объектов из конфигурации 1С в расширение (CFE). Используй когда нужно перехватить метод, изменить форму или добавить реквизит к существующему объекту конфигурации

2 other projects use a version of this, 2 of them edited.

Adopted by

Most recently taken up by

The file

Files
SKILL.md

/cfe-borrow — Заимствование объектов из конфигурации

Заимствует объекты из основной конфигурации в расширение. Создаёт XML-файлы с ObjectBelonging=Adopted и ExtendedConfigurationObject, добавляет запись в ChildObjects расширения.

Предусловие

Расширение должно быть создано (/cfe-init) и содержать валидный Configuration.xml.

Авто-определение ConfigPath

Если пользователь не указал -ConfigPath — попробуй определить автоматически:

  1. Прочитай .v8-project.json из корня проекта
  2. Разреши целевую базу (по имени, ветке или default — алгоритм из /db-list)
  3. Если у базы есть поле configSrc — используй как -ConfigPath
  4. Если configSrc нет — спроси у пользователя

Параметры

ПараметрОписание
ExtensionPathПуть к каталогу расширения (обязат.)
ConfigPathПуть к конфигурации-источнику (обязат.)
ObjectЧто заимствовать, batch через ;;. Обязателен, кроме -Check / -Actualize — там без него берётся всё заимствованное
CheckТолько сверить заимствованное с источником, ничего не меняя
ActualizeОсвежить из источника всё заимствованное в расширении
ModuleСоздать пустые модули объекта: ObjectModule, ManagerModule, RecordSetModule, ValueManagerModule (через запятую) или None. У типов с единственным модулем (CommonModule, HTTPService, WebService) он создаётся и без параметра
BorrowMainAttributeЗаимствовать основной реквизит формы: Form — реквизиты, используемые на форме, All — все реквизиты объекта. Не указан — не заимствует. Требует форму в -Object

Формат -Object

  • Catalog.Контрагенты — справочник
  • CommonModule.РаботаСФайлами — общий модуль
  • Document.РеализацияТоваров — документ
  • Enum.ВидыОплат — перечисление
  • Catalog.Контрагенты.Form.ФормаЭлемента — форма объекта (заимствование формы)
  • CommonForm.ВыборПериода — общая форма, вместе с содержимым (как форма объекта). С -BorrowMainAttribute владелец берётся из типа основного реквизита: объект (DataProcessorObject.X и т.п.), основная таблица динамического списка или константы набора констант
  • Document.ЗаказКлиента.TabularSection.Товары, Document.ЗаказКлиента.Attribute.Комментарий, Document.ЗаказКлиента.TabularSection.Товары.Attribute.Цена, InformationRegister.Цены.Dimension.Номенклатура — отдельный дочерний объект (реквизит, табличная часть, реквизит табличной части, измерение…), без формы. Виды: Attribute, TabularSection, Dimension, Resource, AddressingAttribute, AccountingFlag
  • Catalog.X ;; CommonModule.Y ;; Enum.Z — несколько объектов

Заимствование форм

Формат Тип.Имя.Form.ИмяФормы заимствует форму конкретного объекта. Если родительский объект ещё не заимствован — он будет заимствован автоматически.

Создаётся:

  1. Метаданные формы — Forms/ИмяФормы.xml с ObjectBelonging=Adopted, FormType=Managed
  2. Form.xml — Forms/ИмяФормы/Ext/Form.xml с копией исходной формы + <BaseForm> (начальное состояние)
  3. Module.bsl — пустой файл Forms/ИмяФормы/Ext/Form/Module.bsl
  4. Регистрация — <Form> в ChildObjects родительского объекта

Заимствование основного реквизита формы (-BorrowMainAttribute)

Когда нужно: пользователь хочет добавить новый реквизит в существующий объект конфигурации и вывести его на заимствованную форму. Без -BorrowMainAttribute форма заимствуется "пустой" — только визуальные элементы, без привязки к данным объекта. С -BorrowMainAttribute форма сохраняет привязки к реквизитам объекта (DataPath), что позволяет затем добавить на неё новые элементы через /form-edit.

Два режима:

  • Form — заимствует только те реквизиты объекта, которые уже выведены на форму. Оптимальный выбор для большинства случаев
  • All — заимствует все реквизиты и табличные части объекта. Используй если планируешь выводить на форму реквизиты, которых на ней ещё нет

Объект, чьи реквизиты заимствуются, — тот, что в типе основного реквизита формы. Обычно это владелец формы; если другой (форма обработки с основным реквизитом DocumentObject.X), заимствуется он сам и его реквизиты.

Типовой сценарий (добавление реквизита + вывод на форму):

  1. /cfe-borrow с -BorrowMainAttribute — заимствовать форму с реквизитами
  2. /meta-edit — добавить новый реквизит в объект расширения
  3. /form-edit — вывести реквизит на заимствованную форму

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

Заимствование реквизитов и табличных частей без формы

Формат Тип.Имя.<Вид>.<Имя> (и Тип.Имя.TabularSection.<ТЧ>.Attribute.<Реквизит>) заимствует один дочерний объект — реквизит, табличную часть, реквизит табличной части, измерение и т.п.:

  • родительский объект заимствуется автоматически, для реквизита табличной части — и сама табличная часть
  • табличная часть приходит без реквизитов. Форма, заимствованная позже с -BorrowMainAttribute, дозаимствует в неё недостающие реквизиты, собственные реквизиты сохраняются
  • объект из ссылочного типа реквизита (CatalogRef.Номенклатура) заимствуется оболочкой — пустым, без реквизитов и форм
  • вид не из списка или дочерний объект, которого нет в источнике, — ошибка, расширение не меняется

Коду модулей расширения реквизиты источника доступны и без заимствования — заимствуй их, только когда табличная часть нужна под собственные реквизиты или реквизит выводит своя форма расширения.

Собственный реквизит табличной части — когда форма не нужна (например, реквизит использует только код):

  1. /cfe-borrow -Object "Document.ЗаказКлиента.TabularSection.Товары"
  2. /meta-edit на Documents/ЗаказКлиента.xml расширения: -Operation add-ts-attribute -Value "Товары.пд_Скидка: Number(15,2)"

У плана видов характеристик, плана счетов и плана видов расчёта собственный реквизит в заимствованную табличную часть платформа не примет (отказ при обновлении конфигурации БД), у бизнес-процесса и задачи — только с платформы 8.3.25. Навык такую табличную часть заимствует, но выводит [WARN] — собственных реквизитов в неё не добавляй.

Своя форма расширения видит только заимствованные реквизиты объекта: путь Объект.Склад к незаимствованному реквизиту — «Неверный путь к данным». Заимствуй выводимые реквизиты по одному (Document.ЗаказКлиента.Attribute.Склад ;; Document.ЗаказКлиента.TabularSection.Товары.Attribute.Цена), саму форму создай через /form-add и /form-compile.

Команда

powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/cfe-borrow.ps1" -ExtensionPath src\cfe\extname -ConfigPath src\cf -Object "Catalog.Контрагенты"

Примеры

# Заимствовать один объект
... -ExtensionPath src\cfe\extname -ConfigPath src\cf -Object "Catalog.Контрагенты"

# Заимствовать справочник вместе с модулями объекта и менеджера
... -ExtensionPath src\cfe\extname -ConfigPath src\cf -Object "Catalog.Контрагенты" -Module ObjectModule,ManagerModule

# Общий модуль без файла модуля
... -ExtensionPath src\cfe\extname -ConfigPath src\cf -Object "CommonModule.РаботаСФайлами" -Module None

# Заимствовать форму (автоматически заимствует родительский объект)
... -ExtensionPath src\cfe\extname -ConfigPath src\cf -Object "Catalog.Контрагенты.Form.ФормаЭлемента"

# Несколько объектов за раз
... -ExtensionPath src\cfe\extname -ConfigPath src\cf -Object "Catalog.Контрагенты ;; CommonModule.ОбщийМодуль ;; Enum.ВидыОплат"

# Заимствовать форму с основным реквизитом (реквизиты по DataPath формы)
... -ExtensionPath src\cfe\extname -ConfigPath src\cf -Object "Catalog.Номенклатура.Form.ФормаЭлемента" -BorrowMainAttribute Form

# Заимствовать форму с ВСЕМИ реквизитами объекта
... -ExtensionPath src\cfe\extname -ConfigPath src\cf -Object "Catalog.Номенклатура.Form.ФормаЭлемента" -BorrowMainAttribute All

# После обновления конфигурации — освежить всё заимствованное
... -ExtensionPath src\cfe\extname -ConfigPath src\cf -Actualize

# Табличная часть без формы — под собственные реквизиты
... -ExtensionPath src\cfe\extname -ConfigPath src\cf -Object "Document.ЗаказКлиента.TabularSection.Товары"

# Реквизит документа и реквизит табличной части — для своей формы расширения
... -ExtensionPath src\cfe\extname -ConfigPath src\cf -Object "Document.ЗаказКлиента.Attribute.Склад ;; Document.ЗаказКлиента.TabularSection.Товары.Attribute.Цена"

Верификация

/cfe-validate <ExtensionPath> -ConfigPath <ConfigPath>

Конфигурацию-источник передавай и валидатору: заимствованные формы он проверяет по ней.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.