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

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

• Основные понятия и элементы схемы компоновки,
• Настройки вариантов отчетов,
• Работа с пользовательскими настройками,
• Расширения языка запросов,
• Наборы данных и связи между ними, иерархии.

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

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

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

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

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

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

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

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

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

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

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

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

 

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

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

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

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

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

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

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

 

Группировка

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

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

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

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

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

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

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

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

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

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

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

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

 

Тип расчета

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

 

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

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

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

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

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

И

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

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

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

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

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

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

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

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

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

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

 

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

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

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

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

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

 

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

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

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

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

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

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

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

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

 

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

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

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

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

 

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

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

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

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

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

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

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

Поле1

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

Запрещается накладывать отбор на детальные записи, в которых используется функция «ВычислитьВыражение». Появляется ошибка вида «Выражение не может быть вычислено…». Если отбор накладывается на уровне группировки, и выполняется по полю «Ресурс» запрет распространяется только на конструкцию:  

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

Для остальных выражений, например:

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

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

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

Скорее всего отбор будет не тем, который ожидается.

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

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

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

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

 

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

 

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

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

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

• Основные понятия и элементы схемы компоновки,
• Настройки компоновки данных,
• Пользовательские настройки,
• Расширения языка запросов для СКД,
• Наборы данных и связи между ними, собственная иерархия.

 

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

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