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

Передача параметра отчета в URL-адресе отчета с разбивкой на страницы Power BI

  • Статья

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

Параметры отчета можно передать в отчет, включив их в URL-адрес отчета для отчетов с разбивкой на страницы. Такие параметры URL-адреса не снабжаются префиксами, поскольку они передаются непосредственно в подсистему обработки отчетов.

Все параметры запроса могут иметь соответствующие параметры отчета. Параметр запроса можно передать в отчет. Дополнительные сведения см. в разделе "Создание запроса" в конструкторе реляционных запросов (Power BI построитель отчетов).

Правила параметров отчета с разбивкой на страницы

Параметры отчета учитывают регистр символов и используют следующие специальные символы:

  • Все пробельные символы в строке URL-адресов заменяются символами «%20» в соответствии со стандартами кодировки URL-адресов.
  • Пробел в секции параметров URL-адреса заменяется символом плюса (+).
  • Точка с запятой в любой части строки заменяется символами «%3A».
  • Браузер должен автоматически выполнить необходимую кодировку URL-адреса. Пользователю нет необходимости выполнять кодировку символов вручную.
  • Если синтаксис прокси-сервера не включен, префикс параметра с помощью rp:.

Примеры параметров отчета с разбивкой на страницы

Чтобы задать параметр отчета в URL-адресе, используйте следующий синтаксис:

  
rp:parameter=value

Например, чтобы указать два параметра " Salesperson" и "State", определенные в отчете в моей рабочей области, вы будете использовать следующий URL-адрес:

https://app.powerbi.com/groups/me/rdlreports/xxxxxxx-abc7-40f0-b456-febzf9cdda4d?rp:Salesperson=Tie+Bear&rp:State=Utah

Чтобы указать одинаковые два параметра, определенные в отчете в приложении, можно использовать следующий URL-адрес:

https://app.powerbi.com/groups/me/apps/xxxxxxx-c4c4-4217-afd9-3920a0d1e2b0/rdlreports/xxxxxxx-639e-41d0-b733-05d2bca9853c?rp:Salesperson=Tiggee&rp:State=Utah

Чтобы задать параметру значение NULL, используйте следующий синтаксис:

  
parameter:isnull=true

Например,

rp:SalesOrderNumber:isnull=true

Чтобы задать значение Boolean , используйте 0 для значения ложь и 1 для значения верно. Чтобы передать значение Float , добавьте десятичный разделитель языкового стандарта сервера.

Примечание.

Если отчет содержит параметр отчета, имеющий значение по умолчанию, а свойство Prompt имеет значение false (то есть в диспетчере отчетов не выбрано свойство Подсказка пользователю), передать значение этого параметра отчета в URL-адресе невозможно. Это позволяет администраторам запретить пользователям добавлять и изменять значения определенных параметров отчета.

Дополнительные примеры

В следующем примере URL-адреса содержится параметр Salesperson с несколькими значениями. Формат параметра с несколькими значениями — повторять имя параметра для каждого значения.

https://app.powerbi.com/groups/me/rdlreports/xxxxxxx-abc7-40f0-b456-febzf9cdda4d?rp:Salesperson=Tie+Bear&rp:Salesperson=Mickey

В следующем примере URL-адреса передается один параметр SellStartDate со значением "7/1/2005".

https://app.powerbi.com/groups/me/rdlreports/xxxxxxx-abc7-40f0-b456-febzf9cdda4d?rp:SellStartDate=7/1/2005

Рекомендации и ограничения

  • Если отчет содержит параметр отчета, имеющий значение по умолчанию, а значение свойства Запроса имеет значение false (то есть свойство "Пользователь запроса" не выбрано в Power BI построитель отчетов), то нельзя передать значение для этого параметра отчета в URL-адресе. Это позволяет администраторам запретить конечным пользователям добавлять или изменять значения определенных параметров отчета.
  • Power BI не поддерживает строку запроса более 2000 символов. Если вы используете параметры URL-адреса для просмотра отчета с разбивкой на страницы, может быть непреднамеренно превышено это значение, особенно если строка запроса содержит несколько значений параметров. Чтобы правильно загрузить отчет, уменьшите число символов до 2000.
  • Ограничение в строке запроса вычисляется после входа в Power BI. Если вы открываете отчет перед входом, ограничение уменьшается.
  • Поддерживаемые форматы дат для передачи параметров отчета в URL-адресе — ISO (ГГГГ-MM-DD) и en-US (MM/DD/ГГГГ).

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