Шаг «Изменить строку таблицы»

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

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

Откройте шаг на схеме. В поле «Таблица» выберите активную таблицу проекта, затем укажите лист.

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

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

Выберите действие

В поле «Что сделать» доступны три режима:

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

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

Определите ключ записи

Автоматизация не предполагает, что на одного лида всегда нужна одна строка. Сначала определите смысл таблицы:

• для одной текущей карточки лида ключом может быть lead_id;
• для отдельных заявок одного лида используйте request_id либо сочетание lead_id и идентификатора заявки;
• для журнала событий не ищите старую строку, а добавляйте новую при каждом событии.

Имя, телефон или номер строки не подходят как надёжный ключ, если они могут изменяться или повторяться. Номер строки — текущее положение, а не идентификатор записи.

Настройте поиск и несколько совпадений

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

Если могут совпасть несколько строк, выберите поведение в поле «Если найдено несколько строк»:

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

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

За одно выполнение можно изменить не более 1000 строк.

Укажите, что записать

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

Текущая дата и время вычисляются в момент выполнения. Системные данные лида доступны только автоматизациям «Для диалогов». Если используется переменная, она должна быть заполнена к моменту выполнения шага.

Проверьте запись безопасными данными

Тестовый запуск изменяет настоящую таблицу. Используйте строку, которую можно восстановить или удалить. Для интеграционного теста через API или MCP можно создать отдельную пустую таблицу и заполнить её типизированным JSON-методом добавления строк — загружать CSV/XLSX для этого не требуется.

Сначала убедитесь в истории процесса, что шаг завершён. Затем проверьте ключ и записанные значения. Фоновое обновление снимка таблицы для чтения может занять несколько десятков секунд. Если данные не видны сразу, повторяйте проверку с ограниченным ожиданием, пока версия таблицы не изменится. Подробные правила поиска и структуры таблицы также разобраны в статье о шаге «Найти строку в таблице».