| name | cfe-borrow |
| description | 1C CFE extension - borrow config object for method, form, or attribute interception. |
$cfe-borrow — Заимствование объектов из конфигурации
Заимствует объекты из основной конфигурации в расширение. Создаёт XML-файлы с ObjectBelonging=Adopted и ExtendedConfigurationObject, добавляет запись в ChildObjects расширения.
Предусловие
Расширение должно быть создано ($cfe-init) и содержать валидный Configuration.xml.
Авто-определение ConfigPath
Если пользователь не указал -ConfigPath — попробуй определить автоматически:
- Прочитай
.v8-project.json из корня проекта
- Разреши целевую базу (по имени, ветке или
default — алгоритм из $db-list)
- Если у базы есть поле
configSrc — используй как -ConfigPath
- Если
configSrc нет — спроси у пользователя
Параметры
| Параметр | Описание |
|---|
ExtensionPath | Путь к каталогу расширения (обязат.) |
ConfigPath | Путь к конфигурации-источнику (обязат.) |
Object | Что заимствовать (обязат.), batch через ;; |
BorrowMainAttribute | Заимствовать основной реквизит формы. Без параметра — не заимствует. Form — реквизиты, используемые на форме. All — все реквизиты объекта. Требует форму в -Object |
Формат -Object
Catalog.Контрагенты — справочникCommonModule.РаботаСФайлами — общий модульDocument.РеализацияТоваров — документEnum.ВидыОплат — перечислениеCatalog.Контрагенты.Form.ФормаЭлемента — форма объекта (заимствование формы)Catalog.X ;; CommonModule.Y ;; Enum.Z — несколько объектов
Поддерживаются все 44 типа объектов конфигурации.
Заимствование форм
Формат Тип.Имя.Form.ИмяФормы заимствует форму конкретного объекта. Если родительский объект ещё не заимствован — он будет заимствован автоматически.
Создаётся:
- Метаданные формы —
Forms/ИмяФормы.xml с ObjectBelonging=Adopted, FormType=Managed
- Form.xml —
Forms/ИмяФормы/Ext/Form.xml с копией исходной формы + <BaseForm> (начальное состояние)
- Module.bsl — пустой файл
Forms/ИмяФормы/Ext/Form/Module.bsl
- Регистрация —
<Form> в ChildObjects родительского объекта
Заимствование основного реквизита формы (-BorrowMainAttribute)
Когда нужно: пользователь хочет добавить новый реквизит в существующий объект конфигурации и вывести его на заимствованную форму. Без -BorrowMainAttribute форма заимствуется "пустой" — только визуальные элементы, без привязки к данным объекта. С -BorrowMainAttribute форма сохраняет привязки к реквизитам объекта (DataPath), что позволяет затем добавить на неё новые элементы через $form-edit.
Два режима:
Form (по умолчанию) — заимствует только те реквизиты объекта, которые уже выведены на форму. Оптимальный выбор для большинства случаевAll — заимствует все реквизиты и табличные части объекта. Используй если планируешь выводить на форму реквизиты, которых на ней ещё нет
Типовой сценарий (добавление реквизита + вывод на форму):
$cfe-borrow с -BorrowMainAttribute — заимствовать форму с реквизитами$meta-edit — добавить новый реквизит в объект расширения$form-edit — вывести реквизит на заимствованную форму
Защита существующих данных: если зависимый объект уже заимствован с содержимым (реквизитами, формами) — скрипт не перезаписывает его, а добавляет только недостающее.
Команда
python .agents/skills/cfe-borrow/scripts/cfe-borrow.py -ExtensionPath src -ConfigPath C:\cfsrc\erp -Object "Catalog.Контрагенты"
Примеры
... -ExtensionPath src -ConfigPath C:\cfsrc\erp -Object "Catalog.Контрагенты"
... -ExtensionPath src -ConfigPath C:\cfsrc\erp -Object "Catalog.Контрагенты.Form.ФормаЭлемента"
... -ExtensionPath src -ConfigPath C:\cfsrc\erp -Object "Catalog.Контрагенты ;; CommonModule.ОбщийМодуль ;; Enum.ВидыОплат"
... -ExtensionPath src -ConfigPath C:\cfsrc\erp -Object "Catalog.Номенклатура.Form.ФормаЭлемента" -BorrowMainAttribute
... -ExtensionPath src -ConfigPath C:\cfsrc\erp -Object "Catalog.Номенклатура.Form.ФормаЭлемента" -BorrowMainAttribute All
Верификация
$cfe-validate <ExtensionPath>
