各製品の資料を入手。
詳細はこちら →JasperReports Server で ADP に連携する帳票を作成
CData JDBC ドライバをJasperReports Server に配置して、Jasper Studio でリアルタイムADP のデータを連携利用する帳票を作ろう。
最終更新日:2022-06-07
この記事で実現できるADP 連携のシナリオ
こんにちは!ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。
CData JDBC Driver for ADP は企業全体のADP へのデータ連携を可能にします。この記事では、JasperReports server にドライバーを配布してレポーティングドメイン、ビルディングブロックを作成し、ad hoc 帳票を作成する方法を説明します。
ADP ドライバーのJAR を配布
下記の手順に従って、ドライバーのJAR をJasperReports server に配置します。標準的なプロセスに従って、JNDI データソースをTomcat またはJBoss に配布できます。以下の説明にはADP およびJasperReports Server にバンドルされたTomcat server の詳細が含まれます。
- インストールディレクトリの[lib]サブフォルダ内のドライバーJAR およびlic ファイルを、apache-tomcat フォルダの[lib]サブフォルダにコピーします。
-
以下のリソースエントリーをjasperserver-pro Web アプリケーションのcontext.xml に追加します。これはアプリケーションの[META-INF]サブフォルダに配置されています。必要な接続プロパティをJDBC URL に指定します。
ADP 接続プロパティの取得・設定方法
接続を確立する前に、ADP に連絡してOAuth アプリとそれに関連するクレデンシャルを提供してもらう必要があります。 これらのクレデンシャルはADP からのみ取得が可能で、直接取得することはできません。
ADP への接続
次のプロパティを指定してADP に接続します。
- OAuthClientId:ADP より提供されたアプリのクライアントId に設定。
- OAuthClientSecret:ADP より提供されたアプリのクライアントシークレットに設定。
- SSLClientCert:ADP より提供された証明書に設定。
- SSLClientCertPassword:証明書のパスワードに設定。
- UseUAT:CData 製品はデフォルトで、本番環境にリクエストを行います。開発者アカウントを使用している場合は、UseUAT をtrue に設定します。
- RowScanDepth:テーブルで利用可能なカスタムフィールドカラムをスキャンする行数の最大値。デフォルト値は100に設定されています。大きい値を設定すると、パフォーマンスが低下する場合があります。
<Resource name="jdbc/adp" auth="Container" type="javax.sql.DataSource" driverClassName="cdata.jdbc.adp.ADPDriver" url="jdbc:adp:OAuthClientId=YourClientId;OAuthClientSecret=YourClientSecret;SSLClientCert='c:\cert.pfx';SSLClientCertPassword='admin@123'" maxActive="20" maxIdle="10" maxWait="-1" factory="com.jaspersoft.jasperserver.tomcat.jndi.JSBasicDataSourceFactory"/>
-
jasperserver-pro Web アプリケーションのweb.xml に以下の参照を追加します。これはアプリケーションの[WEB-INF]サブフォルダに配置されています。
ADP データ JSP jdbc/adp javax.sql.DataSource Container - サーバーを再起動します。
ADP JDBC データソースの作成
ドライバーを配布したら、JNDI 接続を作成してバンドルされたあらゆるドライバーと同じように接続できます。
- JasperReports Server にログインして[Create]>[Data Source]をクリックします。
- [Type]メニューで[JNDI Data Source]を選択します。
- [Service Name]ボックスにADP に定義したJDNI ルックアップを入力します。例では、ルックアップは jdbc/adp です。
ドメイン の作成
データのドメインはJaspersoft のメタデータレイヤです。アドホックな分析および帳票で使うことができます。
- [Create]>[Domain]をクリックし、ドメインにID を入力します。
- [Data Source]セクションで[ブラウズ]をクリックし、作成したADP のデータソースを選択します。
- [Domain Design]セクションで[Create with Database Designer]をクリックします。[Select Database Schema]ダイアログが表示されます。
- ADP のデータソースを選択します。
- [Tables]タブの[Data Source]ペインでテーブルを選択し、矢印をクリックして[Selected Tables]に追加します。
- [Display]タブの[Resources]ペインでADP エンティティを選択し、矢印をクリックしてリソースを[Sets and Items]ペインに追加します。
ドメインにView Based を作成
ドメインを使ってADP のビジネスビューを作成したら、データに関連あるサブセットを表示するビューを作成します。下記の手順に従って、[Ad Hoc Editor]の[Ad Hoc view]にビューを作成します。
- [Create]>[Ad Hoc View]をクリックします。
-
ダイアログが表示されたら、作成したADP ドメインを選択します。
-
[Choose Data]ページで、ビューで使いたいカラムを選択します。[Select Fields]セクションでは、フィルターおよび入力用のプロンプトユーザーを作成できます。[Display]セクションでは、フィールドおよびフィールド名の並び順を変更できます。
- ウィザードを完了したら、ビューの種類を選択しビューにカラムを追加できます。JasperSoft はドライバーのメタデータを使って、利用可能なdimensions およびmeasures をデータの種類に基づいて検出します。 [Columns] および[Rows]ボックスにdimensions およびmeasures をドラッグします。例えば、チャートを作成するには[Columns]ボックスに[excol#1]を、[Rows]ボックスに[excol#2]をドラッグします。
- ビューを保存します。
帳票の作成
これでドメインから帳票を作成できます:
