cf - Операции с конфигурацией

Группа команд cf обеспечивает работу с конфигурацией 1С: сборку из исходников, разборку, загрузку в базу, выгрузку, создание файла поставки, объединение и сравнение.

bash

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

Формат исходников. cf compile, cf load принимают каталог исходников как в XML-дампе Конфигуратора, так и в формате 1С:EDT; cf decompile умеет выгружать в формат EDT. Формат определяется автоматически, опции --src-format, --edt-version, --edt-workspace, --edt-timeout. Подробнее: Исходники в формате 1С:EDT →.

compile

Собирает конфигурацию 1С из XML-исходников в файл .cf.

bash

vrunner cf compile [опции] <OUT>

Аргументы

Аргумент	Описание
`OUT`	Путь к создаваемому файлу конфигурации (`.cf`)

Опции

Опция	Переменная окружения	Описание
`--s`, `--src`	`VRUNNER_SRC`	Каталог исходников конфигурации (по умолчанию - текущий каталог)
`--list`	-	Список файлов для выборочной загрузки
`--ibconnection`	`VRUNNER_IBCONNECTION`	Строка подключения к ИБ. Если не указана - автоматически создаётся временная ИБ
`--db-user`	`VRUNNER_DBUSER`	Пользователь информационной базы
`--db-pwd`	`VRUNNER_DBPWD`	Пароль пользователя ИБ
`--ibcmd`	-	Использовать утилиту `ibcmd` вместо Конфигуратора
`--v8version`	`VRUNNER_V8VERSION`	Версия платформы 1С
`--uccode`	`VRUNNER_UCCODE`	Код разрешения блокировки
`--language`	`VRUNNER_LANGUAGE`	Язык платформы
`--locale`	`VRUNNER_LOCALE`	Язык сеанса (локаль)
`--dbms-type`	`VRUNNER_DBMS_TYPE`	Тип СУБД: `MSSQLServer`, `PostgreSQL`, `IBMDB2`, `OracleDatabase`. Нужен при `--ibcmd` для серверной ИБ
`--dbms-server`	`VRUNNER_DBMS_SERVER`	Адрес сервера СУБД
`--dbms-base`	`VRUNNER_DBMS_BASE`	Имя базы данных СУБД
`--dbms-user`	`VRUNNER_DBMS_USER`	Пользователь СУБД
`--dbms-pwd`	`VRUNNER_DBMS_PWD`	Пароль СУБД
`--settings`	`VRUNNER_SETTINGS`	Путь к файлу настроек (JSON)

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

Примеры

bash

# Собрать конфигурацию с помощью ibcmd
vrunner cf compile --s ./src --ibcmd ./build/MyApp.cf

# Собрать через конфигуратор с указанием базы
vrunner cf compile \
  --s ./src \
  --ibconnection /FD:/bases/MyProject \
  --v8version 8.3.24 \
  ./build/MyApp.cf

decompile

Разбирает конфигурацию в XML-исходники: из файла .cf либо напрямую из указанной информационной базы.

Если --cf-file задан — он загружается во временную (или указанную) ИБ, после чего конфигурация выгружается в исходники. Если --cf-file не задан — стадия загрузки пропускается и исходники выгружаются из ИБ, переданной через --ibconnection. Когда не указаны ни --cf-file, ни строка подключения (т.е. потребовалось бы создавать пустую временную ИБ), команда завершается с ошибкой — выгружать нечего.

bash

vrunner cf decompile [опции] <OUT>

Аргументы

Аргумент	Описание
`OUT`	Каталог для выгрузки исходников конфигурации

Опции

Опция	Переменная окружения	Описание
`--cf-file`	`VRUNNER_CF_FILE`	Путь к CF-файлу для разборки. Если не задан — исходники выгружаются из ИБ, указанной в `--ibconnection`
`--ibconnection`	`VRUNNER_IBCONNECTION`	Строка подключения к ИБ. Если не указана - автоматически создаётся временная ИБ
`--db-user`	`VRUNNER_DBUSER`	Пользователь информационной базы
`--db-pwd`	`VRUNNER_DBPWD`	Пароль пользователя ИБ
`--ibcmd`	-	Использовать утилиту `ibcmd` вместо Конфигуратора
`--v8version`	`VRUNNER_V8VERSION`	Версия платформы 1С
`--uccode`	`VRUNNER_UCCODE`	Код разрешения блокировки
`--language`	`VRUNNER_LANGUAGE`	Язык платформы
`--locale`	`VRUNNER_LOCALE`	Язык сеанса (локаль)
`--dbms-type`	`VRUNNER_DBMS_TYPE`	Тип СУБД: `MSSQLServer`, `PostgreSQL`, `IBMDB2`, `OracleDatabase`. Нужен при `--ibcmd` для серверной ИБ
`--dbms-server`	`VRUNNER_DBMS_SERVER`	Адрес сервера СУБД
`--dbms-base`	`VRUNNER_DBMS_BASE`	Имя базы данных СУБД
`--dbms-user`	`VRUNNER_DBMS_USER`	Пользователь СУБД
`--dbms-pwd`	`VRUNNER_DBMS_PWD`	Пароль СУБД
`--settings`	`VRUNNER_SETTINGS`	Путь к файлу настроек (JSON)

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

Примеры

bash

# Разобрать CF в исходники
vrunner cf decompile --cf-file ./build/MyApp.cf --ibcmd ./src

# Через конфигуратор
vrunner cf decompile \
  --cf-file ./MyApp.cf \
  --ibconnection /FD:/bases/temp \
  --v8version 8.3.24 \
  ./src

# Выгрузить исходники из существующей ИБ (без cf-файла)
vrunner cf decompile --ibconnection /FD:/bases/work ./src

load

Загружает конфигурацию в информационную базу из XML-исходников или CF-файла.

После загрузки конфигурация БД по умолчанию обновляется (UpdateDBCfg / config apply), чтобы изменения применились к базе. Флаг --no-update-db отключает обновление — команда только загружает основную конфигурацию.

bash

vrunner cf load [опции] <SRC>

Аргументы

Аргумент	Описание
`SRC`	Каталог исходников конфигурации или путь к CF-файлу

Опции

Опция	Переменная окружения	Описание
`--list`	-	Список файлов для выборочной загрузки
`--increment`	-	Инкрементальная загрузка по индексу изменений
`--no-update-db`	-	Не обновлять конфигурацию БД после загрузки (по умолчанию БД обновляется)
`--ibconnection`	`VRUNNER_IBCONNECTION`	Строка подключения к ИБ (`/F<путь>` - файловая, `/S<сервер>\<база>` - серверная)
`--db-user`	`VRUNNER_DBUSER`	Пользователь информационной базы
`--db-pwd`	`VRUNNER_DBPWD`	Пароль пользователя ИБ
`--ibcmd`	-	Использовать утилиту `ibcmd` вместо Конфигуратора
`--v8version`	`VRUNNER_V8VERSION`	Версия платформы 1С
`--uccode`	`VRUNNER_UCCODE`	Код разрешения блокировки
`--language`	`VRUNNER_LANGUAGE`	Язык платформы
`--locale`	`VRUNNER_LOCALE`	Язык сеанса (локаль)
`--dbms-type`	`VRUNNER_DBMS_TYPE`	Тип СУБД: `MSSQLServer`, `PostgreSQL`, `IBMDB2`, `OracleDatabase`. Нужен при `--ibcmd` для серверной ИБ
`--dbms-server`	`VRUNNER_DBMS_SERVER`	Адрес сервера СУБД
`--dbms-base`	`VRUNNER_DBMS_BASE`	Имя базы данных СУБД
`--dbms-user`	`VRUNNER_DBMS_USER`	Пользователь СУБД
`--dbms-pwd`	`VRUNNER_DBMS_PWD`	Пароль СУБД
`--settings`	`VRUNNER_SETTINGS`	Путь к файлу настроек (JSON)

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

Инкрементальная загрузка из EDT. Платформа не умеет инкрементально выгружать EDT, поэтому для EDT-исходников --increment детектирует изменения по самому каталогу EDT (а не по временному XML-дампу): экспорт в XML выполняется полностью, но в базу выборочно грузятся только объекты, чьи .mdo/.bsl/.form изменились. Добавление/удаление объектов и изменения корня конфигурации (src/Configuration) выполняются полной загрузкой. См. Исходники EDT →.

Примеры

bash

# Загрузить конфигурацию из исходников (с обновлением конфигурации БД)
vrunner cf load --ibconnection /F./ib ./src

# Загрузить без обновления конфигурации БД
vrunner cf load --ibconnection /F./ib --no-update-db ./src

# Инкрементальная загрузка
vrunner cf load --ibconnection /F./ib --increment ./src

# Инкрементальная загрузка из EDT-проекта
vrunner cf load --ibconnection /F./ib --increment --src-format edt ./edt-project

unload

Выгружает конфигурацию из информационной базы в CF-файл.

bash

vrunner cf unload [опции] <OUT>

Аргументы

Аргумент	Описание
`OUT`	Путь к создаваемому CF-файлу (обязательный)

Опции

Опция	Переменная окружения	Описание
`--ibconnection`	`VRUNNER_IBCONNECTION`	Строка подключения к ИБ (`/F<путь>` - файловая, `/S<сервер>\<база>` - серверная)
`--db-user`	`VRUNNER_DBUSER`	Пользователь информационной базы
`--db-pwd`	`VRUNNER_DBPWD`	Пароль пользователя ИБ
`--ibcmd`	-	Использовать утилиту `ibcmd` вместо Конфигуратора
`--v8version`	`VRUNNER_V8VERSION`	Версия платформы 1С
`--uccode`	`VRUNNER_UCCODE`	Код разрешения блокировки
`--language`	`VRUNNER_LANGUAGE`	Язык платформы
`--locale`	`VRUNNER_LOCALE`	Язык сеанса (локаль)
`--dbms-type`	`VRUNNER_DBMS_TYPE`	Тип СУБД: `MSSQLServer`, `PostgreSQL`, `IBMDB2`, `OracleDatabase`. Нужен при `--ibcmd` для серверной ИБ
`--dbms-server`	`VRUNNER_DBMS_SERVER`	Адрес сервера СУБД
`--dbms-base`	`VRUNNER_DBMS_BASE`	Имя базы данных СУБД
`--dbms-user`	`VRUNNER_DBMS_USER`	Пользователь СУБД
`--dbms-pwd`	`VRUNNER_DBMS_PWD`	Пароль СУБД
`--settings`	`VRUNNER_SETTINGS`	Путь к файлу настроек (JSON)

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

Примеры

bash

vrunner cf unload --ibconnection /F./ib ./backup/MyApp.cf

make-dist

Создаёт полный файл поставки конфигурации командой Конфигуратора /CreateDistributionFiles. Источником служит конфигурация указанной информационной базы; ibcmd эту операцию не поддерживает.

bash

vrunner cf make-dist [опции] <OUT>

Аргументы

Аргумент	Описание
`OUT`	Путь к создаваемому полному файлу поставки (`.cf`)

Опции

Опция	Переменная окружения	Описание
`--ibconnection`	`VRUNNER_IBCONNECTION`	Строка подключения к ИБ (обязательна)
`--db-user`	`VRUNNER_DBUSER`	Пользователь информационной базы
`--db-pwd`	`VRUNNER_DBPWD`	Пароль пользователя ИБ
`--v8version`	`VRUNNER_V8VERSION`	Версия платформы 1С
`--uccode`	`VRUNNER_UCCODE`	Код разрешения блокировки
`--language`	`VRUNNER_LANGUAGE`	Язык платформы
`--locale`	`VRUNNER_LOCALE`	Язык сеанса (локаль)
`--dbms-type`	`VRUNNER_DBMS_TYPE`	Тип СУБД для серверной ИБ
`--dbms-server`	`VRUNNER_DBMS_SERVER`	Адрес сервера СУБД
`--dbms-base`	`VRUNNER_DBMS_BASE`	Имя базы данных СУБД
`--dbms-user`	`VRUNNER_DBMS_USER`	Пользователь СУБД
`--dbms-pwd`	`VRUNNER_DBMS_PWD`	Пароль СУБД
`--settings`	`VRUNNER_SETTINGS`	Путь к файлу настроек (JSON)

Пример

bash

vrunner cf make-dist --ibconnection /F./ib ./build/1Cv8-dist.cf

merge

Объединяет конфигурацию из CF-файла с конфигурацией информационной базы согласно файлу настроек.

bash

vrunner cf merge [опции]

Опции

Опция	Описание
`--s`, `--src`	Путь к CF-файлу с конфигурацией для объединения (обязательный)
`--merge-settings`	Путь к файлу настроек объединения (обязательный)
`--enable-support`	Поставить конфигурацию на поддержку
`--disable-support`	Снять конфигурацию с поддержки
`--IncludeObjectsByUnresolvedRefs`	Включить объекты с неразрешёнными ссылками
`--ClearUnresolvedRefs`	Очищать неразрешённые ссылки
`--force`	-
`--ibconnection`	`VRUNNER_IBCONNECTION`
`--db-user`	`VRUNNER_DBUSER`
`--db-pwd`	`VRUNNER_DBPWD`
`--ibcmd`	-
`--v8version`	`VRUNNER_V8VERSION`
`--uccode`	`VRUNNER_UCCODE`
`--language`	`VRUNNER_LANGUAGE`
`--locale`	`VRUNNER_LOCALE`
`--dbms-type`	`VRUNNER_DBMS_TYPE`
`--dbms-server`	`VRUNNER_DBMS_SERVER`
`--dbms-base`	`VRUNNER_DBMS_BASE`
`--dbms-user`	`VRUNNER_DBMS_USER`
`--dbms-pwd`	`VRUNNER_DBMS_PWD`
`--settings`	`VRUNNER_SETTINGS`

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

Примеры

bash

vrunner cf merge \
  --s ./vendor/BSP.cf \
  --merge-settings ./merge-settings.xml \
  --ibconnection /F./ib \
  --enable-support

compare

Сравнивает два CF-файла или CF-файл с конфигурацией базы и формирует отчёт.

bash

vrunner cf compare [опции]

Опции

Опция	По умолчанию	Переменная окружения	Описание
`--second-cf`	-	-	Путь ко второму CF-файлу (с чем сравниваем) (обязательный)
`--first-cf`	-	-	Путь к первому CF-файлу; если не задан - сравнивается конфигурация базы
`--report-dir`	`.`	-	Каталог для сохранения отчёта (имя файла генерируется автоматически)
`--report-type`	`Full`	-	Тип отчёта: `Full` (полный) или `Brief` (краткий)
`--report-format`	`txt`	-	Формат файла: `txt` или `mxl`
`--ibconnection`	-	`VRUNNER_IBCONNECTION`	Строка подключения к ИБ (`/F<путь>` - файловая, `/S<сервер>\<база>` - серверная). Нужна, если сравниваем с конфигурацией базы (без `--first-cf`)
`--db-user`	-	`VRUNNER_DBUSER`	Пользователь информационной базы
`--db-pwd`	-	`VRUNNER_DBPWD`	Пароль пользователя ИБ
`--v8version`	-	`VRUNNER_V8VERSION`	Версия платформы 1С
`--uccode`	-	`VRUNNER_UCCODE`	Код разрешения блокировки
`--language`	-	`VRUNNER_LANGUAGE`	Язык платформы
`--locale`	-	`VRUNNER_LOCALE`	Язык сеанса (локаль)
`--dbms-type`	-	`VRUNNER_DBMS_TYPE`	Тип СУБД: `MSSQLServer`, `PostgreSQL`, `IBMDB2`, `OracleDatabase`
`--dbms-server`	-	`VRUNNER_DBMS_SERVER`	Адрес сервера СУБД
`--dbms-base`	-	`VRUNNER_DBMS_BASE`	Имя базы данных СУБД
`--dbms-user`	-	`VRUNNER_DBMS_USER`	Пользователь СУБД
`--dbms-pwd`	-	`VRUNNER_DBMS_PWD`	Пароль СУБД
`--settings`	-	`VRUNNER_SETTINGS`	Путь к файлу настроек (JSON)

Сравнение выполняется через Конфигуратор. Подробнее о форматах строки подключения: Подключение к базе данных →

Примеры

bash

# Сравнить два CF-файла
vrunner cf compare \
  --first-cf ./old/App.cf \
  --second-cf ./new/App.cf \
  --report-dir ./reports

# Сравнить конфигурацию базы с CF-файлом
vrunner cf compare \
  --second-cf ./vendor/BSP.cf \
  --ibconnection /F./ib \
  --report-type Brief

make-dist

В разработке

Команда cf make-dist находится в разработке и пока не реализована.

Создаёт файл поставки конфигурации.

bash

vrunner cf make-dist [опции]

Опции

Опция	Переменная окружения	Описание
`--settings`	`VRUNNER_SETTINGS`	Путь к файлу настроек (JSON)

convert

Конвертирует каталог исходников конфигурации между форматами 1С:EDT и XML-дамп Конфигуратора.

Тип исходников определяется автоматически по маркерам каталога, а результат пишется в противоположном формате:

каталог 1С:EDT (.project + src/*.mdo) → XML-дамп Конфигуратора;
каталог XML-дампа (Configuration.xml) → проект 1С:EDT.

Если тип исходников определить не удалось (в каталоге нет маркеров ни одного из форматов или найдено несколько вложенных EDT-проектов), команда завершается с ошибкой.

Конвертация выполняется утилитой 1cedtcli, поэтому требуется установленная 1С:EDT (см. Исходники в формате 1С:EDT →).

bash

vrunner cf convert [опции] OUT

Аргументы

Аргумент	Описание
`OUT`	Каталог для результата конвертации (обязательный)

Опции

Опция	По умолчанию	Переменная окружения	Описание
`--src` / `-s`	текущий каталог	`VRUNNER_SRC`	Каталог исходников для конвертации
`--edt-version`	-	`VRUNNER_EDT_VERSION`	Версия установленной 1С:EDT (например `2024.1`) для выбора среди нескольких
`--edt-workspace`	-	`VRUNNER_EDT_WORKSPACE`	Базовый каталог рабочей области EDT (по умолчанию - временный)
`--edt-timeout`	-	`VRUNNER_EDT_TIMEOUT`	Таймаут операций `1cedtcli` в секундах. По умолчанию `1cedtcli` использует свой (60 с) - на больших конфигурациях его может не хватать
`--settings`	-	`VRUNNER_SETTINGS`	Путь к файлу настроек (JSON)

Примеры

bash

# Конвертировать EDT-проект конфигурации в XML-дамп Конфигуратора (тип определится автоматически)
vrunner cf convert --src ./edt-project ./build/xml

# Обратная конвертация: XML-дамп → проект 1С:EDT
vrunner cf convert --src ./build/xml ./edt-project

# Большая конфигурация: увеличить таймаут 1cedtcli до 90 минут
vrunner cf convert --src ./edt-erp --edt-timeout 5400 ./build/xml

Таймаут на больших конфигурациях

По умолчанию 1cedtcli ограничивает операцию таймаутом в 60 секунд. Для тяжёлых конфигураций (1С:ERP и т. п.) экспорт/импорт не успевает завершиться - увеличьте таймаут опцией --edt-timeout или переменной окружения VRUNNER_EDT_TIMEOUT.

cf - Операции с конфигурацией ​

compile ​

Аргументы ​

Опции ​

Примеры ​

decompile ​

Аргументы ​

Опции ​

Примеры ​

load ​

Аргументы ​

Опции ​

Примеры ​

unload ​

Аргументы ​

Опции ​

Примеры ​

make-dist ​

Аргументы ​

Опции ​

Пример ​

merge ​

Опции ​

Примеры ​

compare ​

Опции ​

Примеры ​

make-dist ​

Опции ​

convert ​

Аргументы ​

Опции ​

Примеры ​

cf - Операции с конфигурацией

compile

Аргументы

Опции

Примеры

decompile

Аргументы

Опции

Примеры

load

Аргументы

Опции

Примеры

unload

Аргументы

Опции

Примеры

make-dist

Аргументы

Опции

Пример

merge

Опции

Примеры

compare

Опции

Примеры

make-dist

Опции

convert

Аргументы

Опции

Примеры