Skip to content

epf - Операции с внешними обработками

Группа команд epf обеспечивает работу с внешними обработками и отчётами 1С (.epf, .erf): сборку из XML-исходников и разборку.

bash
vrunner epf <подкоманда> [аргументы] [опции]

compile

Собирает внешние обработки (.epf/.erf) из XML-исходников. Поддерживает обработку целого каталога с рекурсивным поиском.

bash
vrunner epf compile [SRC] [опции]

Аргументы

АргументОписание
SRCКаталог с XML-исходниками обработок (по умолчанию - текущий каталог)

Опции

ОпцияПеременная окруженияОписание
--R, --recursive-Рекурсивный поиск обработок в подкаталогах
--out-Каталог для сохранения собранных обработок
--ibconnectionVRUNNER_IBCONNECTIONСтрока подключения к ИБ. Если не указана - автоматически создаётся временная ИБ
--db-userVRUNNER_DBUSERПользователь информационной базы
--db-pwdVRUNNER_DBPWDПароль пользователя ИБ
--ibcmd-Использовать утилиту ibcmd вместо Конфигуратора
--v8versionVRUNNER_V8VERSIONВерсия платформы 1С
--uccodeVRUNNER_UCCODEКод разрешения блокировки
--languageVRUNNER_LANGUAGEЯзык платформы
--localeVRUNNER_LOCALEЯзык сеанса (локаль)
--dbms-typeVRUNNER_DBMS_TYPEТип СУБД: MSSQLServer, PostgreSQL, IBMDB2, OracleDatabase. Нужен при --ibcmd для серверной ИБ
--dbms-serverVRUNNER_DBMS_SERVERАдрес сервера СУБД
--dbms-baseVRUNNER_DBMS_BASEИмя базы данных СУБД
--dbms-userVRUNNER_DBMS_USERПользователь СУБД
--dbms-pwdVRUNNER_DBMS_PWDПароль СУБД
--settingsVRUNNER_SETTINGSПуть к файлу настроек (JSON)

Подробнее о форматах строки подключения, ibcmd и опциях СУБД: Подключение к базе данных →

Примеры

bash
# Собрать все обработки в текущем каталоге
vrunner epf compile --ibcmd

# Рекурсивно собрать все обработки в каталоге epf/
vrunner epf compile ./epf -R --out ./build/epf --ibcmd

# Через конфигуратор
vrunner epf compile ./epf \
  --ibconnection /F./ib \
  --v8version 8.3.24

Формат исходников

Каждая обработка хранится в отдельном каталоге, где корневой файл имеет расширение .os или описание в формате конфигуратора.

decompile

Разбирает файл обработки .epf/.erf (или каталог с файлами) в XML-исходники.

bash
vrunner epf decompile <SRC> [опции]

Аргументы

АргументОписание
SRCПуть к EPF-файлу или каталогу с EPF-файлами (обязательный)

Опции

ОпцияПеременная окруженияОписание
--R, --recursive-Рекурсивный поиск EPF-файлов (для каталога)
--out-Каталог для сохранения разобранных исходников
--ibconnectionVRUNNER_IBCONNECTIONСтрока подключения к ИБ. Если не указана - автоматически создаётся временная ИБ
--db-userVRUNNER_DBUSERПользователь информационной базы
--db-pwdVRUNNER_DBPWDПароль пользователя ИБ
--ibcmd-Использовать утилиту ibcmd вместо Конфигуратора
--v8versionVRUNNER_V8VERSIONВерсия платформы 1С
--uccodeVRUNNER_UCCODEКод разрешения блокировки
--languageVRUNNER_LANGUAGEЯзык платформы
--localeVRUNNER_LOCALEЯзык сеанса (локаль)
--dbms-typeVRUNNER_DBMS_TYPEТип СУБД: MSSQLServer, PostgreSQL, IBMDB2, OracleDatabase. Нужен при --ibcmd для серверной ИБ
--dbms-serverVRUNNER_DBMS_SERVERАдрес сервера СУБД
--dbms-baseVRUNNER_DBMS_BASEИмя базы данных СУБД
--dbms-userVRUNNER_DBMS_USERПользователь СУБД
--dbms-pwdVRUNNER_DBMS_PWDПароль СУБД
--settingsVRUNNER_SETTINGSПуть к файлу настроек (JSON)

Подробнее о форматах строки подключения, ibcmd и опциях СУБД: Подключение к базе данных →

Примеры

bash
# Разобрать один файл
vrunner epf decompile ./MyReport.epf --ibcmd

# Разобрать все файлы из каталога рекурсивно
vrunner epf decompile ./build/epf -R --out ./epf --ibcmd

# Через конфигуратор
vrunner epf decompile ./MyReport.epf \
  --ibconnection /F./ib \
  --out ./src/reports/MyReport