validate - Проверка конфигурации
Группа команд validate обеспечивает статическую проверку конфигурации 1С: синтаксическую проверку через конфигуратор и проверку в EDT.
vrunner validate <подкоманда> [опции]syntax-check
Выполняет проверку синтаксиса конфигурации в указанных режимах через конфигуратор. Формирует отчёт в формате JUnit XML, совместимый с системами CI/CD.
vrunner validate syntax-check [опции]Опции
| Опция | По умолчанию | Переменная окружения | Описание |
|---|---|---|---|
--mode | - | - | Режимы проверки (можно указать несколько через повторение опции) |
--junitpath | - | VRUNNER_JUNITPATH | Путь к файлу отчёта JUnit XML |
--exception-file | - | - | Путь к файлу исключений (UTF-8, по одному исключению на строку) |
--groupbymetadata | false | - | Группировать ошибки по объектам метаданных |
--testsuitename | syntax-check | - | Имя тестового набора в JUnit-отчёте |
--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 | Пароль СУБД |
--storage-name | - | VRUNNER_STORAGE_NAME | Адрес хранилища |
--storage-user | - | VRUNNER_STORAGE_USER | Пользователь хранилища |
--storage-pwd | - | VRUNNER_STORAGE_PWD | Пароль хранилища |
--storage-ver | - | VRUNNER_STORAGE_VER | Версия хранилища |
--settings | - | VRUNNER_SETTINGS | Путь к файлу настроек (JSON) |
Подробнее о подключении, ibcmd и опциях СУБД: Подключение к базе данных →
Доступные режимы проверки (--mode)
| Режим | Описание |
|---|---|
ThinClient | Тонкий клиент |
WebClient | Веб-клиент |
Server | Сервер |
ExternalConnection | Внешнее соединение |
ExternalConnectionServer | Внешнее соединение (клиент-серверный) |
MobileClient | Мобильный клиент |
MobileClientStandalone | Мобильный клиент (автономный) |
MobileAppClient | Мобильное приложение (клиент) |
MobileAppServer | Мобильное приложение (сервер) |
ThickClientManagedApplication | Толстый клиент (управляемое приложение) |
ThickClientServerManagedApplication | Толстый клиент (управляемое, клиент-серверный) |
ThickClientOrdinaryApplication | Толстый клиент (обычное приложение) |
ThickClientServerOrdinaryApplication | Толстый клиент (обычное, клиент-серверный) |
ConfigLogIntegrity | Проверка логической целостности конфигурации |
IncorrectReferences | Поиск некорректных ссылок |
DistributiveModules | Поставка модулей без исходных текстов |
UnreferenceProcedures | Поиск неиспользуемых процедур и функций |
HandlersExistence | Проверка существования назначенных обработчиков |
EmptyHandlers | Поиск пустых обработчиков |
ExtendedModulesCheck | Расширенная проверка модулей |
CheckUseModality | Поиск использования модальности |
CheckUseSynchronousCalls | Поиск синхронных вызовов |
UnsupportedFunctional | Поиск неподдерживаемой функциональности |
AllExtensions | Проверка всех расширений |
Примеры
# Проверить синтаксис для нескольких режимов клиента
vrunner validate syntax-check \
--ibconnection /F./ib \
--mode ThinClient \
--mode Server \
--mode WebClient \
--junitpath ./build/reports/syntax.xml
# Проверить с группировкой по метаданным и файлом исключений
vrunner validate syntax-check \
--ibconnection /F./ib \
--mode ThinClient \
--mode Server \
--junitpath ./build/reports/syntax.xml \
--groupbymetadata \
--exception-file ./syntax-check-exceptions.txt \
--testsuitename "MyProject syntax check"Файл исключений
Файл исключений (--exception-file) позволяет игнорировать известные/допустимые ошибки. Каждая строка файла - одна строка из сообщения об ошибке, которую нужно пропустить. Кодировка: UTF-8.
Интеграция с CI
JUnit-отчёт совместим с GitLab CI, Jenkins, GitHub Actions и другими системами CI/CD. Укажите путь к файлу в настройках сборки для публикации результатов проверки.
edt
Выполняет штатную проверку проекта средствами 1С:EDT (1cedtcli validate). Команда запускает проверку, разбирает выгруженные замечания, печатает отчёт и при наличии замечаний нужного уровня важности завершается с ошибкой. Дополнительно может сформировать отчёт в формате JUnit XML для CI/CD.
vrunner validate edt [опции]Опции
| Опция | По умолчанию | Переменная окружения | Описание |
|---|---|---|---|
--src / -s | текущий каталог | VRUNNER_SRC | Каталог EDT-проекта |
--min-severity | major | - | Минимальный уровень замечаний, при котором команда завершается с ошибкой: critical, major, minor, none |
--junitpath | - | VRUNNER_JUNITPATH | Путь к файлу отчёта JUnit XML |
--testsuitename | edt | - | Имя тестового набора в JUnit-отчёте |
--src-format | auto | - | Формат каталога исходников: auto, edt, xml |
--edt-version | - | VRUNNER_EDT_VERSION | Версия установленной 1С:EDT (например 2024.1) для выбора среди нескольких |
--edt-workspace | - | VRUNNER_EDT_WORKSPACE | Базовый каталог рабочей области EDT (по умолчанию - временный) |
--edt-timeout | - | VRUNNER_EDT_TIMEOUT | Таймаут операций 1cedtcli в секундах (на больших конфигурациях увеличьте) |
--settings | - | VRUNNER_SETTINGS | Путь к файлу настроек (JSON) |
Подробнее о форматах исходников, поиске
1cedtcliи опциях--edt-*: Исходники в формате 1С:EDT →
Уровни важности (--min-severity)
| Значение | Поведение |
|---|---|
critical | завершаться с ошибкой только при критических замечаниях |
major | значительные и критические (по умолчанию) |
minor | все замечания, включая незначительные |
none | не завершать с ошибкой, только вывести отчёт |
Примеры
# Проверить EDT-проект в текущем каталоге (порог по умолчанию - major)
vrunner validate edt
# Проверить конкретный проект и сформировать JUnit-отчёт для CI
vrunner validate edt \
--src ./edt-project \
--edt-version 2024.1 \
--junitpath ./build/reports/edt.xml
# Не падать на замечаниях, только собрать отчёт
vrunner validate edt --src ./edt-project --min-severity none --junitpath ./build/reports/edt.xmlИнтеграция с CI
Как и syntax-check, команда формирует JUnit-совместимый отчёт. Уровнем --min-severity управляется, какие замечания считаются блокирующими (приводят к падению сборки).