Проверка схемы

Проверка читает схему и рассказывает, что в ней не так. Сама она схему не правит — править ведут кнопки внутри замечаний. Проверка идёт при сохранении, чтобы обрыв не всплывал через час генерации на живом проекте.

Где видны замечания

Место	Что там
Графа «СХЕМА» штампа, справа	✓ замечаний нет либо счёт замечаний жёлтым.
Графа ведомости, карточками	Каждое замечание — карточка. Жёлтая — предупреждение, красная — ошибка. У карточки бывают кнопки, ведущие к месту.
Строка состояния внизу окна	Подсказка, что делать следующим шагом.

Три уровня

Уровень	Что означает
Ошибка	Схему нельзя сохранить и нельзя считать.
Предупреждение	Схема рабочая, но что-то выглядит забытым.
Сообщение	Не претензия: так бывает, и это нормально. В счёт замечаний не идёт.

Note

Пример сообщения, а не ошибки: неподключённый аргумент вызова. Старая подпись метода обязана сохраниться целиком, даже если половина её значений схеме не нужна, и требовать от инженера «исправить» тут нечего. Текст замечания: «Аргумент “X” схеме не нужен, но остаётся в вызове — так подпись совпадает со старой».

Что проверка находит

Про схему целиком

Уровень	Сообщение	Что делать
Ошибка	У схемы нет имени.	Впишите имя в поле «ИМЯ СХЕМЫ» наверху окна.
Ошибка	Имя не годится для вызова из ячейки: в нём можно ставить только буквы, цифры, подчёркивание и точку. Разбор строки такое имя не найдёт.	Уберите из имени пробелы, скобки, дефисы.
Ошибка	Не указано, какой шаг даёт результат: соедините последний шаг с выходом схемы.	Нажмите «⇄» на нужной фигуре.
Ошибка	Выход схемы никуда не ведёт.	Тот же шаг: назначьте результат заново.
Ошибка	Связи блоков образуют кольцо.	Разорвите цикл: шаг не может получать значение сам от себя через цепочку.
Предупреждение	Не сказано, что схема делает. Одна фраза в штампе — это всё, что о ней увидят в каталоге и в списке действий.	Заполните графу «ЧТО ДЕЛАЕТ».

Про производительность

Caution

Отдельное замечание, которое стоит прочитать целиком:

Схема читает строку вызова и обходит объекты проекта: она посчитается заново на каждом объекте, и на большом проекте это минуты генерации. Передайте нужное значение аргументом из ячейки — ИмяСхемы(ТЕГ) — и схема посчитается один раз на каждое разное значение.

То есть: схема, которая и читает «эту строку», и ходит по всему прогону, не кэшируется. Значение из строки надо подавать аргументом.

Про аргументы

Уровень	Сообщение
Ошибка	Имя «X» занято дважды.
Ошибка	В имени аргумента «X» есть точка: связь на такой аргумент потеряется при открытии схемы. Уберите точку из имени.
Сообщение	Аргумент «X» схеме не нужен, но остаётся в вызове — так подпись совпадает со старой.

Про шаги

Уровень	Сообщение	Пояснение
Ошибка	Не заполнено «X».	Обязательная настройка или обязательный вход пуст. На фигуре это жёлтая рамка.
Ошибка	«X»: «Y» — не из списка. Допустимые: …	В закрытый список попало чужое значение — обычно после ручной правки файла схемы.
Ошибка	Неизвестный вид блока «X».	Файл схемы написан более новой версией либо правился руками.
Ошибка	Имя «X» занято дважды.	Два шага с одним именем.
Предупреждение	Шаг «X» ни к чему не подключён: его значение в результат не попадает.	Забытая фигура. На схеме от выхода до неё не дотянуться, и подсказка на фигуре говорит то же.
Предупреждение	Ветка «X» ничем не занята: по этому пути схема вернёт пустоту.	У развилки есть ветка без ответа.
Предупреждение	Параметр «X» этому виду блока неизвестен и не будет учтён.	Осталось от прежней правки файла.
Предупреждение	Значение «Y» вписано во вход «X», которого у этого блока нет.	То же.
Предупреждение	На вход «X» приходит связь, поэтому вписанное значение «Y» не учитывается.	Напоминание про правило «связь сильнее вписанного».

Про связи и формы

Уровень	Сообщение
Ошибка	Связь начинается в несуществующем выходе «X».
Ошибка	Связь приходит в несуществующий вход «X».
Ошибка	На вход «X» приходит больше одной связи.
Ошибка	На вход «X» приходит текст, а шаг ждёт пары — на счёте он оборвётся. Разберите текст шагом «Разобрать на пары».
Ошибка	На вход «X» приходит текст, а шаг ждёт объекты проекта — на счёте он оборвётся. Выберите источник, который даёт объекты.

Чего проверка не ловит

Проверка видит только схему — не данные и не книги. Она не скажет:

• что порядок аргументов не совпадает с вызовом в книге;
• что колонка, имя которой вписано руками, в проекте не встречается;
• что условие заведомо никого не найдёт.

Всё это ловит пробный запуск: он считает схему на настоящих объектах и показывает отсев по каждой строке условия.