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

Применяется к: Microsoft Report Builder (SSRS) Power BI Report Builder Конструктор отчетов в SQL Server Data Tools

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

Примечание.

Файлы определения страничных отчетов (.rdl) можно создавать и изменять в Microsoft Report Builder, Power BI Report Builder и в конструктор отчетов в 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")

Связанный контент

  • Last updated on