Шаг «Найти строку в таблице»

Шаг «Найти строку в таблице» проверяет наличие подходящих строк и направляет процесс по ветке «Да» или «Нет». Он доступен автоматизациям «Для диалогов» и «Фоновая». Сначала создайте или импортируйте таблицу, если в проекте её ещё нет.

Выберите таблицу и лист

Добавьте шаг «Найти строку в таблице» и откройте его на схеме.

В поле «Таблица» выберите активную таблицу проекта, затем укажите лист. При смене таблицы или листа диапазоны сбрасываются, поэтому после такого изменения проверьте условия поиска и сохраняемые столбцы.

Для условий поиска редактор запоминает не только номер, но и заголовок столбца. Если столбец переместили, но его уникальный заголовок не изменился, настройка последует за ним. Если заголовок переименован или одинаковое название встречается несколько раз, шаг попросит выбрать столбец заново. Это защищает от незаметного поиска не в том поле.

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

Укажите структуру данных

В поле «Структура таблицы» выберите один из вариантов:

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

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

Настройте поиск строки

В блоке «Где искать» добавьте одно или несколько условий. Для каждого условия выберите столбец, сравнение «Равно» или «Содержит» и значение. Строка подходит, только если одновременно выполнены все условия.

Для значения доступны:

• текст, число, «Да / нет» или пустая ячейка;
• текущая дата, текущее время или дата и время. Значение вычисляется при выполнении шага в часовом поясе, сохранённом при настройке, и записывается в формате 2026-08-19, 14:30:00 или 2026-08-19 14:30:00;
• системные данные текущего лида: имя, телефон, email, канал, внешний ID и другие поля. Этот источник есть только в автоматизации «Для диалогов»;
• переменная текущего процесса, лида, диалога или проекта.

В текст можно вставить несколько переменных и дополнить их обычными словами. В окне вставки доступны переменные процесса, проекта, лида и диалога, а в автоматизации «Для диалогов» — также системные данные лида. Если нужной переменной ещё нет, создайте её из этого же окна; после создания она вставится автоматически.

Типы важны: например, число 10 и текст 10 при точном сравнении считаются разными значениями. «Содержит» сравнивает текст без учёта регистра.

В одном шаге можно задать до 20 условий. Перед публикацией проверьте его на данных, для которых используемые переменные заполнены.

Шаг «Найти строку в таблице» переходит по ветке «Да», если найдена хотя бы одна подходящая строка, и по ветке «Нет», если совпадений нет. Данные таблицы он не изменяет.

Сохраните результат поиска

В шаге «Найти строку в таблице» откройте блок «Сохранение результата» и в поле выберите один из вариантов:

• «Не сохранять» — шаг только перейдёт по ветке «Да» или «Нет»;
• «Первую найденную строку» — возьмёт первое совпадение сверху вниз;
• «Все найденные строки» — соберёт все совпадения в массив.

Для первой строки в поле способа сохранения доступны два варианта:

• «Выбранные поля в объект» — выберите столбцы, дайте их полям понятные имена и сохраните объект в одну переменную;
• «Выбранные поля в переменные» — каждый столбец записывается в отдельную совместимую переменную.

Для варианта «Выбранные поля в переменные» в блоке «Сохранить выбранные поля» нажмите «Добавить», выберите столбец и укажите переменную процесса, лида, диалога или проекта. Значение будет взято из первой найденной строки сверху вниз. Можно добавить до 100 полей; одна целевая переменная не должна повторяться в нескольких строках.

Для всех строк выберите поля и их имена, затем укажите переменную типа «Массив». В неё будет записан массив объектов. Имя поля начинается с латинской буквы или _, может содержать латинские буквы, цифры, _ и - и не может быть длиннее 80 символов.

Можно выбрать до 100 полей. Целевые переменные не должны повторяться; в фоновой автоматизации области «Лид» и «Диалог» недоступны. Карандаш рядом с целевой переменной позволяет сохранить результат во вложенное поле.

Если строка не найдена, объект первой строки получит null, а массив всех строк — пустой массив. При сохранении отдельных полей их переменные не изменяются, потому что значений для записи нет. В любом из этих случаев процесс перейдёт по ветке «Нет».

Перейдите к изменению строк

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

Проверьте перед публикацией

Запустите тест с данными, для которых заранее известен результат поиска, затем откройте процесс и проверьте выбранную ветку и сохранённые переменные. Этот шаг только читает таблицу и не изменяет её строки.

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