Как проверить наличие колонки в таблице значений 1С

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

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

Основной и рекомендуемый способ — метод Найти() у коллекции Колонки таблицы значений. Альтернативы — перебор колонок в цикле и обращение через попытку/исключение. Каждый вариант имеет свою область применения.

Как устроена коллекция колонок таблицы значений

У каждой таблицы значений есть свойство Колонки — это коллекция объектов типа «КолонкаТаблицыЗначений». Каждая колонка имеет имя, тип значения, заголовок и ширину. Именно по имени колонки происходит обращение к данным строки: Строка.Сумма фактически означает обращение к значению в колонке с именем «Сумма».

Коллекция колонок поддерживает индексацию, перебор в цикле «Для Каждого» и методы поиска. Для проверки существования колонки используется метод Найти(ИмяКолонки): он возвращает объект колонки, если она найдена, и Неопределено, если колонки с таким именем нет. Исключение при этом не возникает — это ключевое преимущество метода.

Важно понимать: поиск по имени колонки нечувствителен к регистру. Колонки «Сумма» и «СУММА» для платформы — одна и та же колонка, и метод Найти() найдёт её при любом написании имени.

Основной способ: метод Найти() у коллекции колонок

Стандартная конструкция проверки выглядит так:

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

Метод возвращает сам объект колонки, а не булево, поэтому сравнение идёт именно с Неопределено. Это удобно: найденную колонку можно сразу использовать, например прочитать её тип через НайденнаяКолонка.ТипЗначения и убедиться, что данные в ней ожидаемого формата.

Тот же приём работает и для дерева значений (ДеревоЗначений) — у него тоже есть коллекция Колонки с методом Найти(). Код проверки полностью аналогичен.

Колонка = ТаблицаДанных.Колонки.Найти("Сумма");
Если Колонка <> Неопределено Тогда
    Сообщить("Колонка найдена, тип: " + Колонка.ТипЗначения);
Иначе
    Сообщить("Колонки нет");
КонецЕсли;

Альтернативный способ: перебор колонок в цикле

Иногда нужно проверить сразу несколько колонок или найти колонки по частичному совпадению имени. В этом случае удобнее перебрать коллекцию в цикле:

Функция ЕстьКолонка(Таблица, ИмяКолонки)
Для Каждого Колонка Из Таблица.Колонки Цикл
Если ВРег(Колонка.Имя) = ВРег(ИмяКолонки) Тогда
Возврат Истина;
КонецЕсли;
КонецЦикла;
Возврат Ложь;
КонецФункции

Для простой проверки одной колонки цикл избыточен — метод Найти() короче и быстрее. Цикл оправдан, когда нужен гибкий поиск: по подстроке в имени, по типу колонки, по заголовку. Например, так можно найти все колонки, начинающиеся с префикса «Доп», через функцию СтрНайти().

При переборе помните о регистронезависимости: сравнивайте имена через ВРег() или НРег(), чтобы не зависеть от написания.

Проверка через Попытка/Исключение: когда и почему осторожно

Третий вариант — обратиться к колонке напрямую и перехватить ошибку:

Попытка
Значение = СтрокаТаблицы.Сумма;
КолонкаЕсть = Истина;
Исключение
КолонкаЕсть = Ложь;
КонецПопытки;

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

Использовать исключение оправдано в одном случае: когда обращение к колонке и так находится внутри блока «Попытка» по другим причинам (например, при разборе внешних данных), и отдельная проверка дублировала бы логику.

Практические сценарии применения

Загрузка данных из файла с непостоянной структурой

При загрузке из Excel или CSV набор колонок может меняться от файла к файлу. Безопасный шаблон: после формирования таблицы проверить обязательные колонки списком и отказаться от обработки с понятным сообщением, если чего-то не хватает:

Обязательные = СтрРазделить("Номенклатура,Количество,Цена", ",");
Для Каждого Имя Из Обязательные Цикл
Если Таблица.Колонки.Найти(Имя) = Неопределено Тогда
ВызватьИсключение "В файле отсутствует колонка: " + Имя;
КонецЕсли;
КонецЦикла;

Универсальная процедура обработки таблиц

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

Результат запроса с условными полями

Когда текст запроса собирается динамически, состав выгружаемых полей заранее неизвестен. После Результат.Выгрузить() проверка через Колонки.Найти() — единственный надёжный способ узнать, попало ли нужное поле в выборку.

1. 1
   Получите таблицу значений: результат запроса, загрузка из файла или программное заполнение
2. 2
   Вызовите Таблица.Колонки.Найти("ИмяКолонки") до начала обхода строк
3. 3
   Сравните результат с Неопределено — Неопределено означает, что колонки нет
4. 4
   Задайте поведение для отсутствующей колонки: значение по умолчанию, пропуск обработки или сообщение об ошибке
5. 5
   Только после проверки обращайтесь к колонке в цикле по строкам

Сравнение способов проверки

Типичные ошибки и как их избежать

Первая распространённая ошибка — сравнение результата Найти() с Ложь вместо Неопределено. Метод возвращает объект или Неопределено, булево значение он не возвращает, поэтому проверка = Ложь всегда даст неверный результат.

Вторая ошибка — проверка колонки у строки таблицы, а не у самой таблицы. У объекта «СтрокаТаблицыЗначений» нет коллекции колонок; проверять нужно Таблица.Колонки, а затем уже обращаться к значениям строки.

Третья ошибка — повторная проверка внутри цикла по строкам. Структура таблицы не меняется от строки к строке, поэтому достаточно одной проверки до цикла. Лишние вызовы не сломают код, но усложнят его и немного замедлят.

Как убедиться, что проверка работает правильно

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

Дополнительный признак корректной работы — отсутствие ошибок «Поле объекта не обнаружено» в журнале регистрации при обработке реальных данных. Если такие ошибки продолжают появляться, значит где-то осталось обращение к колонке в обход проверки.

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