Power BI 中編頁報告的 URL 參數

  • 發行項

適用於：Power BI 報表產生器 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 要求可以包含多個參數，並依任何順序列出。 參數會以 ampersand （&） 分隔。 名稱和值組會以等號 （=） 分隔。 例如：

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

可用的值：

  • collapsed：載入已關閉參數面板的報表。 參數按鈕已啟用，讓使用者可以選取要展開的按鈕。
  • hidden：載入已關閉參數面板並停用參數按鈕的報表。
  • 展開 （預設值）：以開啟參數面板和啟用參數按鈕載入報表。

裝置資訊

您可以指定下列匯出格式的其他輸出參數。

  • 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。

相關內容