共用方式為

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 存取參數的名稱與值組。

prefix

URL 參數的前置詞，可指定 Power BI 服務中的動作。 例如，rp: 或 rdl:。

parameter

參數名稱。

value

對應至所使用參數值的 URL 文字。

URL 報表參數參考

您可以藉由將報表參數包含在報表 URL 中，來將其傳遞至報表。

報表參數 (rp:)

如需在 URL 上傳遞報表參數的範例，請參閱在 URL 中傳遞報表參數 (部分機器翻譯)。

注意

報表參數需要參數前置詞 rp:，且會區分大小寫。

URL 存取參數參考

您可以使用下列參數作為 URL 的一部分，以設定 Power BI 中編頁報表的外觀及操作。 本章節中將列出最常用的參數。 這些參數不會區分大小寫，如果與輸出格式相關，則會以參數前置詞 rdl: 開頭。

報表命令 (rdl:)

匯出格式

指定用於轉譯和匯出報表的格式。

  • 例如：rdl:format=PDF

可用值：

  • PPTX (PowerPoint)
  • MHTML
  • IMAGE
  • 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 (部分機器翻譯)。

相關內容