epf-dump

/epf-dump — Unpacking a processing

Unpacks an EPF file into XML sources using the 1C platform (hierarchical format). The same CLI command also works for external reports (ERF) — see /erf-dump.

Usage

/epf-dump <EpfFile> [OutDir]

Parameter	Required	Default	Description
EpfFile	yes	—	Path to the EPF file
OutDir	no	`src`	Directory for exporting sources

Connection parameters

Read .v8-project.json from the project root. Take v8path (path to the platform) and resolve the base:

If the user specified connection parameters (path, server) — use them directly
If the user specified a base by name — search by id / alias / name in .v8-project.json
If not specified — match the current Git branch with databases[].branches
If the branch did not match — use default
If .v8-project.json is absent or there are no bases — create an empty IB in ./base If v8path is not set — auto-detect: Get-ChildItem "C:\Program Files\1cv8\*\bin\1cv8.exe" | Sort -Desc | Select -First 1 If the base used is not registered — after execution, suggest adding it via /db-list add.

Command

powershell.exe -NoProfile -File .claude/skills/epf-dump/scripts/epf-dump.ps1 <параметры>

Script parameters

Parameter	Required	Description
`-V8Path <путь>`	no	Platform bin directory (or full path to 1cv8.exe)
`-InfoBasePath <путь>`	*	File base
`-InfoBaseServer <сервер>`	*	1C server (for a server base)
`-InfoBaseRef <имя>`	*	Base name on the server
`-UserName <имя>`	no	User name
`-Password <пароль>`	no	Password
`-InputFile <путь>`	yes	Path to the EPF/ERF file
`-OutputDir <путь>`	yes	Directory for exporting sources
`-Format <формат>`	no	`Hierarchical` (default) / `Plain`

* — either -InfoBasePathis required, or the pair -InfoBaseServer + -InfoBaseRef

Return codes

Code	Description
0	Successful unpacking
1	Error (see log)

Format `-Format Hierarchical`

Key -Format Hierarchical creates the directory structure:

<OutDir>/
├── <Name>.xml                    # Корневой файл
└── <Name>/
    ├── Ext/
    │   └── ObjectModule.bsl      # Модуль объекта (если есть)
    ├── Forms/
    │   ├── <FormName>.xml
    │   └── <FormName>/
    │       └── Ext/
    │           ├── Form.xml
    │           └── Form/
    │               └── Module.bsl
    └── Templates/
        ├── <TemplateName>.xml
        └── <TemplateName>/
            └── Ext/
                └── Template.<ext>

Examples

# Разборка обработки (файловая база)
powershell.exe -NoProfile -File .claude/skills/epf-dump/scripts/epf-dump.ps1 -InfoBasePath "C:\Bases\MyDB" -InputFile "build\МояОбработка.epf" -OutputDir "src"

# Серверная база
powershell.exe -NoProfile -File .claude/skills/epf-dump/scripts/epf-dump.ps1 -InfoBaseServer "srv01" -InfoBaseRef "MyDB" -UserName "Admin" -Password "secret" -InputFile "build\МояОбработка.epf" -OutputDir "src"