SHOEISHA iD

※旧SEメンバーシップ会員の方は、同じ登録情報(メールアドレス&パスワード)でログインいただけます

CodeZine編集部では、現場で活躍するデベロッパーをスターにするためのカンファレンス「Developers Summit」や、エンジニアの生きざまをブーストするためのイベント「Developers Boost」など、さまざまなカンファレンスを企画・運営しています。

5分でわかるActiveReports帳票

5分でわかるActiveReports帳票(2013年度版)-グループ化、集計処理、レイアウト

ActiveReports for .NET 7.0Jで作るサンプル帳票(3)

  • X ポスト
  • このエントリーをはてなブックマークに追加

集計処理

 TextBoxコントロールの集計処理について見てみましょう。

 TextBoxコントロールの集計関連プロパティ(SummaryFuncSummaryGroupSummaryRunningSummaryType)の設定によって、レポート上に集計値を表示することができます。具体的には、以下のような値を表示することができます。

  • あるフィールドの値の全体の集計値(合計値、平均値など)
  • あるフィールドの値のグループ内での集計値
  • あるフィールドの値のそれまでのデータ行の累計値
  • ページ数(現在のページ数、総ページ数)

 これらを表示するために使用する各集計関連プロパティの役割は、以下のとおりです。

  • SummaryFuncプロパティ:どのような集計値を表示するかを設定します。デフォルトは「Sum」であり、加算合計値を表します。他にも「Avg」(平均)、「Count」(データの個数)、「Max」「Min」(最大値・最小値)などがあります。
     
  • SummaryGroupプロパティ:どのグループについて集計値を計算するかを設定します。そのレポートにあるグループヘッダ名を設定します。このプロパティは、SummaryTypeを「SubTotal」に設定した時のみ有効です。
     
  • SummaryRunningプロパティ:累積しながら集計値を出力するか、累積する場合にどのタイミングで集計をリセットするかを設定します。「None」「Group」「All」があり、「None」は累積せずに集計結果を得ます。「Group」ではグループごとの累計値が得られ、その集計はグループごとにリセットされます。「All」はリセットすることなく全体に対する累計値が得られます。
     
  • SummaryTypeプロパティ:集計処理の動作を設定します。「None」では、集計を行いません(デフォルト)。「GrandTotal」では全体に対しての集計を行います。「PageTotal」はページごとの集計を行います。「SubTotal」はグループごとの集計を行います。「PageCount」はページ数の表示を行います。

 なお、フィールドの値の集計を行うためには、そのTextBoxコントロールのDataFieldプロパティに、「集計したいフィールド」を設定しておく必要があります。今回のレポートでは「Price」フィールドを設定しています。

(1)ページ番号・総ページ数の表示

 帳票にページ番号を表示するには、SummaryTypeプロパティに「PageCount」を設定します。ページ番号の表示の場合にはSummaryFuncプロパティは関係ありません。

  プロパティ 設定値
現在のページ番号 SummaryRunning All
SummaryType PageCount
総ページ数 SummaryRunning None
SummaryType PageCount

 なお、セクションレポートには「ReportInfo」というコントロールが用意されております。今回は集計機能の解説のためにTextBoxを使用しておりますが、ページ番号を表示するだけであればReportInfoコントロールを使用する方が簡単に実現できます。ご使用ください。

(2)総計の表示

 明細の全データを集計する場合は、SummaryTypeプロパティに「GrandTotal」を設定します。

  プロパティ 設定値
前データの集計
 
SummaryFunc Sum
SummaryGroup (なし)
SummaryRunning None
SummaryType GrandTotal

(3)グループごとの小計値の表示

 グループごとの小計項目は、以下のように設定します。

TextBox プロパティ
注文番号ごとの小計 SummaryFunc Sum
SummaryGroup 「注文番号」のグループヘッダ
SummaryRunning None
SummaryType SubTotal
注文日付ごとの小計 SummaryFunc Sum
SummaryGroup 「注文日付」のグループヘッダ
SummaryRunning None
SummaryType SubTotal

 今回の例では小計を表示するTextBoxコントロールはグループフッタに配置しています。これは一般的な配置ですが、SummaryRunningプロパティが「None」の場合は、グループ内のセクションならばどこに置いても同じ値が得られます。グループヘッダやDetailセクションに配置しても構いません。

 ページヘッダに項目タイトル用のLabelコントロールを配置するなどしてレポートの体裁を整えたら、デザイナの「プレビュータブ」などを使用して、レポートを表示させてください。一日に複数の注文がある日(例:1994/8/8)のグループフッタには、その日の合計値が表示されているのが確認できます。

作成されたレポート
作成されたレポート
コラム:書式について

 データフィールドをTextBoxコントロールにバウンドする(DataFieldプロパティにフィールド名を設定する)と、そのフィールドの値がTextBoxコントロールに表示されます。デフォルトではToString()で得られる文字列が表示されます。
 

 ただしそのままでは要件を満たせない場合があります。例えば日付/時刻型データの場合、デフォルトでは「1994/04/01 0:00:00」のように時刻まで文字列化されてしまいます。日付だけが欲しい場合にはこのままでは使えません。
 

 このように出力する書式を設定したい時のために、TextBoxコントロールやLabelコントロールには「OutputFormat」プロパティが用意されています。このプロパティには、.NET FrameworkのString.Formatメソッドと同じ書式が使用できます。直接書式文字列を記述することもできますが、プロパティウィンドウから「出力書式の設定」ダイアログが出るので、それを利用すると便利です。
 

出力書式の設定ダイアログ
出力書式の設定ダイアログ

累計値の表示

 レポートの要件によっては「それまでの累計値を表示したい」という場合があります。この場合もTextBoxコントロールの集計機能が有効です。

 累計値を表示するレポートを作ってみましょう。先程と同じデータベースから、以下のSQLで「注文日付および注文番号ごとの金額」(フィールド名:Price)を取得します。

注文ごとの金額を取り出すSQL
SELECT  Orders.OrderDate,
        Orders.OrderID,
        Sum(Round(Round([Order Details].UnitPrice,0)
       * [Order Details].[Quantity] * (1 - [Order Details].[Discount]), 0)) AS Price
  FROM  Orders
        INNER JOIN (Products INNER JOIN [Order Details] 
                    ON Products.ProductID = [Order Details].ProductID) 
        ON Orders.OrderID = [Order Details].OrderID
GROUP BY Orders.OrderDate, Orders.OrderID
ORDER BY Orders.OrderDate, Orders.OrderID;

 このデータから「それまでの金額の累計」を表示するレポートを作成します。

 まず、グループヘッダ/フッタを1つ追加し、そのグループヘッダのDataFieldプロパティに「OrderDate(注文日付)」を、UnderlayNextプロパティにTrueを設定します。

 次に、詳細(Detail)セクション上に「注文番号」を表示するためのTextBoxコントロール(DataFieldプロパティ=「OrderID」)と「金額」を表示するためのTextBoxコントロール(DataFieldプロパティ=「Price」)を配置します。さらに「グループ内累計」「全体累計」を表示するTextBoxコントロールを配置します。これらの2つのTextBoxコントロールのプロパティは、以下のように設定します。

TextBox プロパティ 設定値
グループ内累計 SummaryFunc Sum
SummaryGroup グループヘッダ
SummaryRunning Group
SummaryType SubTotal
全体累計 SummaryFunc Sum
SummaryGroup (なし)
SummaryRunning All
SummaryType GrandTotal

 前述の「注文表」における「グループ内小計」「全体合計」との違いは、SummaryRunningプロパティがNoneではない点です。

 最後に、ページヘッダに項目タイトル用のLabelコントロールを配置したり、グループヘッダ上にLineコントロールを配置するなどして、レポートの体裁を整えます。

累計値を表示するレポートのデザイン画面
累計値を表示するレポートのデザイン画面

 このレポートをプレビュー表示すると、以下のような結果になります。

累計値を表示するレポートのプレビュー結果
累計値を表示するレポートのプレビュー結果

 このレポートは「注文日付(OrderDate)」ごとにグループ化されており、罫線で区切られている部分が1つのグループになります。

 1注文日付あたり1注文というデータがほとんどですが、「注文日付=1994/8/8」というグループには、2つ注文が存在することが確認できます。

 このグループの「グループ内累計」をご覧ください。最初の注文の「金額」が1546なので、「グループ内累計」も同じ1546になります。2つ目の注文の「金額」が665なので、「グループ内累計」は2211(1546+665)となっているのが確認できます。

 一方、「全体累計」は、レポート全体の累計になります。最初の注文の「金額」が40250なので、最初の「全体累計」もそれと同じ数値になります。次の注文の「金額」が443なので、その行の「全体累計」は40693(40250+443)です。それ以降の行についても「金額」の分だけ累積した値が「全体累計」に表示されているのが確認できます。

次のページ
改ページとレイアウトの制御

この記事は参考になりましたか?

  • X ポスト
  • このエントリーをはてなブックマークに追加
5分でわかるActiveReports帳票連載記事一覧

もっと読む

この記事の著者

グレープシティ株式会社 ActiveReportsチーム(グレープシティカブシキガイシャ アクティブレポートチーム)

 宮城県仙台市に本社を構えるグレープシティでは、日本の業務に適したシステムをより早く開発するためのソフトウェアを提供しています。エンドユーザーの利用しやすさ、幅広いユーザー環境への対応、そして何よりプログラマの作業を軽減することを一番に目指しています。 ActiveReportsは、帳票開発に必要なあらゆる機能を備えた当社を代表するコンポーネントの1つ。1998年の発売以来、日本だけでなく全世界で多数の帳票開発者に使用されています。製品開発は同チームが中心になり、「日本仕様」の厳しい要望を実現することを目指しています。...

※プロフィールは、執筆時点、または直近の記事の寄稿時点での内容です

この記事は参考になりましたか?

この記事をシェア

  • X ポスト
  • このエントリーをはてなブックマークに追加
CodeZine(コードジン)
https://codezine.jp/article/detail/7434 2015/07/23 16:16

おすすめ

アクセスランキング

アクセスランキング

イベント

CodeZine編集部では、現場で活躍するデベロッパーをスターにするためのカンファレンス「Developers Summit」や、エンジニアの生きざまをブーストするためのイベント「Developers Boost」など、さまざまなカンファレンスを企画・運営しています。

新規会員登録無料のご案内

  • ・全ての過去記事が閲覧できます
  • ・会員限定メルマガを受信できます

メールバックナンバー

アクセスランキング

アクセスランキング