Как получить количество документов в выборке с разбивкой по статусам в 1С?

При разработке отчетов или обработок в 1С часто возникает задача посчитать количество документов, сгруппировав их по определенному признаку, например, по статусу («Новая», «В работе», «Просрочено»). Новички часто сталкиваются с проблемой: запрос возвращает «ноль» или неверные данные из-за неправильной работы с результатом запроса или неверной структуры самого запроса. Давайте разберем, как решить эту задачу профессионально и избежать ошибок.

Вариант 1: Использование итогов в запросе

Этот способ идеален, когда вам нужно получить «сводные» показатели по всем статусам за один проход. Мы используем конструкцию ИТОГИ, которая позволяет системе 1С самостоятельно рассчитать сумму по заданным условиям.

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

Запрос = Новый Запрос;
Запрос.Текст = "ВЫБРАТЬ
|	ВЫБОР
|		КОГДА Журнал.Статус = ЗНАЧЕНИЕ(Перечисление.Статусы.Новая) ТОГДА 1
|		ИНАЧЕ 0
|	КОНЕЦ КАК Новая,
|	ВЫБОР
|		КОГДА Журнал.Статус = ЗНАЧЕНИЕ(Перечисление.Статусы.ВРаботе) ТОГДА 1
|		ИНАЧЕ 0
|	КОНЕЦ КАК ВРаботе,
|	ВЫБОР
|		КОГДА Журнал.Статус = ЗНАЧЕНИЕ(Перечисление.Статусы.Просрочено) ТОГДА 1
|		ИНАЧЕ 0
|	КОНЕЦ КАК Просрочено
|ИЗ
|	Документ.Журнал КАК Журнал
|ИТОГИ
|	СУММА(Новая),
|	СУММА(ВРаботе),
|	СУММА(Просрочено)
|ПО
|	ОБЩИЕ";

Результат = Запрос.Выполнить();
Выборка = Результат.Выбрать(ОбходРезультатаЗапроса.ПоГруппировкам);

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

Важные моменты:

• Ключевое слово ОБЩИЕ в разделе ИТОГИ заставляет запрос рассчитать сумму по всей выборке.
• Метод Выбрать(ОбходРезультатаЗапроса.ПоГруппировкам) позволяет нам сразу встать на строку общих итогов.
• Мы обращаемся к переменным напрямую, так как они теперь содержат агрегированные данные.

Вариант 2: Использование группировки (СГРУППИРОВАТЬ ПО)

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

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

Выборка = Запрос.Выполнить().Выбрать();

Пока Выборка.Следующий() Цикл
    Если Выборка.Статус = Перечисления.Статусы.Новая Тогда
        Новые = Выборка.Количество;
    ИначеЕсли Выборка.Статус = Перечисления.Статусы.ВРаботе Тогда
        ВРаботе = Выборка.Количество;
    ИначеЕсли Выборка.Статус = Перечисления.Статусы.Просрочено Тогда
        Просрочено = Выборка.Количество;
    КонецЕсли;
КонецЦикла;

Почему этот способ надежен:

1. Запрос возвращает ровно столько строк, сколько активных статусов используется в документах.
2. Мы обходим результат циклом Пока Выборка.Следующий(), что исключает потерю данных.
3. Внутри цикла мы анализируем каждое поле Статус и распределяем полученное Количество по нужным нам переменным.

Типичные ошибки при разработке

Разберем, почему у вас могли возникать «нули» или ошибки:

• Неправильный обход: Если запрос содержит итоги, нельзя использовать цикл Пока для детальных записей, если вы хотите получить только итог. Сначала нужно выполнить метод Выборка.Следующий(), чтобы перейти к строке итогов.
• Ошибки обращения: Часто программисты пытаются обратиться к свойству, которого нет в текущей итерации цикла. Всегда проверяйте, что именно вы выбрали из базы данных.
• Путаница методов: Никогда не путайте свойства объекта с методами. Например, Результат.Выбрать — это метод, поэтому он всегда пишется со скобками (). Отсутствие скобок приведет к ошибке Поле объекта не обнаружено.

Совет по отладке

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