Back to Details

epf-dump

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

/epf-dump — Разборка обработки

/epf-dump — 解析处理程序

Разбирает EPF-файл во XML-исходники с помощью платформы 1С (иерархический формат). Та же команда CLI работает и для внешних отчётов (ERF) — см. 
/erf-dump
.
借助1C平台将EPF文件解析为XML源代码（分层格式）。该CLI命令同样适用于外部报表（ERF）——请查看
/erf-dump
。

Usage

使用方法

/epf-dump <EpfFile> [OutDir]
ПараметрОбязательныйПо умолчаниюОписание
EpfFileда—Путь к EPF-файлу
OutDirнет
src
Каталог для выгрузки исходников
/epf-dump <EpfFile> [OutDir]
参数是否必填默认值描述
EpfFile是—EPF文件路径
OutDir否
src
源代码导出目录

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

连接参数

Прочитай 
.v8-project.json
из корня проекта. Возьми 
v8path
(путь к платформе) и разреши базу:
  1. Если пользователь указал параметры подключения (путь, сервер) — используй напрямую
  2. Если указал базу по имени — ищи по id / alias / name в 
    .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
    Если использованная база не зарегистрирована — после выполнения предложи добавить через 
    /db-list add
    .
从项目根目录读取
.v8-project.json
文件。获取
v8path
（平台路径）并解析数据库：
  1. 如果用户指定了连接参数（路径、服务器）——直接使用
  2. 如果按名称指定了数据库——在
    .v8-project.json
    中按id / alias / name查找
  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
    如果使用的数据库未注册——执行完成后建议通过
    /db-list add
    添加。

Команда

命令

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

Параметры скрипта

脚本参数

ПараметрОбязательныйОписание
-V8Path <путь>
нетКаталог bin платформы (или полный путь к 1cv8.exe)
-InfoBasePath <путь>
*Файловая база
-InfoBaseServer <сервер>
*Сервер 1С (для серверной базы)
-InfoBaseRef <имя>
*Имя базы на сервере
-UserName <имя>
нетИмя пользователя
-Password <пароль>
нетПароль
-InputFile <путь>
даПуть к EPF/ERF-файлу
-OutputDir <путь>
даКаталог для выгрузки исходников
-Format <формат>
нет
Hierarchical
(по умолч.) / 
Plain
*
— нужен либо 
-InfoBasePath
, либо пара 
-InfoBaseServer
+ 
-InfoBaseRef
参数是否必填描述
-V8Path <путь>
否平台bin目录（或1cv8.exe的完整路径）
-InfoBasePath <путь>
*文件数据库
-InfoBaseServer <сервер>
*1C服务器（适用于服务器端数据库）
-InfoBaseRef <имя>
*服务器上的数据库名称
-UserName <имя>
否用户名
-Password <пароль>
否密码
-InputFile <путь>
是EPF/ERF文件路径
-OutputDir <путь>
是源代码导出目录
-Format <формат>
否
Hierarchical
（默认）/ 
Plain
*
— 需指定
-InfoBasePath
，或同时指定
-InfoBaseServer
和
-InfoBaseRef
参数对

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

返回码

КодОписание
0Успешная разборка
1Ошибка (см. лог)
代码描述
0解析成功
1错误（查看日志）

Формат 
-Format Hierarchical

-Format Hierarchical
格式

Ключ 
-Format Hierarchical
создаёт структуру каталогов:
<OutDir>/
├── <Name>.xml                    # Корневой файл
└── <Name>/
    ├── Ext/
    │   └── ObjectModule.bsl      # Модуль объекта (если есть)
    ├── Forms/
    │   ├── <FormName>.xml
    │   └── <FormName>/
    │       └── Ext/
    │           ├── Form.xml
    │           └── Form/
    │               └── Module.bsl
    └── Templates/
        ├── <TemplateName>.xml
        └── <TemplateName>/
            └── Ext/
                └── Template.<ext>
-Format Hierarchical
参数会创建如下目录结构：
<OutDir>/
├── <Name>.xml                    # 根文件
└── <Name>/
    ├── Ext/
    │   └── ObjectModule.bsl      # 对象模块（若存在）
    ├── Forms/
    │   ├── <FormName>.xml
    │   └── <FormName>/
    │       └── Ext/
    │           ├── Form.xml
    │           └── Form/
    │               └── Module.bsl
    └── Templates/
        ├── <TemplateName>.xml
        └── <TemplateName>/
            └── Ext/
                └── Template.<ext>

Примеры

示例

powershell
undefined
powershell
undefined

Разборка обработки (файловая база)

解析处理程序（文件数据库）

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 -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"
undefined
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"
undefined