Неверное имя колонки в 1С: как найти и исправить ошибку

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

Типичные ситуации: в запросе указано поле, которого нет в источнике; код обращается к реквизиту табличной части, переименованному при обновлении конфигурации; в схеме компоновки данных используется поле, отсутствующее в наборе данных; после загрузки данных из файла структура таблицы не совпала с ожидаемой. Во всех этих случаях логика исправления одинакова: найти, где формируется структура колонок, и сопоставить её с местом обращения.

Ниже разобраны основные сценарии возникновения ошибки, способы локализации проблемы через конфигуратор и отладчик, а также методы исправления для запросов, табличных частей, таблиц значений и отчётов на СКД.

Где именно возникает ошибка: основные источники

Сообщение «Неверное имя колонки» платформа выдаёт в нескольких контекстах, и для каждого свой порядок диагностики. Чаще всего источником оказывается обращение к таблице значений в коде: например, строка СтрокаТаблицы.Количество, когда колонка называется КоличествоТовара или вообще не добавлена. Второй частый источник — запрос: поле в секции ВЫБРАТЬ не существует в таблице-источнике, либо псевдоним задан неверно.

Третья группа случаев — табличные части объектов. Если при обновлении конфигурации реквизит табличной части был переименован или удалён, весь старый код, который к нему обращается, начнёт выдавать ошибку. Четвёртый источник — схема компоновки данных: поле указано в настройках отчёта, но отсутствует в наборе данных или на закладке «Вычисляемые поля».

Наконец, ошибка возникает при обмене данными: загрузке из Excel, CSV, при работе правил конвертации. Если структура файла изменилась (удалили или переименовали столбец), а код загрузки остался прежним, обращение по старому имени приведёт к тому же сообщению.

Как локализовать проблему через текст ошибки и отладчик

Первый шаг — внимательно прочитать полный текст сообщения. Платформа обычно указывает имя колонки, которое не удалось найти, и контекст: модуль, номер строки, процедуру. Если ошибка возникает в пользовательском режиме без деталей, включите отладку: откройте конфигуратор, подключитесь к сеансу (Отладка → Подключение) и поставьте точку останова на строке, указанной в сообщении.

В отладчике удобно использовать табло (Вычислить выражение): выполните выражение вида ТаблицаЗначений.Колонки и посмотрите фактический список колонок в момент ошибки. Часто оказывается, что колонка называется иначе, чем предполагал разработчик, — например, с другим регистром букв или с сокращением. Для запросов полезно вывести результат в временную таблицу и проверить состав полей через консоль запросов.

Если ошибка «плавающая» и возникает только при определённых данных, добавьте перед проблемной строкой проверку существования колонки и запись в журнал регистрации. Это позволит собрать фактуру: при каких условиях структура таблицы отличается от ожидаемой.

1. 1
   Скопируйте полный текст ошибки: имя колонки, модуль, строка
2. 2
   Откройте указанное место в конфигураторе или поставьте точку останова в отладчике
3. 3
   В табло вычислите структуру колонок объекта в момент ошибки
4. 4
   Сравните фактические имена с тем, что используется в коде
5. 5
   Исправьте имя или добавьте колонку и повторите сценарий

Исправление ошибки в запросе

Если ошибка возникает при выполнении запроса, откройте его текст и проверьте каждое поле в секции ВЫБРАТЬ. Поле должно существовать в таблице-источнике с точным именем, включая обращения через точку: Товары.Номенклатура.Код корректно только если у документа есть табличная часть «Товары» с реквизитом «Номенклатура», а у справочника «Номенклатура» есть реквизит «Код» (он есть всегда, но для произвольных реквизитов проверка обязательна).

Частая причина — псевдонимы. Если полю задан псевдоним через КАК, то дальше в коде к результату запроса нужно обращаться именно по псевдониму, а не по исходному имени поля. Например, запрос ВЫБРАТЬ Сумма КАК СуммаДокумента означает, что в выборке доступна колонка «СуммаДокумента», а обращение Выборка.Сумма вызовет ошибку.

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

ВЫБРАТЬ
	Продажи.Номенклатура КАК Товар,
	СУММА(Продажи.Количество) КАК КоличествоПродано
ИЗ
	РегистрНакопления.Продажи КАК Продажи
СГРУППИРОВАТЬ ПО
	Продажи.Номенклатура

Исправление при работе с таблицами значений и табличными частями

При работе с программно созданной таблицей значений колонка должна быть явно добавлена через ТаблицаЗначений.Колонки.Добавить("ИмяКолонки") до первого обращения. Если таблица создаётся выгрузкой из результата запроса (Запрос.Выполнить().Выгрузить()), состав колонок определяется полями запроса — изменение запроса автоматически меняет и структуру таблицы, о чём легко забыть.

Для табличных частей документов и справочников имя колонки — это имя реквизита табличной части в метаданных. Откройте объект в конфигураторе, перейдите на закладку «Данные» → «Табличные части» и сверьте точное написание. Помните, что платформа частично допускает обращение без учёта регистра, но полагаться на это не стоит: при рефакторинге и поиске ссылок точное имя критично.

Защитный приём — проверка существования колонки перед обращением. Конструкция Если Таблица.Колонки.Найти("Скидка") = Неопределено Тогда ... КонецЕсли; позволяет корректно обработать ситуацию, когда структура таблицы зависит от внешних данных, вместо того чтобы падать с ошибкой.

Ошибка в отчётах на СКД и после обновления конфигурации

В схеме компоновки данных ошибка «Неверное имя колонки» (или родственное «Поле не найдено») появляется, когда поле указано в настройках отчёта, ресурсах или отборе, но отсутствует в наборе данных. Откройте схему компоновки, проверьте текст запроса набора данных и закладку «Вычисляемые поля». Если поле добавлено в настройки вручную пользователем, а в схеме его нет, — удалите его из настроек или добавьте в набор данных.

Отдельный сценарий — сохранённые настройки отчётов. Пользователь мог сохранить вариант отчёта, после чего конфигурацию обновили и поле переименовали. Старая настройка ссылается на несуществующее поле, и отчёт падает при открытии. Решение: сбросить настройки отчёта к стандартным (Ещё → Установить стандартные настройки) или удалить устаревшие пользовательские варианты.

После обновления конфигурации используйте глобальный поиск по всем модулям (Правка → Глобальный поиск) по старому имени реквизита. Так вы найдёте все места обращения, включая те, что не проявляются в типовых сценариях и всплывут только при редких операциях. Дополнительно выполните проверку конфигурации (Конфигурация → Проверка конфигурации) с включённой проверкой логической целостности — она выявит часть битых ссылок на реквизиты ещё до запуска.

Типичные ошибки при исправлении

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

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

Третья ошибка — игнорирование регистра и локализации. В коде, формируемом динамически (например, при построении выражений для СКД или обращении через Вычислить() / Выполнить()), имя колонки собирается строкой, и опечатка в ней не видна при статической проверке. Такие места требуют особенно тщательного тестирования.

Проверка результата и профилактика

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

Для профилактики полезны три практики. Первая — использование конструктора запросов вместо написания текста вручную: он не даст сослаться на несуществующее поле. Вторая — централизованное задание имён колонок через константы или функции-конструкторы таблиц, чтобы имя существовало в одном месте. Третья — регламентная проверка конфигурации и прогон ключевых сценариев после каждого обновления, особенно если обновление затрагивало структуру метаданных.

Частые вопросы