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

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

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

Ниже разобраны рабочие приёмы с примерами кода, типичными ошибками и рекомендациями по выбору метода под конкретную задачу.

Обращение к строке по индексу и чтение ячейки

Каждая строка таблицы значений доступна по числовому индексу, начиная с нуля. Общий синтаксис: ТЗ[Индекс].ИмяКолонки. Например, чтобы прочитать значение колонки «Сумма» из первой строки:

ЗначениеЯчейки = ТаблицаТоваров[0].Сумма;

Имя колонки можно также передать строкой через квадратные скобки — это удобно, когда имя колонки заранее неизвестно и хранится в переменной:

ИмяКолонки = "Сумма";
ЗначениеЯчейки = ТаблицаТоваров[0][ИмяКолонки];

Главный риск прямого обращения — выход за границы таблицы. Если таблица пустая или индекс больше, чем Количество() - 1, платформа выдаст ошибку «Индекс находится за границами массива». Поэтому перед обращением по индексу проверяйте размер таблицы:

Если ТаблицаТоваров.Количество() > 0 Тогда
ПерваяСумма = ТаблицаТоваров[0].Сумма;
КонецЕсли;

Поиск строки методом Найти()

Метод Найти(Значение, ИмяКолонки) возвращает первую строку, где указанная колонка равна искомому значению. Если совпадений нет — возвращает Неопределено. Это самый частый способ получить конкретное значение по ключу:

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

Обязательно проверяйте результат на Неопределено до обращения к колонкам найденной строки. Обращение Неопределено.Цена — одна из самых распространённых ошибок при работе с таблицами значений.

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

Отбор нескольких строк через НайтиСтроки()

Когда нужно получить все строки, удовлетворяющие одному или нескольким условиям, применяется метод НайтиСтроки(ПараметрыОтбора). Условия передаются структурой, где ключ — имя колонки, а значение — искомое значение. Метод возвращает массив строк (возможно, пустой):

Отбор = Новый Структура;
Отбор.Вставить("Склад", ОсновнойСклад);
Отбор.Вставить("Активна", Истина);

НайденныеСтроки = ТаблицаТоваров.НайтиСтроки(Отбор);
Для Каждого Строка Из НайденныеСтроки Цикл
ОбщееКоличество = ОбщееКоличество + Строка.Количество;
КонецЦикла;

Все условия в структуре объединяются по «И»: строка попадёт в результат, только если совпадут значения всех перечисленных колонок. Отбор по условию «ИЛИ» или по сравнению «больше/меньше» через НайтиСтроки() не делается — такие задачи решаются циклом с проверкой или запросом.

Перебор строк в цикле и получение значений по условию

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

МаксимальнаяСумма = 0;
СтрокаМаксимума = Неопределено;

Для Каждого СтрокаТовара Из ТаблицаТоваров Цикл
Если СтрокаТовара.Сумма > МаксимальнаяСумма Тогда
МаксимальнаяСумма = СтрокаТовара.Сумма;
СтрокаМаксимума = СтрокаТовара;
КонецЕсли;
КонецЦикла;

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

Если строки нужны по индексу (например, обработка парами или с конца), подойдёт классический цикл со счётчиком: Для Индекс = 0 По ТЗ.Количество() - 1 Цикл. Обратный обход удобен при удалении строк внутри цикла — удаление при прямом обходе сдвигает индексы и приводит к пропуску строк.

Для Индекс = -ТЗ.Количество() + 1 По 0 Цикл
    Строка = ТЗ[-Индекс];
    Если Строка.Пометка Тогда
        ТЗ.Удалить(Строка);
    КонецЕсли;
КонецЦикла;

Итоги, свёртка и выгрузка колонки

Если нужна не строка, а агрегированное значение по колонке, перебор не обязателен. Метод Итог("Сумма") возвращает сумму по числовой колонке всей таблицы:

ОбщаяСумма = ТаблицаТоваров.Итог("Сумма");

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

Для получения всех значений одной колонки в виде массива используйте ВыгрузитьКолонку("Номенклатура"). Обратная операция — ЗагрузитьКолонку(Массив, "Номенклатура") — записывает массив значений в колонку.

Производительность и большие таблицы

Методы Найти() и НайтиСтроки() выполняют линейный перебор строк. На таблице в несколько тысяч строк это незаметно, но если поиск вызывается внутри цикла по другой таблице, сложность становится квадратичной, и обработка может занять минуты.

Для ускорения повторного поиска создайте индекс по колонке: ТЗ.Индексы.Добавить("Номенклатура"). После этого Найти() и НайтиСтроки() по этой колонке будут работать значительно быстрее. Индекс имеет смысл добавлять, когда поиск выполняется многократно — на одиночный поиск затраты на построение индекса могут не окупиться.

Альтернатива для тяжёлых выборок — получить данные запросом сразу с нужным отбором и группировкой, а не фильтровать таблицу значений в памяти. Запрос на сервере СУБД почти всегда быстрее программного перебора.

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

После получения значения полезно убедиться, что оно корректно: тип соответствует ожиданиям, значение заполнено. Для проверки типа используйте ТипЗнч(Значение), для проверки заполненности — ЗначениеЗаполнено(Значение).

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

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