Строки шага

Внутри фигуры шага стоят строки. Строка — это одно место, куда попадает значение. Слева написано, откуда значение берётся, справа — само значение.

Подпись строки, выбор источника («Откуда брать значение») и поле значения.

Настройка и вход — одно место

Это главное, что стоит понять про шаги, потому что в первой версии конструктора было иначе и это мешало.

У многих шагов есть параметры, которые можно либо вписать руками, либо подать связью — из аргумента вызова или из шага выше. Примеры:

• у «Взять N-й» — номер: обычно вписан, но может приходить из ячейки;
• у «Взять поле» — имя поля;
• у «Заменить» — что заменить и на что;
• у «Если / иначе» — сами ответы.

На фигуре под это отведена одна строка, а не две. Она всегда на месте, и выбор источника говорит, откуда значение приходит сейчас.

Note

Связь сильнее вписанного. Если на вход пришёл провод, вписанное значение не смотрится вовсе. Это правило одно на все такие пары.

Откуда берётся значение

Тут надо различать две вещи: что написано в строке сейчас и что можно выбрать.

Что написано в строке

Подпись	Что означает
от предыдущего шага	Значение приходит от соседа сверху. Линии не нужно — достаточно соседства.
от шага N · ↰ шаг N	Значение приходит от шага номер N, который стоит не рядом.
имя аргумента	Значение приходит из аргумента вызова: tag, fieldTag.
вписанное значение	Значение вписано прямо в шаг. Подсказка у поля: «Впишите значение прямо сюда».
пусто	Ни связи, ни значения. Обязательная строка при этом подсвечена жёлтым.

Что можно выбрать в списке «откуда»

Список открывается кнопкой «откуда ▾» справа от значения; подсказка у неё — «Откуда брать значение».

Пункт	Что означает
своё значение	Вписать прямо в строку. У входа, который вписать нельзя (ждёт словарь или таблицу), вместо этого стоит не подключать — у списка это возврат к таблице на фигуре.
имя аргумента	По одному пункту на каждый аргумент вызова.
шаг N · форма	По пункту на каждый шаг выше этого: «шаг 2 · текст», «шаг 3 · объекты». Только их значения уже посчитаны к его очереди.
шаг N · имя ответа	Дополнительные выходы шага: у «Подставить по списку» с несколькими ответами это «шаг 2 · на что».
эта строка · ПЛК этой строки	Только у строки, которая берёт объект из места вызова («Взять поле», «Собрать текст»). Эти два пункта стоят первыми вместо «своего значения»: объект вписать нельзя.

Note

Не у всех строк можно выбрать источник. У настроек, за которыми нет входа — «Где искать», «вид сравнения», «связь», — выбора источника нет: они задают поведение шага, а не значение. Предлагать там источник было бы обещанием, которого схема не выполнит.

И наоборот: в строку, которая ждёт словарь, значение нельзя вписать — пары текстом не напишешь. Такой вход только подключают.

Жёлтая рамка

Жёлтым отмечено незаполненное обязательное место. Рамка гаснет от набранной буквы, а не от выхода из поля: иначе непонятно, засчиталось ли то, что вы написали.

Списки значений

Часть строк — это выпадающие списки. Пункты в них бывают двух родов, и это важно различать.

Род списка	Пример	Поведение
Закрытый список	«Где искать», «вид сравнения», «связь», «какая часть», «если файла нет»	Значений ровно столько, сколько объявлено. Под каждым пунктом стоит строка-пояснение, чем он отличается от соседей. Значение, которого в списке нет, схема не примет и скажет допустимые.
Список из проекта	«Поле или ключ», ключи словаря	Список берётся из открытого проекта, но поле остаётся открытым для ручного ввода: проект может быть не открыт, а колонка законно встречается не у всех объектов.

Caution

Проект не открыт — список полей пуст, и конструктор говорит это вслух. Пустой список неотличим от «полей не бывает» и читался бы как поломка. Имя колонки при этом можно вписать руками — на счёте поле читается по имени, и промах даёт пустоту, а не обрыв.

Фраза шага

Наверху фигуры стоит фраза: «найти объекты ПЛК, у которых TAG равно», «взять второй объект», «перейти по связи “пороги”», «взять из пути имя файла без расширения». Фразу собирает сам шаг из своих настроек — заголовок действия без настроек ничего не значит.

Фраза меняется вместе с настройками и показывает то, что там написано как есть: если в номер вписали слово, во фразе будет это слово, и опечатку видно там, где её сделали.

Сводка у свёрнутой фигуры

Обычно раскрыты поля только у выбранной фигуры — остальные показывают фразу и сводку. Свёрнутая фигура плотнее: фраза на ступень мельче, поля ужаты в строку-сводку. Галка «раскрыть настройки всех шагов» в верхней строке окна раскрывает все.

Свободный вход

Незанятый вход у шага «Свой код» или «Вызвать схему» — не ошибка. Подсказка говорит прямо: «Свободный вход — не ошибка: подпись переносимого метода обязана совпасть со старой целиком». Переносимая функция обязана сохранить свою подпись, даже если часть аргументов в новой реализации не нужна.