cf - Операции с конфигурацией
Группа команд cf обеспечивает работу с конфигурацией 1С: сборку из исходников, разборку, загрузку в базу, выгрузку, объединение и сравнение.
bash
vrunner cf <подкоманда> [аргументы] [опции]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.24decompile
Разбирает файл конфигурации .cf в XML-исходники.
bash
vrunner cf decompile <OUT> [опции]Аргументы
| Аргумент | Описание |
|---|---|
OUT | Каталог для выгрузки исходников конфигурации |
Опции
| Опция | Переменная окружения | Описание |
|---|---|---|
--cf-file | VRUNNER_CF_FILE | Путь к CF-файлу для разборки (обязательный) |
--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.24load
Загружает конфигурацию в информационную базу из 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 и опциях СУБД: Подключение к базе данных →
Примеры
bash
# Загрузить конфигурацию из исходников
vrunner cf load ./src --ibconnection /F./ib
# Инкрементальная загрузка
vrunner cf load ./src --ibconnection /F./ib --incrementunload
Выгружает конфигурацию из информационной базы в 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./ibmerge
Объединяет конфигурацию из 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-supportcompare
Сравнивает два 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 Briefmake-dist
В разработке
Команда cf make-dist находится в разработке и пока не реализована.
Создаёт файл поставки конфигурации.
bash
vrunner cf make-dist [опции]Опции
| Опция | Переменная окружения | Описание |
|---|---|---|
--settings | VRUNNER_SETTINGS | Путь к файлу настроек (JSON) |