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

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

ページ分割されたレポートで指定された式の指定されたスコープの最初の値を返します。

注意

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

構文

  
First(expression, scope)

式 (expression)
(Variant または Binary) この集計関数の実行対象の式です ( =Fields!FieldName.Valueなど)。

スコープ (scope)
(文字列) 省略可。集計関数の適用先となるレポートアイテムを含むデータセット、グループ、またはデータ領域の名前です。 scope を指定しない場合、現在のスコープが使用されます。

式の種類によって決まります。

First 関数は、指定されたスコープですべての並べ替えおよびフィルター処理が適用された後、データセットの最初の値を返します。

First 関数は、現在 (既定) のスコープ以外のスコープを使用してグループ化フィルター式で使用することはできません。

また、ページヘッダーで First を使用して、ページの ReportItems コレクションから最初の値を返し、各ページの最初と最後のエントリを表示する辞書形式のヘッダーを作成することもできます。

scope の値は文字列定数である必要があり、式にすることはできません。外部の集計または他の集計を指定しない集計では、 scope は現在のスコープまたはコンテナースコープを参照する必要があります。集計の集計では、入れ子になった集計に、子のスコープを指定できます。

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

入れ子集計のScope は、外部集計のスコープと同じであるか、そのスコープに含まれている必要があります。式内のすべてのスコープについては、1 つのスコープがそれ以外のすべてのスコープに対する子であるようなリレーションシップが必要です。
入れ子集計のScope には、データセット名は使用できません。
Expression には、 First、 Last、 Previous、または RunningValue の各関数を含めることができません。
Expression には、 recursiveを指定する入れ子集計を含めることができません。

次のコード例では、データ領域の Category グループの最初の製品番号が返されます。

=First(Fields!ProductNumber.Value, "Category")