レポート ビルダー関数 - ページ分割されたレポートの RunningValue 関数 (レポート ビルダー)

適用対象: Microsoft レポート ビルダー (SSRS) Power BI Report Builder SQL Server Data Tools のレポート デザイナー

式で指定されたすべての非 null 数値の現在の集計を、指定されたスコープに対して評価してページ分割されたレポートで返します。

注意

ページ分割されたレポートの定義ファイル (.rdl) は、Microsoft レポート ビルダー、Power BI レポート ビルダー、または SQL Server Data Tools のレポート デザイナーを使用して作成および変更できます。

構文

  
RunningValue(expression, function, scope)  

パラメーター

式 (expression)
この集計関数の実行対象の式です ( [Quantity]など)。

function
(列挙型) 式に適用する集計関数の名前です ( Sumなど)。 この関数は、 RunningValue、 RowNumber、または Aggregateにすることはできません。

スコープ (scope)
(文字列) 集計を評価するコンテキストを示すデータセット、データ領域、またはグループの名前である文字列定数か、NULL (Visual Basic では Nothing) です。 Nothing は、最も外側のコンテキスト (通常はレポート データセット) を示します。

戻り値の型

function パラメーターに指定された集計関数によって決まります。

解説

RunningValue の値は、スコープの新しいインスタンスごとに 0 にリセットされます。 グループが指定された場合は、累計値はグループ式の変更時にリセットされます。 データ領域が指定された場合は、累計値はデータ領域の新しいインスタンスごとにリセットされます。 データセットが指定された場合は、累計値はデータセット全体にわたってリセットされません。

RunningValue は、フィルター式または並べ替え式では使用できません。

実行中の値が計算される一連のデータは、同じデータ型である必要があります。 複数の数値データ型のデータを同じデータ型に変換するには、 CInt、 CDbl 、 CDecなどの変換関数を使用します。 詳細については、「 データ型変換関数」を参照してください。

Scope には、式を指定することはできません。

Expression には、入れ子になった集計関数への呼び出しを含めることができます。ただし、次に示すように、これには例外および条件があります。

• 入れ子集計のスコープは、外部集計のスコープと同じであるか、そのスコープに含まれている必要があります。 式内のすべてのスコープについては、1 つのスコープがそれ以外のすべてのスコープに対する子であるようなリレーションシップが必要です。

• 入れ子集計のスコープには、データセット名は使用できません。

• Expression には、 First、 Last、 Previous、または RunningValue の各関数を含めることができません。

• Expression には、 recursiveを指定する入れ子集計を含めることができません。

行数の累計値を計算するには、 RowNumberを使用します。 詳細については、RowNumber 関数 (レポート ビルダーおよび SSRS) に関する記事を参照してください。

詳細については、「集計関数リファレンス (レポート ビルダーおよび SSRS)」および「合計、集計、および組み込みコレクションの式のスコープ (レポート ビルダーおよび SSRS)」を参照してください。

再帰的集計については、「複数の再帰型階層グループの作成 (レポート ビルダーおよび SSRS)」を参照してください。

例

次のコード例では、最も外側のスコープ (データセット) の Cost フィールドの累計が返されます。

=RunningValue(Fields!Cost.Value, Sum, Nothing)  

次のコード例では、 Score データセットの DataSet1フィールドの累計が返されます。

=RunningValue(Fields!Score.Value,sum,"DataSet1")  

次のコード例では、最も外側のスコープの Traffic Charges フィールドの累計が返されます。

=RunningValue(Fields!Traffic Charges.Value, Sum, Nothing)  

参照

レポートでの式の使用 (レポート ビルダーおよび SSRS)
式の例 (レポート ビルダーおよび SSRS)
式で使用されるデータ型 (レポート ビルダーおよび SSRS)
合計、集計、および組み込みコレクションの式のスコープ (レポート ビルダーおよび SSRS)