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

  • Статья

ПРИМЕНИМО К: Power BI Report Builder Power BI Desktop

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

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

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

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

  • Все пробельные символы в строке 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 со значением "01.07.2005".

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

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

  • Если отчет содержит параметр отчета со значением по умолчанию, а свойство Prompt имеет значение false (то есть свойство Пользователя запроса не выбрано в Power BI Report Builder), вы не сможете передать значение этого параметра отчета в URL-адресе. В этом случае администраторы могут запрещать пользователям добавлять или изменять значения определенных параметров отчета.
  • Power BI не поддерживает строку запроса длиной более 2000 символов. Вы можете непреднамеренно превысить это значение, если вы используете параметры URL-адреса для просмотра отчета с разбивкой на страницы, особенно если строка запроса содержит несколько значений параметров. Для правильной загрузки отчета сократите число символов, чтобы оно не превышало 2000.
  • Ограничение в строке запроса вычисляется после входа в Power BI. Если открыть отчет перед входом, ограничение уменьшается.

Дальнейшие действия