Функция

Описание

Пример

{Avg()}

Предоставляет возможность высчитать среднее арифмитическое значение.
В аргументах указывается объект или два объекта.
Возвращает значения различного типа (double, decimal, long, DateTime, TimeSpan), в зависимости от выбранной функции

{Avg(DataSource.Column1)} - будет вычислено среднее арифметическое по колонке Column1.
{AvgDate(DataSource.ColumnDate)} - будет вычислено среднее значение даты по колонке ColumnDate.
{AvgTime(DataSource.ColumnTime)} - будет вычислено среднее значение времени по колонке ColumnTime.
Во всех функциях может быть указано два аргумента. Например, в отчете используется несколько секций Данные. Необходимо рассчитать среднее арифметическое по колонке для первой секции Данные. В этом случае, первым аргументом указывается секция, вторым объект для вычисления - {Avg(DataBand1,DataSource.Column2)}. В результате будет рассчитано среднее арифметическое по Column2, но только для значений DataBand1

{Count()}

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

{Count()} - результатом будет количество записей в источнике данных.
{Count(DataBand1, DataSource.Column1)} - результатом будет количество записей в колонке Column1 для DataBand1.
{CountDistinct(DataSource.Column1)} - результатом будет количество уникальных записей в DataSource.Column1.
{CountDistinct(DataBand2, DataSource.Column2)} - результатом будет количество уникальных записей в колонке Column2 для DataBand2

{First()}

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

{First(DataSource1.Column1)} - результатом будет первое значение Column1 из источника DataSource1.
{First(DataBand2, DataSource.Column2)} - результатом будет первое значение Column2 секции DataBand2

{Last()}

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

{Last(DataSource1.Column1)} - результатом будет последнее значение Column1 из источника DataSource1.
{Last(DataBand2, DataSource.Column2)} - результатом будет последнее значение Column2 секции DataBand2

{Max()}

Предоставляет возможность отобразить максимальное значение из указанного объекта.
В аргументах указывается объект или два объекта.
Возвращает значения различного типа double, decimal, long, DateTime, TimeSpan, string, в зависимости от выбранной функции

{Max(DataSource1.Column1)} - результатом будет максимальное значение из Column1 источника DataSource1.
{MaxDate(DataSource1.ColumnDate)} - результатом будет максимальная дата из ColumnDate источника DataSource1.
{MaxTime(DataSource1.ColumnTime)} - результатом будет максимальное время из ColumnTime источника DataSource1.
{MaxStr(DataSource1.Column1)} - все значения будут отсортированы в алфавитном порядке. Результатом будет последнее значение.
{Max(DataBand2, DataSource.Column2)} - в этом случае, результатом будет максимальной значение Column2 секции DataBand2

{Median()}

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

Допустим, Column1 содержит 5 значений: 2,5,6,1,7. Функция {Median(DataSource1.Column1)} отобразит среднее значения из этого списка, т.е. результатом будет значение 6.
{Median(DataBand2, DataSource.Column2)}  - результатом будет среднее значение Column2 секции DataBand2

{Min()}

Предоставляет возможность отобразить максимальное значение из указанного объекта.
В аргументах указывается объект или два объекта.
Возвращает значения различного типа double, decimal, long, DateTime, TimeSpan, string, в зависимости от выбранной функции

{Min(DataSource1.Column1)} - результатом будет минимальное значение из Column1 источника DataSource1.
{MinDate(DataSource1.ColumnDate)} - результатом будет минимальная дата из ColumnDate источника DataSource1.
{MinTime(DataSource1.ColumnTime)} - результатом будет минимальное время из ColumnTime источника DataSource1.
{MinStr(DataSource1.Column1)} - все значения будут отсортированы в алфавитном порядке. Результатом будет первое значение.
{Min(DataBand2, DataSource.Column2)} - результатом будет минимальное значение Column2 секции DataBand2

{Mode()}

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

{Mode(DataSource1.Column1)}. Допустим Сolumn1 содержит список значений: 2, 2, 6, 7, 7, 8, 7, 6, 5, 9, 4. Результатом будет число 7, т.к. оно повторяется в списке значений наиболее часто.
{Mode(DataBand2, DataSource.Column2)} - результатом будет значение из Column2 секции DataBand2, которое наиболее часто встречается

{Rank(,)}

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

•Объекты для обработки и присвоения ранга (тип object);

•Значение (true or false) для присвоения плотного или не плотного ранка;

•Направление сортировки значений.

Возвращает значения различного типа long

{Totals.Rank(DataBand1,DataSource.Column1)}. Допустим, колонка Column1 содержит список значений: 44, 9, 36, 55, 71. В этом случае, значения будут отсортированы по возрастанию, т.е. 9, 36, 44, 55, 71 и каждому из них будет присвоен ранг. Число 9 получит ранг 1, 36 - ранг 2, 44 - ранг 3, 55 - ранг 4, 71 - ранг 5. По умолчанию рассчитывает плотный ранг, и сортировка значений для присвоения ранга выполняется по возрастанию.
{Totals.Rank(DataBand1,DataSource.Column1, true, StiRankOrder.Desс)} - будет плотный ранг поскольку установлено значение true. При присвоении ранга значения будут отсортированы по убыванию, т.к. StiRankOrder установлено в Desc. Для сортировки по возрастанию (используется по умолчанию) следует установить в значение Asc (StiRankOrder.Asc).
Пример неплотного ранга - {Totals.Rank(DataBand1,DataSource.Column1, false, StiRankOrder.Asc)}. Допустим Column1 содержит список значений: 44, 9, 44, 9, 31, 64,68, 71. Значения присвоены по возрастанию, т.е. 9, 9, 31, 44, 44, 44, 68, 71. В этом случае, ранги будут следующими: 9 - ранг 1, 9 - ранг 1, 31 - ранг 3, 44 - ранг 4, 44 - ранг 4, 44 - ранг 4, 68 - ранг 7, 71 - ранг 8. Иначе говоря, при присвоении ранга числу учитывается ранг предыдущего значения и количество значений с этим рангом

{Sum()}

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

•Объекты для обработки и присвоения ранга (тип object);

•Условие;

•Выражение суммирования.

Возвращает значения различного типа long, decimal, double, TimeSpan

{Sum(DataSource1.Column1)} - результатом будет сумма всех значений Column1 в источнике DataSource1.
{SumDistinct(DataSource1.Column1)} - результатом будет сумма всех уникальных значений Column1 в источнике DataSource1.
SumTime(DataSource1.Column1) - результатом будет сумма времени из колонки Column1 в источнике DataSource1.
{Sum(DataBand2,DataSource2.Column2)} - результатом будет сумма значений из Column2 бэнда DataBand2.
{SumDistinct(DataBand1,DataSource.Column1, DataSource.Column2)} - результатом будет сумма значений Column2, которые соответствуют уникальным значениям из Column1 секции DataBand2

Допустим, есть Master-Detail отчет, который представляет собой список продуктов по категориям:

В этом отчете итог может быть рассчитан по каждой категории, по всему отчету. Также можно рассчитать долю каждой категории из общей суммы. Для начала рассчитаем сумму продуктов категории. Для этого в шаблон отчета следует добавить секцию Итог данных, разместить на нем текстовый компонент с выражением расчета итога {Sum(DataBand2,Products.UnitPrice)}. Для суммирования значений применяется функция Sum, в ее аргументах указывается объект, по которому будут считаться итоги и колонка данных, значения которой будут суммироваться. Поскольку необходимо рассчитать сумму продуктов по каждой категории, то объектом для расчета итогов будет детальная секция Данные, т.е. DataBand2. Значения в колонке UnitPrice обозначают стоимость каждого продукта, поэтому сумма этих значений и будет итог для категории:

В этом случае итог является связанным с секцией Данные. Для расчета итога по отчету в этом случае следует использовать функции, не связанные с секциями. Для этого к функции необходимо добавить префикс Totals через разделитель ".". В качестве объекта следует указать источник данных. Выражение расчета итога по отчету в этом случае будет {Totals.Sum(Products,Products.UnitPrice)}. Результат отобразим на master секции:

Каждый раз когда в отчете будет печататься master секция, будет выводиться итог по отчету. Используя результаты расчетов, можно вычислить долю каждой категории из общего итога. Результат отобразим в процентах. Для расчета доли, следует итог по категории разделить на итог по отчету - {(Sum(DataBand2,Products.UnitsInStock) / Totals.Sum(Products, Products.UnitsInStock))}. Для текстового компонента, в котором будет выводиться доля, следует установить процентный формат. Результат отобразим на master секции:

Таким образом, рассчитать можно любой итог в отчете. Для расчета итога, не связанного с секциями, следует использовать префикс Totals к имени функции, через разделитель ".".