steelmorgan/epf-full

EPF Full — Полный цикл внешних обработок

Workflow: epf init → add-form → add-template → BSP-регистрация (BSL). Шаги 1–3 — через xml-gen CLI, BSP — прямое редактирование ObjectModule.bsl. Для макетов конфигурационных объектов — §4.

---

§2 Быстрый индекс команд

| Задача | Команда | |--------|---------| | Создать обработку | xml-gen epf init --name <Name> output/ | | Создать внешний отчёт (ERF) | xml-gen epf init --type report --name <Name> output/ | | Добавить форму | xml-gen epf add-form --epf <Name> --name <FormName> output/ | | Добавить MXL-шаблон к EPF | xml-gen epf add-template --epf <Name> --name <T> --type spreadsheet output/ | | Добавить реквизит в обработку | xml-gen epf add-attribute --name <N> --type <T> output/<Name>.xml | | Добавить ТЧ в обработку | xml-gen epf add-tabular-section --name <N> output/<Name>.xml | | Зарегистрировать в БСП (печать) | Вставить СведенияОВнешнейОбработке() в ObjectModule.bsl — см. §5 | | Добавить команду БСП | Вставить блок команды перед Возврат — см. §5 | | Добавить макет к Справочнику/Документу | xml-gen template add --object <Type.Name> --name <T> --type <TemplateType> src/ | | Удалить макет | xml-gen template remove --object <Type.Name> --name <T> src/ | | Добавить встроенную справку | xml-gen template add-help --object <Type.Name> src/ |

Ключевые пути (Designer):

• Корневой XML: output/<Name>.xml
• Модуль объекта: output/<Name>/Ext/ObjectModule.bsl
• Form.xml: output/<Name>/Forms/<FormName>/Ext/Form.xml
• Template: output/<Name>/Templates/<TName>/Ext/Template.xml

---

§3 EPF Base — init, add-form, add-template

references/epf-base.md

• CLI принимает только именованные аргументы --epf, --name; output_dir — последний позиционный.
• epf add-attribute редактирует корневой XML обработки (<Name>.xml), а не Form.xml. Для формы — form add-attribute.

---

§4 Templates — макеты для любых объектов метаданных

template add / remove / add-help — для Catalog, Document, Report, DataProcessor, InformationRegister, AccumulationRegister и др.

references/templates.md

• --object обязателен, формат Type.Name (пример: Document.ЗаказКлиента).
• Для СКД-отчётов при первом добавлении схемы — --set-main-dcs.
• Префикс ПФ_ для SpreadsheetDocument применять автоматически.

Типы макетов для xml-gen epf add-template (поддерживаются 4): | --type | Назначение | |----------|-----------| | SpreadsheetDocument | Печатная форма (MXL) | | HTMLDocument | HTML-шаблон | | TextDocument | Текстовый шаблон | | BinaryData | Двоичные данные |

DataCompositionSchema в epf add-template НЕ поддерживается — CLI отвечает Failed to add template: Unknown template type: DataCompositionSchema. Для добавления СКД-макета в EPF используй универсальную команду xml-gen template add --object DataProcessor.<EpfName> --name <T> --type DataCompositionSchema <output_dir> (она знает все 5 типов, включая DataCompositionSchema). См. также раздел §3 в xml-generation/SKILL.md и references/universal-commands.md.

После добавления MXL-макета — заполни содержимым через xml-gen mxl compile invoice.json <путь к Template.xml>.

---

§5 EPF БСП — регистрация в «Дополнительные отчёты и обработки»

references/epf-bsp.md

• BSP-регистрация — BSL-код в ObjectModule.bsl, не CLI-команда.
• СведенияОВнешнейОбработке() — в область #Область ПрограммныйИнтерфейс.
• Назначаемые виды (ЗаполнениеОбъекта, Отчет, ПечатнаяФорма, СозданиеСвязанныхОбъектов) — требуют Назначение.Добавить(...).
• Глобальные виды (ДополнительнаяОбработка, ДополнительныйОтчет) — без назначения.
• Дополнительные команды: НСтр("ru = '...'") для Представления (не МетаданныеОбработки.Представление()).
• Маппинг BspKind → ВидОбработки, BspCommandType → ТипКоманды — см. references/epf-bsp.md.

---

depends_on:

• mxl-dsl
• meta-operations metadata: category: 1c-development version: "1.0"

---