После вставки столбца найдите первое место, где скрипт выбирает поле по числу: row[3], getRange(..., 4) или фиксированный A1-диапазон. Эти адреса описывают позицию, поэтому новое поле сдвигает смысл. Для изменяемой таблицы стройте карту полей по проверенной строке заголовков и запрещайте запись при неоднозначности.
Индекс массива и координата листа отличаются
Google документирует getValues как двумерный массив с индексами от нуля, тогда как координаты Range начинаются с единицы. Источник проверен 27 октября 2026 года. После нахождения поля в массиве нельзя без преобразования использовать тот же индекс как номер столбца листа.
Условный пример для уже прочитанных headers и row:
const matches = headers.flatMap((h, i) => h === 'record_id' ? [i] : []);
if (matches.length !== 1) throw new Error('Schema mismatch');
const index = matches[0];
const recordId = row[index];
const sheetColumn = index + 1;
Пример предполагает начало диапазона в столбце A.
Для другого начала нужен его фактический столбец.Этот фрагмент только показывает выбор поля, а не готовую обработку заказов. Строку заголовков, нужный лист и начальный столбец задавайте явно. Если скрипт запускается по триггеру, не полагайтесь на случайно выбранную пользователем активную вкладку.
| Изменение схемы | Ожидаемая реакция |
|---|---|
| Добавлено необязательное поле | Разрешить, если контракт допускает |
| Обязательное поле исчезло | Остановить запись с объяснением |
| Два одинаковых заголовка | Отказаться от неоднозначного выбора |
| Столбцы переставлены | Сохранить смысл по карте |
| Название поля изменилось | Применить утверждённое соответствие или отказ |
Человеческая подпись не всегда хороший идентификатор
Решите, допускается ли редактирование заголовков. Для контролируемой автоматизации удобны стабильные ключи полей или отдельная схема, а человекочитаемые подписи могут меняться независимо. Если используется только видимая строка, закрепите её контракт и понятное сообщение об ошибке.
Нормализацию заголовков выбирайте осторожно. Удаление пробелов по краям иногда полезно, но превращение похожих названий в одно может создать коллизию. После любой нормализации снова проверяйте уникальность. Не выбирайте первый совпавший столбец автоматически.
Проверяйте все обязательные поля до любых изменений. Если скрипт сначала запишет половину результатов, а затем обнаружит отсутствующий столбец, книга останется в частично обновлённом состоянии. Разделите чтение и проверку схемы, вычисление результата и контролируемую запись.
getDataRange возвращает область с данными, но не знает бизнес-смысл строк и столбцов. Документация Google проверена 27 октября 2026 года. Пустая строка заголовков, служебные блоки и данные сбоку требуют явного выбора рабочего диапазона, а не предположения, что вся область — одна таблица.
Перестановка становится регрессионным сценарием
- Сделать копию с синтетическими данными и отключёнными внешними действиями.
- Сохранить исходный результат для нескольких record_id.
- Вставить и переставить допустимые столбцы.
- Проверить одинаковый смысл результата по ключам записей.
- Удалить обязательное поле и убедиться, что запись не началась.
Добавьте тест с дублирующимся заголовком. Он выявляет опасный вариант, когда скрипт продолжает работать, но использует чужое поле. В отчёте об отказе достаточно имени схемы и проблемных заголовков; полные строки клиентов в журнале не нужны.
Если другие редакторы могут менять структуру во время запуска, согласуйте окно изменения или проверку версии схемы перед записью. Карта, прочитанная в начале, может устареть. Повтор запуска должен опираться на ключ записи и не создавать дубли из-за частично обработанного прошлого набора.
Для разбора приложите строку заголовков до и после, начальную координату диапазона и пример ожидаемого соответствия. Правильный результат — сохранение смысла полей при разрешённых перестановках и явный отказ до записи при нарушении схемы.