diff --git a/docs/build-spec.md b/docs/build-spec.md index 8f3e8464..522ca423 100644 --- a/docs/build-spec.md +++ b/docs/build-spec.md @@ -295,10 +295,15 @@ Documents/РеализацияТоваровУслуг/Forms/ФормаДоку | `-Format Hierarchical` | Иерархическая структура каталогов (по умолчанию) | | `-Format Plain` | Плоская структура | -### Примечания +### Примечания по сборке -- Пустая ИБ достаточна для сборки, если обработка не ссылается на объекты конфигурации. -- Если обработка использует ссылочные типы конфигурации (`CatalogRef.*`, `DocumentRef.*` и т.п.) — в реквизитах, табличных частях или реквизитах форм — **сборка в пустой базе упадёт** с ошибкой XDTO. Необходима база с целевой конфигурацией. +- Если база не указана — скрипт `epf-build.ps1` автоматически создаёт временную базу. Для обработок со ссылочными типами (`CatalogRef.*`, `DocumentRef.*` и т.п.) генерируются заглушки метаданных. Временная база удаляется после сборки. +- Категории колонок регистров (Dimension/Resource/Attribute) угадываются по Form.xml — при round-trip через реальную базу привязки полей формы могут не сохраниться. + +### Примечания по разборке + +- Разборка **обязательно** требует базу с конфигурацией, содержащей используемые типы. +- Dump в пустой базе **безвозвратно** теряет ссылочные типы — `CatalogRef.XXX` превращается в `xs:string`. ## Запуск в режиме предприятия diff --git a/docs/epf-guide.md b/docs/epf-guide.md index e58e3584..f03dea63 100644 --- a/docs/epf-guide.md +++ b/docs/epf-guide.md @@ -159,6 +159,18 @@ src/ Первая добавленная форма автоматически становится основной (DefaultForm). Флаг `--main` нужен только для переназначения основной формы на другую. +## Сборка и разборка + +### Сборка (`/epf-build`, `/erf-build`) + +Если база не указана — автоматически создаётся временная база с заглушками метаданных для ссылочных типов. Явная база не обязательна, но предпочтительна — обеспечивает точное соответствие типов. + +Ограничение: категории колонок регистров (Dimension/Resource/Attribute) угадываются — при round-trip через реальную базу привязки полей формы могут не сохраниться. + +### Разборка (`/epf-dump`, `/erf-dump`) + +База с конфигурацией **обязательна**. Dump в пустой базе безвозвратно теряет ссылочные типы (`CatalogRef.XXX` → `xs:string`). + ## Технические детали - Все XML-файлы создаются в **UTF-8 с BOM** (как в реальных выгрузках 1С)