Share via

在 Power BI 編頁報表的 URL 內傳遞報表參數

  • 發行項

適用於：Power BI 報表產生器 Power BI Desktop

您可以將報表參數包含在編頁報表的報表 URL 中，以將報表參數傳遞至報表。 這些 URL 參數不會加上前置詞，因為它們會直接傳遞給報表處理引擎。

所有查詢參數都可以有相對應的報表參數。 您可以傳遞相對應的報表參數，即可傳遞查詢參數。 如需詳細資訊，請參閱在關係型查詢設計工具中建置查詢（Power BI 報表產生器）。

編頁報表參數規則

報表參數會區分大小寫，而且使用下列特殊字元：

  • 根據 URL 編碼標準，在 URL 字串中的任何空格字元都會使用字元 "%20" 來取代。
  • URL 參數部分中的空格字元會取代成加號字元 (+)。
  • 任何字串部分中的分號都會取代成 "%3A" 字元。
  • 瀏覽器應該會自動執行正確的 URL 編碼。 您不必手動編碼任何字元。
  • 如果您沒有包含 Proxy 語法，請在 參數前面加上 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

若要傳遞 布林 值，請使用 0 表示 False，使用 1 表示 True。 若要傳遞 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 範例會傳遞具有 「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 報表產生器 中未選取提示使用者屬性），則您無法在 URL 內傳遞該報表參數的值。 這可讓系統管理員選擇防止終端使用者新增或修改特定報表參數的值。
  • Power BI 不支持超過 2,000 個字元的查詢字串。 如果您使用 URL 參數來檢視編頁報表，特別是當您的查詢字串包含多個參數值時，可能會不小心超過此值。 若要正確載入報表，請將字元數目減少到 2,000 以下。
  • 當您登入 Power BI 之後，會評估查詢字串中的限制。 如果您在登入之前開啟報表，則會降低限制。

相關內容