Агрегатные функции СКД, о которых мало кто знает

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

Разработка - Практика программирования

агрегатные функции системы компоновки данных

276
Пользуетесь ли Вы всеми возможными агрегатными функциями, которые предоставляет система компоновки данных? Если Вы используете только: СУММА, КОЛИЧЕСТВО, МИНИМУМ, МАКСИМУМ, СРЕДНЕЕ, то эта статья для Вас.

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

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

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

Агрегатные функции из выпадающего списка

Если посмотреть справку то можно увидеть гораздо больше агрегатных функций, о существовании некоторых из которых мало кто знает:

Все агрегатные функции

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

Но мы, программисты 1С довольно редко читаем справку. Обычно мы пытаемся понять новый материал интуитивно, максимум обращаемся к синтаксис-помощнику, и очень зря.  Ведь, использование этих функций позволяет сильно облегчить и, главное, ускорить создание большого количество отчетов.

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

 

Массив

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

Массив(Различные Номенклатура)
Массив(Количество)

Если массив формируется по числовому полю, то к его результату можно применять еще одну агрегатную функцию (Сумма, Количество, Максимум, Минимум, Среднее).

 

ТаблицаЗначений

Функция формирует таблицу значений. Количество колонок результирующей функции равно количеству переданных параметров (полей или выражений). Обрабатываются подчиненные записи текущей группировки. После ключевого слова «КАК» можно задать наименования колонок таблицы. Ключевое слово «Различные» перед первым параметром позволяет получить только различные записи. Проверка выполняется по всем колонкам таблицы значений.

ТаблицаЗначений(Различные Контрагент КАК Клиент,  Номенклатура КАК Товар)

Если в качестве параметров указаны поля-остатки и данные выбираются с периодичностью (Остатки и обороты), стоки таблицы формируются в разрезе периодов и уникальной комбинации измерений. То-есть, если значение остатка в разных периодах различное, в итоговой таблице значений будет сформировано несколько строк, со значениями из разных периодов.

Для наглядности приведу пример.

Создадим набор данных со следующим запросом:

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

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

ТаблицаЗначений(ПериодМесяц КАК Период, Склад КАК Склад, КоличествоКонечныйОстаток КАК Остаток)

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

Функция: ТаблицаЗначений

 

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

 

 Свернуть 

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

Свернуть(Массив(Товар))
Свернуть(ТаблицаЗначений(Номенклатура КАК Товар, КоличествоОборот) ,"Товар")
Свернуть(ТаблицаЗначений(КоличествоОборот) ,"1")

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

Функция: Свернуть  

Для массива, функция аналогична применению ключевого слова «Различные» в функции «Массив». Для таблицы значений, функция позволяет проверить уникальность не по всем колонкам, в отличие от применения ключевого слова «Различные» в функции «ТаблицаЗначений».

 

ПолучитьЧасть

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

ПолучитьЧасть(ТаблицаЗначений(Номенклатура, Количество) ,"1")
ПолучитьЧасть(ТаблицаЗначений(Номенклатура КАК Товар, Количество) ,"Товар")

В результате получится таблица значений с одной колонкой «Номенклатура».


Упорядочить

Функция позволяет упорядочить массив или таблицу значений. Если используется таблица значений, вторым параметром нужно указать номера колонок, по которым требуется выполнить упорядочивание. Можно указать направление упорядочивания (Возр / Убыв) и признак «Автоупорядочивание»:

Упорядочить (Массив(Номенклатура))
Упорядочить(ТаблицаЗначений(Номенклатура, Количество),"1 Возр Автоупорядочивание")
Упорядочить(ТаблицаЗначений(Номенклатура КАК Товар, Количество),"Товар Убыв")


СоединитьСтроки

Функция выполняет соединение срок, переданных в качестве массива или таблицы значений. Втором параметром можно указать символ соединения строк, массива или таблицы (по умолчанию используется символ перевода строки). Если в качестве первого параметра используется таблица значений, в третьем параметре можно указать символ соединения колонок таблицы (по умолчанию используется символ «;»). Результатом выполнения функции является строка.

Примеры использования функций:

СоединитьСтроки(Массив(Товар), ";")
СоединитьСтроки(ТаблицаЗначений(Товар, КоличествоОборот), ";", ",")

Функция: СоединитьСтроки

 

ГрупповаяОбработка

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

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

ГрупповаяОбработка(Выражения, ВыраженияИерархии, ИмяГруппировки)

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

ВыраженияИерархии – поля или выражения, которые требуется обработать для иерархических записей (если обработка выполняется для иерархии). Если параметр не указан, используются такие же поля, которые указаны в параметре «Выражения».

ИмяГруппировки – Имя группировки, по строкам которой необходимо выполнить расчет. Если параметр не указан, вычисление выполняется по строкам на уровне текущей группировки. Если указанная группировка не доступна на текущем уровне (группировка более низкого уровня), функция вернет значение NULL.

Результат групповой обработки возвращается в виде объекта с типом «ДанныеГрупповойОбработкиКомпоновкиДанных». Данные групповой обработки можно передать в качестве параметра в экспортную функцию общего модуля

Объект содержит следующие реквизиты:

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

Пример использования функции

Создадим набор данных с простым запросом:

ВЫБРАТЬ              
   ПродажиОбороты.Покупатель КАК Покупатель,              
   ПродажиОбороты.Товар КАК Товар,              
   ПродажиОбороты.КоличествоОборот КАК КоличествоОборот,              
   ПродажиОбороты.СуммаОборот КАК СуммаОборот
ИЗ              
   РегистрНакопления.Продажи.Обороты КАК ПродажиОбороты

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

СКДСервер.ФункцияОбщегоМодуля(ГрупповаяОбработка ("СУММА(КоличествоОборот) КАК Количество"))

В конфигурации, в общем серверном модуле «СКДСервер» разместим экспортную процедуру:

Функция ФункцияОбщегоМодуля(Данные) Экспорт 
                           
   ВременныеДанные = Данные.ВременныеДанныеОбработки;
   Если ВременныеДанные.Свойство("СреднееКоличество") Тогда
      СреднееКоличество = ВременныеДанные.СреднееКоличество;
   Иначе
      ОбщееКоличество = 0;
      Для каждого СтрокаДанных Из Данные.Данные Цикл
         ОбщееКоличество = ОбщееКоличество + СтрокаДанных.Количество;
      КонецЦикла;
      СреднееКоличество = Окр(ОбщееКоличество / Данные.Данные.Количество());
      ВременныеДанные.Вставить("СреднееКоличество", СреднееКоличество);
   КонецЕсли;  
                                                 
   Если Данные.ТекущийЭлемент <> Неопределено Тогда
      ОтклонениеОтСреднего = СреднееКоличество - Данные.ТекущийЭлемент.Количество;
   Иначе
      ОтклонениеОтСреднего = 0;
   КонецЕсли; 
                                                   
   Возврат ОтклонениеОтСреднего;

КонецФункции

Функция рассчитывает отклонение значения в текущей группировке от среднего значения по всем группировкам.

Проверяется наличие параметра «СреднееКоличество» в структуре «ВременныеДанныеОбработки». Если параметр существует, используется он, так как среднее количество в рамках одной и той же группировки будет одинаковым. Если параметра не существует (выводится первая строка группировки), выполняется его расчет по таблицы значений «Данные». Полученное значение добавляется в структуру «ВременныеДанныеОбработки».

На заметку. Имейте в виду про следующую особенность. Функция общего модуля, указанная для ресурса, вызывается дважды для одной и той же строки. Это связано с типовой обработкой расшифровки для поля – ресурса. Если для данного поля создать собственный макет, с указанием одного и того же выражения для основного параметра и для параметра расшифровки, такой особенности не будет. Функция будет вызвана один раз для каждой строки.


Каждый

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

Каждый(КоличествоОборот > 10)

Функция: Каждый


Любой

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

Любой(КоличествоОборот > 10)


МестоВПорядке

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

Строки с одинаковым значением порядка будут иметь одно и то же место.

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

МестоВПорядке(Порядок, ПорядокИерархии, ИмяГруппировки)

Порядок – выражение порядка, по которому происходит сортировка строк. Можно указать направление упорядочивания (Возр / Убыв) и признак «Автоупорядочивание».

ПорядокИерархия – выражение упорядочивания для иерархических записей. Если не указано, действует выражение для основных записей.

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

Примеры использования:

МестоВПорядке("СУММА(КоличествоОборот)")
МестоВПорядке("Номенклатура Возр Автоупорядочивание")
МестоВПорядке("СУММА(КоличествоОборот) ", СУММА("СуммаОборот"))

Для обычных строк группировки действует сортировка по полю «КоличествоОборот», для иерархических – «СуммаОборот»:

МестоВПорядке - для иерархии

МестоВПорядке("Сумма(КоличествоОборот)",, "Покупатель")

Для всех вложенных группировок место в порядке будет рассчитано по группировкам верхнего уровня «Покупатель»:

МестоВПорядке для группировки верхнего уровня

 

КлассификацияABC

Функция вычисляет значение классификации «ABC» по переданному выражению и пороговым значениям.

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

КлассификацияABC(Значение, КоличествоГрупп, ПроцентыДляГрупп, ИмяГруппировки)

Значение – поле или выражение, для которого требуется рассчитать классификацию ABC.

КоличествоГрупп – количество групп классификации. Можно указать количество больше трех, тогда уже будет классификация «ABCD», «ABCDE» и т.д.

ПроцентыДляГрупп – пороги для попадания в группы через запятую в виде строки. Причем для последней группы порог не указывается. Диапазон последней группы считается от последнего порога до 100%. Пример указания порогов для трех групп: «50, 80».

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

Примеры использования:

КлассификацияABC("Сумма(КоличествоОборот)", 4, "40, 70, 90")

Фнкция: КлассификацияАВС

КлассификацияABC("Сумма(КоличествоОборот)", 3, "50, 80", "Покупатель")

Классификация вложенных строк выполняется по строкам группировки верхнего уровня «Покупатель»:

КлассификацияАВС для группировки верхнего уровня

В СКД существует еще целый набор математических агрегатных функций:

  • СтандартноеОтклонениеГенеральнойСовокупности
  • СтандартноеОтклонениеВыборки
  • ДисперсияВыборки
  • ДисперсияГенеральнойСовокупности
  • КовариацияГенеральнойСовокупности
  • КовариацияВыборки
  • Корреляция
  • РегрессияНаклон
  • РегрессияОтрезок
  • РегрессияКоличество
  • РегрессияR2
  • РегрессияСреднееX
  • РегрессияСреднееY
  • РегрессияSXX
  • РегрессияSYY
  • РегрессияSXY

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

 

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

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

 

276

См. также

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

Комментарии
Избранное Подписка Сортировка: Древо
1. VmvLer 05.09.19 16:52 Сейчас в теме
каждый кто хоть раз открывал справку по СКД знает об этих функциях, думаю 80% сидящих тут это делали. Причем, в справке все более-менее понятно и ее осилит ученик старших классов.

а 90% их использовали, +10% - это копи-пастеры без шевеления мысли.

За рисунки спасибо - они врезаются в память, проще говоря "якорят" уже полученное ранее знание. Талант создания "якорей" якорей у вас есть.
triviumfan; alex_bitti; +2 24 Ответить
2. for_sale 773 05.09.19 16:58 Сейчас в теме
(1)
В справке вообще ничего порядочного не описано. Те же вычислить выражения там описаны в паре предложений, при этом там чуть ли не десяток параметров. Что это за параметры, как их использовать, какие там хотя бы типы значений - ничего! В стиле 1С
Прикрепленные файлы:
yku; A_Max; mifka186; Summer_13; Fox-trot; Anchoret; Jestery; Quasar; FreeArcher; Batman; fancy; dsdred; rpgshnik; ids79; +14 Ответить
11. Светлый ум 226 06.09.19 06:39 Сейчас в теме
(2) Справка по СКД отвратительная +1 . Годная статья
ids79; Yashazz; Quasar; +3 Ответить
5. alex_bitti 123 05.09.19 17:03 Сейчас в теме
(1) поддерживаю, не претендую на оригинальность своих публикаций, но это за гранью, видно курсы 1С стали чаще выпускать контентмейкеров ис)))
6. ids79 3803 05.09.19 21:06 Сейчас в теме
(1)
90% их использовали

Что же, если это действительно так, так это же здорово!
Но, согласитесь, многие формулировки в справке 1С только больше запутывают, чем разъясняют. А альтернативное описание очень даже полезно.
На счет якорей, спасибо. Приятно, что даже для такого продвинутого специалиста как Вы, есть что-то интересное.
YPermitin; yku; Jestery; zqzq; FreeArcher; for_sale; +6 Ответить
13. Jestery 06.09.19 13:43 Сейчас в теме
(6) спасибо за труд. А так то в каждой подобной статье обязательно найдутся крикуны, отправляющие в справку, на итс, в гугл, еще куда нибудь. И ты думаешь такой - ну ок, пойду посмотрю что же там такое. Идешь туда, куда крикуны направляют и обнаруживаешь там...ничего. Вот вообще ничего от слова совсем. Пара фраз на функцию с десятком параметров. Ощущение что кто-то на скорую руку быстренько накидал это всё за пару минут. Просто "чтобы было". Справка же нужна все таки. Вот она и есть. И дальше только эксперименты и изучение того функционала, который не лишним было бы просто описать нормально.
YPermitin; ids79; +2 Ответить
23. triviumfan 10 09.09.19 17:36 Сейчас в теме
(1) нынче пошёл такой "мейнстрим" статей на ИС. Повторение - мать учение (с).
YPermitin; +1 Ответить
3. wowik 603 05.09.19 17:00 Сейчас в теме
+1. Но откуда информация??
7. ids79 3803 05.09.19 21:07 Сейчас в теме
(3)Из справки 1С + практика использования.
rpgshnik; +1 Ответить
4. Cmapnep 10 05.09.19 17:02 Сейчас в теме
Спасибо, особенно за наглядные примеры!
yku; fancy; ids79; +3 Ответить
8. Pim 167 05.09.19 21:40 Сейчас в теме
Не скажу, что сильно необходимые функции. По крайней мере, сходу не понимаю, где их можно использовать. Но всё равно за наводку и разъяснения большое спасибо.
25. ids79 3803 09.09.19 19:37 Сейчас в теме
(8)ТаблицаЗначений, СоединитьСтроки - можно использовать для вывода строк из разных колонок и разных строк в одном поле.
ГрпповаяОбработка - для любых расчетов с использованием таблицы всех строк группировки и текущей строки. Причем можно сохранять промежуточный расчет.
МестоВПорядке - для какой-нибудь сложной сортировки.
Каждый, Любой - для вывода обобщающей информации по строкам.
КлассификацияABC - для любой классификации данных по порогам.

А вообще да, согласен. Не каждый день применять приходиться).
9. protexprotex 172 05.09.19 23:28 Сейчас в теме
"Нет такого программиста 1С, который некогда не работал бы с СКД" - нуу семерошники не работали.... Или они не программисты 1С? :-)
10. German_Tagil 6 06.09.19 05:58 Сейчас в теме
Мда.... Спасибо.
Отправил в избранное
12. ivanov660 1587 06.09.19 10:05 Сейчас в теме
С каких версий платформы стали поддерживаться? Кто-нибудь смотрел?
27. ids79 3803 09.09.19 19:51 Сейчас в теме
(12)Как-то не задавался этим вопросом).
Массив, ТаблицаЗначений, Свернуть, ПолучитьЧасть, Упорядочить, СоединитьСтроки, ГрупповаяОбработка - еще в 8.2 были.
Остальные в 8.3 появились, в каких версиях - не скажу.
14. aleksey.kubovtsov 73 06.09.19 15:03 Сейчас в теме
сколько скд крутил, ни разу их не использовал )
Автору спасибо
15. protexprotex 172 07.09.19 09:52 Сейчас в теме
Хорошие функции. Но они как sin, cos, Exp и т.д. в 1С - вроде бы есть, но кто их использует?
16. ids79 3803 07.09.19 10:38 Сейчас в теме
(15)Ну, кто-то использует, кто-то нет. Это уже зависит от задач и от желания использовать или не использовать.
17. protexprotex 172 07.09.19 11:00 Сейчас в теме
(16) Ответ достойный дипломата :-) - вроде бы и ответил, а ответа не получил и не прицепишься к словам :-)
18. Mopo3 288 07.09.19 17:07 Сейчас в теме
Вот по математическим функциям таки было бы самое интересное) На практике пока пригождалось СО и Дисперсия, но остальные тоже были бы интересны, для общего развития ;)
19. ids79 3803 07.09.19 17:13 Сейчас в теме
(18)Я, честно говоря, вышеуказанные математические функции на практически не применял. Если у Вас есть опыт, напишите, очень интересно.
20. binipox 07.09.19 20:55 Сейчас в теме
Лучшая статья по данному вопросу! Спасибо Вам!
21. Yashazz 2522 09.09.19 09:53 Сейчас в теме
Ну да, статья полезная хотя бы как анти-склерозник, именно по причине скудной встроенной справки. Но не лучшая, видел я более подробные разборы, правда, не на ИС. Многим из описанного давно пользуюсь, и что скажу - например, классификация АВС по скорости иногда сильно проигрывает обычному запросу и даже, о ужас, обычному коду с таблицами значений) Статистические функции не гонял, но тоже есть сомнения в их быстродействии.
24. ids79 3803 09.09.19 19:24 Сейчас в теме
(21)На лучшую и не претендую)).
22. mambo 09.09.19 12:27 Сейчас в теме
просто оставлю тут коммент=)) Нужна обработка выгрузка загрузка данных xml с отбором для 8.3 готов заплатить адекватный ценник=))
26. ids79 3803 09.09.19 19:38 Сейчас в теме
(22)Это Вы не совсем по теме. Лучше разместите на форуме или в тендерах.
28. Evil Beaver 6247 10.09.19 10:26 Сейчас в теме
Отличная статья. А вот когда в обычном языке для коллекций появятся методы "Каждый" и "Любой" - тогда 1С вообще шагнет вперед по адекватности языка. (В 1Скрипте, например, есть библиотека стриминговой обработки, ее можно перетянуть в 1С, но на уровне платформы точно будет удобнее)

И еще, в СКД есть функция "КовариацияГенеральнойСовокупности", вот ее бы кто описал так же подробно :)
YPermitin; ids79; +2 Ответить
29. ids79 3803 10.09.19 10:48 Сейчас в теме
(28)Спасибо, Андрей.
Судя по всему 1Скрипт во многом превосходит конфигуратор 1С ))
Да, есть "КовариацияГенеральнойСовокупности" и еще много других, я их привел в конце статьи.
Но, по всей видимости, их практически никто не использует пока.
Да, было бы здорово, если бы кто-то описал с примерами.
Я пока не готов )). Может быть позже...
YPermitin; +1 Ответить
30. Evil Beaver 6247 10.09.19 22:36 Сейчас в теме
(29) Ну нет, вовсе не превосходит. Просто есть несколько вещей, которые в сообществе реализованы чуть лучше.
YPermitin; +1 Ответить
31. DedMoroz1983 13.09.19 09:03 Сейчас в теме
Познавательно. В справке не всегда найдёшь необходимую информацию.
Оставьте свое сообщение