Функции построителя отчетов — функция First в отчете с разбивкой на страницы (построитель отчетов)

  • Статья

Применимо: Microsoft построитель отчетов (SSRS) Power BI построитель отчетов конструктор отчетов в SQL Server Data Tools

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

Примечание.

Создать и изменить определение для отчета на страницу (RDL-файл) можно с помощью построителя отчетов (Майкрософт), построителя отчетов Power BI и конструктора отчетов в SQL Server Data Tools.

Синтаксис

  
First(expression, scope)

Параметры

выражение
(Variant или Binary) Выражение, к которому применяется статистическая обработка, например =Fields!FieldName.Value.

область
(String) необязательно. Имя набора данных, группы или области данных, содержащих элементы отчета, к которым применяется агрегатная функция. Если аргумент scope не задан, используется текущая область.

Тип возвращаемых данных

Определяется типом выражения.

Замечания

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

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

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

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

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

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

  • ПараметрScope для вложенных агрегатов не может быть именем набора данных.

  • Expression не может содержать функции First, Last, Previousи RunningValue .

  • Expression не может содержать вложенные агрегаты, в которых указан параметр recursive.

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

Дополнительные сведения о рекурсивных статистических выражениях см. в разделе Создание групп рекурсивной иерархии (построитель отчетов и SSRS).

Пример

Следующий пример кода возвращает первый номер продукта в группировании или области данных Category :

=First(Fields!ProductNumber.Value, "Category")

См. также

Использование выражений в отчетах (построитель отчетов и SSRS)
Примеры выражений (построитель отчетов и службы SSRS)
Типы данных в выражениях (построитель отчетов и службы SSRS)
Область выражений для итогов, агрегатов и встроенных коллекций (построитель отчетов и SSRS)