Инструменты · Сквозные
validate
Проверяет проект или один объект — ошибки и предупреждения EDT, проверки по стандартам ИТС (структура модулей, обмен данными, запросы, права ролей), недостижимый код. Умеет сохранить базовый уровень и потом показывать только новые проблемы.
Когда использовать
- После правки кода — точечная проверка объекта
fqnбез полной пересборки: неизвестные идентификаторы и другие смысловые ошибки. - Перед сдачей задачи — проект целиком с нужными
checkers. - В проекте много старых предупреждений —
baseline_save, затемbaseline_compareпоказывает только новые. - Права ролей по стандарту ИТС 689 —
checkers: ["rights"].
Соседние инструменты домена «Сквозные»
Операции
| operation | Что делает | Нужно передать |
|---|---|---|
checkпо умолчанию | Отчёт о проблемах: дайджест с числом ошибок, предупреждений и отфильтрованных, секции по важности — файл:строка [источник] — сообщение со ссылкой на стандарт ИТС. С fqn — точечная проверка одного объекта. | по желанию project или projects, checkers, severity, fqn, path_includes, path_excludes, strict |
baseline_save | Сохраняет текущие проблемы как базовый уровень с меткой baseline_label. Только для одного проекта. | project; по желанию baseline_label |
baseline_compare | Показывает только проблемы, которых нет в базовом уровне. | project; по желанию baseline_label |
Параметры
| Параметр и тип | Обязательный | Описание | По умолчанию |
|---|---|---|---|
projectстрока | для baseline_save, baseline_compare и точечной проверки | Проект; вместо него можно передать список projects. Без обоих — все открытые проекты. | — |
projectsмассив (строка) | нет | Список проектов. Без projects и project — все открытые проекты. | — |
operationстрока | нет | Операция инструмента — значения и их смысл в таблице «Операции».значения: check · baseline_save · baseline_compare | check |
checkersмассив (строка) | нет | Какие проверки запустить: edt-builtin — маркеры EDT (по умолчанию), std-455 — структура модулей, std-708, std-436, its-обменДанныхЗагрузки — проверка ОбменДанными.Загрузка, reachability — достижимость, rights — права ролей.значения: std-455 · its-обменДанныхЗагрузки · std-708 · std-436 · reachability · rights · edt-builtin | — |
strictбулево | нет | true — отключить список известных ложных срабатываний. | false |
severityстрока | нет | Отбор по важности: error, warning, info. По умолчанию — все.значения: error · warning · info | — |
baseline_labelстрока | нет | Имя базового уровня для baseline_save и baseline_compare; по умолчанию default. | default |
path_includesстрока | нет | Оставить только проблемы в файлах, путь которых содержит подстроку, например src/DataProcessors/<Обработка>/. | — |
path_excludesстрока | нет | Исключить файлы, путь которых содержит подстроку; применяется после path_includes. | — |
fqnстрока | нет | Точечная проверка одного объекта без полной пересборки, например Обработка.<Обработка> или Справочник.Контрагенты; адрес модуля сводится к объекту. Только для одного проекта и check; проверки ИТС при этом не выполняются. | — |
limitцелое | нет | Окно чтения: сколько строк готового ответа вернуть. По умолчанию 200, максимум 1000. | 200 |
offsetцелое | нет | Окно чтения: номер строки ответа, с которой начать (0 — первая страница). Значение для следующей страницы подсказывает строка *lines: …* в конце ответа. | 0 |
filterстрока | нет | Регулярное выражение без учёта регистра. Сужает вывод: оставляет строки ответа, в которых есть совпадение (заголовки секций с совпадениями сохраняются). Применяется до окна чтения. | — |
Таблица собрана из схемы инструмента, которую получает агент при подключении.
Адреса
fqn нужен только для точечной проверки одного объекта.
| Адрес | Что адресует |
|---|---|
Справочник.Контрагенты | точечная проверка справочника |
Обработка.<Обработка> | точечная проверка обработки |
Role.<Роль> | с checkers: ["rights"] — только одна роль |
Пример вызова и ответа
{ "operation": "check", "project": "УТ2020", "fqn": "Справочник.Контрагенты" }Пример ответа в подготовке Устройство ответа — на странице Формат ответов.
Отказы и ошибки
Устаревшие маркеры
edt-builtin читает уже посчитанные маркеры EDT. Для свежего результата сначала project_action с операцией clean.
Неизвестная проверка
Имя проверки с опечаткой перечисляется в отдельной секции ответа, остальные проверки выполняются.
failed · Unknown operation
Неизвестное значение operation. В ответе — fix_hint: supported: … со списком допустимых операций и секция Did you mean. Допустимо: check, baseline_save, baseline_compare.
failed · лицензия
Без действующего ключа инструмент отвечает карточкой failed с сообщением лицензия: … и подсказкой, где ввести ключ; в секции Context — список инструментов, доступных без ключа. Подробнее — Лицензия и бесплатный доступ.
Ограничения
- Не больше 5000 проблем за вызов — при достижении ответ предупреждает.
- Список известных ложных срабатываний — встроенный плюс файл проекта
.quanta/false-positives.yaml;strict: trueего отключает. - Проверка прав не сверяет связность «подсистема — объект» — об этом сказано в примечании ответа.