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

1. [スタート] ボタンをクリックし、[プログラム]、[Microsoft SQL Server 2008 R2 レポート ビルダー 3.0] の順にポイントして、[レポート ビルダー 3.0] をクリックします。

   [作業の開始] ダイアログ ボックスが表示されます。

   注
   [作業の開始] ダイアログ ボックスが表示されない場合は、[レポート ビルダー] ボタンの [新規作成] をクリックします。

2. 左ペインで、[レポート] が選択されていることを確認します。

3. 右ペインで、[テーブルまたはマトリックス ウィザード] をクリックします。

4. [作成] をクリックします。

5. [データセットの選択] ページで、[データセットを作成する] をクリックします。

6. [次へ] をクリックします。

7. [データ ソースへの接続の選択] ページで、種類が [SQL Server] のデータ ソースを選択します。一覧からデータ ソースを選択するか、レポート サーバーを参照してデータ ソースを選択します。

8. [次へ] をクリックします。

9. [クエリのデザイン] ページで、[テキストとして編集] をクリックします。

10. 次のクエリをクエリ ペインに貼り付けます。

    ;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 ステートメントの結果が共通テーブル式の中で結合されています。Contoso 売上データは、消費者向け商品の各国の売上データを表します。このチュートリアルでは、カメラの売上データを使用します。サブカテゴリは、デジタル カメラ、デジタル一眼レフ (SLR) カメラ、ビデオ カメラ、およびアクセサリを表します。

    クエリには、3 つの店舗の販売注文に関して、店舗 ID (StoreID)、商品のサブカテゴリ (Subcategory)、および注文数 (Quantity) を格納している列の名前が指定されています。このクエリでは、店舗名は結果セットに含まれません。このチュートリアルで後ほど、店舗 ID に対応する店舗の名前を別のデータセットから参照します。

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

11. クエリ デザイナーのツール バーで、[実行] (!) をクリックします。結果セットは StoreID 列、Subcategory 列、Quantity 列で構成され、4 店舗のサブカテゴリごとの販売済み商品数量を示す 11 行のデータが表示されます。

12. [次へ] をクリックします。

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

2. StoreID を [列グループ] にドラッグします。

3. Quantity を [値] にドラッグします。

   販売数量の値をサブカテゴリごとにグループ化された行に整理しました。店舗ごとに 1 列のデータが存在します。

4. [次へ] をクリックします。

5. [レイアウトの選択] ページの [オプション] で、[小計と総計を表示] が選択されていることを確認します。

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

6. [次へ] をクリックします。

7. [スタイルの選択] ページのスタイル ペインで、スタイルを選択します。

8. [完了] をクリックします。

   マトリックスがデザイン画面に追加されます。マトリックスは 3 行× 3 列で表示されます。先頭行のセルの内容は、Subcategory、[StoreID]、および Total です。2 番目の行のセルの内容は、サブカテゴリ、店舗ごとの販売品目の数量、および、すべての店舗のサブカテゴリごとの合計数量を表す式です。最後の行のセルには、店舗ごとの総計が表示されます。

9. マトリックス内をクリックし、最初の列の端にカーソルを合わせてハンドルをドラッグして、列の幅を拡張します。

10. [実行] をクリックして、レポートをプレビューします。

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

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

1. デザイン ビューに切り替えます。

2. レポート データ ペインで、[データセット] フォルダーを展開して DataSet1 を右クリックし、[クエリ] をクリックします。

3. クエリの最後の行に、次の Transact-SQLWHERE 句を追加します。

   WHERE StoreID = (@StoreID)
   

   この WHERE 句によって、取得されるデータが、クエリ パラメーター @StoreID で指定された店舗 ID に限定されます。

4. クエリ デザイナーのツール バーで、[実行] (!) をクリックします。[クエリ パラメーターの定義] ダイアログ ボックスが開き、クエリ パラメーター @StoreID の値を入力するように求められます。

5. [パラメーター値] に「200」と入力します。

6. [OK] をクリックします。

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

7. [OK] をクリックします。

8. レポート データ ペインで [パラメーター] フォルダーを展開します。

@StoreID というレポート パラメーターが存在することがわかります。パラメーターの既定のデータ型は [テキスト] です。店舗 ID は整数なので、次の手順でデータ型を [整数] に変更します。

1. レポート データ ペインの [パラメーター] ノードで、@StoreID を右クリックし、[パラメーターのプロパティ] をクリックします。

2. [プロンプト] に「Store identifier?」と入力します。レポートを実行すると、レポート ビューアーのツール バーにこのテキストが表示されます。

3. [データ型] のドロップダウン リストから [整数] を選択します。

4. このダイアログ ボックスのそれ以外の設定は、既定値のままにします。

5. [OK] をクリックします。

6. レポートをプレビューします。レポート ビューアーに @StoreID のプロンプトが表示されます。

7. レポート ビューアー ツール バーで、店舗 ID の横に「200」と入力し、[レポートの表示] をクリックします。

1. デザイン ビューに切り替えます。

2. レポート データ ペインで、[データセット] フォルダーを右クリックし、[データセットの追加] をクリックします。

3. [名前] に、「Stores」と入力します。

4. [レポートに埋め込まれたデータセットを使用します。] オプションを選択します。

5. [データ ソース] のドロップダウン リストから、最初の手順で作成したデータ ソースを選択します。

6. [クエリの種類] で [テキスト] が選択されていることを確認します。

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

   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
   

8. [OK] をクリックします。

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

1. レポート データ ペインでパラメーター @StoreID を右クリックし、[パラメーターのプロパティ] をクリックします。

2. [使用できる値] をクリックし、[クエリから値を取得] をクリックします。

3. [データセット] ボックスの一覧で Stores をクリックします。

4. [値フィールド] ボックスの一覧で [StoreID] をクリックします。

5. [ラベル フィールド] ボックスの一覧で [StoreName] をクリックします。ラベル フィールドによって値の表示名が指定されます。

6. [全般] をクリックします。

7. [プロンプト] に「Store name?」と入力します。

   これで、店舗 ID ではなく、店舗名の一覧からの選択ができるようになりました。ただし、パラメーターは店舗名ではなく店舗 ID に基づいているので、パラメーターのデータ型は [整数] のままです。

8. [OK] をクリックします。

9. レポートをプレビューします。

   レポート ビューアー ツール バーのパラメーター テキスト ボックスがドロップダウン リストに変わり、"<Select a Value>" と表示されるようになりました。

10. ドロップダウン リストから Contoso Catalog Store を選択し、[レポートの表示] をクリックします。

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

1. デザイン ビューに切り替えます。

2. レポート データ ペインで @StoreID を右クリックし、[パラメーターのプロパティ] をクリックします。

3. [既定値] をクリックし、[クエリから値を取得] をクリックします。

4. [データセット] ボックスの一覧で Stores をクリックします。

5. [値フィールド] ボックスの一覧で [StoreID] をクリックします。

6. [OK] をクリックします。

7. レポートをプレビューします。

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

1. デザイン ビューに切り替えます。

2. レポート データ ペインで @StoreID を右クリックし、[パラメーターのプロパティ] をクリックします。

3. [既定値] をクリックし、[値の指定] をクリックして、[追加] をクリックします。新しい値の行が追加されます。

4. [値] に「200」と入力します。

5. [OK] をクリックします。

6. レポートをプレビューします。

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

1. デザイン ビューに切り替えます。

2. デザイン画面のマトリックスの先頭行の列見出しで、[StoreID] を右クリックし、[式] をクリックします。

3. 式ペインで、先頭の equals (=) を除くすべてのテキストを削除します。

4. [カテゴリ] で、[共通の関数] を展開して [その他] をクリックします。アイテム ペインに関数セットが表示されます。

5. [アイテム] で、[参照] をダブルクリックします。式ペインに "=Lookup(" と表示されます。サンプル ペインに Lookup 構文の例が表示されます。

6. 式「=Lookup(Fields!StoreID.Value,Fields!StoreID.Value,Fields!StoreName.Value,"Stores")」を入力します。

   Lookup 関数は、StoreID の値を受け取って Stores データセットを検索して、StoreName の値を返します。

7. [OK] をクリックします。

   店舗の列見出しに、複合式の表示テキスト "<<Expr>>" が示されます。

8. レポートをプレビューします。

各ページの上部にあるテキスト ボックスに、店舗 ID ではなく店舗名が表示されます。

1. デザイン ビューに切り替えます。

2. ページ フッターを右クリックし、[挿入] をポイントして、[テキスト ボッス] をクリックします。タイムスタンプを示すテキスト ボックスの横にテキスト ボックスをドラッグします。テキスト ボックスの側面にあるハンドルをクリックしてドラッグすることにより、幅を拡張します。

3. レポート データ ペインからテキスト ボックスに @StoreID パラメーターをドラッグします。テキスト ボックスに "[@StoreID]" と表示されます。

4. パラメーターのラベルを表示するには、既存の式の後ろに挿入カーソルが表示されるまでテキスト ボックスをクリックし、空白を入力した後、レポート データ ペインからテキスト ボックスにもう一度パラメーターをドラッグします。テキスト ボックスに "[@StoreID] [@StoreID]" と表示されます。

5. 1 つ目の式を右クリックし、[式] をクリックします。[式] ダイアログ ボックスが表示されます。「Value」を「Label」に置き換えます。

6. [OK] をクリックします。

   "[@StoreID.Label] [@StoreID]" というテキストが表示されます。

7. レポートをプレビューします。

1. デザイン ビューに切り替えます。

2. マトリックス上の行ヘッダーまたは列ヘッダーのハンドルを右クリックし、[Tablix のプロパティ] をクリックします。

3. [フィルター] をクリックして、[追加] をクリックします。新しいフィルター行が表示されます。

4. [式] ボックスの一覧からデータセット フィールドの StoreID を選択します。データ型に [整数] が表示されます。式の値がデータセット フィールドの場合、データ型は自動的に設定されます。

5. [演算子] で equals (=) が選択されていることを確認します。

6. [値] に「[@StoreID]」と入力します。[@StoreID] は、=Parameters!StoreID.Value を表す単純な式の構文です。

7. [OK] をクリックします。

8. レポートをプレビューします。

   マトリックスに、"Contoso Catalog Store" のデータのみが表示されます。

9. レポート ビューアー ツール バーで、"Store name?" に対して Contoso Asia Online Store を選択し、[レポートの表示] をクリックします。

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

1. デザイン ビューに切り替えます。

2. レポート データ ペインで @StoreID を右クリックし、[パラメーターのプロパティ] をクリックします。

3. [複数の値を許可] を選択します。

4. [OK] をクリックします。

5. レポート データ ペインで、[データセット] フォルダーを展開して DataSet1 を右クリックし、[クエリ] をクリックします。

6. クエリの最後の行にある Transact-SQLWHERE 句で、equals (=) を IN に変更します。

   WHERE StoreID IN (@StoreID)
   

   IN 演算子によって、値が一連の値に含まれているかどうかがテストされます。

7. [OK] をクリックします。

8. マトリックス上の行ヘッダーまたは列ヘッダーのハンドルを右クリックし、[Tablix のプロパティ] をクリックします。

9. [フィルター] をクリックします。

10. [演算子] で [次に含まれる] を選択します。

11. [OK] をクリックします。

12. ページ フッターのパラメーターを表示するテキスト ボックスで、すべてのテキストを削除します。

13. テキスト ボックスを右クリックして、[式] をクリックします。式「=Join(Parameters!StoreID.Label, ", ")」を入力します。

    この式は、ユーザーが選択したすべての店舗名を連結します。

14. [OK] をクリックします。

15. 作成した式の前にあるテキスト ボックス内をクリックして、「Parameter Values Selected:」と入力します。

16. レポートをプレビューします。

17. "Store Name?" の横にあるドロップダウン リストをクリックします。

    有効な各値がチェック ボックスの横に表示されます。

18. [すべて選択] をクリックして、[レポートの表示] をクリックします。

    レポートに、全店舗のすべてのサブカテゴリの販売数量が表示されます。

19. ドロップダウン リストで [すべて選択] をクリックして一覧を消去し、"Contoso Catalog Store" と "Contoso Asia Online Store" をクリックして [レポートの表示] をクリックします。

1. デザイン画面のレポート データ ペインで [パラメーター] を右クリックし、[パラメーターの追加] をクリックします。

2. [名前] に「ShowSelections」と入力します。

3. [プロンプト] に「Show selections?」と入力します。

4. [データ型] のドロップダウン リストで [ブール] をクリックします。

5. [既定値] をクリックします。

6. [値の指定] をクリックして、[追加] をクリックします。

7. [値] に「False」と入力します。

8. [OK] をクリックします。

1. デザイン画面で、ページ フッターのパラメーター値を表示するテキスト ボックスを右クリックし、[テキスト ボックスのプロパティ] をクリックします。

2. [表示] をクリックします。

3. [式を基に表示/非表示を切り替える] オプションを選択し、式ボタン ([Fx]) をクリックします。

4. 式「=Not Parameters!ShowSelections.Value」を入力します。

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

5. [OK] をクリックします。

6. [OK] をクリックします。

7. レポートをプレビューします。

   パラメーターの選択肢を表示するテキスト ボックスが表示されません。

8. レポート ビューアー ツール バーで、"Show selections" の横の [True] をクリックします。

9. レポートをプレビューします。

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

1. デザイン画面で、[クリックしてタイトルを追加] をクリックします。

2. 「Parameterized Product Sales」と入力し、テキスト ボックスの外側をクリックします。

1. レポート ビルダーのボタンの [名前を付けて保存] をクリックします。

2. [最近使ったサイトとサーバー] をクリックします。

3. レポートを保存する権限があるレポート サーバーの名前を入力するか選択します。

   "レポート サーバーに接続しています" というメッセージが表示されます。接続が完了すると、レポート サーバー管理者がレポートの既定の場所として指定したレポート フォルダーのコンテンツが表示されます。

4. [名前] に表示されている既定の名前を「Parameterized Sales Report」に変更します。

5. [保存] をクリックします。

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