教學課程：將參數新增至報表 (報表產生器)

發行項
03/14/2024

在此教學課程中，將參數新增至 Reporting Services 分頁報表，讓報表讀者可篩選報表資料中的一或多個值。

Screenshot that shows you can add a parameter to a paginated report.

系統會針對您包含在資料集查詢中的每個查詢參數，自動建立報表參數。參數資料類型會決定該類型會如何在報表檢視器工具列上顯示。

注意

在本教學課程中，精靈的步驟會合併為一個程序。如需如何瀏覽至報表伺服器、選擇資料來源以及建立資料集的逐步指示，請參閱本系列的第一個教學課程：教學課程：建立基本資料表報表 (報表產生器)。

完成此教學課程的估計時間：25 分鐘。

需求

如需需求的資訊，請參閱教學課程的先決條件 (報表產生器)。

1.在資料表或矩陣精靈中建立矩陣報表和資料集

建立矩陣報表、資料來源與資料集。

注意

在本教學課程中，查詢會包含資料值，因此不需要外部資料來源。這樣會使查詢相當冗長。在商業環境中，查詢不會包含資料。這僅供教學之用。

若要建立新的矩陣圖報表

從電腦、Reporting Services Web 入口網站或 SharePoint 整合模式啟動報表產生器。

[新報表或資料集] 對話方塊隨即開啟。

如果您看不到 [新增報表或資料集] 對話方塊，請按一下 [檔案] 功能表 > [新增]。
在左窗格中，確認已選取 [新增報表]。
在右窗格中，選取 [資料表或矩陣精靈]。
在 [選擇資料集] 頁面中，選取 [建立資料集]>[下一步]。
在 [選擇與資料來源的連接] 頁面中，選取清單中的資料來源，或瀏覽至報表伺服器來選取資料來源。選取類型為 [SQL Server] 的任何資料來源。
選取 [下一步]。

您可能需要輸入您的認證。
在 [設計查詢] 頁面中，選取 [當成文字編輯]。

將下列查詢貼入頂端的空窗格中：

;WITH CTE (StoreID, Subcategory, Quantity)   
AS (  
SELECT 200 AS StoreID, 'Digital SLR Cameras' AS Subcategory, 2002 AS Quantity  
UNION SELECT  200 AS StoreID, 'Camcorders' AS Subcategory, 1954 AS Quantity  
UNION SELECT  200 AS StoreID, 'Accessories' AS Subcategory, 1895 AS Quantity  
UNION SELECT  199 AS StoreID, 'Digital Cameras' AS Subcategory, 1849 AS Quantity  
UNION SELECT  306 AS StoreID, 'Digital SLR Cameras' AS Subcategory, 1579 AS Quantity  
UNION SELECT  306 AS StoreID, 'Camcorders' AS Subcategory, 1561 AS Quantity  
UNION SELECT  306 AS StoreID, 'Digital Cameras' AS Subcategory, 1553 AS Quantity  
UNION SELECT  306 AS StoreID, 'Accessories' AS Subcategory, 1534 AS Quantity  
UNION SELECT 307 AS StoreID, 'Accessories' AS Subcategory, 1755 AS Quantity  
UNION SELECT 307 AS StoreID, 'Camcorders' AS Subcategory, 1631 AS Quantity  
UNION SELECT 307 AS StoreID, 'Digital SLR Cameras' AS Subcategory, 1772 AS Quantity)  
SELECT StoreID, Subcategory, Quantity  
FROM CTE

此查詢會將數個 Transact-SQL SELECT 陳述式的結果結合在一個通用資料表運算式內，來指定以 Contoso 樣本資料庫中簡化相機銷售資料為基礎的值。子類別目錄是數位相機、數位單眼反光式 (SLR) 相機、攝影機和相關配件。

在查詢設計工具的工具列上，選取 [執行]( ! ) 查看資料。

結果集包含 11 個資料列，這些資料列會顯示四間商店中每個子類別所銷售的項目數量，在下列資料行：StoreID、Subcategory、Quantity。儲存體名稱不是結果集的一部分。稍後在本教學課程中，您會利用個別資料集查詢對應於商店識別碼的商店名稱。

此查詢並不包含查詢參數。稍後可在本教學課程中加入參數。
選取 [下一步]。

2.在精靈中組織資料並選擇配置

此精靈提供用於顯示資料的起始設計。精靈中的預覽窗格可協助您在完成資料表或矩陣設計之前，先視覺化群組資料的結果。

將資料組織為群組

在 [排列欄位] 頁面上，將 [Subcategory] 拖曳至 [資料列群組]。
將 [StoreID] 拖曳至 [資料行群組]。
將 [Quantity] 拖曳至 [值]。

現在，您已經按照子類別目錄的分組，以資料列組織銷售量的值，即一個商店一個資料行。
選取 [下一步]。
在 [選擇配置] 頁面的 [選項] 下方，確定已選取 [顯示小計和總計]。

當您執行報表時，最後一個資料行將會顯示所有商店之每個子類別的總數量，而最後一個資料列則會顯示每家商店之所有子類別的總數量。
選取 [下一步] 。
選取完成。

矩陣會加入至設計介面。此矩陣會顯示 3 個資料行和 3 個資料列。第一個資料列的資料格內容為 Subcategory、StoreID 和 Total。第二個資料列的資料格內容包含多個運算式，分別表示子類別、每家商店所售出的項目數量以及所有商店之每個子類別的數量總計。最後一個資料列的資料格顯示每家商店的銷售總額。
選取矩陣內部，將滑鼠停留在第一個資料行的邊緣，抓取控點並且擴展資料行寬度。
選取 [執行] 預覽報表。

報表就會在報表伺服器上執行，並且顯示標題以及進行報表處理的時間。

Screenshot of the report preview run on the report server.

到目前為止，資料行標題會顯示商店識別碼，而非商店名稱。稍後，加入運算式，在包含商店識別碼/商店名稱組的資料集中，查詢商店名稱。

3.加入查詢參數來建立報表參數

當您將查詢參數加入至查詢時，報表產生器會自動建立一個單一值報表參數，其中包含名稱、提示與資料類型的預設屬性。

新增查詢參數

選取 [設計]，切換到 [設計] 檢視。
在 [報表資料] 窗格中，展開 [資料集] 資料夾，並以滑鼠右鍵按一下 [DataSet1]，然後選取 [查詢]。
新增下列 Transact-SQL WHERE 子句作為查詢中的最後一行：
```
WHERE StoreID = (@StoreID)  
```
WHERE 子句會將擷取的資料限制為查詢參數 @StoreID所指定的商店識別碼。
在查詢設計工具的工具列上，選取 [執行] (!)。 [定義查詢參數] 對話方塊隨即開啟，並且提示您輸入查詢參數 @StoreID的值。
在 [參數值] 中，輸入 200。
選取 [確定]。

結果集會針對商店識別碼 200顯示 Accessories、Camcorders 與 Digital SLR Cameras 售出的數量。
選取 [確定]。
在 [報表資料] 窗格中，展開 [參數] 資料夾。

現在已有名為 @StoreID 的報表參數，以及可配置報表參數的 [參數] 窗格。

Screenshot of the StodeID field in the Report Data pane.

看不到 [參數] 窗格嗎？在 [檢視] 功能表上，選取 [參數]。

4.變更報表參數的預設資料類型和其他屬性

在您建立報表參數之後，即可調整屬性的預設值。

變更報表參數的預設資料類型

根據預設，所建立參數的資料類型為 [文字]。因為商店識別碼是整數，所以您可以將資料類型變更為 Integer。

在 [報表資料] 窗格的 [參數] 節點下，並以滑鼠右鍵按一下 [@StoreID]，然後選取 [參數屬性]。
在 [提示] 中，輸入 [儲存識別碼？]。當您執行報表時，此文字會出現在報表檢視器工具列上。
在 [資料類型] 的下拉式清單中，選取 [整數] 。
接受對話方塊中其餘的預設值。
選取 [確定]。
選取 [執行] 預覽報表。報表檢視器會針對 @StoreID 顯示 [商店識別碼？] 提示。
在報表檢視器工具列上，就在 Store ID 旁，輸入 [200]，然後選取 [檢視報表]。

Screenshot of the report preview for Store ID 200.

4a. 加入資料集來提供可用值與顯示名稱

為了確保您的報表讀取器僅輸入有效的參數值，您可以建立列出多個值的下拉式清單，供使用者選擇。這些值可以取自資料集或是根據您另外指定的清單。可用的值必須透過資料集提供，且該資料集具有不含參數參考的查詢。

建立資料集以提供有效的參數值

選取 [設計]，切換到 [設計] 檢視。
在 [報表資料] 窗格中，以滑鼠右鍵按一下 [資料集] 資料夾，然後選取 [加入資料集]。
在 [名稱] 中，輸入 [商店]。
選取 [使用內嵌在我的報表中的資料集] 。
在 [資料來源] 中，從下拉式清單選擇您於第一個程序中使用的資料來源。
在 [查詢類型] 中，確認已選取 [文字] 。

在 [查詢] 中，貼上下列文字：

SELECT 200 AS StoreID, 'Contoso Catalog Store' as StoreName  
UNION SELECT 199 AS StoreID, 'Contoso North America Online Store' as StoreName  
UNION SELECT 307 AS StoreID, 'Contoso Asia Online Store' as StoreName  
UNION SELECT 306 AS StoreID, 'Contoso Europe Online Store' as StoreName

選取 [確定]。

[報表資料] 窗格會在 Stores 資料集節點下顯示 StoreID 和 StoreName 欄位。

4b. 指定要以清單顯示的可用值

建立資料集來提供可用的值之後，可以變更報表屬性，以指定要用於填入 [報表檢視器] 工具列中有效下拉式清單值的資料集與欄位。

從資料集提供可用的參數值

在 [報表資料] 窗格中，以滑鼠右鍵按一下參數 @StoreID，然後選取 [參數屬性]。
選取 [可用值] ，然後選取 [從查詢取得值]。
在 [資料集] 的下拉式清單中，選取 [商店]。
在 [值欄位] 的下拉式清單中，選取 [StoreID]。
從 [標籤欄位] 的下拉式清單中，選取 [StoreName]。標籤欄位會指定值的顯示名稱。
選取 [一般]。
在 [提示] 中，將 [商店識別碼？] 變更為 [商店名稱？]

報表讀取器現在會從商店名稱的清單中進行選取，而非從商店識別碼的清單中進行選取。請注意，參數資料類型仍為 [整數]，因為參數是根據商店識別項而不是商店名稱。
選取 [確定]。
預覽報表。

在報表檢視器工具列中，參數文字方塊現在是顯示 [選取一個值] 的下拉式清單。
從下拉式清單中選取 [Contoso Catalog Store]，然後選取 [檢視報表]。

報表會針對商店識別碼 200顯示 Accessories、Camcorders 與 Digital SLR Cameras 售出的數量。

4c. 指定預設值

您可以指定每一個參數的預設值，讓報表能夠自動執行。

從資料集指定預設值

切換至 [設計] 檢視。
在 [報表資料] 窗格中，以滑鼠右鍵按一下 @StoreID，然後選取 [參數屬性]。
選取 [預設值]，然後選取 [從查詢取得值]。
在 [資料集] 的下拉式清單中，選取 [商店]。
在 [值欄位] 的下拉式清單中，選取 [StoreID]。
選取 [確定]。
預覽報表。

對於 @StoreID，報表檢視器會顯示值 "Contoso North America Online Store"，原因是它來自 Stores資料集之結果集的第一個值。報表會針對商店識別碼 199顯示 Digital Cameras 售出的數量。

指定自訂預設值

切換至 [設計] 檢視。
在 [報表資料] 窗格中，以滑鼠右鍵按一下 @StoreID，然後選取 [參數屬性]。
選取 [預設值]>[指定值]>[新增]。新的值資料列隨即加入。
在 [值] 中，輸入 200。
選取 [確定]。
預覽報表。

若是 @StoreID，報表檢視器會顯示 "Contoso Catalog Store"，因為這是商店識別碼 200的顯示名稱。報表會針對商店識別碼 200顯示 Accessories、Camcorders 與 Digital SLR Cameras 售出的數量。

4d. 查閱名稱/值對

資料集可能同時包含識別碼與對應的名稱欄位。如果您只有識別碼，那麼可以查詢包含名稱/值組之資料集 (您先前建立) 中的對應名稱。

從資料集查詢值

切換至 [設計] 檢視。
在設計介面的矩陣中，即第一個資料列欄標題中，以滑鼠右鍵按一下 [StoreID]，然後選取 [運算式]。
在運算式窗格中，刪除所有文字，但是保留開頭的等號 (=)。
在 [類別] 中，展開 [一般功能] ，再選取 [其他]。 [項目] 窗格顯示函數集。
在 [項目] 中，按兩下 [查詢] 。運算式窗格會顯示 =Lookup(。 [範例] 窗格會示 Lookup 語法的範例。
輸入下列運算式：
```
=Lookup(Fields!StoreID.Value,Fields!StoreID.Value,Fields!StoreName.Value,"Stores")      
```
Lookup 函數會接受 StoreID 值並在 "Stores" 資料集中尋找該值，然後再傳回 StoreName 值。
選取 [確定]。

商店的資料行標題包含複雜運算式的顯示文字：Expr。
預覽報表。

每個資料行頂端的資料行標頭會顯示商店名稱，而非商店識別碼。

5.在報表中顯示選取的參數值

如果報表讀者對報表有任何疑問，這有助於明白先前選擇哪些參數值。您可以在報表中保留使用者為每一個參數所選取的值。其中一個方法是在頁尾的文字方塊中顯示參數。

切換至 [設計] 檢視。
以滑鼠右鍵按一下頁尾 > [插入]> [文字方塊]。將文字方塊拖曳到具有時間戳記的文字方塊中。抓取文字方塊的側邊控點，然後拉長寬度。
從 [報表資料] 窗格中，將 @StoreID 參數拖曳至文字方塊。此文字方塊便會顯示 [@StoreID]。
若要顯示參數標籤，請在文字輸入框中選取，直到插入游標出現在現有運算式之後為止。輸入空格，然後將參數的另一個拷貝從 [報表資料] 窗格拖曳至文字輸入框。此文字方塊便會顯示 [@StoreID] [@StoreID]。
以滑鼠右鍵按一下第一個 [@StoreID]，然後選取 [運算式]。 [運算式] 對話方塊隨即開啟。將文字 Value 取代為 Label。
選取 [確定]。

文字便會顯示 [@StoreID.Label] [@StoreID]。
預覽報表。

6.在篩選中使用報表參數

篩選有助於控制在自外部資料來源擷取報表後，要在其中使用哪些資料。若要讓報表讀者控制他們想要看到的資料，您可以在矩陣的篩選中包含報表參數。

在矩陣篩選中指定參數

切換至 [設計] 檢視。
以滑鼠右鍵按一下矩陣上的資料行標頭控制代碼，然後選取 [Tablix 屬性]。
選取 [篩選]，然後選擇 [新增]。新的篩選資料列隨即顯示。
在 [運算式] 的下拉式清單中，選取 StoreID 資料集欄位。資料類型會顯示 [整數] 。當運算式值為資料集欄位時，會自動設定資料類型。
在 [運算子] 中，確認已選取 [等號]\(=)。
在 [值] 中，輸入 [@StoreID]。

[@StoreID] 為表示 =Parameters!StoreID.Value的簡單運算式語法。
選取 [確定]。
預覽報表。

矩陣只會顯示 "Contoso Catalog Store" 的資料。
在報表檢視器工具列上，為 [Store name?] 選取 [Contoso Asia Online Store] ，然後選取 [檢視報表]。

矩陣會顯示對應於您所選商店的資料。

7.將報表參數變更為可以接受多個值

若要將參數由單一值變更為多重值，您必須變更查詢以及所有包含參數參考的所有運算式 (包含篩選)。多重值參數為值的陣列。在資料集查詢中，查詢語法必須經過測試，確認值組中包含一個值。在報表運算式中，運算式語法必須存取值的陣列，而不是單一值。

將參數由單一值變更為多重值

切換至 [設計] 檢視。
在 [報表資料] 窗格中，以滑鼠右鍵按一下 @StoreID，然後選取 [參數屬性]。
選取 [允許多個值] 。
選取 [確定]。
在 [報表資料] 窗格中，展開 [資料集] 資料夾，並以滑鼠右鍵按一下 [DataSet1]，然後選取 [查詢]。
在查詢最後一行的 Transact-SQL WHERE 子句中，將等號 (=) 變更為 IN：
```
WHERE StoreID IN (@StoreID)  
```
IN 運算子會測試一個值，確認已包含一組值。
選取 [確定]。
以滑鼠右鍵按一下矩陣上的資料行標頭控制代碼，然後選取 [Tablix 屬性]。
選取 [篩選條件]。
在 [運算子] 中，選取 [In] 。
選取 [確定]。
在顯示頁尾中參數的文字方塊中，刪除所有文字。
以滑鼠右鍵按一下文字輸入框，然後選取 [運算式]。輸入下列運算式：=Join(Parameters!StoreID.Label, ", ")

這個運算式會串聯使用者選取的所有商店名稱 (以逗號和空格分隔)。
選取 [確定]。
在您剛剛建立之運算式前面的文字輸入框上選取，然後輸入下列文字：

選取的參數值：
預覽報表。
選取 [Store Name?] 旁的下拉式清單

每一個有效值會顯示在核取方塊旁。
選取 [全選]，然後選擇 [檢視報表]。

報表會示所有商店中所有子類別的出售數量。
從下拉式清單中，選取 [全選] 清除清單，並選取 [Contoso Catalog Store] 與 [Contoso Asia Online Store]，然後選取 [檢視報表]。

8.加入可見度條件的布林參數

新增布林值參數

在設計介面的 [報表資料] 窗格中，以滑鼠右鍵按一下 [參數]，然後選取 [新增參數]。
在 [名稱] 中，輸入 [顯示選取]。
在 [提示] 中，輸入 [顯示選取？]
在[資料類型]中，選取[布林值]。
選取 [預設值]。
選取 [指定值]，然後選取 [新增]。
在 [值] 中，輸入 [False]。
選取 [確定]。

根據布林值參數設定可見性

在設計介面上，以滑鼠右鍵按一下頁尾中顯示參數值的文字輸入框，然後選取 [文字輸入框屬性]。
選取 [可見度]。
選取 [依據運算式顯示或隱藏] 選項，然後選取 [Fx]運算式按鈕。
輸入下列運算式：=Not Parameters!ShowSelections.Value

文字輸入框 [可見度] 選項會由 [Hidden] 屬性所控制。套用 [Not] 運算子，如此一來，當選取該參數時，Hidden 屬性會為 False，而且會顯示文字輸入框。
選取 [確定]。
選取 [確定]。
預覽報表。

頁尾中不會出現顯示參數選項的文字輸入框。
在報表檢視器工具列中，選取 [顯示選項] 旁邊的 [True]>[檢視報表]。

頁尾中顯示此文字方塊，以顯示您所選取的所有商店名稱。

9.加入報表標題

加入報表標題

切換至 [設計] 檢視。
在設計介面上，選取 [按一下以加入標題]。
輸入「參數化產品銷售」，然後選取文字輸入框外部。

10.儲存報表

將報表儲存在報表伺服器上

在 [報表產生器] 按鈕中，選取 [另存新檔]。
選取 [最近使用的網站和伺服器]。
選取或輸入您有權儲存報表之報表伺服器的名稱。

[連接到報表伺服器] 訊息隨即顯示。連接完成時，您就會看見報表伺服器管理員指定為預設報表位置之報表資料夾的內容。
在 [名稱] 中，將預設名稱取代為「參數化產品銷售」。
選取 [儲存]。

報表就會儲存至報表伺服器。您所連接的報表伺服器會顯示在視窗底部的狀態列中。

後續步驟

您已完成如何將參數新增至報表的教學課程。如需參數的詳細資訊，請參閱編頁報告參數 (報表產生器)。

教學課程：將參數新增至報表 (報表產生器)

需求