合計を計算して表示するには、レポート内にテキストコンポーネントを配置し、エディタを呼び出して「サマリー」タブに移動する必要があります。
式」フィールドです。このフィールドは、合計を計算する式を指定します。式は手動で指定することもできますし、他のパラメータの種類によって自動的に生成されることもあります。
サマリー関数」フィールド。このフィールドでは、合計を計算する機能が選択されています。
このフィールドでは、合計を計算するデータ バンドを指定することができます。
このフィールドでは、合計を計算するためにどの値を使用するか、データ列によって指定することができます。
ラジオボタンを使って、合計を計算する対象を設定することができます。
レポート。合計は、レポート全体について計算されます。
列。合計は、レポート内のすべての列で計算されます。
ページ。合計は、レンダリングされたレポートの各ページごとに計算されます。
Running Totalパラメータ。このフラグがチェックされている場合、合計がランニングとして計算されます。チェックされていない場合は、プロジェクト（レポート、列、ページ）のみで合計が計算されます。
条件パラメータ。このフラグがチェックされている場合、合計を計算する際に条件が考慮されます。チェックされていない場合は、条件を考慮せずに合計が計算されます。
フィールドは、条件の式を指定します。
関数結果の合計の型
デフォルトでは、合計を計算する関数はDecimal型を返します（関数-CountとCountDistinctを除く）。しかし、他の2つのデータ型、DoubleとInt64を使用して計算を行うこともできます。Doubleデータ型を使って計算結果を返す関数は、関数名の上位にラテン文字のDを付けます。Int64型を使った計算の場合は、ラテン文字のIを上位のレジスタに追加します。このように分離することで、合計の計算における損失を避けることができます。
|
関数のシンタックスに関するいくつかの言葉
プログラミング言語C#を使用する場合、すべての関数はレジスタに厳密に準拠して記述する必要があります。
ページやコンテナによる計算の場合、関数名の前にラテン文字のcを付ける以外は同じ構文です。
列ごとの合計を計算する場合は、関数名に接頭辞 col をつけます。
Count関数は、他の関数と異なり、計算のための式を持ちません。この関数のシンタックスを以下に示します。
|
任意の場所に合計を表示する
通常、関数呼び出しが指定されたテキスト表現内のコンポーネントは、データバンド上のフッターバンドに配置される。フッターバンドにはいくつかの種類がある。
上記のいずれかのバンドに機能を持つコンポーネントを配置することで、レポート作成者は、この機能がどのデータバンドに適用されるかを正確に判断することができます。また、関数を持つコンポーネントをデータバンドに配置することも可能です。この場合、各データ行に、すべての行による関数の計算結果が表示されます。
ヘッダーバンドに、例えば合計を表示したい場合、これはスクリプトを使用して行われます。しかし、Stimulsoftレポートでは、関数を持つコンポーネントは、レポートのどのバンドにも存在することができます。
また、レポートテンプレートのページなどに、その機能を持つコンポーネントを配置することも可能である。例えば、リストによる値の合計を計算し、ヘッダーリストに出力することが可能である。別の例では、リストの行数を計算し、その値をページの冒頭に出力します。同時に、結果が計算されるデータバンドを指定しなければならないという制限もある。
|
関数を使った表現
合計を計算するために、式に追加の引数を指定しないことも可能である。例えば、Count関数では省略可能ですし、Sum関数では計算すべき式を1つだけ引数として設定することができます。レポート作成者が、これらの関数がどのデータバンドに関連しているかを判断できれば、これらすべてが可能です。
それ以外の場合は、引数で、合計を計算する必要があるデータソースまたはデータバンドを指定する必要があります。式で指定できるのは以下の通り。
|
ページによる集計の計算
ページまたはパネルによる合計を計算するには、関数名の前に小文字でラテン文字「c」を追加する必要があります。
パネルやページ単位で集計を行う場合、集計関数の計算を行うデータバンドを指定することが望まれる。これは、1ページに複数のデータバンドが存在する可能性があるためです。
1つのページやパネルに、いくつでも集計関数を使用することができます。Stimulsoftのソフトはこれに対して何の制限もありません。ページ別の合計を条件付きで結合することは可能です。例えば
|
列別集計の計算
列による合計を計算するには、関数名の前に小文字の接頭辞 col (column の語源) を付ける必要があります。たとえば、次のようになります。
列による集計を行う場合、ColumnHeader、ColumnFooter、Header、Footerのいずれかのバンドに関数を持つテキストコンポーネントを配置することが望まれる。列による合計は、無制限に計算することができます。これには制限はない。また、条件付きでフッターをカラム別にまとめることも可能である。
|
イベントコードでの集計計算
Stimulsoftソフトウェアを使用すると、レポートイベントのコードで関数を計算することができます。これにより、より複雑な関数を計算することができます。また、この場合、計算の過程でコードから計算値を参照し、この処理に影響を与えることができます。この計算を行うには、データディクショナリに関数の値を格納する変数を作成する必要があります。
変数を作成する際、変数のデータ型を指示します。例えば、Decimal、初期値として、0を指定します。 次に、Data bandで、Renderingイベントで変数をインクリメントする式を指定します。例えば、Products.UnitPriceフィールドによる値の合計を計算したい場合、式は次のようになります。
計算結果を表示するには、式と一緒にテキストコンポーネントを配置する必要があります。
また、式 {Variable} を持つテキストコンポーネントが必要で、Process At プロパティを End of Report 値に設定します。残りのコンポーネントを処理した後に、レポート・ジェネレータが変数の値を計算することが必要です。 |
条件付き合計の計算
合計を計算するときに、ある値を考慮する必要がある場合があります。この場合、合計を計算する機能で条件を設定します。たとえば、ゼロより大きい値を合計する必要がある場合などです。合計を計算する関数に条件を追加するには、関数名の末尾に If (ラテンアルファベット) を付け、条件を指定した引数を追加する必要があります。
|
合計と、構成要素のサイズを自動的に変更する機能
|
無効データバンドとの合計
データバンドは、さまざまな方法で無効にすることができます。たとえば、特定の条件によって無効にしたり、高さをゼロにしたりすることができます。デフォルトでは、レポートをレンダリングする際、レポート エンジンは無効化されたデータ バンドを考慮せず、処理しません。しかし、無効化されたデータバンドによって合計を計算する必要がある場合は、このバンドのCalcInvisibleプロパティをtrueに設定する必要があります。この場合、レポートはDataを含むバンドのみ表示され、合計の計算はDataバンドを考慮して実行される。 |
マスターディテールレポートにおける合計の計算
階層型レポートで合計を計算する場合、結果の算出に問題がある場合があります。マスター・ディテール・レポートを基にした例を考えてみましょう。このレポートには、商品カテゴリのリストが表示されているとします。この場合、カテゴリーはマスター項目、商品は詳細項目です。
レポートに表示される商品の数をカウントしたいとします。商品（詳細レコード）のリストを持つバンドに、関数Count()を持つフッターバンドを追加すると、各カテゴリ（マスターレコード）ごとに、合計が計算されます。
カテゴリを持つバンドに関数Count()を持つフッターバンドを追加した場合、結果はレポート内のマスターエントリの数、カテゴリの数になります。しかし、マスター-詳細レポートでは、すべての詳細レコードに対してすぐに合計を計算することができます。この場合、両方の（マスターと詳細の）バンド名をコロン付きの関数として指定する必要があります。Count(MasterBand:DetailBand)と指定します。
Count(MasterBand:DetailBand)関数の結果は、全カテゴリーの商品数です。
|
