epf

name	epf
description	Используй этот скилл для всех операций с внешними обработками 1С (EPF): создание (init), сборка (build), разборка (dump), добавление формы (add-form), регистрация в БСП (bsp-init), добавление команды БСП (bsp-add-command). Также используй при любой работе с EPF-файлами и их исходниками. Не используй для внешних отчётов (ERF) — используй erf; для добавления формы к объекту конфигурации — form-add.
argument-hint	<mode> [args...] # modes: init|build|dump|add-form|bsp-init|bsp-add-command
allowed-tools	["Bash","Read","Write","Edit","Glob","Grep"]

epf — Внешние обработки 1С (EPF)

Единый скилл для всех операций с внешними обработками EPF. Выбери нужный режим:

Режим	Что делает
init	Создать новую пустую обработку (scaffold XML)
build	Собрать EPF из XML-исходников
dump	Разобрать EPF в XML-исходники
add-form	Добавить управляемую форму к обработке
bsp-init	Зарегистрировать обработку в подсистеме БСП
bsp-add-command	Добавить команду в регистрацию БСП

---

Режим: init — создание обработки

Генерирует минимальный набор XML-исходников для внешней обработки (EPF) 1С.

Usage

epf init <Name> [Synonym] [SrcDir]

Параметр	Обязательный	По умолчанию	Описание
Name	да	—	Имя обработки (латиница/кириллица)
Synonym	нет	= Name	Синоним (отображаемое имя)
SrcDir	нет	src	Каталог исходников относительно CWD

Команда

powershell.exe -NoProfile -File scripts/epf-init.ps1 -Name "<Name>" [-Synonym "<Synonym>"] [-SrcDir "<SrcDir>"]

Что создаётся

<SrcDir>/
├── <Name>.xml          # Корневой файл метаданных (4 UUID)
└── <Name>/
    └── Ext/
        └── ObjectModule.bsl  # Модуль объекта с 3 регионами

• Корневой XML содержит MetaDataObject/ExternalDataProcessor с пустыми DefaultForm и ChildObjects
• ClassId фиксирован: c3831ec8-d8d5-4f93-8a22-f9bfae07327f
• Файл создаётся в UTF-8 с BOM

Дальнейшие шаги

• Добавить форму: epf add-form
• Добавить макет: /mxl template-add
• Добавить справку: /help-add
• Собрать EPF: epf build

---

Режим: build — сборка EPF

Собирает EPF файл из XML-исходников с помощью платформы 1С.

Usage

epf build <Name> [SrcDir] [OutDir]

Параметр	Обязательный	По умолчанию	Описание
Name	да	—	Имя объекта (имя корневого XML)
SrcDir	нет	src	Каталог исходников
OutDir	нет	build	Каталог для результата

Параметры подключения

Прочитай .v8-project.json из корня проекта. Возьми v8path и разреши базу:

1. Если пользователь указал параметры (путь, сервер) — используй напрямую
2. Если указал базу по имени — ищи в .v8-project.json
3. Если не указал — сопоставь ветку Git с databases[].branches
4. Если ветка не совпала — используй default
5. Если .v8-project.json нет — создай пустую ИБ в ./base

Если v8path не задан: Get-ChildItem "C:\Program Files\1cv8\*\bin\1cv8.exe" | Sort -Desc | Select -First 1

Команда

powershell.exe -NoProfile -File scripts/epf-build.ps1 -InfoBasePath "<путь>" -SourceFile "src\<Name>.xml" -OutputFile "build\<Name>.epf"

Параметр	Обязательный	Описание
-V8Path <путь>	нет	Каталог bin платформы
-InfoBasePath <путь>	*	Файловая база
-InfoBaseServer <сервер>	*	Сервер 1С
-InfoBaseRef <имя>	*	Имя базы на сервере
-UserName <имя>	нет	Пользователь
-Password <пароль>	нет	Пароль
-SourceFile <путь>	да	Корневой XML исходников
-OutputFile <путь>	да	Выходной EPF файл

* — нужен либо -InfoBasePath, либо пара -InfoBaseServer + -InfoBaseRef

Примечание: Если объект использует ссылочные типы конфигурации — сборка в пустой базе упадёт с ошибкой XDTO. Зарегистрируй базу с целевой конфигурацией через /db-list add.

---

Режим: dump — разборка EPF

Разбирает EPF файл в XML-исходники с помощью платформы 1С (иерархический формат).

Usage

epf dump <File> [OutDir]

Параметр	Обязательный	По умолчанию	Описание
File	да	—	Путь к EPF файлу
OutDir	нет	src	Каталог для выгрузки исходников

Параметры подключения

Аналогично режиму build — разрешение базы через .v8-project.json.

Команда

powershell.exe -NoProfile -File scripts/epf-dump.ps1 -InfoBasePath "<путь>" -InputFile "<файл>.epf" -OutputDir "src"

Параметр	Обязательный	Описание
-V8Path <путь>	нет	Каталог bin платформы
-InfoBasePath <путь>	*	Файловая база
-InfoBaseServer <сервер>	*	Сервер 1С
-InfoBaseRef <имя>	*	Имя базы на сервере
-UserName <имя>	нет	Пользователь
-Password <пароль>	нет	Пароль
-InputFile <путь>	да	Путь к EPF файлу
-OutputDir <путь>	да	Каталог для выгрузки
-Format <формат>	нет	Hierarchical (по умолч.) / Plain

Структура результата (Hierarchical)

<OutDir>/
├── <Name>.xml
└── <Name>/
    ├── Ext/
    │   └── ObjectModule.bsl
    ├── Forms/
    │   ├── <FormName>.xml
    │   └── <FormName>/Ext/Form.xml
    └── Templates/
        ├── <TemplateName>.xml
        └── <TemplateName>/Ext/Template.<ext>

---

Режим: add-form — добавление формы

Создаёт управляемую форму и регистрирует её в корневом XML обработки.

Usage

epf add-form <ProcessorName> <FormName> [Synonym] [--main]

Параметр	Обязательный	По умолчанию	Описание
ProcessorName	да	—	Имя обработки (должна существовать)
FormName	да	—	Имя формы
Synonym	нет	= FormName	Синоним формы
--main	нет	авто	Установить как форму по умолчанию
SrcDir	нет	src	Каталог исходников

Команда

powershell.exe -NoProfile -File scripts/add-form.ps1 -ProcessorName "<ProcessorName>" -FormName "<FormName>" [-Synonym "<Synonym>"] [-Main] [-SrcDir "<SrcDir>"]

Что создаётся

<SrcDir>/<ProcessorName>/Forms/
├── <FormName>.xml                    # Метаданные формы (1 UUID)
└── <FormName>/
    └── Ext/
        ├── Form.xml                  # Описание формы (logform namespace)
        └── Form/
            └── Module.bsl           # BSL-модуль с 5 регионами

• <SrcDir>/<ProcessorName>.xml — добавляется <Form> в ChildObjects, обновляется DefaultForm
• FormType: Managed; UsePurposes: PlatformApplication, MobilePlatformApplication
• AutoCommandBar с id=-1; Реквизит "Объект" с MainAttribute=true

---

Режим: bsp-init — регистрация в БСП

Добавляет в модуль объекта обработки функцию СведенияОВнешнейОбработке() для подсистемы БСП.

Usage

epf bsp-init <ProcessorName> <Вид> [Назначение...]

Параметр	Обязательный	По умолчанию	Описание
ProcessorName	да	—	Имя обработки
Вид	да	—	Вид обработки (см. маппинг)
Назначение	*	—	Объекты для назначаемых видов
SrcDir	нет	src	Каталог исходников

* Обязательно для: ЗаполнениеОбъекта, Отчет, ПечатнаяФорма, СозданиеСвязанныхОбъектов.

Маппинг вида обработки

Пользователь пишет	Вид	API-метод
доп обработка, глобальная	ДополнительнаяОбработка	ВидОбработкиДополнительнаяОбработка()
доп отчёт, глобальный отчёт	ДополнительныйОтчет	ВидОбработкиДополнительныйОтчет()
заполнение	ЗаполнениеОбъекта	ВидОбработкиЗаполнениеОбъекта()
отчёт (назначаемый)	Отчет	ВидОбработкиОтчет()
печатная форма, печать	ПечатнаяФорма	ВидОбработкиПечатнаяФорма()
создание связанных объектов	СозданиеСвязанныхОбъектов	ВидОбработкиСозданиеСвязанныхОбъектов()

Тип команды по умолчанию

Вид	ТипКоманды
ДополнительнаяОбработка	ТипКомандыОткрытиеФормы()
ДополнительныйОтчет	ТипКомандыОткрытиеФормы()
ЗаполнениеОбъекта	ТипКомандыВызовСерверногоМетода()
Отчет	ТипКомандыОткрытиеФормы()
ПечатнаяФорма	ТипКомандыВызовСерверногоМетода()
СозданиеСвязанныхОбъектов	ТипКомандыВызовСерверногоМетода()

Шаблон функции

Функция СведенияОВнешнейОбработке() Экспорт

	МетаданныеОбработки = Метаданные();

	ПараметрыРегистрации = ДополнительныеОтчетыИОбработки.СведенияОВнешнейОбработке("2.2.2.1");
	ПараметрыРегистрации.Вид    = ДополнительныеОтчетыИОбработкиКлиентСервер.{{ВидОбработки}};
	ПараметрыРегистрации.Версия = "1.0";

	{{СЕКЦИЯ_НАЗНАЧЕНИЕ}}  // только для назначаемых видов

	НоваяКоманда = ПараметрыРегистрации.Команды.Добавить();
	НоваяКоманда.Представление        = МетаданныеОбработки.Представление();
	НоваяКоманда.Идентификатор        = МетаданныеОбработки.Имя;
	НоваяКоманда.Использование        = ДополнительныеОтчетыИОбработкиКлиентСервер.{{ТипКоманды}};
	НоваяКоманда.ПоказыватьОповещение = Ложь;
	{{СЕКЦИЯ_МОДИФИКАТОР}}  // только для ПечатнаяФорма: НоваяКоманда.Модификатор = "ПечатьMXL"

	Возврат ПараметрыРегистрации;

КонецФункции

Инструкции

1. Найди ObjectModule.bsl: src/{{ProcessorName}}/Ext/ObjectModule.bsl
2. Если СведенияОВнешнейОбработке уже есть — сообщи, не дублируй
3. Найди область #Область ПрограммныйИнтерфейс и вставь функцию внутрь
4. Для видов с серверным обработчиком — добавь соответствующую процедуру после функции
5. Используй табы для отступов

---

Режим: bsp-add-command — добавление команды БСП

Добавляет команду в существующую функцию СведенияОВнешнейОбработке(). Предварительно должен быть вызван bsp-init.

Usage

epf bsp-add-command <ProcessorName> <Идентификатор> [ТипКоманды] [Представление]

Параметр	Обязательный	По умолчанию	Описание
ProcessorName	да	—	Имя обработки
Идентификатор	да	—	Внутреннее имя команды (латиница)
ТипКоманды	нет	из вида	Тип запуска
Представление	нет	= Идентификатор	Отображаемое имя
SrcDir	нет	src	Каталог исходников

Маппинг типов команд

Пользователь пишет	ТипКоманды
открыть форму	ТипКомандыОткрытиеФормы()
клиентский метод	ТипКомандыВызовКлиентскогоМетода()
серверный метод	ТипКомандыВызовСерверногоМетода()
заполнение формы	ТипКомандыЗаполнениеФормы()
сценарий	ТипКомандыСценарийВБезопасномРежиме()

Шаблон вставляется перед Возврат ПараметрыРегистрации

	НоваяКоманда = ПараметрыРегистрации.Команды.Добавить();
	НоваяКоманда.Представление        = НСтр("ru = '{{Представление}}'");
	НоваяКоманда.Идентификатор        = "{{Идентификатор}}";
	НоваяКоманда.Использование        = ДополнительныеОтчетыИОбработкиКлиентСервер.{{ТипКоманды}};
	НоваяКоманда.ПоказыватьОповещение = Ложь;

Инструкции

1. Найди и прочитай ObjectModule.bsl
2. Убедись что СведенияОВнешнейОбработке() существует — если нет, предложи bsp-init
3. Определи вид обработки из существующего кода
4. Вставь блок команды перед Возврат ПараметрыРегистрации
5. Добавь обработчик: для серверных — в ObjectModule.bsl, для клиентских — в модуль формы
6. Если обработчик уже есть — добавь ветку ИначеЕсли, не дублируй процедуру