Передача параметра отчета в 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. Если открыть отчет перед входом, ограничение уменьшается.