合計、集計、および組み込みコレクションの式のスコープ (レポートビルダーおよび SSRS)

[アーティクル]
09/10/2013

式の作成に関して、"スコープ" という用語は、さまざまな文脈で用いられています。スコープは、式を評価するのに使用するデータ、表示されたページのテキストボックスのセット、または表示と非表示を切り替えることのできるレポートアイテムのセットを示します。スコープという用語は、式の評価、集計関数の構文、条件付き表示に関連したトピックと、これらの領域に関連したエラーメッセージで使用されます。次の説明を参考にして、どの意味でスコープが適用されているかを区別してください。

データスコープ データスコープは、レポートプロセッサがレポートデータとレポートレイアウトを組み合わせ、テーブルやグラフなどのデータを表示するデータ領域を作成する場合に使用するスコープの階層です。データスコープを理解することで、次のような操作を行う場合に目的の結果を得ることができます。
- 集計関数を使用する式を作成する 集計するデータを示します。レポート内の式の場所は、集計計算のスコープに含まれるデータに影響します。
- テーブルまたはマトリックスにスパークラインを追加する グラフの軸の範囲の最小値と最大値を示し、テーブルまたはマトリックスの入れ子になったインスタンスを揃えます。
- テーブルまたはマトリックスにインジケーターを追加する ゲージのスケールの最小値と最大値を示し、テーブルまたはマトリックスの入れ子になったインスタンスを揃えます。
- 並べ替え式を作成する 複数の関連レポートアイテムの並べ替え順序を同期するために使用できるコンテナースコープを示します。
セルスコープ セルスコープは、セルが属する Tablix データ領域内の行グループと列グループのセットです。各 Tablix セルには、既定でテキストボックスが含まれます。テキストボックスの値は式です。セルの場所によって、式の集計計算に指定できるデータスコープが決まります。
レポートアイテムのスコープ レポートアイテムのスコープは、表示されたレポートページのアイテムのコレクションを表します。レポートプロセッサは、データとレポートレイアウト要素を組み合わせ、コンパイル済みのレポート定義を生成します。この処理中に、テーブルやマトリックスなどのデータ領域は、レポートデータをすべて表示するように必要に応じて拡張されます。次にコンパイル済みレポートがレポートレンダラーによって処理されます。レポートレンダラーによって、各ページに表示されるレポートアイテムが決まります。レポートサーバーでは、各ページは表示する操作に応じて表示されます。レポートをエクスポートする場合は、すべてのページが表示されます。レポートアイテムスコープを理解することで、次のような操作を行う場合に目的の結果を得ることができます。
- 切り替えアイテムを追加する レポートアイテムの表示を制御する切り替えを追加するためのテキストボックスを示します。切り替えは、切り替えるレポートアイテムのスコープ内にあるテキストボックスにのみ追加できます。
- ページヘッダーおよびページフッターに式を作成する 表示されたページ上のテキストボックスまたは他のレポートアイテムで使用できる式の値を示します。

スコープを理解することで、式を正しく作成し、目的の結果を得ることができます。

注
SQL Server データツールのレポートビルダーまたはレポートデザイナーを使用して、レポート定義 (.rdl) を作成および変更できます。これらの作成環境では、レポートおよび関連アイテムの作成方法、開く方法、および保存方法が異なります。詳細については、microsoft.com Web サイトの「レポートデザイナーおよびレポートビルダーを使用したレポートのデザイン (SSRS)」を参照してください。

SQL Server データツールのレポートビルダーまたはレポートデザイナーを使用して、レポート定義 (.rdl) を作成および変更できます。これらの作成環境では、レポートおよび関連アイテムの作成方法、開く方法、および保存方法が異なります。詳細については、microsoft.com Web サイトの「レポートデザイナーおよびレポートビルダーを使用したレポートのデザイン (SSRS)」を参照してください。

この記事の内容

データスコープ、データ階層、および式について

集計関数のスコープの指定

テーブルデータ領域の集計式の例

スパークラインのスケールの同期

インジケーターの範囲の同期

ページヘッダーまたはページフッターのスコープの指定

ドリルダウンと条件付き表示の切り替えアイテムの指定

並べ替え順序を同期する並べ替え式の指定

NULL 値または 0 の非表示

データスコープとデータ階層について

データスコープは、レポートデータのセットを示します。データスコープには、固有の包含関係を持つ自然階層が存在します。階層の上位のスコープには、下位の階層のスコープが含まれます。次のデータスコープの一覧では、最もデータの多いものから順に階層について説明します。

データセットフィルターが適用された後のデータセット データ領域、またはレポート本文内のレポートアイテムにリンクされたレポートデータセットを示します。集計には、データセットのフィルター式が適用された後の、レポートデータセットのデータが使用されます。つまり、共有データセットの場合は、共有データセットの定義内のフィルターとレポート内の共有データセットのインスタンス内のフィルターの両方になります。
データ領域 データ領域のフィルター式および並べ替え式が適用された後のデータ領域のデータを示します。データ領域の集計を計算する際にはグループフィルターが使用されません。
グループフィルターが適用された後のデータ領域のグループ 親グループと子グループにグループ式およびグループフィルターが適用された後のデータを示します。テーブルの場合は、行グループと列グループになります。グラフの場合は、系列グループとカテゴリグループになります。スコープの包含関係を明確にするため、各親グループにはその子グループが含まれています。
入れ子になったデータ領域 入れ子になったデータ領域が追加されたセルのコンテキストで、入れ子になったデータ領域のフィルター式と並べ替え式が適用された後の、そのデータ領域のデータを示します。
入れ子になったデータ領域の行グループと列グループ 入れ子になったデータ領域のグループ式とグループフィルターが適用された後のデータを示します。

コンテナースコープと包含されるスコープを理解しておくことは、集計関数を含んだ式を作成する場合に重要です。

セルスコープと式

スコープを指定すると、集計計算に使用するデータがレポートプロセッサに対して示されます。式と式の場所に応じて、有効なスコープはコンテナースコープ (親スコープとも呼ばれます) または包含されるスコープ (子または入れ子になったスコープとも呼ばれます) になります。一般に、集計計算では個々のグループインスタンスを指定することはできません。すべてのグループインスタンスの集計は指定できます。

レポートプロセッサはレポートデータセットのデータと Tablix データ領域を組み合わせ、グループ式を評価し、グループインスタンスを表すのに必要な行と列を作成します。各 Tablix セル内のテキストボックスにある式の値は、セルスコープのコンテキストで評価されます。 Tablix の構造によっては、セルは複数の行グループおよび列グループに属することができます。集計関数では、以下のいずれかのスコープを使用して、使用するスコープを指定できます。

既定のスコープ レポートプロセッサが式を評価する場合に計算のスコープ内にあるデータ。そのセルまたはデータポイントが属している最も内側のグループセットが既定のスコープとなります。 Tablix データ領域では、行グループと列グループをセットに含めることができます。グラフデータ領域の場合は、カテゴリグループと系列グループにセットを含めることができます。
名前付きスコープ 式のスコープ内にあるデータセット、データ領域、またはデータ領域グループの名前。集計計算では、コンテナースコープを指定できます。行グループと列グループの両方の名前付きスコープを 1 つの式で指定することはできません。式が集計の集計に使用される場合を除き、包含されたスコープを指定することはできません。
ドメインスコープ 同期スコープとも呼ばれます。入れ子になったデータ領域の式の評価に適用されるデータスコープの種類。ドメインスコープはすべてのグループインスタンスの集計を示すのに使用されるため、入れ子になったインスタンスを揃えて簡単に比較できます。たとえば、値を並べるには、テーブルに埋め込まれたスパークラインの範囲と高さを揃えます。

レポートの場所によっては、スコープを指定する必要があります。たとえば、デザイン画面上のテキストボックスには、=Max(Fields!Sales.Value,"Dataset1") のように、使用するデータセットの名前を指定する必要があります。その他の場所には、暗黙的な既定のスコープが存在します。たとえば、グループスコープ内でテキストボックスの集計を指定しない場合は、既定の集計 First が使用されます。

各集計関数のトピックには、使用可能なスコープが一覧表示されます。詳細については、「集計関数リファレンス (レポートビルダーおよび SSRS)」を参照してください。

テーブルデータ領域の集計式の例

既定以外のスコープを指定する式を作成するには練習が必要です。次の図と表は、さまざまなスコープを理解するのに役立ちます。図は、年度、四半期、および販売区域ごとの販売品目の数量を表した販売情報テーブル内の各セルの名称を示したものです。行グループと列グループの構造を表示する行ハンドルと列ハンドルの視覚的な手掛かりが、入れ子になったグループを示しています。テーブルの構造は次のとおりです。

テーブルヘッダー。コーナーセルと列グループヘッダーを含む 3 つの行を含んでいます。
2 つの入れ子になった行グループ。Cat という名前のカテゴリと SubCat という名前のサブカテゴリに基づいています。
2 つの入れ子になった列グループ。Year という名前の年と Qtr という名前の四半期に基づいています。
Totals というラベルが付いた 1 つの静的な合計列。
1 つの隣接する列グループ。Territory という名前の販売区域に基づいています。

販売区域グループの列ヘッダーは、表示目的で 2 つのセルに分割されています。最初のセルには販売区域の名前と合計、2 番目のセルには各販売区域のすべての売上に対して貢献した割合を計算したプレースホルダーテキストが表示されます。

rs_BasicTableSumCellScope

DataSet1 というデータセットと Tablix1 というテーブルがあるとします。次の表は、セルのラベル、既定のスコープ、および例を示しています。プレースホルダーテキストの値は式の構文に示されます。

セル	既定のスコープ	プレースホルダーのラベル	テキストまたはプレースホルダーの値
C01	Tablix1	[Sum(Qty)]	集計とスコープ =Sum(Fields!Qty.Value)
C02	外部列グループ "Year"	[Year] ([YearQty])	=Fields!Year.Value =Sum(Fields!Qty.Value)
C03	Tablix1	[Sum(Qty)]	Totals =Sum(Fields!Qty.Value)
C04	ピア列グループ "Territory"	([Total])	Territory =Sum(Fields!Qty.Value)
C05	内部グループ "Qtr"	[Qtr] ([QtrQty])	Q =Fields!Qtr.Value =Sum(Fields!Qty.Value)
C06	ピア列グループ "Territory"	[Territory] ([Tty]) [Pct]	=Fields!Territory.Value =Sum(Fields!Qty.Value) =FormatPercent(Sum(Fields!Qty.Value,"Territory")/Sum(Fields!Qty.Value,"Tablix1"),0) & " of " & Sum(Fields!Qty.Value,"Tablix1")
C07	外部行グループ "Cat"	[Cat] [Sum(Qty)]	=Fields!Cat.Value =Sum(Fields!Qty.Value)
C08	C07 と同じ
C09	外部行グループ "Cat" と内部列グループ "Qtr"	[Sum(Qty)]	=Sum(Fields!Qty.Value)
C10	C07 と同じ	<<Expr>>	=Sum(Fields!Qty.Value) & ": " & FormatPercent(Sum(Fields!Qty.Value)/Sum(Fields!Qty.Value,"Tablix1"),0) & " of " & Sum(Fields!Qty.Value,"Tablix1")
C11	外部行グループ "Cat" と列グループ "Territory"	<<Expr>>	=Sum(Fields!Qty.Value) & ": " & FormatPercent(Sum(Fields!Qty.Value)/Sum(Fields!Qty.Value,"Territory"),0) & " of " & Sum(Fields!Qty.Value,"Territory")
C12	内部行グループ "Subcat"	[Subcat] [Sum(Qty)]	=Fields!SubCat.Value =Sum(Fields!Qty.Value)
C13	内部行グループ "Subcat" と内部列グループ "Qtr"	[Sum(Qty)]	=Sum(Fields!Qty.Value)
C14	内部行グループ "Subcat"	<<Expr>>	=Sum(Fields!Qty.Value) & ": " & FormatPercent(Sum(Fields!Qty.Value)/Sum(Fields!Qty.Value,"Cat"),0) & " of " & Sum(Fields!Qty.Value,"Cat")
C15	内部行グループ "Subcat" と列グループ "Territory"	<<Expr>>	=Sum(Fields!Qty.Value) & ": " & FormatPercent(Code.CalcPercentage(Sum(Fields!Qty.Value),Sum(Fields!Qty.Value,"Cat")),0) & " of " & Sum(Fields!Qty.Value,"Cat")

Tablix データ領域の視覚的手掛かりの解釈の詳細については、「Tablix データ領域のセル、行、および列 (レポートビルダーおよび SSRS)」を参照してください。 Tablix データ領域の詳細については、「Tablix データ領域のセル、行、および列 (レポートビルダーおよび SSRS)」を参照してください。式と集計の詳細については、「レポートでの式の使用 (レポートビルダーおよび SSRS)」および「集計関数リファレンス (レポートビルダーおよび SSRS)」を参照してください。