Анатомия схемы
Схема нарисована блок-схемой сверху вниз. Форма фигуры несёт смысл, поэтому цвет остаётся свободным под состояние: жёлтым отмечено незаполненное место, зелёным — результат, красным — шаг, оборвавший прогон.
Сверху овал «Из ячейки», дальше фигуры шагов с номерами, внизу овал результата. Справа графа ведомости — по строке на шаг.
Фигуры
Section titled “Фигуры”| Фигура | Что это |
|---|---|
| Овал сверху | Граница с книгой: аргументы вызова из ячейки. Не «начало программы» — это место, где значения приходят извне. |
| Прямоугольник | Действие: шаг из палитры. |
| Ромб | Развилка: «Если / иначе» или «Развилка по значению». Вопрос написан внутри ромба, ответы стоят в ветках. |
| Овал снизу | Результат схемы: что уйдёт в ячейку и с какого шага. |
Номера шагов
Section titled “Номера шагов”У каждой фигуры слева стоит номер. Это порядок выполнения: заголовок графы ведомости так и подписан — вышло · шаги выполняются по номерам. Номера у шагов внутри ветки составные: 5.2.1.
Порядок исполнения задаётся связями, а не расположением; но раскладку считает программа, и номера всегда идут сверху вниз. В файле схемы координат нет вовсе: от перестановки фигур в редакторе файл не меняется и чисто сливается в SVN.
Линий на схеме ровно столько, сколько настоящих переходов, и это сделано нарочно.
| Как выглядит | Что означает |
|---|---|
| Стрелка между соседними фигурами | Значение идёт от предыдущего шага. Никаких подписей не нужно, достаточно соседства. На стрелке написано, что по ней течёт: объекты, текст, словарь. См. Формы значений. |
Пометка ↰ шаг N внутри фигуры | Значение пришло не от соседа, а от шага номер N. Это единственный случай, ради которого нужна ссылка, — и она стоит внутри фигуры, а не рисуется линией через полсхемы. |
| Пунктирная серая стрелка | По этой стрелке ничего не пронесли. Под фигурой, где это началось, написано здесь началась пустота. |
| Линии сходятся в узел на оси | ветки сходятся: после развилки дороги обеих ветвей приходят в одну точку, и дальше схема продолжается одной нитью. |
Как добавляют шаг
Section titled “Как добавляют шаг”Три способа, и они дают разный результат.
| Способ | Что получится |
|---|---|
| Клик по действию в палитре | Фигура встаёт в конец схемы и подключается к тому, чем схема заканчивается. Погашенное действие встанет отдельно — его вход надо будет подключить самому. |
Кнопка + под фигурой | Раскрывает список «дальше:» — только те действия, которые примут то, что вышло из этого шага. Подсказка у кнопки: «Вставить шаг сюда». |
Кнопка + шаг в ветку | Ставит шаг внутрь ветки развилки — он и станет её ответом. Подсказка: «Поставить шаг внутрь этой ветки: он и станет её ответом». |
Кнопки на самой фигуре
Section titled “Кнопки на самой фигуре”| Кнопка | Что делает |
|---|---|
| ↑ / ↓ | Переставить шаг выше («Выше») или ниже («Ниже»). |
| ✕ | Удалить шаг. |
| «подробнее…» | Показать всё, что вышло из шага, списком. Появляется у шага, из которого вышли объекты либо длинное значение. См. Окно «подробнее…». |
| «Править код» | Только у шага «Свой код»: открывает окно кода. |
| «Открыть схему» | Только у шага «Вызвать схему»: открывает вызываемую схему соседней вкладкой. |
| «Взять входы схемы» | Только у шага «Вызвать схему»: подгоняет строки вызова под текущие входы вызываемой схемы. Подсказка предупреждает: «Связи в пропавшие входы снимутся, новые строки заполните сами». |
Слияние ветвей: у каждой ветки своя точка входа, подписанная «сюда же приходит ответ ветки «Да»» и «…«Нет»», а на оси — то, что уйдёт дальше, и список «дальше: …».
Правая кнопка мыши на фигуре
Section titled “Правая кнопка мыши на фигуре”Контекстное меню фигуры: «Сделать результатом» — этот шаг станет результатом схемы, — и удаление шага. Кнопки для этого на фигуре нет.
Развилки
Section titled “Развилки”Развилка рисуется ромбом, стоящим на той же оси, что прямоугольники. Внутри ромба — строка с вопросом, подписанная «ЧЕМ ЗАДАН ВОПРОС» и «ВОПРОС»: это строки блока, втянутого в ромб, и правятся они здесь же.
Ответы стоят в своих ветках, а не в развилке: ответ принадлежит ветке. Шаги, которые кормят один ответ, нить рисует внутри его ветки — и тогда сразу видно, что эти шаги считаются только при выбранной ветке.
Вложенная развилка рисуется ветками друг под другом: колонки в колонку не влезают.
Развилка целиком: ромб с вопросом, строки «ВОПРОС» под ним, ветка «Да» с ответом GAP_error, ветка «Нет» со своими шагами 1.4.1–1.4.3, ниже — слияние.
Овал результата
Section titled “Овал результата”Внизу. Говорит, что уйдёт и со шага номер какой.
| Вид | Что означает |
|---|---|
| Зелёный | Схема отдаёт значение. Само значение написано рядом. |
| Жёлтый | Итог пуст: в ячейку уйдёт пустая строка. Овал говорит, с какого шага пошла пустота. |
Подпись из ячейки не зовут — ставят в другие схемы | Схема отдаёт объекты или список. Это законно: такая схема — блок для других схем, а не скрипт для ячейки. |
Овал результата: «В ячейку · текст со шага 1». Зелёный — схема отдаёт значение.
Пустая схема
Section titled “Пустая схема”Новая схема приходит с каркасом, но если шагов нет, на листе стоит подсказка «Шагов пока нет» с текстом:
Подсказка на пустом листе — она же отвечает, с чего начать.
Выберите первое действие в списке слева. «Найти объекты» — если схема ищет что-то в проекте. «Склеить» — если она собирает строку из аргументов вызова. Аргументы вызова заводятся наверху, в овале «Из ячейки», кнопкой «+ аргумент»: сколько их у переносимой функции, знает только тот, кто её переносит. Первый шаг возьмёт подходящий сам; какой именно, меняется в самой строке шага.