在 Power BI 編頁報告的 URL 內傳遞報告參數
適用於：
Power BI Report Builder 
Power BI Desktop
您可以藉由將報告參數包含在編頁報告 URL 中，來將其傳遞至報告。 這些 URL 參數不會加上前置詞，因為它們會直接傳遞給報表處理引擎。
所有查詢參數都可以有相對應的報表參數。 您可以傳遞相對應的報表參數，即可傳遞查詢參數。 如需詳細資訊，請參閱在關聯式查詢設計工具中建置查詢 (Power BI Report Builder)。
編頁報告參數規則
報表參數會區分大小寫，而且使用下列特殊字元：
- 根據 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 Report Builder 中選取 [提示使用者] 屬性)，則您無法在 URL 中傳遞該報告參數的值。 這可讓系統管理員選擇防止終端使用者新增或修改特定報表參數的值。
- Power BI 不支援超過 2,000 個字元的查詢字串。 如果您使用 URL 參數來檢視編頁報表，特別是當您的查詢字串包含多個參數值時，可能會不小心超過此值。 若要正確載入報表，請將字元數目減少到 2,000 以下。
- 登入 Power BI 後將評估查詢字串中的限制。 如果您在登入之前開啟報表，則會降低限制。