Skip to content

validate - Проверка конфигурации

Группа команд validate обеспечивает статическую проверку конфигурации 1С: синтаксическую проверку через конфигуратор и проверку в EDT.

bash
vrunner validate <подкоманда> [опции]

syntax-check

Выполняет проверку синтаксиса конфигурации в указанных режимах через конфигуратор. Формирует отчёт в формате JUnit XML, совместимый с системами CI/CD.

bash
vrunner validate syntax-check [опции]

Опции

ОпцияПо умолчаниюПеременная окруженияОписание
--mode--Режимы проверки (можно указать несколько через повторение опции)
--junitpath-VRUNNER_JUNITPATHПуть к файлу отчёта JUnit XML
--exception-file--Путь к файлу исключений (UTF-8, по одному исключению на строку)
--groupbymetadatafalse-Группировать ошибки по объектам метаданных
--testsuitenamesyntax-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Проверка всех расширений

Примеры

bash
# Проверить синтаксис для нескольких режимов клиента
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

В разработке

Команда validate edt находится в разработке и пока не реализована.

Выполняет проверку проекта средствами Enterprise Development Tools (EDT).

bash
vrunner validate edt [опции]