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 ./build/MyApp.cf --s ./src --ibcmd

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

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 ./src --cf-file ./build/MyApp.cf --ibcmd

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

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

load

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

bash

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

Аргументы

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

Опции

Опция	Переменная окружения	Описание
`--list`	-	Список файлов для выборочной загрузки
`--increment`	-	Инкрементальная загрузка по индексу изменений
`--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 ./src --ibconnection /F./ib

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

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

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 ./backup/MyApp.cf --ibconnection /F./ib

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`	-
`--ibconnection`	-	`VRUNNER_IBCONNECTION`
`--db-user`	-	`VRUNNER_DBUSER`
`--db-pwd`	-	`VRUNNER_DBPWD`
`--ibcmd`	-	-
`--v8version`	-	`VRUNNER_V8VERSION`
`--uccode`	-	`VRUNNER_UCCODE`
`--language`	-	`VRUNNER_LANGUAGE`
`--locale`	-	`VRUNNER_LOCALE`
`--settings`	-	`VRUNNER_SETTINGS`

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

Примеры

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)

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

compile ​

Аргументы ​

Опции ​

Примеры ​

decompile ​

Аргументы ​

Опции ​

Примеры ​

load ​

Аргументы ​

Опции ​

Примеры ​

unload ​

Аргументы ​

Опции ​

Примеры ​

merge ​

Опции ​

Примеры ​

compare ​

Опции ​

Примеры ​

make-dist ​

Опции ​

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

compile

Аргументы

Опции

Примеры

decompile

Аргументы

Опции

Примеры

load

Аргументы

Опции

Примеры

unload

Аргументы

Опции

Примеры

merge

Опции

Примеры

compare

Опции

Примеры

make-dist

Опции