Создание параметров для отчетов с разбивкой на страницы в Power BI "Report Builder"

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

В этой статье вы узнаете, как создать параметры в построителе отчетов Power BI для отчетов с разбивкой на страницы. Параметр отчета позволяет читателям отчетов выбирать данные отчета и изменять презентацию отчета. Создание полнофункционального параметра включает в себя несколько шагов: определение параметра, задание доступных значений, настройка значений по умолчанию и подключение параметра к запросу набора данных.

Дополнительные сведения о взаимодействии бизнес-пользователей с параметрами в службе Power BI см. в разделе "Просмотр параметров для отчетов с разбивкой на страницы".

На следующем рисунке показан режим конструктора в Power BI Report Builder для отчета с параметрами @BuyingGroup, @Customer, @FromDate, и @ToDate.

Снимок экрана: параметры в построителе отчетов.

  1. Параметры отчета в области данных отчета.
  2. Таблица с одним из параметров в наборе данных.
  3. Область параметров. Структуру параметров можно настроить в области параметров.
  4. Параметры @FromDate и @ToDate имеют тип данных DateTime. При просмотре отчета можно ввести дату в текстовом поле, выбрать дату в элементе управления календарем или перейти к сегодняшнему дню.
  5. Один из параметров в диалоговом окне "Свойства набора данных".

Предварительные условия

Требования к лицензии для отчетов Power BI с разбивкой на страницы (RDL-файлы) совпадают с требованиями к отчетам Power BI (PBIX-файлам).

Обзор: действия по созданию рабочего параметра

Для создания параметра, который фильтрует данные отчета, необходимо выполнить следующие действия:

  1. Создайте параметр отчета— определите имя параметра , тип данных и текст запроса.
  2. Задайте доступные значения (рекомендуется) — укажите список значений, которые пользователи могут выбрать.
  3. Задайте значения по умолчанию (необязательно) — укажите начальные значения, чтобы отчет выполнялось автоматически.
  4. Подключите параметр к набору данных. Свяжите параметр с запросом, чтобы фильтровать данные.

В следующих разделах описывается каждый шаг.

Шаг 1. Создание параметра отчета

  1. Откройте отчет с разбивкой на страницы в Power BI построитель отчетов.
  2. В области данных отчета щелкните правой кнопкой мыши узел "Параметры " и выберите "Добавить параметр". Откроется диалоговое окно Свойства параметра отчета .
  3. В поле "Имя" введите имя параметра (например, ProductCategory). Имя должно начинаться с буквы и может содержать только буквы, цифры или символы подчеркивания (_). Пробелы не допускаются.
  4. В командной строке введите текст рядом с параметром (например, Select a category:).
  5. В поле Тип данныхвыберите тип данных для значения параметра. Распространенные типы включают:
    • Текст — для строковых значений
    • Целое число — для целых чисел
    • DateTime — для значений дат (отображает средство выбора календаря)
    • Логический — для значений true/false (отображает радиокнопки)
  6. Настройте дополнительные параметры по мере необходимости:
    • Разрешить пустое значение . Пользователь может отправить пустую строку.
    • Разрешить значение NULL . Пользователь может оставить параметр неустановленным.
    • Разрешить несколько значений . Пользователь может выбрать несколько значений (отображает флажки).
  7. Задайте видимость:
    • Видимый — параметр отображается на панели инструментов отчета.
    • Скрытый — параметр не отображается, но может быть задан по URL-адресу.
    • Внутренний — параметр скрыт и не может быть изменен после публикации.
  8. Пока не нажимайте кнопку "ОК ". Продолжайте задавать доступные значения.

Шаг 2. Установка доступных значений

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

Вариант A. Указание значений вручную

  1. В диалоговом окне "Свойства параметра отчета " выберите страницу "Доступные значения ".
  2. Выберите "Указать значения".
  3. Нажмите кнопку "Добавить ", чтобы создать каждое значение:
    • Значение — фактическое значение, переданное запросу (например, 1).
    • Метка — понятное имя, отображаемое пользователям (например, Bikes).
  4. Повторите для каждого значения. Используйте кнопки со стрелками для переупорядочения списка.

Вариант B. Получение значений из запроса

  1. Сначала создайте набор данных, который извлекает доступные значения. Например, создайте набор данных с именем CategoryList с помощью этого запроса.

    SELECT CategoryID, CategoryName FROM ProductCategory ORDER BY CategoryName

  2. В диалоговом окне "Свойства параметра отчета " выберите страницу "Доступные значения ".

  3. Выберите "Получить значения из запроса".

  4. В наборе данных выберите набор данных (например, CategoryList).

  5. В поле "Значение" выберите поле, содержащее фактические значения (например, CategoryID).

  6. В поле "Метка" выберите поле, содержащее отображаемые имена (например, CategoryName).

Шаг 3. Установка значений по умолчанию (необязательно)

Значения по умолчанию вызывают автоматический запуск отчета при первом открытии. Без значений по умолчанию пользователи должны выбирать значения и выбирать представление отчета.

  1. В диалоговом окне "Свойства параметра отчета " выберите страницу "Значения по умолчанию ".
  2. Выберите один из следующих вариантов:
    • Отсутствие значения по умолчанию - Пользователи должны сделать выбор.
    • Укажите значения . Вручную введите одно или несколько значений по умолчанию.
    • Получение значений из запроса . Используйте набор данных для предоставления значений по умолчанию.
  3. Выберите ОК, чтобы закрыть диалог.

Шаг 4. Подключение параметра к набору данных

Параметр не фильтрует данные, пока не подключите его к запросу набора данных. Существует два распространенных подхода.

Вариант A. Добавление переменной запроса

  1. В области данных отчета щелкните правой кнопкой мыши основной набор данных и выберите свойства набора данных.

  2. На странице "Запрос" измените запрос, чтобы включить предложение WHERE с переменной:

    SELECT ProductID, ProductName, CategoryID, Price
FROM Products
WHERE CategoryID = @ProductCategory

  3. При нажатии кнопки "ОК" построитель отчетов автоматически создает параметр набора данных и связывает его с параметром отчета.

Если вы переименовали параметр или хотите вручную связать их:

  1. В области данных отчета щелкните правой кнопкой мыши набор данных и выберите свойства набора данных.
  2. Выберите страницу "Параметры ".
  3. В столбце "Значение параметра " выберите параметр отчета, чтобы связаться с каждым параметром запроса (например, [@ProductCategory]).
  4. Нажмите ОК.

Проверка параметра

  1. Нажмите кнопку "Выполнить " (или нажмите клавишу F5), чтобы просмотреть отчет.
  2. Параметр отображается на панели инструментов с доступными значениями.
  3. Выберите значение и выберите "Просмотреть отчет ", чтобы проверить правильность фильтров данных.

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

  • Last updated on