Как получить количество строк в таблице 1С: от простых методов до сложных запросов

Работа с таблицами в 1С:Предприятие — одна из самых частых задач, с которыми сталкиваются как разработчики, так и опытные пользователи. Нередко требуется узнать количество строк в табличной части документа, справочника или результата запроса — будь то для отчетности, проверки данных или оптимизации кода. На первый взгляд задача кажется тривиальной, но в зависимости от контекста (версия платформы, тип таблицы, наличие отборов) подходы могут кардинально отличаться.

В этой статье мы разберем 5 основных способов получения количества строк — от элементарных методов для новичков до продвинутых техник с использованием Запросов и объектной модели. Особое внимание уделим нюансам: почему Количество() иногда возвращает неверное значение, как учитывать отборы и группировки, и какие методы работают быстрее на больших объемах данных. Если вы когда-либо сталкивались с тем, что количество строк в таблице на форме не совпадает с реальным числом записей в базе, эта инструкция поможет разобраться в причинах и найти решение.

1. Простейший способ: метод Количество() для таблиц на форме

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

Пример кода для таблицы на форме документа:

КоличествоСтрок = ЭлементыФормы.ТабличнаяЧастьТовары.Количество();

Важно понимать ограничения этого метода:

• 🔹 Работает только с таблицами, привязанными к элементам формы. Для программных таблиц (ТаблицаЗначений или ТаблицаДокумента) нужен другой подход.
• 🔹 Учитывает только те строки, которые прошли клиентские отборы. Если на сервере данные фильтруются иначе, результат может отличаться.
• 🔹 Не работает с динамическими списками — для них требуется отдельная логика (см. раздел 3).

⚠️ Внимание: Если таблица на форме имеет иерархический вид (например, с группировками по складам), метод Количество() вернет количество визуальных строк, включая заголовки групп. Чтобы получить только данные, используйте ЭлементыФормы.Таблица.Данные.Количество().

2. Работа с ТаблицаЗначений и ТаблицаДокумента

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

Примеры:

// Для ТаблицыЗначений
ТаблицаТоваров = Новый ТаблицаЗначений;
ТаблицаТоваров.Колонки.Добавить("Наименование");
ТаблицаТоваров.Колонки.Добавить("Количество");
ТаблицаТоваров.Добавить();
ТаблицаТоваров.Добавить();

КоличествоСтрок = ТаблицаТоваров.Количество(); // Вернет 2

// Для табличной части документа (серверный контекст)
КоличествоСтрок = Документ.Товары.Количество();

Особенности работы с этими объектами:

• 📌 ТаблицаЗначений.Количество() — самый быстрый метод для программных таблиц, так как не требует обращения к базе данных.
• 📌 Для ТаблицаДокумента (например, Документ.Товары) результат зависит от прав пользователя: если у него нет прав на чтение некоторых строк, они не будут учтены.
• 📌 Если таблица пустая, метод вернет 0, а не Неопределено.

3. Подсчет строк в динамических списках

Динамические списки — это особый тип таблиц в 1С, который подгружает данные порциями (пагинация) и поддерживает серверные отборы. Здесь метод Количество() работать не будет, так как на клиенте отображается только часть данных. Чтобы получить полное количество строк, нужно использовать свойство ВыбратьКоличество().

Пример для динамического списка на форме:

ДинамическийСписок = ЭлементыФормы.СписокТоваров.Список;
КоличествоСтрок = ДинамическийСписок.ВыбратьКоличество();

Ключевые моменты:

⚠️ Внимание: Метод ВыбратьКоличество() выполняет дополнительный запрос к базе данных. Если динамический список уже имеет отборы, они будут учтены автоматически. Однако если отборы меняются динамически (например, при изменении фильтров пользователем), результат может устареть. В таких случаях используйте событие ПриИзмененииОтбора для пересчета.

4. Использование запросов для подсчета строк

Когда нужно посчитать строки в реальной таблице базы данных (например, в регистре накопления или документе), самый надежный способ — использовать Запрос. Этот метод универсален, работает на сервере и учитывает все возможные отборы, включая права доступа.

Базовый пример:

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|   КОЛИЧЕСТВО(*) КАК КоличествоСтрок
|ИЗ
|   Документ.ЗаказПокупателя КАК Заказ
|ГДЕ
|   Заказ.Дата МЕЖДУ &НачалоПериода И &КонецПериода";

Запрос.УстановитьПараметр("НачалоПериода", НачалоДня(ТекущаяДата()));
Запрос.УстановитьПараметр("КонецПериода", КонецДня(ТекущаяДата()));

Результат = Запрос.Выполнить();
КоличествоСтрок = Результат.Выбрать().КоличествоСтрок();

Преимущества этого подхода:

• 🛠️ Работает с любыми таблицами базы: документы, справочники, регистры, последовательности.
• 🛠️ Поддерживает сложные отборы, включая вложенные запросы и объединения (ОБЪЕДИНИТЬ).
• 🛠️ Учитывает права доступа текущего пользователя (в отличие от прямых обращений к таблицам).

Для ускорения запросов на больших объемах данных используйте:

Использовать индексированные поля в условиях (например, Ссылка вместо Наименование)

Заменять КОЛИЧЕСТВО(*) на КОЛИЧЕСТВО(РАЗЛИЧНЫЕ Поле), если нужны уникальные значения

Избегать ПОМЕСТИТЬ и ВРЕМЕННЫЕ ТАБЛИЦЫ без необходимости

Применять ИНДЕКСИРОВАТЬ ПО для часто используемых полей-->

⚠️ Внимание: Если в запросе используются виртуальные таблицы (например, РегистрНакопления.ОстаткиИОбороты), результат КОЛИЧЕСТВО(*) может отличаться от ожидаемого из-за особенностей хранения данных в 1С. Например, для регистра накопления с периодичностью "По дням" количество строк будет равно числу уникальных комбинаций измерений, а не физических записей.

ВЫБРАТЬ РАЗРЕШЕННЫЕ Документ.ЗаказПокупателя.Ссылка КАК Ссылка ПОМЕСТИТЬ ВТДокументы
ВЫБРАТЬ КОЛИЧЕСТВО(РАЗЛИЧНЫЕ Ссылка) ИЗ ВТДокументы

Счетчик = 0;
Для Каждого Строка Из ТаблицаЗначений Цикл
Счетчик = Счетчик + 1;
КонецЦикла;

МенеджерВременныхТаблиц = Новый МенеджерВременныхТаблиц;
ДанныеСписка = ЭлементыФормы.СписокТоваров.Список.ПолучитьДанные(МенеджерВременныхТаблиц);
КоличествоСтрок = ДанныеСписка.Выбрать().Количество();

КомпоновщикМакета = Новый КомпоновщикМакетаКомпоновкиДанных;
КомпоновщикМакета.Инициализировать(СхемаКомпоновкиДанных);
Настройки = КомпоновщикМакета.ПолучитьНастройкиПоУмолчанию();
// Примените отборы через Настройки.Отбор
Результат = КомпоновщикМакета.Выполнить(Настройки);
КоличествоСтрок = Результат.Вывод.КоличествоСтрок();