チュートリアル:レポートへのパラメータの追加 (Report Builder)

[アーティクル]
01/19/2024

このチュートリアルでは、Reporting Services のページ分割されたレポートにパラメーターを追加し、レポート閲覧者が 1 つまたは複数の値でレポートデータをフィルター処理できるようにします。

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

レポートパラメーターは、データセットクエリに追加したクエリパラメーターごとに自動で作成されます。パラメーターのデータ型により、パラメーターがレポートビューアーツールバーに表示される方法が決まります。

Note

このチュートリアルでは、ウィザードに関する複数の手順を 1 つにまとめて示します。レポートサーバーの参照、データソースの選択、データセットの作成に関する詳細な手順については、このシリーズの最初のチュートリアル (「チュートリアル: 基本的な表レポートの作成 (Report Builder)」) を参照してください。

このチュートリアルの推定所要時間:25 分。

必要条件

要件の詳細については、「チュートリアルの前提条件 (Report Builder)」を参照してください。

1. テーブルまたはマトリックスウィザードでマトリックスレポートとデータセットを作成する

マトリックスレポート、データソース、およびデータセットを作成します。

Note

このチュートリアルのクエリにはデータ値が含まれているため、外部データソースを必要としません。このため、クエリが非常に長くなっています。ビジネス環境では、クエリにデータは含まれません。これは、学習に使用することのみを目的としています。

新しいマトリックスレポートを作成する

コンピューター、Web ポータル、SharePoint 統合モードのいずれかからレポートビルダーを起動します Reporting Services 。

[新しいレポートまたはデータセット] ダイアログボックスが開きます。

[新しいレポートまたはデータセット] ダイアログボックスが表示されない場合、[ファイル] メニュー >[新規作成] を選択します。
左ペインで、 [新しいレポート] が選択されていることを確認します。
右ペインで、 [テーブルまたはマトリックスウィザード] をクリックします。
[データセットの選択] ページで、 [データセットを作成する]>[次へ] の順に選択します。
[データソースへの接続の選択] ページで、既存のデータソースを選択するか、レポートサーバーを参照して選択します。種類が 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

Contoso サンプルデータベースから抜粋した単純化されたカメラの販売データを使って値を指定する関係上、このクエリでは、複数の Transact-SQL SELECT ステートメントの結果が共通テーブル式の中で結合されています。サブカテゴリは、デジタルカメラ、デジタル一眼レフ (SLR) カメラ、ビデオカメラ、およびアクセサリです。

クエリデザイナーのツールバーで、[実行 (!)] を選択してデータを表示します。

結果セットは、11 のデータ行で構成されており、4 ストアそれぞれの下位カテゴリに関するアイテム数量が以下の列に表示されます: StoreID、Subcategory、Quantity ストア名は結果セットの一部ではありません。このチュートリアルで後ほど、店舗 ID に対応する店舗の名前を別のデータセットから参照します。

このクエリには、クエリパラメーターは存在しません。以降、このチュートリアルの中でクエリパラメーターを追加していきます。
[次へ] を選択します。

2. ウィザードでデータを整理し、レイアウトを選択する

ウィザードは、データを表示するための最初のデザインを提供します。ウィザードのプレビューペインでは、テーブルやマトリックスのデザインを完了する前にデータのグループ化の結果を表示できます。

データをグループにまとめる

[フィールドの配置] ページで、Subcategory を [行グループ] にドラッグします。
StoreID を [列グループ] にドラッグします。
Quantity を [値] にドラッグします。

販売数量の値を、店舗ごとに 1 つの列で、サブカテゴリごとにグループ化された行に整理しました。
[次へ] を選択します。
[レイアウトの選択] ページの [オプション] で、 [小計と総計を表示] が選択されていることを確認します。

レポートを実行すると、最後の列にはすべての店舗のサブカテゴリごとの合計数量が表示され、最後の行には店舗ごとのすべてのサブカテゴリの合計数量が表示されます。
[次へ] を選択します。
[完了] を選択します。

マトリックスがデザイン画面に追加されます。マトリックスは 3 行× 3 列で表示されます。先頭行のセルの内容は、Subcategory、[StoreID]、および Total です。 2 番目の行のセルの内容は、サブカテゴリ、店舗ごとの販売品目の数量、および、すべての店舗のサブカテゴリごとの合計数量を表す式です。最後の行のセルには、店舗ごとの総計が表示されます。
マトリックス内を選択し、最初の列の端にカーソルを合わせてハンドルをドラッグして、列の幅を拡張します。
[実行] を選択してレポートをプレビューします。

レポートサーバーでレポートが実行され、タイトルとレポートの処理時刻がレポートに表示されます。

Screenshot of the report preview run on the report server.

ここでは、列見出しに店舗 ID は表示されますが店舗名は表示されません。後ほど、店舗 ID と店舗名のペアが格納されているデータセットで店舗名を参照する式を追加します。

3. クエリパラメーターを追加してレポートパラメーターを作成する

クエリパラメーターをクエリに対して追加すると、名前、プロンプト、およびデータ型に既定のプロパティを持つ単一値のレポートパラメーターがレポートビルダーによって自動的に作成されます。

クエリパラメーターを追加する

‭デザインビューに切り替えるには、[デザイン] を選択します。
レポートデータペインで、[データセット] フォルダーを展開して DataSet1を右クリックし、[クエリ] を選択します。
クエリの最後の行に、次の Transact-SQL WHERE 句を追加します。
```
WHERE StoreID = (@StoreID)  
```
この WHERE 句によって、取得されるデータが、クエリパラメーター @StoreIDで指定された店舗 ID に限定されます。
クエリデザイナーのツールバーで、[実行 (!)] を選択します。 [クエリパラメーターの定義] ダイアログボックスが開き、クエリパラメーター @StoreIDの値を入力するように求められます。
[パラメーター値] に「200」と入力します。
[OK] を選択します。

結果セットには、店舗 ID 200について、Accessories、Camcorders、および Digital SLR Cameras の販売数量が表示されます。
[OK] を選択します。
レポートデータペインで [パラメーター] フォルダーを展開します。

@StoreID というレポートパラメーターと、レポートパラメーターをレイアウトできるパラメーターペインが存在することがわかります。

Screenshot of the StodeID field in the Report Data pane.

パラメーターペインが表示されない場合は、 [表示] メニューの [パラメーター] をクリックします。

4. レポートパラメーターの既定のデータ型とその他のプロパティを変更する

プロパティの既定値は、レポートパラメーターの作成後に調整することができます。

レポートパラメーターの既定のデータ型を変更する

既定では、作成したパラメーターのデータ型は [テキスト] です。店舗 ID は整数なので、データ型を [整数] に変更します。

レポートデータペインの [パラメーター] ノードで、@StoreIDを右クリックし、[パラメーターのプロパティ]を選択します。
[プロンプト] で、「Store identifier?」と入力します。レポートを実行すると、レポートビューアーのツールバーにこのテキストが表示されます。
[データ型] のドロップダウンリストから [整数] を選択します。
このダイアログボックスのそれ以外の設定は、既定値のままにします。
[OK] を選択します。
[実行] を選択してレポートをプレビューします。レポートビューアーには、 @StoreID の入力を求めるプロンプト Store Identifier?が表示されます。
レポートビューアーのツールバーで、店舗 ID の横に「200」と入力し、[レポートの表示] を選択します。

Screenshot of the report preview for Store ID 200.

4a. 使用可能な値と表示名を持つデータセットを追加する

レポート閲覧者がパラメーターの有効な値しか入力できないようにするには、選択可能な値のドロップダウンリストを作成します。値は、データセットまたは指定した一覧から取得できます。使用可能な値は、パラメーターへの参照を含まないクエリが格納されているデータセットから指定する必要があります。

パラメーターの有効な値のデータセットを作成する

デザインビューに切り替えるには、[デザイン] を選択します。
レポートデータペインで、[データセット] フォルダーを右クリックし、[データセットの追加] を選択します。
[名前] に「Stores」と入力します。
[レポートに埋め込まれたデータセットを使用します] を選択します。
[データソース] のドロップダウンリストから、最初の手順で使用したデータソースを選択します。
[クエリの種類] で [テキスト] が選択されていることを確認します。

[クエリ] に、次のテキストを貼り付けます。

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

[OK] を選択します。

レポートデータペインの Stores データセットノードに、StoreID フィールドと StoreName フィールドが表示されます。

4b. 一覧に表示される使用可能な値を指定する

使用できる値のソースとなるデータセットを作成したら、レポートのプロパティで、レポートビューアーツールバーの有効な値のドロップダウンリストに値を設定するために使用するデータセットとフィールドを指定します。

パラメーターに使用できる値をデータセットから提供する

レポートデータペインでパラメーター @StoreIDを右クリックし、[パラメーターのプロパティ]を選択します。
[使用できる値] を選択し、[クエリから値を取得] を選択します。
[データセット] ドロップダウンリストで [Stores] を選択します。
[値フィールド] ドロップダウンリストで [StoreID] を選択します。
[ラベルフィールド] ドロップダウンリストで [StoreName] を選択します。ラベルフィールドによって値の表示名が指定されます。
全般を選択します。
[プロンプト] で、「Store Identifer?」を「Store name?」に変更します。

これで、レポート閲覧者は、店舗 ID ではなく、店舗名の一覧から選択できるようになりました。パラメーターは店舗名ではなく店舗 ID に基づいているので、パラメーターのデータ型は [整数] のままです。
[OK] を選択します。
レポートをプレビューします。

レポートビューアーツールバーのパラメーターテキストボックスがドロップダウンリストに変わり、" 値を選択してください" と表示されるようになりました。
ドロップダウンリストから Contoso Catalog Store を選択し、[レポートの表示] を選択します。

レポートには、店舗 ID 200について、Accessories、Camcorders、および Digital SLR Cameras の販売数量が表示されます。

4c. 既定値を指定する

各パラメーターの既定値を指定して、レポートが自動的に実行されるようにすることができます。

データセットから既定値を指定する

デザインビューに切り替えます。
レポートデータペインで @StoreIDを右クリックし、[パラメーターのプロパティ]を選択します。
[既定値] を選択し、[クエリから値を取得] を選択します。
[データセット] ドロップダウンリストで [Stores] を選択します。
[値フィールド] ドロップダウンリストで [StoreID] を選択します。
[OK] を選択します。
レポートをプレビューします。

レポートビューアーに、"Contoso North America Online Store" が @StoreID の値として表示されます。この値が、データセット Storesの結果セットの最初の値であるためです。レポートには、店舗 ID 199について、Digital Cameras の販売数量が表示されます。

カスタムの既定値を指定する

デザインビューに切り替えます。
レポートデータペインで @StoreIDを右クリックしたら、[パラメーターのプロパティ]を選択します。
[既定値]>[値を指定]>[追加] を選択します。新しい値の行が追加されます。
[値] に、「200」と入力します。
[OK] を選択します。
レポートをプレビューします。

レポートビューアーに、"Contoso Catalog Store" が @StoreIDの値として表示されます。この値が、店舗 ID 200の表示名であるためです。レポートには、店舗 ID 200について、Accessories、Camcorders、および Digital SLR Cameras の販売数量が表示されます。

4d. 名前と値の組を参照する

データセットには、ID と対応する名前フィールドの両方が含まれている場合があります。 ID しかない場合は、名前と値のペアが格納されている作成済みのデータセットで対応する名前を参照できます。

データセットから値を参照する

デザインビューに切り替えます。
デザインサーフェイスのマトリックスの先頭行の列ヘッダーで、[StoreID] を右クリックし、[式] を選択します。
式ペインで、先頭の等号 (=) を除くすべてのテキストを削除します。
[カテゴリ] で、[共通の関数] を展開して [その他] を選択します。アイテムペインに関数セットが表示されます。
[アイテム] で、 [参照] をダブルクリックします。式ペインに " =Lookup(" と表示されます。サンプルペインに Lookup 構文の例が表示されます。
次の式を入力します。
```
=Lookup(Fields!StoreID.Value,Fields!StoreID.Value,Fields!StoreName.Value,"Stores")      
```
Lookup 関数は、StoreID の値を受け取って Stores データセットを検索して、StoreName の値を返します。
[OK] を選択します。

店舗の列見出しに、複合式の表示テキストとして次が示されます:Expr。
レポートをプレビューします。

各列の上部にある列ヘッダーに、店舗 ID ではなく店舗名が表示されます。

5. 選択されたパラメーターの値をレポートに表示する

レポート閲覧者がレポートの詳細を確認する場合に、選択したパラメーターの値がわかるようにすることができます。レポートのパラメーターごとにユーザーが選択した値を保持できます。そのための方法の 1 つとして、ページフッターのテキストボックスにパラメーターを表示する方法があります。

デザインビューに切り替えます。
ページフッターの >[挿入]>[テキストボックス] で右クリックします。タイムスタンプを示すテキストボックスの横にテキストボックスをドラッグします。テキストボックスの側面にあるハンドルをクリックしてドラッグすることにより、幅を拡張します。
レポートデータペインからテキストボックスに @StoreID パラメーターをドラッグします。テキストボックスに " [@StoreID]" と表示されます。
パラメーターラベルを表示するには、挿入カーソルが既存の式の後に表示されるまで、テキストボックス内で選択します。スペースを入力し、[レポートデータ] ペインからテキストボックスにパラメーターの別のコピーをドラッグします。テキストボックスに " [@StoreID] [@StoreID]" と表示されます。
1 つ目の [@StoreID] を右クリックし、[式] を選択します。 [式] ダイアログボックスが表示されます。 Value を Labelに置き換えます。
[OK] を選択します。

テキストボックスに " [@StoreID.Label] [@StoreID]" と表示されます。
レポートをプレビューします。

6. フィルターにレポートパラメーターを使用する

フィルターを使用すると、外部データソースから取得されたデータのうちどのデータをレポートで使用するかを制御できます。表示するデータをレポート閲覧者が制御できるようにするには、マトリックスのフィルターにレポートパラメーターを含めます。

マトリックスフィルターにパラメーターを指定する

デザインビューに切り替えます。
マトリックス上の行ヘッダーまたは列ヘッダーのハンドルを右クリックし、[Tablix のプロパティ] を選択します。
[フィルター] を選択後、[追加] を選択します。新しいフィルター行が表示されます。
[式] ドロップダウンリストからデータセットフィールドの StoreID を選択します。データ型に [整数] が表示されます。式の値がデータセットフィールドの場合、データ型は自動的に設定されます。
[演算子] で等号 (=) が選択されていることを確認します。
[値] に [@StoreID] と入力します。

[@StoreID] は、 =Parameters!StoreID.Valueを表す単純な式の構文です。
[OK] を選択します。
レポートをプレビューします。

マトリックスに、"Contoso Catalog Store" のデータのみが表示されます。
レポートビューアーツールバーで、Store name? に対して [Contoso Asia Online Store]を選択し、[レポートの表示] を選択します。

マトリックスに、選択した店舗に対応するデータが表示されます。

7. レポートパラメーターを複数値をとるように変更する

パラメーターを単一値ではなく複数値を持つように変更するには、クエリと、フィルターなどのパラメーターへの参照を含むすべての式を変更する必要があります。複数値パラメーターは値の配列です。データセットクエリでは、クエリ構文で 1 つの値が一連の値に含まれているかどうかをテストする必要があります。レポート式では、式の構文が個々の値ではなく値の配列にアクセスする必要があります。

パラメーターを単一値ではなく複数値をとるように変更する

デザインビューに切り替えます。
レポートデータペインで @StoreIDを右クリックしたら、[パラメーターのプロパティ]を選択します。
[複数の値を許可] を選択します。
[OK] を選択します。
レポートデータペインで、[データセット] フォルダーを展開して DataSet1を右クリックし、[クエリ] を選択します。
クエリの最後の行で、等号 (=) を Transact-SQL WHERE 句の IN に変更します。
```
WHERE StoreID IN (@StoreID)  
```
IN 演算子によって、値が一連の値に含まれているかどうかがテストされます。
[OK] を選択します。
マトリックス上の行ヘッダーまたは列ヘッダーのハンドルを右クリックし、[Tablix のプロパティ] を選択します。
[フィルター] を選びます。
[演算子] で [次に含まれる] を選択します。
[OK] を選択します。
ページフッターのパラメーターを表示するテキストボックスで、すべてのテキストを削除します。
テキストボックスを右クリックして、[式] を選択します。式 =Join(Parameters!StoreID.Label, ", ") を入力します。

この式は、ユーザーが選択したすべての店舗名を、コンマとスペースで区切って連結します。
[OK] を選択します。
作成した式の前にあるテキストボックス内を選択して、以下のテキストを入力します。

「Parameter Values Selected:」と入力します。
レポートをプレビューします。
"Store Name?" の横にあるドロップダウンリストを選択します。

有効な各値がチェックボックスの横に表示されます。
[すべて選択] を選択し、[レポートの表示] を選択します。

レポートに、全店舗のすべてのサブカテゴリの販売数量が表示されます。
ドロップダウンリストで [すべて選択] を選択して一覧を消去し、"Contoso Catalog Store" と "Contoso Asia Online Store" を選択して [レポートの表示]を選択します。

8. 条件付き表示のためにブール値パラメーターを追加する

ブール値パラメーターを追加するには

デザインサーフェイスのレポートデータペインで [パラメーター] を右クリックし、[パラメーターの追加] を選択します。
[名前] に「ShowSelections」と入力します。
[プロンプト] で、「Show selections?」と入力します。
[データ型] には、ブール値を選択します。
[既定値] を選択します。
[値の指定] を選択し、[追加] を選択します。
[値] に、「False」と入力します。
[OK] を選択します。

ブール値パラメーターに基づいて表示を設定するには

デザインサーフェイスで、ページフッターのパラメーター値を表示するテキストボックスを右クリックし、[テキストボックスのプロパティ] を選択します。
[表示] を選びます。
[式を基に表示/非表示を切り替える] オプションを選択し、式ボタン ( [Fx] ) を選択します。
式 =Not Parameters!ShowSelections.Value を入力します。

テキストボックスの [表示] オプションは、[非表示] プロパティによって制御されます。 Not 演算子を適用すると、パラメーターが選択されたときに、[非表示] プロパティが false になり、テキストボックスが表示されます。
[OK] を選択します。
[OK] を選択します。
レポートをプレビューします。

パラメーターの選択肢を表示するテキストボックスがフッターに表示されません。
レポートビューアーツールバーで、" Show selections" の横の [True]>[レポートの表示] を選択します。

ページフッターにテキストボックスが表示され、選択したすべての店舗名が示されます。

9. レポートタイトルを追加する

レポートタイトルの追加

デザインビューに切り替えます。
デザインサーフェイスで、[選択してタイトルを追加] を選択します。
「Parameterized Product Sales」と入力し、テキストボックスの外側を選択します。

10. レポートを保存する

レポートサーバーにレポートを保存する

レポートビルダー ボタンで、[名前を付けて保存] を選びます。
[最近使ったサイトとサーバー] を選択します。
レポートを保存する権限があるレポートサーバーの名前を入力するか選択します。

" レポートサーバーに接続しています" というメッセージが表示されます。接続が完了すると、レポートサーバー管理者がレポートの既定の場所として指定したレポートフォルダーのコンテンツが表示されます。
[名前] に表示されている既定の名前を Parameterized Sales Report に変更します。
[保存] を選択します。

レポートがレポートサーバーに保存されます。接続しているレポートサーバーがウィンドウ下部のステータスバーに表示されます。

次のステップ

レポートにパラメーターを追加する方法のチュートリアルはこれで終了です。レポートパラメーターの詳細については、「ページ分割されたレポートのパラメーターを作成する (Report Builder)」を参照してください。

チュートリアル:レポートへのパラメータの追加 (Report Builder)

必要条件