mirror of https://github.com/Nikolay-Shirokov/cc-1c-skills.git synced 2026-06-11 00:14:56 +03:00

Files

T

Nick Shirokov 43333f1481 Initial commit: EPF skills for Claude Code

7 skills for working with 1C external data processor XML sources:
- epf-init: scaffold a new processor (root XML + ObjectModule.bsl)
- epf-add-form: add a managed form with BSL module
- epf-add-template: add a template (HTML/Text/SpreadsheetDocument/BinaryData)
- epf-remove-form: remove a form and update root XML
- epf-remove-template: remove a template and update root XML
- epf-build: build EPF from XML (documentation only)
- epf-dump: dump EPF to XML (documentation only)

Includes XML format spec and build/dump command reference.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

2026-02-07 19:05:27 +03:00

4.6 KiB

Raw Blame History

Сборка и разборка внешних обработок 1С (EPF/ERF)

Общие сведения

Конфигуратор 1С:Предприятия 8.3 поддерживает пакетный режим для сборки .epf/.erf файлов из XML-исходников и обратной разборки. Это позволяет хранить исходники в Git и собирать бинарные файлы по необходимости.

Требования: для работы команд необходимо подключение к информационной базе (может быть пустой).

Команды

Сборка (XML → EPF)

1cv8.exe DESIGNER /F <путь_к_базе> /DisableStartupDialogs /LoadExternalDataProcessorOrReportFromFiles <корневой_xml> <путь_к_epf> /Out <лог_файл>

Параметр	Описание
`/F <путь>`	Путь к файловой информационной базе
`/S <строка>`	Строка подключения к серверной базе (альтернатива `/F`)
`/N <имя> /P <пароль>`	Аутентификация (если требуется)
`/DisableStartupDialogs`	Подавляет GUI-диалоги (обязательно для пакетного режима)
`<корневой_xml>`	Путь к корневому XML-файлу обработки (например, `src\МояОбработка.xml`)
`<путь_к_epf>`	Путь к выходному файлу `.epf` или `.erf`
`/Out <лог>`	Файл для записи лога операции

Важно: первый аргумент — путь к корневому XML-файлу (не к каталогу). Если указать каталог, конфигуратор вернёт ошибку.

Разборка (EPF → XML)

1cv8.exe DESIGNER /F <путь_к_базе> /DisableStartupDialogs /DumpExternalDataProcessorOrReportToFiles <каталог_выгрузки> <путь_к_epf> [-Format Hierarchical] /Out <лог_файл>

Параметр	Описание
`<каталог_выгрузки>`	Каталог для XML-файлов
`<путь_к_epf>`	Исходный файл `.epf` или `.erf`
`-Format Hierarchical`	Иерархическая структура каталогов (по умолчанию)
`-Format Plain`	Плоская структура

Коды возврата

Код	Значение
`0`	Успешно
`1`	Ошибка
`101`	Ошибка данных

Создание пустой ИБ

1cv8.exe CREATEINFOBASE File="<путь_к_каталогу_базы>"

Создаёт файловую ИБ в указанном каталоге. Необходима для пакетного режима конфигуратора.

Примечания

Пустая ИБ достаточна для сборки, если обработка не ссылается на объекты конфигурации.
Если обработка использует ссылочные типы конфигурации (СправочникСсылка.* и т.п.), при выгрузке/загрузке нужна база с соответствующей конфигурацией — иначе типы сохраняются как UUID.
Путь к 1cv8.exe зависит от установленной версии платформы (например, C:\Program Files\1cv8\8.3.27.1859\bin\1cv8.exe).
/DisableStartupDialogs — подавляет интерактивные диалоги (например, «ИБ не обнаружена»), без него конфигуратор может зависнуть в ожидании пользовательского ввода.
Первый аргумент /LoadExternalDataProcessorOrReportFromFiles — путь к корневому XML-файлу, а не к каталогу.

Claude Code Skills

Сборка и разборка доступны как навыки Claude Code:

/epf-build — документация по сборке EPF из XML
/epf-dump — документация по разборке EPF в XML

Переменные окружения:

V8_PATH — каталог bin платформы 1С (например, C:\Program Files\1cv8\8.3.27.1859\bin)
V8_BASE — путь к пустой ИБ (создаётся автоматически при первом запуске)

4.6 KiB Raw Blame History