Как посчитать количество в запросе 1С

Подсчёт количества — одна из самых частых задач при работе с запросами в 1С: нужно узнать число строк в документе, количество записей регистра, число сотрудников в подразделении или суммарное количество товара на складе. Язык запросов 1С предлагает для этого два разных механизма: агрегатную функцию КОЛИЧЕСТВО() и функцию СУММА() по числовому полю. Выбор между ними зависит от того, что именно вы считаете — строки или значения.

Типичная ошибка начинающих разработчиков — путать эти функции. КОЛИЧЕСТВО считает строки (или непустые значения поля), а СУММА складывает числовые значения, например остатки товара в штуках. Если в поле «Количество» документа хранится число упаковок, то «количество» в прикладном смысле считается через СУММА, а через КОЛИЧЕСТВО вы получите лишь число строк табличной части.

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

Чем КОЛИЧЕСТВО отличается от СУММА в языке запросов

Агрегатная функция КОЛИЧЕСТВО подсчитывает число значений в выборке. Вариант КОЛИЧЕСТВО(*) считает все строки результата, включая строки с NULL в любых полях. Вариант КОЛИЧЕСТВО(Поле) считает только строки, где указанное поле не равно NULL — это важное отличие, о котором часто забывают.

Функция СУММА работает иначе: она складывает числовые значения поля по всем строкам группы. Если в регистре накопления «ТоварыНаСкладах» есть ресурс «Количество», то суммарный остаток товара в штуках получают именно через СУММА по виртуальной таблице остатков, а не через КОЛИЧЕСТВО.

Простое правило выбора: если нужен ответ на вопрос «сколько записей» — используйте КОЛИЧЕСТВО, если «сколько единиц товара, часов, рублей» — используйте СУММА по соответствующему числовому полю.

Как посчитать количество строк через КОЛИЧЕСТВО(*)

Самая простая задача — узнать, сколько записей содержит таблица или выборка с отбором. Например, посчитать количество проведённых реализаций за период:

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

Запрос вернёт одну строку с одним полем. Если записей нет, результат будет 0, а не NULL — это удобно, потому что не требуется дополнительная проверка на пустое значение при обработке результата в коде.

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

Как посчитать суммарное количество товара через СУММА

Когда речь идёт о количестве в прикладном смысле — штуках, килограммах, часах — правильный инструмент это СУММА. Пример подсчёта остатков товара по всем складам:

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

Обратите внимание на секцию СГРУППИРОВАТЬ ПО: поле Номенклатура не обёрнуто в агрегатную функцию, поэтому оно обязано входить в группировку. Если забыть группировку, конструктор запросов выдаст ошибку ещё на этапе проверки текста.

Для табличных частей документов логика та же. Чтобы узнать общее количество товара в конкретной реализации, суммируйте поле Количество табличной части «Товары» с отбором по ссылке на документ.

Запрос = Новый Запрос("ВЫБРАТЬ СУММА(Товары.Количество) КАК Количество ИЗ Документ.РеализацияТоваровУслуг.Товары КАК Товары ГДЕ Товары.Ссылка = &Ссылка"); Запрос.УстановитьПараметр("Ссылка", СсылкаНаДокумент); Выборка = Запрос.Выполнить().Выбрать(); Если Выборка.Следующий() Тогда ИтогКоличество = ?(Выборка.Количество = NULL, 0, Выборка.Количество); КонецЕсли;

Как посчитать количество уникальных значений

Частая задача — узнать, сколько разных контрагентов, товаров или складов встречается в выборке. Для этого внутрь функции КОЛИЧЕСТВО добавляют ключевое слово РАЗЛИЧНЫЕ:

ВЫБРАТЬ
КОЛИЧЕСТВО(РАЗЛИЧНЫЕ Продажи.Контрагент) КАК КоличествоКлиентов
ИЗ
РегистрНакопления.Продажи.Обороты(&Начало, &Конец, , ) КАК Продажи

Конструкция считает каждое уникальное значение один раз, даже если контрагент встречается в тысяче строк оборотов. Без РАЗЛИЧНЫЕ вы получили бы общее число строк, что обычно не имеет смысла для такой задачи.

Учтите: КОЛИЧЕСТВО(РАЗЛИЧНЫЕ Поле) по-прежнему игнорирует NULL. Если поле необязательное и часть строк его не содержит, эти строки в подсчёт не попадут. Когда нужно считать и «пустые» как отдельную категорию, замените NULL на явное значение через ЕСТЬNULL(Поле, ЗНАЧЕНИЕ(...)) до группировки.

Группировки и итоги: два способа разложить количество по измерениям

Есть два способа получить количество в разрезе измерений. Первый — группировка СГРУППИРОВАТЬ ПО: результат содержит только строки групп, по одной на каждую комбинацию измерений. Это оптимально, когда детальные строки не нужны, например для диаграммы или сводного отчёта.

Второй способ — секция ИТОГИ ПО: запрос возвращает и детальные строки, и итоговые записи с подсчитанным количеством по каждой группе. Такой результат удобно обходить с группировкой в коде через Выбрать(ОбходРезультатаЗапроса.ПоГруппировкам) или выводить в табличный документ.

Если нужны только итоги, не тащите детальные строки через ИТОГИ — это лишняя нагрузка на сервер и память. Обратная ошибка — попытка «дособрать» детали к сгруппированному результату вторым запросом, хотя проще было сразу использовать ИТОГИ.

Обработка результата запроса в коде модуля

После выполнения запроса результат нужно корректно прочитать. Для запроса, возвращающего одну строку с количеством, типовой код выглядит так:

Запрос = Новый Запрос;
Запрос.Текст = "ВЫБРАТЬ КОЛИЧЕСТВО(*) КАК Количество ИЗ Справочник.Номенклатура";
Выборка = Запрос.Выполнить().Выбрать();
Если Выборка.Следующий() Тогда
КоличествоЭлементов = Выборка.Количество;
КонецЕсли;

Для СУММА ситуация тоньше: если выборка пуста, агрегат вернёт NULL. Присваивание NULL числовой переменной или дальнейшие арифметические операции с ним приведут к ошибке. Всегда обрабатывайте этот случай через проверку на NULL или функцию ЕСТЬNULL прямо в тексте запроса: ЕСТЬNULL(СУММА(Остатки.КоличествоОстаток), 0) КАК Количество.

Если поле результата названо через КАК, обращайтесь к нему в выборке именно по этому псевдониму. Обращение к несуществующему полю выборки вызывает ошибку исполнения, а не возвращает пустое значение.

1. 1
   Определите, что считаете: строки, уникальные значения или сумму числового поля
2. 2
   Напишите запрос с нужной агрегатной функцией и отбором
3. 3
   Добавьте СГРУППИРОВАТЬ ПО для всех неагрегатных полей
4. 4
   Оберните СУММА в ЕСТЬNULL(..., 0) для защиты от пустого результата
5. 5
   Выполните запрос в консоли запросов и сверьте цифру с данными в базе
6. 6
   Перенесите текст в модуль и обработайте результат через Выбрать() и Следующий()

Типичные ошибки и как их проверить

Первая частая ошибка — смешение агрегатных и обычных полей без группировки. Запрос ВЫБРАТЬ Номенклатура, КОЛИЧЕСТВО(*) ... без СГРУППИРОВАТЬ ПО Номенклатура не выполнится. Конструктор запросов подсвечивает такую проблему сразу, поэтому пишите сложные запросы именно через конструктор.

Вторая ошибка — подсчёт по таблице с соединением, которое размножает строки. Если к документам присоединить табличную часть, один документ даст столько строк, сколько позиций в нём, и КОЛИЧЕСТВО(*) завысит результат. Решение — считать КОЛИЧЕСТВО(РАЗЛИЧНЫЕ Ссылка) или выполнять подсчёт до соединения во временной таблице.

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

FAQ: частые вопросы о подсчёте количества в запросах 1С