Поделиться через

Встроенные коллекции в выражениях в отчете с разбивкой на страницы (Power BI построитель отчетов)

  • Статья

ОБЛАСТЬ ПРИМЕНЕНИЯ: Power BI построитель отчетов Power BI Desktop

В выражение в отчете с разбивкой на страницы можно включить ссылки на следующие встроенные коллекции: ReportItems, Parameters, Fields, DataSets, DataSources, Variables и встроенные поля для общих сведений, таких как имя отчета. В диалоговом окне Выражения отображаются не все коллекции. Коллекции DataSets и DataSources доступны только во время выполнения для опубликованных отчетов в службе. Коллекция ReportItems является коллекцией текстовых полей в области отчета, например текстовых полей на странице или в верхнем колонтитуле.

Дополнительные сведения см. в разделе "Выражения" (Power BI построитель отчетов).

Основные сведения о встроенных коллекциях

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

Встроенная коллекция Категория в диалоговом окне «Выражение» Пример Description
Глобальные переменные Встроенные поля =Globals.ReportName

- or -

=Globals.PageNumber		 Представляет глобальные переменные, полезные для отчетов, например для имени отчета или номера страницы. Доступна всегда.

Дополнительные сведения см. в статье "Встроенные глобальные и пользователи" (Power BI построитель отчетов).
Пользователь Встроенные поля =User.UserID

- или -

=User.Language		 Представляет коллекцию сведений о пользователе, выполняющем отчет, например языковые настройки или идентификатор пользователя. Доступна всегда.

Дополнительные сведения см. в статье "Встроенные глобальные и пользователи" (Power BI построитель отчетов).
Параметры Параметры =Parameters("ReportMonth").Value

- или -

=Parameters!ReportYear.Value		 Представляет коллекцию параметров отчета, каждый из которых может быть однозначным или многозначным. Недоступна до завершения обработки инициализации. Дополнительные сведения см. в статьях "Ссылки на коллекции параметров" (Power BI построитель отчетов).
Fields(<набор_данных>>) Поля =Fields!Sales.Value Представляет коллекцию полей набора данных, доступных для отчета. Доступна после получения данных из источника данных в набор данных. Дополнительные сведения см. в статьях "Ссылки на коллекции полей набора данных" (Power BI построитель отчетов).
Наборы данных Не отображается =DataSets("TopEmployees").CommandText Представляет коллекцию наборов данных, к которым выполняется обращение из тела определения отчета. Не включает источники данных, которые используются только в верхних или нижних колонтитулах. Недоступна в режиме локального предварительного просмотра. Дополнительные сведения см. в статьях DataSources и DataSets Collection References (Power BI построитель отчетов).
Коллекция DataSources Не отображается =DataSources("AdventureWorks2012").Type Представляет коллекцию источников данных, к которым выполняется обращение из тела отчета. Не включает источники данных, которые используются только в верхних или нижних колонтитулах. Недоступна в режиме локального предварительного просмотра. Дополнительные сведения см. в статьях DataSources и DataSets Collection References (Power BI построитель отчетов).
Переменные Variables =Variables!CustomTimeStamp.Value Представляет коллекцию переменных отчета и групповых переменных. Дополнительные сведения см. в статьях "Ссылки на коллекции переменных отчетов и групп" (Power BI построитель отчетов).
ReportItems Не отображается =ReportItems("Textbox1").Value Представляет коллекцию текстовых полей для элемента отчета. Эта коллекция может использоваться для суммирования элементов на странице для включения в верхний или нижний колонтитул. Дополнительные сведения см. в справочниках по коллекции ReportItems (Power BI построитель отчетов).

Использование в выражениях синтаксиса коллекций

Чтобы обратиться к коллекции из выражения, можно использовать стандартный синтаксис Microsoft Visual Basic для элемента в коллекции. В следующей таблице показаны примеры синтаксиса коллекций.

Синтаксис Пример
Collection!ObjectName.Property =Fields!Sales.Value
Collection!ObjectName("Property") =Fields!Sales("Value")
Collection("ObjectName").Property =Fields("Sales").Value
Collection("Member") =User("Language")
Collection.Member =User.Language

Следующие шаги