При разработке отчетов в системе компоновки данных (СКД) часто возникает задача посчитать итог по вычисляемому полю из дочерней группировки. Например, у нас есть группировка "Контрагент", а внутри нее — "Счет покупателя". В группировке "Счет покупателя" мы рассчитали некий ресурс, и теперь хотим увидеть сумму этого ресурса на уровне "Контрагента" и в общих итогах.
Интуитивно понятное решение — использовать конструкцию Сумма(ВычислитьВыражениеСГруппировкойМассив("МойРесурс", "СчетПокупателя")). Однако, к удивлению многих разработчиков, вместо итоговой суммы в ячейке отчета отображается пустота. Отчет как будто собирает нужные данные, но не может их просуммировать. Давайте разберем по шагам, почему так происходит и какие существуют надежные способы решения этой проблемы.
Чтобы понять корень проблемы, нужно четко представлять, как работает функция ВычислитьВыражениеСГруппировкойМассив. Она вычисляет указанное выражение для каждой детальной записи, входящей в заданную группировку, и возвращает результат в виде массива значений. Далее функция Сумма пытается сложить все элементы этого массива.
Главный виновник сбоя — это значение NULL. Если хотя бы для одной из детальных записей ваше выражение вернет NULL, вся агрегатная функция Сумма может вернуть некорректный результат или, как в нашем случае, ничего. Это происходит потому, что в выражениях СКД арифметические операции с NULL (например, 5 + NULL) сами возвращают NULL. В итоге в массив для суммирования попадает "испорченное" значение, которое ломает весь расчет.
Проблема усугубляется тем, что NULL может возникнуть незаметно. Например, в выражении (СуммаДоходов - СуммаРасходов), если СуммаРасходов для какой-то записи отсутствует (является NULL), то и результат всей разности будет NULL. Поэтому ключевая стратегия — не допускать попадания NULL в массив для суммирования.
Самый прямой и надежный способ борьбы с NULL — это использовать функцию ЕстьNULL(). Она проверяет первое значение, и если оно равно NULL, заменяет его вторым, указанным значением (обычно нулем).
Важный момент: функцию ЕстьNULL() нужно применять не снаружи, а внутри выражения, которое передается в ВычислитьВыражениеСГруппировкойМассив. Мы должны гарантировать, что в формируемый массив попадут только числа.
Посмотрим на пример. Допустим, в группировке "СчетПокупателя" у нас есть вычисляемое поле "Взаимозачет", выражение для которого может вернуть NULL. Тогда в родительской группировке "Контрагент" мы должны написать:
Сумма(
ВычислитьВыражениеСГруппировкойМассив("ЕстьNULL(Взаимозачет, 0)", "СчетПокупателя")
)
Таким образом, мы сначала получаем массив, гарантированно состоящий из чисел (нули вместо NULL), и только потом этот "чистый" массив передаем функции Сумма, которая теперь без проблем его обработает.
Часто вычисляемое поле зависит от каких-либо условий. В таких случаях конструкция ВЫБОР КОГДА ... КОНЕЦ становится незаменимым инструментом. Она позволяет не только задать условия, но и определить значение по умолчанию через оператор ИНАЧЕ, что эффективно защищает от появления NULL.
Предположим, наше поле "Взаимозачет" должно рассчитываться только для определенного типа документа. Выражение для ресурса в самой группировке "СчетПокупателя" может выглядеть так:
Сумма(
ВЫБОР
КОГДА Документ.ТипОперации = ЗНАЧЕНИЕ(Перечисление.ТипыОпераций.Взаимозачет)
ТОГДА Документ.СуммаОперации
ИНАЧЕ 0
КОНЕЦ
)
Такой подход гарантирует, что для каждой записи будет возвращено либо значение суммы, либо 0. После этого в родительской группировке можно смело использовать Сумма(ВычислитьВыражениеСГруппировкойМассив(...)), так как исходные данные уже подготовлены и не содержат NULL.
В СКД существует "брат-близнец" нашей функции — ВычислитьВыражение (без суффикса "Массив"). Разница между ними принципиальная:
ВычислитьВыражениеСГруппировкойМассив("Выражение", "Группировка") — возвращает массив значений "Выражения" для каждой детальной записи группировки (это эффективный способ собрать значения колонки из нескольких строк).ВычислитьВыражение("Агрегат(Выражение)", "Группировка") — возвращает одно, уже агрегированное значение из указанной группировки.Второй вариант часто является более предпочтительным, так как избавляет от необходимости вручную суммировать массив. Вычисление происходит на уровне СКД более оптимально.
Выражение для поля в родительской группировке "Контрагент" будет выглядеть так:
ВычислитьВыражение("Сумма(Взаимозачет)", "СчетПокупателя")
Но будьте внимательны! Этот метод не избавляет от необходимости обрабатывать NULL. Проверку нужно по-прежнему встраивать внутрь выражения. Финальный, самый надежный вариант будет таким:
ВычислитьВыражение("Сумма(ЕстьNULL(Взаимозачет, 0))", "СчетПокупателя")
Этот подход считается наиболее профессиональным: он лаконичен, читаем и перекладывает всю работу по агрегации на механизм СКД, избегая создания промежуточных массивов.
Если после всех исправлений результат все равно пустой (например, если данные ограничены правами доступа, стоит проверить СКД в привилегированном режиме), проанализируем ситуацию по шагам:
ВычислитьВыражениеСГруппировкойМассив("ВашеВыражение", "ДочерняяГруппировка"). В отчете вы увидите текстовое представление массива. Проверьте, есть ли в нем значения NULL или что-то кроме чисел.NULL (например, "Количество"). Если с простым полем итог считается, значит, ошибка кроется именно в логике вашего первоначального выражения.NULL, воспользуйтесь советом из обсуждения: временно замените 0 на большое, заметное число, например, 1000000.
Сумма(ВычислитьВыражениеСГруппировкойМассив("ЕстьNULL(Взаимозачет, 1000000)", ...))
NULL.
Подводя итог, можно сказать, что проблема пустого значения при суммировании результатов ВычислитьВыражениеСГруппировкойМассив почти всегда связана с некорректной обработкой NULL. Всегда проверяйте свои данные и выражения на возможность их появления и используйте функции ЕстьNULL, ВЫБОР или более подходящую функцию ВычислитьВыражение для получения надежных и предсказуемых результатов в отчетах СКД.