Агрегатные функцииСумма
Количество
Количество различных
Максимум
Минимум
Среднее
Массив
ТаблицаЗначений
Свернуть
ПолучитьЧасть
Упорядочить
СоединитьСтроки
ГрупповаяОбработка
Агрегатные функции осуществляют некоторое действие над набором данных.
Сумма (Total)Агрегатная функция Сумма рассчитывает сумму значений выражений, переданных ей в качестве аргумента для всех детальных записей. В качестве параметра можно передавать Массив. В этом случае функция будет применена к содержимому массива.
Пример:
Сумма(Продажи.СуммаОборот)
Количество (Count)Функция Количество рассчитывает количество значений отличных от значения
NULL. В качестве параметра можно передавать Массив. В этом случае функция будет применена к содержимому массива.
Пример:
Количество(Продажи.Контрагент)
Количество различныхЭта функция рассчитывает количество различных значений. В указания получения различных значений следует перед параметром метода
Количество указать
Различные (
Distinct). В качестве параметра можно передавать Массив. В этом случае функция будет применена к содержимому массива.
Пример:
Количество(Различные Продажи.Контрагент)
Максимум (Maximum)Функция получает максимальное значение. В качестве параметра можно передавать Массив. В этом случае функция будет применена к содержимому массива.
Пример:
Максимум(Остатки.Количество)
Минимум (Minimum)Функция получает минимальное значение. В качестве параметра можно передавать Массив. В этом случае функция будет применена к содержимому массива.
Пример:
Минимум(Остатки.Количество)
Среднее (Average)Функция получает среднее значение для значений, отличных от
NULL. В качестве параметра можно передавать Массив. В этом случае функция будет применена к содержимому массива.
Пример:
Среднее(Остатки.Количество)
Массив (Array)Функция формирует массив, содержащий для каждой детальной записи значение параметра.
Синтаксис:
Массив([Различные] Выражение)
В качестве параметра можно использовать таблицу значений. При этом результатом работы функции будет массив, содержащий значения первой колонки таблицы значений, переданной в качестве параметра.
Если выражение содержит функцию
Массив, то считается, что данное выражение является агрегатным.
Если указано ключевое слово
Различные, то получаемый массив не будет содержать дублирующихся значений.
Пример:
Массив(Контрагент)
ТаблицаЗначений (ValueTable)Функция формирует таблицу значений, содержащую столько колонок, сколько параметров у функции. Детальные записи получаются из наборов данных, которые нужны для получения всех полей, участвующих в выражениях параметров функции.
Синтаксис:
ТаблицаЗначений([Различные] Выражение1 [КАК ИмяКолонки1][, Выражение2 [КАК ИмяКолонки2],...])
Если параметрами функции выступают поля–остатки, то в результирующую таблицу значений попадут значения для записей по уникальным комбинациям измерений из других периодов. При этом значения получаются только для полей-остатков, измерений, счетов, полей периодов и их реквизитов. Значениями остальных полей в записях из других периодов считаются равными
NULL.
Если выражение содержит функцию
ТаблицаЗначений, то считается, что данное выражение является агрегатным.
Если указано ключевое слово
Различные, то в получаемой таблице значений не будет строк, содержащих одинаковые данные.
После каждого параметра может располагаться необязательное ключевое слово КАК и имя, которое будет назначено колонке таблицы значений.
Пример:
ТаблицаЗначений(Различные Номенклатура, ХарактеристикаНоменклатуры КАК Характеристика)
Свернуть (GroupBy)Функция предназначена для удаления дубликатов из массива.
Синтаксис:
Свернуть(Выражение, НомераКолонок)
Параметры:
- Выражение - выражение типа Массив или ТаблицаЗначений, значения элементов которого нужно свернуть;
- НомераКолонок - (если выражение имеет тип ТаблицаЗначений) тип Строка. Номера или имена (через запятую) колонок таблицы значений, среди которых нужно искать дубликаты. По умолчанию – все колонки.
Пример:
Свернуть(ТаблицаЗначений(НомерТелефона, Адрес) ,"НомерТелефона");
ПолучитьЧасть (GetPart)Функция получает таблицу значений, содержащую определенные колонки из исходной таблицы значений.
Синтаксис:
ПолучитьЧасть(Выражение, НомераКолонок)
Параметры:
- Выражение - тип ТаблицаЗначений. Таблица значений, из которой нужно получить колонки;
- НомераКолонок - тип Строка. Номера или имена (через запятую) колонок таблицы значений, которые нужно получить.
Возвращаемое значение:
ТаблицаЗначений, в которой имеются только колонки, которые указаные в параметре.
Пример:
ПолучитьЧасть(Свернуть(ТаблицаЗначений(НомерТелефона, Адрес) ,"НомерТелефона"),"НомерТелефона");
Упорядочить (Order)Предназначена для упорядочивания элементов массива и таблицы значений.
Синтаксис:
Упорядочить(Выражение, НомераКолонок)
Параметры:
- Выражение - Массив или ТаблицаЗначений, из которой нужно получить колонки;
- НомераКолонок - (если выражение имеет тип ТаблицаЗначений) номера или имена (через запятую) колонок таблицы значений, по которым нужно упорядочить. Может содержать направление упорядочивания и необходимость автоупорядочивания: Убыв/Возр + Автоупорядочивание.
Возвращаемое значение:
Массив или
ТаблицаЗначений, с упорядоченными элементами.
Пример:
Упорядочить(ТаблицаЗначений(НомерТелефона, Адрес, ДатаЗвонка),"ДатаЗвонка Убыв");
СоединитьСтроки (JoinStrings)Предназначена для объединения строк в одну строку.
Синтаксис:
СоединитьСтроки (Значение, РазделительЭлементов, РазделителиКолонок)
Параметры:
- Значение - выражения, которые нужно объединить в одну строку. Если является Массивом, то в строку будут объединяться элементы массива. Если является ТаблицаЗначений, то в строку будут объединяться все колонки и строки таблицы;
- РазделительЭлементов - строка, содержащая текст, который нужно использовать в качестве разделителя между элементами массива и строками таблицы значений. По умолчанию – символ перевода строк;
- РазделителиКолонок -строка, содержащая текст, который нужно использовать в качестве разделителя между колонками таблицы значений. По умолчанию "; ".
Пример:
СоединитьСтроки(ТаблицаЗначений(НомерТелефона, Адрес));
ГрупповаяОбработка (GroupProcessing)Возвращает объект
ДанныеГрупповойОбработкиКомпоновкиДанных. В объект в свойство
Данные помещается в виде таблицы значений значения группировок для каждого выражения, указанного в параметре функции
Выражения. В случае использования иерархической группировки каждый уровень иерархии обрабатывается отдельно. Значения для иерархических записей также помещаются в данные.
В свойство
ТекущийЭлемент объекта помещается строка таблицы значений, для которой в настоящий момент вычисляется функция.
Синтаксис:
ГрупповаяОбработка(Выражения, ВыраженияИерархии, ИмяГруппировки)
Параметры:
- Выражения. Выражения, которые нужно вычислить. Строка, в которой через запятую перечислены выражения, которые нужно вычислить. После каждого выражение возможно наличие необязательного ключевого слова КАК и имени колонки результирующей таблицы значений. Каждое выражение образует колонку таблицы значений свойства Данные объекта ДанныеГрупповойОбработкиКомпоновкиДанных.
- ВыраженияИерархии. Выражения, которые нужно вычислить для иерархических записей. Аналогично параметру Выражения с тем отличием, что параметр ВыраженияИерархии используется для иерархических записей. Если параметр не указан, то для вычисления значений для иерархических записей используется выражения, указанные в параметре Выражение.
- ИмяГруппировки. Имя группировки, в которой нужно вычислять группировку обработки. Строка. Если не указано, то вычисление происходит в текущей группировке. Если вычисление идет в таблице и параметр содержит пустую строку, или не указан, то значение вычисляется для группировки – строки. Компоновщик макета при генерации макета компоновки данных заменяет данное имя на имя группировки в результирующем макете. Если группировка не доступна, то функция будет заменена на значение NULL.
Другие операцииОперация ВЫБОРОперация
Выбор предназначена для осуществления выбора одного из нескольких значений при выполнении некоторых условий. Например:
Выбор Когда Сумма > 1000 Тогда Сумма Иначе 0 Конец
Правила сравнения двух значенийЕсли типы сравниваемых значений отличаются друг от друга, то отношения между значениями определяются на основании приоритета типов: NULL (самый низший); Булево; Число; Дата; Строка; Ссылочные типы Отношения между различными ссылочными типами определяются на основе ссылочных номеров таблиц, соответствующих тому или иному типу. Если типы данных совпадают, то производится сравнение значений по следующим правилам: у типа
Булево значение
ИСТИНА больше значения
ЛОЖЬ; у типа
Число обычные правила сравнения для чисел; у типа
Дата более ранние даты меньше более поздних; у типа
Строка - сравнения строк в соответствии с установленными национальными особенностями базы данных; ссылочные типы сравниваются на основе своих значений (номера записи и т. п.).
Работа со значением NULLЛюбая операция, в которой значение одного из операндов
NULL, будет давать результат
NULL.
Есть исключения: операция
И будут возвращать
NULL только в случае, если ни один из операндов не имеет значение
Ложь; операция
ИЛИ будет возвращать
NULL только в случае, если ни один из операндов не имеет значение
Истина.
Приоритеты операцийОперации имеют следующие приоритеты (первая строка имеет низший приоритет):
ИЛИ;
И;
НЕ;
В,
ЕСТЬ NULL,
ЕСТЬ НЕ NULL;
=,
<>,
<=,
<,
>=,
>;
Бинарный +,
Бинарный – ;
*,
/,
%;
Унарный +,
Унарный -.