Crystal Reports でDB2 データに連携して帳票を作成

こんにちは！ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。

Crystal Reports には、JDBC 標準向けのサポートが組み込まれています。この記事では、DB2 の機能を持つ帳票を作成するレポート作成ウィザードの使い方を説明します。

DB2 JDBC Driver のインストール

CData JDBC Driver for DB2 を、ドライバーのJAR をCrystal Reports のクラスパスに含めてインストール：DataDriverCommonElement の下のClassPath element のパスに、 .jar を含むファイルのフルパスを追加します。

CRConfig.xml は通常C:\Program Files (x86)\SAP BusinessObjects\SAP BusinessObjects Enterprise XI 4.0\java に配置されます。— パスはインストールによって若干異なる場合があります。ドライバーのJAR はインストールディレクトリの［lib］サブフォルダ内にあります。

ClassPath にJAR を追加したら、Crystal Reports を再起動します。

DB2 データに接続

下記の手順に従って、レポート作成ウィザードを使ってDB2 接続を作成します。

1. 新しい空の帳票で、［Create New Connection］>［JDBC (JNDI)］をクリックします。

2. ウィザードでJDBC 接続URL を選択します。

   jdbc:db2:Server=10.0.1.2;Port=50000;User=admin;Password=admin;Database=test;

3. ドライバーのクラス名を設定：

   cdata.jdbc.db2.DB2Driver

   DB2 への接続には以下を入力します：

   • Server: DB2 が稼働しているサーバー。
   • Port: DB2 サーバーのポート。
   • Database: DB2 のデータベース。
   • User: DB にアクセスする権限のあるユーザー名。
   • Password: DB にアクセスする権限のあるユーザーのパスワード。

   対応するDB2 のドライバーをインストールする必要があります。

   • Windows: IBM Data Server Provider for .NET

     Windows では、IBM Data Server Provider をインストールするだけで十分です。インストールがmachine.config への書き込みを行います。

   • Java: IBM Data Server Driver for JDBC

     Java では、IBM Data Server Driver JAR をアプリケーションのwww\WEB-INF\lib\ フォルダに配置する必要があります。

   パスワード方式によるSSH 接続

   パスワード方式によるSSH接続時に必要なプロパティ一覧を以下に示します。

   • User: DB2 のユーザ
   • Password: DB2 のパスワード
   • Database: DB2 の接続先データベース
   • Server: DB2 のサーバー
   • Port: DB2 のポート
   • UserSSH: "true"
   • SSHAuthMode: "Password"
   • SSHPort: SSH のポート
   • SSHServer: SSH サーバー
   • SSHUser: SSH ユーザー
   • SSHPassword: SSH パスワード

   接続文字列形式では以下のようになります。

   Server=10.0.1.2;Port=50000;User=admin;Password=admin;Database=testUseSSH=true;SSHAuthMode=Password;SSHPort=22;SSHServer=ssh-server;SSHUser=root;SSHPassword=sshpasswd;

   公開鍵認証方式方式によるSSH 接続

   公開鍵認証によるSSH接続時に必要なプロパティ一覧を以下に示します。

   • User: DB2 のユーザ
   • Password: DB2 のパスワード
   • Database: DB2 の接続先データベース
   • Server: DB2 のサーバー
   • Port: DB2 のポート
   • UserSSH: "true"
   • SSHAuthMode: "Public_Key"
   • SSHClientCertType: キーストアの種類
   • SSHPort: SSH のポート
   • SSHServer: SSH サーバー
   • SSHUser: SSH ユーザー
   • SSHClientCert: 秘密鍵ファイルのパス

   接続文字列形式では以下のようになります。

   Server=10.0.1.2;Port=50000;User=admin;Password=admin;Database=test;UseSSH=true;SSHAuthMode=Public_Key;SSHClientCertType=PUBLIC_KEY_FILE;SSHPort=22;SSHServer=ssh-server;SSHUser=root;SSHClientCert=C:\Keys\key.pem;

帳票をデザイン

JDBC 接続をDB2 に追加したら、レポート作成ウィザードを使ってDB2 を帳票に追加できます。

1. 帳票に必要なテーブルやフィールドを選択して、データソースを設定します。この例では、Orders テーブルのOrderName およびFreight カラムを使います。

2. チャートの種類を設定 ウィザードを完了すると、Crystal Reports はDB2 データ に実行されるSQL クエリをビルドします。ドライバーは、ライブDB2 データ に対してクエリを実行します。

3. 必要に応じて、ほかのフィルタや帳票テンプレートを設定します。

4. データのインポートが終わったら、データをサマライズもしくはソートするチャートやレポートオブジェクトを作成できます。［Insert］>［Chart］をクリックして、チャートエキスパートを開きます。Total Freight by OrderName を表すグラフを作成するには、OrderName を［On Change Of］メニューセレクションの下のボックスに追加してからFreight を［Show Values］の下のボックスに追加します。

完成した帳票をプレビューして、チャートにデータが入っていることを確認します。Null 値を取り除きたい場合は、SelectionFormula を使います。