Функции СКД: ВычислитьВыражение, ВычислитьВыражениеСГруппировкойМассив

Публикация № 1101676

Программирование - Практика программирования

внутренние функции СКД вычислить выражение с группировкой массив

203
Подробное описание и использование внутренних функций системы компоновки данных: Вычислить, ВычислитьВыражение, ВычислитьВыражениеСГруппировкойМассив, ВычислитьВыражениеСГруппировкойТаблицаЗначений.

Предыдущие статьи по СКД можно посмотреть по ссылкам ниже:

Система компоновки данных, это очень сложный и многофункциональный механизм. СКД имеет массу возможностей, которые далеко не всегда используются при создании простых отчетов.

Одним из таких механизмов является использование внутренних функций СКД.

Применение внутренних функций достаточно широко, их можно использовать:

  • В реквизитах полей компоновки: «Выражение представления», «Выражение упорядочивания»  
  • В выражениях вычисляемых полей
  • В выражениях ресурсов
  • В выражениях связей наборов данных
  • В выражениях параметров
  • В выражениях параметров предопределенных макетов
  • В выражениях пользовательских полей

Самих функций очень много, полный их перечень можно посмотреть в справке 1С:

Внутренние функции СКД

В основном их назначение и использование интуитивно понятно, поэтому рассматривать их подробно я смысла не вижу.

Исключением являются функции из группы «Вычислить выражение»:

  • Вычислить
  • ВычислитьВыражение
  • ВычислитьВыражениеСГруппировкойМассив
  • ВычислитьВыражениеСГруппировкойТаблицаЗначений

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

Цель этой статьи - «осознанное» применение функций из группы «Вычислять выражение».

И так, поехали…

Первая функция «Вычислить» - на данный момент устарела. Она является подмножеством функции «ВычислитьВыражение», в которой реализован весь ее функционал и добавлены дополнительные возможности. Функция «Вычислить» осталась только для сохранения обратной совместимости. Поэтому перейдем сразу к рассмотрению функции «ВычислятьВыражение».

 

ВычислитьВыражение

Полный синтаксис функции следующий:

ВычислитьВыражение(Выражение, Группировка, ТипРасчета, Начало, Конец, Сортировка, ИерархическаяСортировка, ОбработкаОдинаковыхЗначенийПорядка)

Общее описание функции:

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

Само выражение задается в первом параметре функции. Остальные семь параметров отвечают за определение группировки или набора группировок, в контексте которых этот расчет будет выполнен.

Рассмотрим эти параметры последовательно.

 

Группировка

Указание группировки, в контексте которой будет выполнен расчет.

Для примера, рассмотрим простой отчет со следующей структурой:

Структура простого отчета

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

ВычислитьВыражение("Сумма(Количество)", «Товар»,)

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

Если создать поле с выражением:

ВычислитьВыражение("Сумма(Количество)", «Склад»,)

Для всех записей (детальных и групповых) будет выполнен расчет по строкам, входящим в родительскую группировку «Склад»:

Расчет по группировкам

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

Например, следующие выражения указанное для расчета итога ресурсу «Количество» будут работать абсолютно одинаково:

ВычислитьВыражение("Сумма(Количество)", , )
Сумма(Количество)

Если в качестве параметра указано значение «ОбщийИтог», выражение будет рассчитано по всем строкам отчета.

 

Тип расчета

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

  • Группировка,
  • ОбщийИтог,
  • Иерархия,
  • ГруппировкаНеРесурса.

Если параметр не указан, значение по умолчанию - «Группировка». В этом случае никаких дополнительных уточнений выполняться не будет.

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

Ниже примеры работы выражений:

ВычислитьВыражение("Сумма(Количество)", «Товар», «ОбщийИтог»)
ВычислитьВыражение("Сумма(Количество)", , «ОбщийИтог»)

Тип расчета - общий итог

Значение параметра «Иерархия» имеет смысл только в том случае, если в отчете используется иерархическая группировка. Данная инструкция позволяет рассчитать выражение по родителю группировки, указанной во втором параметре. Если второй параметр не указан, по родителю текущей группировке.

Пример работы выражения:

ВычислитьВыражение("Сумма(Количество)", «Товар», «Иерархия»)

Тип расчета - Иерархия

Если в отчете не используется иерархия для группировок, значение «Иерархия» работает аналогично значению «ОбщийИтог».

Существует еще загадочное значение «ГруппировкаНеРесурса».

Описание, приведенное в справке не понятно:

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

Мне не доводилось использовать данное значение. Проводя эксперименты, каких-то отличий применения данного значения от значения «Группировка», я не выявил. Очень может быть, что это значение не актуально на сегодняшний день.

Если кто-то использовал это значение, напишите, пожалуйста, в комментариях, очень интересно!

 

Группа параметров: «Начало», «Конец»

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

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

Конструкции ниже являются аналогичными:

ВычислитьВыражение("Сумма(Количество)", , «ОбщийИтог»)
ВычислитьВыражение("Сумма(Количество)", , , «Первая», «Последняя»)

И

ВычислитьВыражение("Сумма(Количество)", , )
ВычислитьВыражение("Сумма(Количество)", , «Группировка»)
ВычислитьВыражение("Сумма(Количество)", , , «Текущая», «Текущая»)

Возможные значения параметров следующие:

  • Первая – первая группировка или детальная запись в наборе, возможно указать смещение «Первая(2)»,
  • Последняя - последняя группировка или детальная запись в наборе, возможно указать смещение «Последняя(2)»,
  • Предыдущая – предыдущая от текущей группировки или детальной записи в наборе, возможно указать смещение «Предыдущая(2)»,
  • Последующая - следующая от текущей группировки или детальной записи в наборе, возможно указать смещение «Следующая(2)»,
  • Текущая – текущая группировка или детальная запись,
  • ОграничивающееЗначение – ограничение по конкретному значению, которое можно указать в скобках. Ограничивающее значение применяется к первому полю упорядочивания.

Особенности применения параметров:

Конечная запись не должна предшествовать начальной.

Если указана только начальная запись, конечная будет равна значению «Текущая».

Если выражение рассчитывается по группировке, отбор записей выполняется на уровне этой группировки. Текущей в данном случае будет родительская группировка:

ВычислитьВыражение("Сумма(Сумма)", "Поставщик", ,"Предыдущая", "Текущая")

Диапазон группировок

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

ВычислитьВыражение("СУММА(Сумма)", "Поставщик", , "Первая", "Первая")

Диапазон для иерархической группировке

 

Параметр «Начало» можно использовать совместно с выражением, которое не является агрегатной функцией.

В этом случае, выражение будет вычислено для группировки или строки указанной в данном параметре. Ниже пример получения номера документа из предыдущей строки:

ВычислитьВыражение("Номер", , ,"Предыдущая") 

Если выражение (не агрегатная функция) получается не по строке, а по группировке, для расчета будет использоваться первая строка этой группировки:

ВычислитьВыражение("Номер", "Поставщик", ,"Предыдущая")

Номер предыдущего для группировки

 

Сортировка, ИерархическаяСортировка

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

Параметр «ИерархическаяСортировка» позволяет отдельно переопределить сортировку иерархии элементов. Если он не указан, для иерархии действует выражение параметра «Сортировка».

Если параметр «Сортировка» не указан, получение первой и последней записей будет выполняться с учетом текущей сортировки данных в отчете. 

В выражении сортировки можно использовать ключевые слова: «Возр», «Убыв», «Автоупорядочивание».

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

Пример выражения сортировки:

Поставщик Возр Автоупорядочивание

 

ОбработкаОдинаковыхЗначенийПорядка

Дополнительная настройка, которая на практике применяется крайне редко. Параметр имеет два значения: «Отдельно» (по умолчанию) и «Вместе».

Значение параметра «Отдельно» говорит о том, что записи с одинаковыми значениями упорядочивания будут выстроены в последовательность в любом случае. Последовательность будет определена согласно выводу данных в отчете.

Если значение параметра «Вместе», записи с одинаковыми значениями упорядочивания будут объединены. Например, при определении текущей записи, будут возвращены все строки со значением упорядочивания как у текущей. Предыдущая или последующая строки будут возвращены также с учетом объединения строк с одинаковым значением упорядочивания.   

 

Нюансы использования функции «ВычислитьВыражение»

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

ВычислитьВыражение("Сумма(Количество)", «Товар»,)

В выражении ресурса по этому полю не корректно использовать еще одну агрегатную функцию:

Сумма(Поле1)

В этом случае, по группировке «Товар», вы получите не корректные данные.

Правильным решением будет либо указание поля без агрегатной функции:

Поле1

Существует ограничение на использование полей содержащих функцию «ВычислитьВыражение» в групповых отборах.

Запрещается накладывать отбор на подчиненные записи, расчет которых выполняется по группе. Если отбор накладывается поле – ресурс, ошибка не выдается, но отбор работает не корректно. Примеры таких конструкций:

ВычислитьВыражение("Сумма(Количество)", , «ОбщийИтог»)
ВычислитьВыражение("Сумма(Количество)", , , «Первая», «Текущая»)

Для корректной работы, необходимо указать настройку группового отбора «Применение = После группировки или для иерархии», или «Применение = Только иерархия».

При выполнении отбора по детальным записям (на уровне отчета в целом), подобные конструкции также выдают ошибку. Однако, если наложить отбор по группировке «Детальные записи» с применением «После группировки или для иерархии» - он будет работать корректно.

Более подробно про настройку «Применение» групповых отборов смотрите в статье настройки вариантов отчетов.

Еще одно ограничение - функция «ВычислитьВыражение» не учитывает иерархические отборы примененные к группировкам.

 

ВычислитьВыражениеСГруппировкойМассив и ВычислитьВыражениеСГруппировкойТаблицаЗначений

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

Остановимся подробнее на первой функции. Все рассмотренное будет справедливо и для второй.

Полный синтаксис функции следующий:

ВычислитьВыражениеСГруппировкойМассив (Выражение, ВыраженияПолейГруппировки, ОтборЗаписей, ОтборГруппировок) 

Общее описание функции:

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

В отличие от функции «ВычислитьВыражение», расчет происходит не по одной выбранной, или по набору выбранных группировок, а отдельно по каждому набору группировок, согласно указанным разрезам.

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

ВычислитьВыражениеСГруппировкойМассив("МАКСИМУМ(Сумма)","Поставщик")

Вычислить выражение с группировкой массив

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

В параметрах «ОтборЗаписей» и «ОтборГруппировок» можно задать отбор, соответственно для детальных записей и для итоговых.

Можно использовать данную функцию в выражениях итогов совместно с агрегатными функциями. Если нужно использовать разные агрегатные функции на разных уровнях группировок, можно использовать вложение одной функции в другую. Например так:

СУММА(ВычислитьВыражениеСГруппировкойМассив("СРЕДНЕЕ(ВычислитьВыражениеСГруппировкойМассив(""МАКСИМУМ(Сумма)"", ""Поставщик, Склад""))", "Склад"))

Или создать вычисляемое поле:

ВычислитьВыражениеСГруппировкойМассив("МАКСИМУМ(Сумма)", "Поставщик, Склад")

А в выражении итогов написать следующее:

СУММА(ВычислитьВыражениеСГруппировкойМассив("СРЕДНЕЕ(ВычисляемоеПоле)", "Склад"))

Подробнее про использование вложенных функций «ВычислитьВыражениеСГруппировкойМассив» смотрите в этой статье.

С групповыми отборами, ситуация аналогична функции «ВычислитьВыражение». Отбор по группировке на поле с выражением «ВычислитьВыражениеСГруппировкойМассив» будет работать корректно, только если используется настройка отбора «Применение = После группировки или для иерархии».

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

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

В клиент-серверной информационной базе в режиме работы обычного приложения доступны только клиентские общие модули.

 

В следующих статьях будут рассмотрены:

  • Использование агрегатных функции СКД,
  • Программная работа с отчетом на СКД,
  • Разработка произвольных макетов.

Для ознакомления с предыдущими статьями можно перейти по ссылкам:

 

Спасибо за внимание.

Пишите комментарии, ставьте плюсы, подписывайтесь. Буду рад любой обратной связи.

203

См. также

Специальные предложения

Комментарии
Избранное Подписка Сортировка: Древо
1. ellavs 601 08.08.19 11:37 Сейчас в теме
Вот спасибо, только вчера искала решение по нестандартному итогу: нужно было сделать общий итог в виде суммы по группировкам, в которых итог рассчитывался как максимальное значение по группировке. Набегом не получилось. Снова попытаюсь с Вашей статьей :)
7. ids79 3209 08.08.19 16:28 Сейчас в теме
19. echo77 1081 19.08.19 15:51 Сейчас в теме
(1) нужно сделать двойное агрегирование: Сумма(Вычислить выражением группировкой массив())
20. ids79 3209 19.08.19 16:56 Сейчас в теме
(19)А это не двойное агрегирование. ВычислитьВыражениеСГруппировкойМассив - не агрегатная функция. А про вложенные функции написано кратно + ссылка на статью, где более подробно.
21. echo77 1081 19.08.19 17:02 Сейчас в теме
(20) сама по себе нет, но внутри, можно расположить агрегатную функцию
22. ids79 3209 19.08.19 17:49 Сейчас в теме
(21)Ну это да, в этом ее смысл. Если интересно про вложенные функции, посмотрите по ссылки из статьи.
2. wowik 579 08.08.19 11:43 Сейчас в теме
Спасибо! только вчера искал ВычислитьВыражение("Сумма(Количество)", , «ОбщийИтог»)
8. ids79 3209 08.08.19 16:30 Сейчас в теме
3. mvgfirst 4 08.08.19 11:44 Сейчас в теме
Давно ждал - что кто-то сделает описание с картинками )
И вот это свершилось )...
9. ids79 3209 08.08.19 16:31 Сейчас в теме
4. rpgshnik 1313 08.08.19 12:16 Сейчас в теме
Использовал, но так же пока сам не разобрался не понял :)
С картинками пример вообще супер!
ids79; SmArtist; +2 Ответить
10. ids79 3209 08.08.19 16:31 Сейчас в теме
5. user805739 08.08.19 12:40 Сейчас в теме
А есть возможность рассказать и про другие функции СКД и их практическое применение? Вроде таких как Корреляция, СтандартноеОтклонениеВыборки, Любой, КлассификацияABC и т.д.
scanner1980; +1 Ответить
11. ids79 3209 08.08.19 16:32 Сейчас в теме
(5)Планирую написать про агрегатные функции.
6. Aftee 08.08.19 13:28 Сейчас в теме
Само выражение задается в первом параметра функции

Опечатка
12. ids79 3209 08.08.19 16:35 Сейчас в теме
13. MishaD 12 09.08.19 16:26 Сейчас в теме
Ну вот, а я так надеялся узнать, что за штука такая - группировка не ресурса
14. Yashazz 2502 11.08.19 10:30 Сейчас в теме
Мегаспасибище! Вот наконец хоть кто-то занялся всерьёз.

Слушайте, а как плюс поставить??? Минус у меня поставился (когда тыркал) а плюс нифига. Куда щёлкать-то?
15. ids79 3209 11.08.19 11:32 Сейчас в теме
(14)Пожалуйста.
Нажимайте на плюс, и выбирайте раздел, в котором будет сохранена публикация, Загрузки или Избранное.
16. Yashazz 2502 12.08.19 10:50 Сейчас в теме
(15) Ага, спасибо, жмякнул.
Кстати, у меня лет 6 назад была иллюстрация работы "ВычислитьВыражение" на примере: https://infostart.ru/public/192746/
17. ids79 3209 12.08.19 20:32 Сейчас в теме
(16)Посмотрел, интересно.

П.С. А плюсик так и не поставили :))
18. Yashazz 2502 12.08.19 22:30 Сейчас в теме
(17) Поставил!!! Сделал, как Вы сказали!
Оставьте свое сообщение