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

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

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

Соответственно, теперь необходимо рассчитать итоги, по выше находящимся группировкам («Склады», «ТипыСкладов») и общий итог.
Для этого используется функция ВычислитьВыражениеСГруппировкойМассив:
ВЫЧИСЛИТЬВЫРАЖЕНИЕСГРУППИРОВКОЙМАССИВ (EVALEXPRESSIONWITHGROUPARRAY)
Синтаксис:
ВычислитьВыражениеСГруппировкойМассив(,)
Описание:
Функция возвращает массив, каждый элемент которого содержит результат вычисления выражения для группировки по указанному полю.
Компоновщик макета при генерации макета преобразовывает параметры функции в термины полей макета компоновки данных. Например, поле Контрагент будет преобразовано в НаборДанных.Контрагент.
Компоновщик макета при генерации выражений для вывода пользовательского поля, в выражении которого присутствует только функцияВычислитьМассивСГруппировкойМассив(), генерирует выводимое выражение таким образом, чтобы выводимая информация была упорядочена. Например, для пользовательского поля с выражением:

ВычислитьВыражениеСГруппировкойМассив("Сумма(СуммаОборот)", "Контрагент")
Компоновщик макета сгенерирует для вывода следующее выражение:

СоединитьСтроки(Массив(Упорядочить(ВычислитьВыражениеСГруппировкойТаблицаЗначений("Представление(Сумма(НаборДанных.СуммаОборот)),Сумма(НаборДанных.СуммаОборот)","НаборДанных.Контрагент"),"2")))

Параметры:

Тип: Строка. Выражение, которое нужно вычислить. Строка, например, Сумма(СуммаОборот).

Тип: Строка. Выражения полей группировки – выражения полей группировки, перечисленные через запятую. Например, Контрагент, Партия.

Тип: Строка. Выражение, описывающее отбор, применяемый к детальным записям. В выражении не поддерживается использование агрегатных функций. Например,ПометкаУдаления = Ложь.

Тип: Строка. Выражение, описывающее отбор, применяемый к групповым записям. Например, Сумма(СуммаОборот) > &Параметр1.
Пример:

Максимум(ВычислитьВыражениеСГруппировкойМассив ("Сумма(СуммаОборот)", "Контрагент"));

Подробное описание синтаксиса функции можно найти по адресу http://its.1c.ru/db/v837doc#bookmark:dev:TI000000582
Теперь для расчета, продублируем поле «Заказать», с различными значениями «Рассчитывать по…», используя следующие выражения, обратите внимание, что в каждом выше стоящем уровне используются значения уровней ниже стоящих группировок.

В итоге получаем следующую конструкцию:

Платформа: 8.3; Тип формы: управляемая.

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

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

Группировка полей по папкам на закладке «Наборы данных»

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

Применительно к нашему примеру, давайте создадим папку Характеристики , в которой разместим поля Страна и Наименование . Делается это с помощью соответствующей кнопки, либо из контекстного меню:

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

Теперь перейдем к выбранным полям в настройках и посмотим как там отразились сделанные изменения:

Как видим, два поля пометились как удаленные. Поэтому их надо удалить из списка, и добавить вновь, но уже из папки Характеристики :


Если эти поля использовались на других закладках (Отбор, Сортировка и т.д.), то там надо также сделать соответствующие изменения.

Группировка полей для изменения внешнего вида отчета

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


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


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

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

Функции языка выражений СКД.

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

НачалоПериода(ДатаВремя(2002, 10, 12, 10, 15, 34), "Месяц")

Эта функция отличается от функции языка запросов вторым параметром. Здесь используется строка «Месяц», тогда как в функции языка запросов литерал МЕСЯЦ.

Описание функций можно найти, открыв Конфигуратор: Справка -> Содержание -> Система компоновки данных -> Язык выражений системы компоновки данных -> Функции языка выражений системы компоновки данных .

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

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

Особенности работы СКД.

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

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

Могут ли эти особенности нести какие-то негативные последствия? Да, так как в некоторых случаях будет формироваться не тот запрос, который мы хотели. Поэтому нужно учитывать эти особенности при построении сложных запросов.

Основные настройки полей СКД.

На закладке «Наборы данных» при создании набора данных типа запрос происходит автозаполнение полей компоновки. Как видим, поля содержат большое количество настроек.

Колонка «Поле» содержит название поля, которое получается из информационной базы (ИБ).
Неизменяемое значение, которое жёстко связано с запросом. Оно соответствует псевдониму запроса.

Но есть одна особенность. Если мы поменяем псевдоним, например «Номенклатура», в Конструкторе запроса на вкладке «Объединения/Псевдонимы» в колонке «Имя поля», на «Товар», тогда на закладке «Наборы данных» компоновки появиться новое поле «Товар», но при этом осталось и поле «Номенклатура». Это связано с тем, что установлен флаг «Автозаполнение». При такой настройке система не может понять, что поле «Товар» то же самое, что и поле «Номенклатура», поэтому, на всякий случай, поле добавляется дважды.

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

Хотя можно исключить появление поля «Номенклатура», поставив галочки в колонках «Ограничение поля»-«Условие» и «Ограничение реквизитов»-«Условие» на закладке «Наборы данных» в настройках полей. Кроме того, можно убрать галочку с флага «Автозаполнение» и в Конструкторе запроса на вкладке «Компоновка данных» заполнить все поля.

Колонка «Путь» указывает, как мы будем обращаться к полю на всех закладках компоновки данных. Значение, которое можно изменить по своему усмотрению. Допускаются пробелы в названии пути, но при этом такое название заключается в квадратные скобки. Но лучше, чтобы путь был без пробелов, так как это служебное поле. Лучше изменить заголовок, поставив галочку в колонке «Заголовок».

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

Можно применять следующий способ для работы с колонкой «Путь». С помощью указания пути можно создавать вложенные виртуальные реквизиты элемента. Например, поместим реквизит «Качество» внутрь реквизита «Товар». Изменим поле «Путь» реквизита «Качество» на «Товар.Качество». Теперь на закладке «Настройки» во вкладке «Выбранные поля» мы не найдём поле «Качество», но оно появится в внутри поля «Товар».

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

Колонки ограничения полей СКД

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

Каждая строка разбита ещё на четыре колонки. Если для поля или реквизитов этого поля установлен флаг:

• Поле , то они не будут доступны для выбора на закладке «Настройки» во вкладке «Выбранные поля».
• Условие , то они не будут доступны как условие на закладке «Настройки» во вкладке «Отбор».
• Группа , то на закладке «Настройки» при создании новой группировки не будет доступна группировка по ним.
• Упорядочивание , то они не будут доступны для упорядочивания на закладке «Настройки» во вкладке «Сортировка».

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

Товар. Артикул + "-" + Товар. Наименование

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

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

ДляСКД. ПолучитьПредставление(Товар)

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

Колонка «Выражение упорядочивания» нужна для определения нестандартной сортировки. Здесь можно использовать такие же конструкции, что и в поле «Выражение представления».

Ну вот, рассказал всё, как и обещал. Если есть вопросы, то пишите их в комментариях. Чтобы материал закрепился у вас в уме, подготовлю тест.

Грамотное использование схемы компоновки данных (СКД) позволяет:

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

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

Что такое вычисляемое поле

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

Дело в том, что СКД – это нечто большее, нежели просто отображение результата выполнения запроса и это прекрасно видно из формы создания схемы (Рис.1).

Вычисляемые поля позволяют выполнять определенные действия со сформированным набором данных:

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

Давайте по этому списку и пойдем.

Массив значений в одной ячейке

Смоделируем ситуацию, когда необходимо получить в отдельную ячейку все номера документов поступления по контрагенту:

таким образом, мы в нашей схеме создали дополнительное расчетное поле;

Как видно из приведенного примера, никаких сложностей в добавлении и обработке вычисляемых полей нет. Мы использовали две функции: Массив() и СоединитьСтроки().

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

1. РазделительЭлементов – указывает, какой символ будет отделять один элемент массива или одну строку таблицы значений от другого (в нашем случае мы опустили этот параметр и по умолчанию был назначен перенос строки);
2. РазделительКолонок – символ, используемый для разделения колонок таблицы значений (по умолчанию используется точка с запятой).

Обращение к экспортным функциям общего модуля

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

Несколько важных моментов:

• Функция обязательно должна быть экспортной;
• Если функция расположена в общем модуле с установленным признаком «Глобальный», её вызов осуществляется непосредственно по имени, в противном случае вызов функции должен происходить по схеме «Имя общего модуля». «Имя вызываемой функции».

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

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

Выражения языка компоновки

Достаточно часто в работе разработчика возникает ситуация, когда в поле СКД необходимо вывести результат деления:

1. Рассчитать среднюю стоимость номенклатуры;
2. Всевозможные проценты;
3. Расчеты среднего заработка и т.д.

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

Сделать это можно с помощью конструкции «Выбор Когда ….Тогда… Иначе… Конец».

В конце несколько слов о достаточно новой функции ВычислитьВыражение(). С её помощью, в частности можно вычислять отклонения в стоимости между текущей и предыдущей строкой, накопительный остаток и т.д.

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