通过

在 Power BI 分页报表的 URL 中传递报表参数

  • 项目

适用于： Power BI Report Builder Power BI Desktop

可通过在分页报表的报表 URL 中包含报表参数，向报表传递报表参数。 这些 URL 参数不带前缀，因为它们被直接传递到报表处理引擎。

所有查询参数都可具有对应的报表参数。 通过传递相应报表参数将查询参数传递给报表。 有关详细信息，请参阅在关系查询设计器中生成查询 (Power BI Report Builder)。

分页报表参数规则

报表参数区分大小写并使用以下特殊字符：

  • URL 字符串中的任何空格字符将根据 URL 编码标准被字符“%20”替换。
  • 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 表示 False，使用 1 表示 True。 要传递浮点值，请包含服务器区域设置的小数分隔符。

备注

如果报表包含的某个报表参数具有默认值，并且 Prompt 属性的值为 false （即，在报表管理器中未选择 Prompt User 属性），则无法在 URL 中为该报表参数传递值。 这向管理员提供了一个选项，以防止最终用户添加或修改某些报表参数的值。

其他示例

以下 URL 示例包括一个多值参数“Salesperson”。 多值参数的格式为的是重复每个值的参数名称。

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

以下 URL 示例传递值为“7/1/2005”的单个参数 SellStartDate。

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

注意事项和限制

  • 如果报表包含具有默认值的报表参数，并且“Prompt”属性的值为 false（即未在 Power BI Report Builder 中选择“Prompt User”属性），则不能在 URL 中为该报表参数传递值。 这样，管理员就可以选择阻止最终用户添加或修改某些报表参数的值。
  • Power BI 不支持超过 2,000 个字符的查询字符串。 如果使用 URL 参数查看分页报表，则可能会意外超过此值，尤其是当查询字符串包含多个参数值时。 若要正确加载报表，请将字符数减少到 2,000 以下。
  • 在你登录到 Power BI 之后，才会计算查询字符串中的限制。 如果在登录前打开报表，限制将会减少。

相关内容