Power BI 的分页报表中的 URL 参数

  • 项目

适用于： Power BI Report Builder Power BI Desktop

可以通过将参数添加到 URL，将命令发送到 Power BI 中的分页报表。 例如，你可能已使用一组特定的报表参数值查看了报表。 你可使用预定义的 URL 访问参数在 URL 中封装这些信息。 可通过嵌入参数来呈现格式或设计报表工具栏的外观，进一步自定义 Power BI 处理报表的方式。 然后，可以将此 URL 直接粘贴到电子邮件或网页中，让他人在浏览器中采用相同的方式体验你的报表。

下面是可以通过 URL 访问参数执行的操作：

  • 将报表参数发送到报表。
  • 以支持的文件格式启动报表内容导出。
  • 隐藏或查看参数窗格。
  • 指定 DeviceInfo 设置。

如需获取通过 URL 访问提供的命令和设置的完整列表，请参阅本文的 URL 访问参数参考。

URL 访问概念

Power BI 的 URL 请求包含服务处理的参数。 服务处理 URL 请求的方式取决于在 URL 中包括的参数、参数前缀和项的类型。 分页报表 URL 功能与支持标准 URL 寻址的大多数浏览器和应用程序兼容。

URL 访问语法

URL 请求可包含以任何顺序列出的多个参数。 参数用和号 (&) 分隔。 名称和值对用等号 (=) 分隔。 例如：

powerbiservicereporturl?rp:parameter=value&rdl:parameter=value

语法说明

powerbiservicereporturl

分页报表的 Power BI 服务 URL。 例如：

https://app.powerbi.com/groups/me/rdlreports/xxxxxxx-c4c4-4217-afd9-3920a0d1e2b0

？

用于分隔 powerbiservicereporturl 和 URL 访问参数。

&

用于分隔 URL 访问参数的名称和值对。

前缀

URL 参数的前缀，用于指定 Power BI 服务中的操作。 例如，rp: 或 rdl:。

参数

参数名称。

值

与所使用参数的值相对应的 URL 文本。

URL 报表参数引用

可通过在分页报表 URL 中包含报表参数，向报表传递报表参数。

报表参数 (rp:)

有关在 URL 中传递报表参数的示例，请参阅在 URL 中传递报表参数。

注意

报表参数需要参数前缀 rp: 并且区分大小写。

URL 访问参数参考

可使用以下参数作为 URL 的一部分，在 Power BI 中配置分页报表的外观。 此部分列出了最常用的参数。 参数不区分大小写，如果与输出格式相关，则以参数前缀 rdl: 开头。

报表命令 (rdl:)

导出格式

指定呈现和导出报表采用的格式。

  • 例如： rdl:format=PDF

可用值：

  • PPTX (PowerPoint)
  • MHTML
  • 图像
  • EXCELOPENXML (EXCEL)
  • WORDOPENXML (WORD)
  • CSV
  • PDF
  • ACCESSIBLEPDF (PDF)
  • XML

报表视图

指定显示报表时使用的视图类型。

  • rdl:reportView

可用值：

  • interactive（默认值）：以交互模式加载报表。
  • pageView：在页面视图模式下加载报表。

参数面板

指定在报表加载或完全隐藏时参数面板是关闭还是打开。

  • rdl:parameterPanel

可用值：

  • 折叠：加载报表时参数面板处于关闭状态。 参数按钮已启用，用户可以选择该按钮进行展开。
  • 隐藏：加载报表时参数面板处于关闭状态，参数按钮处于禁用状态。
  • 展开（默认）：加载报表时参数面板处于打开状态，参数按钮处于启用状态。

设备信息

可以为以下导出格式指定其他输出参数。

  • PDF / ACCESSIBLEPDF：

    • rdl:AccessiblePDF=true/false
    • rdl:Columns=integer
    • rdl:ColumnSpacing=decimal(in)
    • rdl:DpiX=integer
    • rdl:DpiY=integer
    • rdl:EndPage=integer
    • rdl:HumanReadablePDF=true/false
    • rdl:MarginBottom=decimal(in)
    • rdl:MarginLeft=decimal(in)
    • rdl:MarginRight=decimal(in)
    • rdl:MarginTop=decimal(in)
    • rdl:PageHeight=decimal(in)
    • rdl:PageWidth=decimal(in)
    • rdl:StartPage=integer

  • CSV：

    注意

    对于这些字符串值，请参阅 CSV 设备信息设置。

    • rdl:Encoding=string
    • rdl:ExcelMode=true/false
    • rdl:FieldDelimiter=string
    • rdl:NoHeader=true/false
    • rdl:Qualifier=string
    • rdl:RecordDelimiter=string
    • rdl:SuppressLineBreaks=true/false
    • rdl:UseFormattedValues=true/false

  • WORDOPENXML (WORD)：

    • rdl:AutoFit=string -> True/False/Never/Default
    • rdl:ExpandToggles=true/false
    • rdl:FixedPageWidth=true/false
    • rdl:OmitDrillthroughs=true/false
    • rdl:OmitHyperlinks=true/false

  • EXCELOPENXML (EXCEL)：

    • rdl:OmitDocumentMap=true/false
    • rdl:OmitFormulas=true/false
    • rdl:SimplePageHeaders=true/false

  • PPTX (PowerPoint)：

    • rdl:Columns=integer
    • rdl:ColumnSpacing=decimal(in)
    • rdl:DpiX=integer
    • rdl:DpiY=integer
    • rdl:EndPage=integer
    • rdl:MarginBottom=decimal(in)
    • rdl:MarginLeft=decimal(in)
    • rdl:MarginRight=decimal(in)
    • rdl:MarginTop=decimal(in)
    • rdl:PageHeight=decimal(in)
    • rdl:PageWidth=decimal(in)
    • rdl:StartPage=integer
    • rdl:UseReportPageSize=true/false

  • XML：

    • rdl:Encoding=string
    • rdl:Indented=true/false
    • rdl:OmitNamespace=true/false
    • rdl:OmitSchema=true/false
    • rdl:Schema=true/false
    • rdl:UseFormattedValues=true/false

可以将 rdl:targetSameWindow=true 追加到报表中的超链接 URL，使 Power BI 在同一浏览器窗口中打开此超链接。 若要了解如何将超链接添加到报表，请参阅向 URL 添加超链接。

相关内容