Epf Expert

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

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

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

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

Usage

/epf-expert init <Name> [Synonym] [SrcDir]

Команда

powershell.exe -NoProfile -File .claude/skills/epf-expert/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-expert add-form
• Добавить макет: /mxl-expert template-add
• Добавить справку: /help-add
• Собрать EPF: /epf-expert build

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

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

Usage

/epf-expert build <Name> [SrcDir] [OutDir]

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

Прочитай .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 .claude/skills/epf-expert/scripts/epf-build.ps1 -InfoBasePath "<путь>" -SourceFile "src\<Name>.xml" -OutputFile "build\<Name>.epf"

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

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

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

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

Usage

/epf-expert dump <File> [OutDir]

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

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

Команда

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

Структура результата (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-expert add-form <ProcessorName> <FormName> [Synonym] [--main]

Команда

powershell.exe -NoProfile -File .claude/skills/epf-expert/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-expert bsp-init <ProcessorName> <Вид> [Назначение...]

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

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

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

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

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

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

	ПараметрыРегистрации = ДополнительныеОтчетыИОбработки.СведенияОВнешнейОбработке("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-expert bsp-add-command <ProcessorName> <Идентификатор> [ТипКоманды] [Представление]

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

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

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

Инструкции

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