編頁報表參數 (報表產生器)

發行項
05/04/2023

適用於：✅ SQL Server 2016 (13.x) Reporting Services 與更新版本 ✅ SharePoint

適用於✅：SQL Server (SQL Server 2016 (13.x) Reporting Services 與更新版本

此主題描述編頁報表參數的一般用法、您可以設定的屬性，以及其他資訊。報表參數可讓您控制報表資料、將相關的報表連接在一起，以及變更報表呈現方式。報表參數可以使用於您在報表產生器和報表設計師中建立的編頁報表，也可以使用於您在 SQL Server 行動報表發行工具中建立的行動報表。深入了解報表參數概念。

注意

SQL Server 行動報表發行工具已針對 SQL Server Reporting Services 2019 之後的所有 SQL Server Reporting Services 版本已退場。從 SQL Server Reporting Services 2022 與 Power BI 報表伺服器開始，其已停用。

若要嘗試自行將參數新增至報表，請參閱教學課程：將參數新增至報表 (報表產生器) (部分機器翻譯)。

參數的一般使用方式

以下提供部分最常使用參數的方式。

控制分頁和行動報表資料

透過撰寫包含變數的資料集查詢，在資料來源篩選分頁報表資料。
篩選共用資料集中的資料。將共用資料集加入至分頁報表時，無法變更查詢。在報表中，您可以加入資料集篩選，其中包含您所建立報表參數的參考。
篩選 SQL Server 行動報表中共用資料集的資料。如需詳細資訊，請參閱使用 SQL Server 行動報表發行工具建立行動報表。
可讓使用者指定值，以自訂分頁報表中的資料。例如，提供兩個參數，做為銷售資料的開始日期和結束日期。

連接相關報表

使用參數，將主報表與鑽研報表、子報表和連結報表產生關聯。當您設計一組報表時，可以將每份報表設計為可回答某些問題。每份報表對於相關資訊都會提供不同的檢視或不同的詳細程度。若要提供一組相關聯的報表，請針對目標報表上的相關資料建立參數。

如需詳細資訊，請參閱鑽研報表 (報表產生器及 SSRS) (部分機器翻譯)、子報表 (報表產生器及 SSRS) (部分機器翻譯) 與建立連結報表 (部分機器翻譯)。
為多位使用者自訂參數集。根據報表伺服器上的銷售報表建立兩個連結的報表。其中一個連結的報表使用銷售人員的預先定義參數值，另一個連結的報表則使用銷售經理的預先定義參數值。這兩個報表會使用相同的報表定義。

變更報表呈現方式

透過 URL 要求傳送命令到報表伺服器，以自訂報表的轉譯。如需詳細資訊，請參閱 URL 存取 (SSRS) (部分機器翻譯) 與在 URL 內傳遞報表參數 (部分機器翻譯)。
可讓使用者指定值，協助自訂報表的外觀。例如，提供 Boolean 參數，指出要展開或摺疊資料表中的所有巢狀資料列群組。
在運算式中包含參數，讓使用者自訂報表資料和外觀。

如需詳細資訊，請參閱參數集合參考 (報表產生器及 SSRS) (部分機器翻譯)。

檢視具有參數的報表

當您檢視具有參數的報表時，報表檢視器工具列會顯示每一個參數，讓您能夠以互動的方式指定值。下圖顯示使用參數 @ReportMonth、@ReportYear、@EmployeeID、@ShowAll、@ExpandTableRows、@CategoryQuota 及 @SalesDate 之報表的參數區域。

View report with parameters

參數窗格 ：報表檢視器工具列會顯示每個參數的提示和預設值。您可以在參數窗格中自訂參數的配置。如需詳細資訊，請參閱自訂報表中的參數窗格 (報表產生器) (部分機器翻譯)。
@SalesDate 參數@SalesDate 參數的資料類型為 DateTime。文字方塊旁會顯示 [選取日期] 提示。若要修改日期，請在文字方塊中輸入新日期，或是使用行事曆控制項。
@ShowAll 參數@ShowAll 參數的資料類型為 Boolean。使用選項按鈕可指定 True 或 False。
顯示或隱藏參數區域控點 ：在報表檢視器工具列上，按一下此箭頭可顯示或隱藏參數窗格。
@CategoryQuota 參數@CategoryQuota 參數的資料類型為 Float，因此其接受數值。 @CategoryQuota 設為允許多個值。
檢視報表 輸入參數值之後，請按一下 [檢視報表] 以執行報表。如果所有參數都有預設值，則報表會在第一次檢視時自動執行。

建立參數

您可以利用幾個不同方式建立報表參數。

注意

並非所有的資料來源都支援參數。

具有參數的資料集查詢或預存程序

新增包含變數的資料集查詢，或者包含輸入參數的資料集預存程序。每個變數或輸入參數都會建立資料集參數，每個資料集參數都會建立報表參數。

Report Builder Parameter Dataset Properties

報表產生器的此圖顯示：

[報表資料] 窗格中的報表參數。
具有參數的資料集。
[參數] 窗格。
[資料集屬性] 對話方塊中所列的參數。

資料集可以是內嵌或共用。當您將共用資料集加入至報表時，不可覆寫報表中標記為內部的資料集參數。您可以覆寫未標記為內部的資料集參數。

如需詳細資訊，請參閱本主題中的＜資料集查詢＞。

手動建立參數

從 [報表資料] 窗格手動建立參數。您可以設定報表參數，讓使用者能夠以互動的方式輸入值，協助自訂報表的內容或外觀。您也可以設定報表參數，讓使用者無法變更預先設定的值。

注意

由於參數是在伺服器上獨立管理，所以使用新的參數設定來重新發行主報表時，將不會覆寫此報表的現有參數設定。

具有參數的報表組件

注意

在從 SQL Server Reporting Services 2019 開始的所有 SQL Server Reporting Services 版本，以及從 Power BI 報表伺服器 2022 年 9 月開始的所有 Power BI 報表伺服器版本中，皆已淘汰報表組件。

加入報表組件，其中包含參數的參考或包含變數之共用資料集的參考。

報表組件會儲存在報表伺服器上，而且可供其他人在報表中使用。本身為參數的報表組件無法從報表伺服器管理。您可以在 [報表組件庫] 中搜尋參數，並且在加入這些參數之後，於報表中進行設定。如需詳細資訊，請參閱報表組件 (報表產生器及 SSRS) (部分機器翻譯)。

注意

您可以針對與參數具有相依資料集的資料區域，將參數當做個別的報表組件發行。雖然參數會列為報表組件，不過您無法直接將報表組件參數加入至報表。請改為加入報表組件，然後系統就會根據報表組件所包含或參考的資料集查詢，自動產生任何必要的報表參數。如需報表組件的詳細資訊，請參閱報表組件 (報表產生器及 SSRS) (部分機器翻譯) 與報表設計師中的報表組件 (SSRS) (部分機器翻譯)。

參數值

下列是在報表中選取參數值的選項。

從下拉式清單選取單一參數值。
從下拉式清單選取多個參數值。
從下拉式清單選取一個參數的值，它會決定其他參數下拉式清單中可用的值。這些是串聯參數。串聯參數可讓您後續從數千個值篩選出能夠管理的參數值數目。

如需詳細資訊，請參閱將串聯參數新增至報表 (報表產生器及 SSRS) (部分機器翻譯)。
不需要先選取參數值就能執行報表，因為已經為參數建立預設值。

報表參數屬性

您可以使用 [報表屬性] 對話方塊來變更報表參數屬性。下表摘要說明您可以針對每個參數設定的屬性：

屬性	描述
Name	輸入區分大小寫的參數名稱。此名稱必須以字母開頭，可以包含字母、數字和底線 (_)。名稱不能有空格。若是自動產生的參數，此名稱會與資料集查詢中的參數相同。根據預設，手動建立的參數類似於 ReportParameter1。
Prompt	在報表檢視器工具列上顯示於參數旁邊的文字。
資料類型	報表參數的資料類型必須是下列其中一種： Boolean (布林值)。使用者會從選項按鈕中選取 True 或 False。 DateTime。使用者會從日曆控制項中選取日期。 Integer (整數)。使用者會在文字方塊中輸入值。 Float (浮點數)。使用者會在文字方塊中輸入值。 Text (文字)。使用者會在文字方塊中輸入值。針對某個參數定義了可用的值之後，使用者就可以從下拉式清單中選擇值，即使資料類型是 DateTime也一樣。如需有關報表資料類型的詳細資訊，請參閱＜ RDL Data Types＞。
允許空白值	如果參數值可為空字串或空白，則選取此選項。如果您為參數指定有效值，而且希望空白值是其中一個有效值，則必須將它納入做為您指定的其中一個有效值。選取此選項並不會自動將空白納入做為可用的值。
允許 null 值	如果參數值可為 null，則選取此選項。如果您為參數指定有效值，而且希望 null 是其中一個有效值，則必須將 null 納入做為您指定的其中一個有效值。選取此選項並不會自動將 null 納入做為可用的值。
允許多個值	提供可用的值，建立可供使用者選擇的下拉式清單。這是確保資料集查詢中只會提交有效值的好方法。如果參數值可以是顯示在下拉式清單中的多個值，則選取此選項。不允許 Null 值。選取此選項時，系統會將核取方塊加入到參數下拉式清單內可用值的清單中。清單的頂端包含 [全選]核取方塊。使用者可以檢查想要的值。如果提供值的資料迅速改變，則使用者看見的清單可能不是最新的。
可見	選取此選項可顯示報表執行時，位於報表頂端的報表參數。此選項可讓使用者在執行階段選取參數值。
Hidden	選取此選項來隱藏已發行報表中的報表參數。您仍然可以在報表 URL、訂閱定義或報表伺服器上設定報表參數值。
內部	選取此選項來隱藏報表參數。已發行報表中的報表參數只能在報表定義中檢視。
可用值	如果您已為參數指定可用的值，則有效值會固定顯示為下拉式清單。例如，如果您為 DateTime 參數提供可用的值，則參數窗格中會出現日期的下拉式清單，而不是行事曆控制項。為確保報表和子報表之間的值清單一致，您可以在資料來源上設定一個選項，針對與資料來源相關聯的資料集中的所有查詢使用單一交易。安全性注意事項：在任何包含 Text 資料類型參數的報表中，請務必使用可用值清單 (也稱為有效值清單)，並確保任何執行報表的使用者都只有檢視報表中資料所需權限。如需詳細資訊，請參閱安全性 (報表產生器) (部分機器翻譯)。
預設值	設定來自查詢或靜態清單的預設值。如果每個參數都有預設值，則報表會在第一次檢視時自動執行。
進階	設定報表定義屬性 UsedInQuery，其值指出此參數直接或間接影響報表中的資料。自動判斷何時重新整理當您想要讓報表處理器判斷此值的設定時，請選擇此選項。如果報表處理器偵測到一個資料集查詢，且其中包含一個這個參數的直接或間接參照，或者如果報表中有子報表，則此值為 True 。永遠重新整理在資料集查詢或參數運算式中直接或間接使用報表參數時，請選擇此選項。此選項會將 UsedInQuery 設定為 True。永不重新整理不在資料集查詢或參數運算式中直接或間接使用報表參數時，請選擇此選項。此選項會將 UsedInQuery 設定為 False。警告：請小心使用 [永不重新整理]。在報表伺服器上， UsedInQuery 用於協助控制報表資料與已轉譯之報表的快取選項，以及快照集報表的參數選項。如果未正確設定 [永不重新整理] ，您可能會快取不正確的報表資料或報表，或者使快照集報表的資料不一致。如需詳細資訊，請參閱報表定義語言 (SSRS) (部分機器翻譯)。

資料集查詢

若要篩選資料集查詢中的資料，您可以加入限制子句，透過指定結果集中要包含或排除的值限制擷取的資料。

使用資料來源的查詢設計工具，可協助您建立參數化查詢。

針對 Transact-SQL 查詢，不同資料來源支援不同的參數語法。支援的範圍是查詢中依據位置或名稱識別的參數。如需詳細資訊，請參閱報表資料集 (SSRS) (部分機器翻譯) 中針對特定外部資料來源類型的主題。在關聯式查詢設計工具中，您必須為篩選選取參數選項，才能建立參數化查詢。如需詳細資訊，請參閱關聯式查詢設計工具使用者介面 (報表產生器) (部分機器翻譯)。
針對依據多維資料來源 (例如 Microsoft SQL Server Analysis Services、SAP NetWeaver BI 或 Hyperion Essbase) 的查詢，您可以指定是否根據您在查詢設計工具中指定的篩選建立參數。如需詳細資訊，請參閱查詢設計工具 (SSRS) (部分機器翻譯) 中對應至資料延伸模組的查詢設計工具主題。

在發行的報表上管理參數

當您設計報表時，報表參數會儲存在報表定義中。當您發行報表時，報表參數會儲存，並且與報表定義分開管理。

在已發行的報表中，可以使用下列項目：

報表參數屬性 直接在報表伺服器上，從報表定義個別變更報表參數值。
快取報表。 若要為報表建立快取計劃，每個參數都必須有預設值。如需詳細資訊，請參閱快取報表 (SSRS) (部分機器翻譯)。
快取共用資料集。 若要為共用資料集建立快取計劃，每個參數都必須有預設值。如需詳細資訊，請參閱快取報表 (SSRS) (部分機器翻譯)。
連結報表。 您可以使用預設的參數建立連結報表，針對不同的對象來篩選資料。如需詳細資訊，請參閱建立連結報表。
報表訂閱。 您可以指定參數值來篩選資料，並透過訂用帳戶傳遞報表。如需詳細資訊，請參閱訂用帳戶與傳遞 (Reporting Services) (部分機器翻譯)。
URL 存取。 您可以在報表 URL 中指定參數值。您也可以使用 URL 存取來執行報表及指定參數值。如需詳細資訊，請參閱 URL 存取 (SSRS) (部分機器翻譯)。

若重新發行了報表定義，將會保留已發佈之報表的參數屬性。如果報表定義和報表同樣重新發行，且參數名稱和資料類型保持相同，則會保留屬性設定。如果您加入或刪除報表定義中的參數，或變更現有參數的資料類型或名稱，您就可能需要變更已發行報表的參數屬性。

並非所有的參數都可以在任何情況下修改。如果報表參數從資料集查詢取得預設值，無法針對已發行的報表修改該值，也無法在報表伺服器上修改該值。執行階段使用的值會在查詢執行時決定，如果是以運算式為基礎的參數，則會在評估運算式時決定。

報表執行選項會影響處理參數的方式。以快照集執行的報表無法使用從查詢所衍生的參數，除非查詢包括參數的預設值。

訂閱的參數

您可以定義視需要或快照集報表的訂閱，並指定在訂閱處理過程中要使用的參數值。

隨選報表。 您可以為隨選報表中所列的每個參數，指定不同於發佈值的參數值。例如，假設您有一個呼叫服務報表，使用 Time Period 參數傳回客戶在目前日期、星期、或月份的服務要求。如果報表的預設參數值設定為 today，您的訂閱可以使用不同的參數值 (例如， week 或 month)，以產生包含每週或每月數字的報表。
快照集。 快照集訂閱必須使用為快照集定義的參數值。您的訂閱無法覆寫快照集所定義的參數值。例如，假設您訂閱當成報表快照集執行的西區銷售報表，而快照集指定 Western 作為區域參數值。在此情況下，如果您對此報表建立訂閱，則必須在訂閱中使用參數值 Western 。為了提供忽略參數的視覺指示，訂閱頁面上的參數欄位會設定為唯讀欄位。

報表執行選項會影響處理參數的方式。當成報表快照集執行的參數化報表，會使用報表快照集所定義的參數值。參數值是在報表的參數屬性頁面中定義。以快照集執行的報表無法使用從查詢所衍生的參數，除非查詢包括參數的預設值。

如果在定義了訂閱之後變更報表快照集內的參數值，報表伺服器就會停用訂閱。停用訂閱指出已經修改報表。若要啟動訂閱，請開啟並儲存訂閱。

注意

資料驅動訂閱可以使用從訂閱者資料來源取得的參數值。如需詳細資訊，請參閱使用外部資料來源以取得訂閱者資料 (資料驅動訂閱) (部分機器翻譯)。

如需詳細資訊，請參閱訂用帳戶與傳遞 (Reporting Services) (部分機器翻譯)。

參數和資料保護

散發包含機密或敏感資訊的參數化報表時，請特別小心。使用者可以輕鬆地以其他值取代報表參數，造成您不希望發生的資訊洩露。

使用員工或個人資料之參數的一個安全替代方式，就是根據包含 Users 集合之 UserID 欄位的運算式來選取資料。 Users 集合提供一種方法，來取得執行報表之使用者的識別，並使用該識別來擷取使用者特定資料。

重要

在任何包含 String類型參數的報表中，務必使用可用的值清單 (也稱為有效值清單)，並且確認任何執行報表的使用者僅擁有檢視報表中資料所需的權限。當您將參數定義為 String類型時，使用者會看到一個可接受任何值的文字方塊。可用的值清單會限制可輸入的值。如果報表參數繫結至資料集參數，而且您不要使用可用的值清單，則報表使用者可以在文字方塊中輸入 SQL 語法，如此可能會使您的報表及伺服器暴露在 SQL 資料隱碼攻擊的危險之下。如果使用者的權限足以執行新的 SQL 陳述式，伺服器可能會出現不良的結果。

如果報表參數未繫結至資料集參數，且參數值有包含在報表中，則報表使用者就可以在參數值中輸入運算式語法或 URL，並將報表轉譯為 Excel 或 HTML。如果另一個使用者接著檢視報表並按一下轉譯的參數內容，該使用者可能會不小心執行惡意指令碼或連結。

若要減輕不小心執行惡意指令碼的風險，請只從信任的來源開啟轉譯的報表。如需保護報表安全的詳細資訊，請參閱保護報表和資源的安全。