コンパイル済みのモジュールをインストールするには、DelphiのIDEから、［コンポーネント｜パッケージをインストール｜追加］メニューで、デザイン時パッケージをインストールします。インストールするファイルは、C:\Program Files\QuickReportsXI\bpl\QR4DesignD2006.bpl です。次に、［プロジェクト｜デフォルトオプション｜Delphi for Win32］メニューを実行し、デフォルトプロジェクトオプションを設定します。［ディレクトリ/条件］の［検索パス］、［デバッグ用ソースパス］に、C:\Program Files\QuickReportsXI を追加します。

ソースコードからインストールするには、C:\Program Files\QuickReportsXI\bpl\QR4DesignD2006.dpk とC:\Program Files\QuickReportsXI\bpl\QR4RunD2006.dpkを、 Delphi Win32 パーソナリティで開いて、コンパイルします。コンパイルが完了したら、設計時パッケージQR4DesignD2006.dpkをプロジェクトマネージャ上で選択して右クリックし［インストール］メニューを実行します。以上で、ツールパレットにQuickReportコンポーネントが追加されます。

Hide image

図1 -ツールパレットにQReportタブとコンポーネントが追加された

Delphi .NETで、ソースコードからインストールするには、インストール直後にインストールディレクトリに展開されているQR4DesignD2006NET.dpk、QR4Run2006NET.dpk を Delphi .NET パーソナリティで開いて、コンパイルします。次に、［コンポーネント|インストール済み .NET コンポーネント］メニューを実行し、QR4DesignD2006NET.dll を .NET VCL コンポーネントとしてインストールします。

C++Builderで、ソースコードからインストールする場合は、少し複雑です。まず、旧バージョンのディレクトリマッピングをベースとした、以下のディレクトリ内のファイルを全て削除します。これは、現在のバージョンで、プロジェクトディレクトリ等の位置が異なるために不整合が発生しているものです。

C:\Program Files\Borland\BDS\4.0\projects\BPL

C:\Program Files\Borland\BDS\4.0\projects\lib

※ \projects 以下のディレクトリを含めて削除してもよい

次に、実行時パッケージの C:\Program Files\Borland\BDS\4.0\quickrpt\QR4RunC2006.bdsproj と、設計時パッケージのC:\Program Files\Borland\BDS\4.0\quickrpt\QR4DesignC2006.bdsprojを開きます。プロジェクトの管理を容易にするために、これらのプロジェクトをまとめるプロジェクトグループを作成してもよいでしょう。

次に、プロジェクト設定を変更します。これは、実行時パッケージ、設計時パッケージそれぞれに行います。

Hide image

図2 – プロジェクトオプション

［プロジェクト｜オプション］メニューを実行し、［パスカルコンパイラ（DCC32）｜パスと定義］を選択し、［パスと定義］の各設定から不正なパスを削除します。そして、次の２つに適切な値を設定します。

次に、Qrabsdatas.hpp ファイルの94行目を修正します。これは、定義の大文字／小文字に誤りがあるためです。

誤）：__property Fielddefs ;
正）：__property FieldDefs ;

パッケージプロジェクトをコンパイルするときには、実行時パッケージからビルドするほうが簡単です。設計時パッケージは、実行時パッケージに依存関係があるため、この関係を定義すれば、コンパイル順序を気にする必要はありません。

コンパイルが成功したら設計時パッケージ QR4DesignC2006.bpl をインストールします。そして、プロジェクトのデフォルト設定でQuickReportが有効になるように、［プロジェクト｜デフォルトオプション｜C++Builder］メニューを実行し、［パスと定義｜インクルードファイルの検索パス］に「$(BDS)\quickrpt」を追加しておきます。

以上で、QuickReportを利用できるようになります。

Hide image

図3 - QuickReportをインストールしたBorland Developer Studio 2006

既存のDelphiアプリケーションでは、BDEなどの従来からのデータベースアクセス技術を使っていることと思います。このようなケースでは、データベースドライバの変更、データベースアクセスコンポーネントの変更などが、今回の移行プロジェクトで、あるいは、将来の時点で発生する可能性があります。こうした状況で、レポート機能が特定のデータベースコンポーネントセットに依存していると、再びレポート機能に修正を加えなければならなくなります。これを回避するには、データベースアクセス機能の分離性を高めます。

具体的な方法としては、TClientDataSet を有効活用します。データベースアプリケーションを変更に強くする方法については、こちらの記事を参照してください。

たいていのQuickReportアプリケーションでは、TTableやTQuery といったデータセットを直接参照しています。このような作り方だと、データアクセスコンポーネントを変更するたびに、数多くの QuickReport コンポーネントのプロパティを変更しなければならなくなります。直接参照をやめて、Table や Query で取得したデータを、メモリキャッシュとして持つことができるデータセットコンポーネントTClientDataSet を利用するように変更すれば、変更への対処がTClientDataSet に集中化され、変更に強くなります。

Hide image

図4 - TClientDataSetを使って変更に強くする

レポート機能は参照系であるため、このような実装が可能になりますが、更新系と混在させる場合には注意が必要です。

また、この方法を検討するには、TClientDataSetの特性を理解しておいてください。TClientDataSet はデータを全てメモリキャッシュに保持します。そのため、TClientDataSet は巨大なデータ処理には向きません。

もうひとつ考慮しなければならないのは、レポート機能の分離性です。QuickReportのコンポーネント機能が、いろいろなフォームのユニットにハードコーディングするのは、データベースアクセスコンポーネントをフォームに貼り付けるのと同様に、最も避けるべきコーディングです。

QuickReportというサードパーティコンポーネントの機能、バージョンなどに、アプリケーション資産がすべてロックインされるというのは、アプリケーションの保守性を考慮したときに、絶対回避したいところです。そのためには、QuickReportを操作するためのクラス（レポートマネージャのような機能）を作成し、各アプリケーション機能からは、レポート機能を抽象化し、QuickReportそのものを隠蔽するようにします。

例えば、次のようなコードがフォームのボタンやメニューのイベントハンドラに記述されていたとします。

procedure TForm1.Button1Click(Sender: TObject);
begin
  QuickReport1.Preview();
end;

これを、次のようなプロシージャを持つクラスTReportManagerを作成し、

procedure TReportManager.printReport;
begin
  ReportForm.QuickRep1.Preview();
end;

フォームから呼び出します。

procedure TForm1.Button1Click(Sender: TObject);
begin
  ReportManager1.printReport();
end;

これにより、少なくともこのフォームからは、QuickReportへの依存性は排除でき、万一印刷に関する機能実装の仕組みが変わった場合でも、TReportManager以降の変更だけで済みます。

関連情報：

・第3回デベロッパーキャンプ – 資料ダウンロード