各製品の資料を入手。
詳細はこちら →
製品をチェック
JasperReports Server で REST に連携する帳票を作成
CData JDBC ドライバをJasperReports Server に配置して、Jasper Studio でリアルタイムREST のデータを連携利用する帳票を作ろう。
最終更新日：2022-06-07
この記事で実現できるREST 連携のシナリオ
こんにちは！ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。
CData JDBC Driver for REST は企業全体のREST へのデータ連携を可能にします。この記事では、JasperReports server にドライバーを配布してレポーティングドメイン、ビルディングブロックを作成し、ad hoc 帳票を作成する方法を説明します。
REST ドライバーのJAR を配布
下記の手順に従って、ドライバーのJAR をJasperReports server に配置します。標準的なプロセスに従って、JNDI データソースをTomcat またはJBoss に配布できます。以下の説明にはREST およびJasperReports Server にバンドルされたTomcat server の詳細が含まれます。
- インストールディレクトリの［lib］サブフォルダ内のドライバーJAR およびlic ファイルを、apache-tomcat フォルダの［lib］サブフォルダにコピーします。
-
以下のリソースエントリーをjasperserver-pro Web アプリケーションのcontext.xml に追加します。これはアプリケーションの［META-INF］サブフォルダに配置されています。必要な接続プロパティをJDBC URL に指定します。
データソースへの認証については、データプロバイダーのヘルプドキュメントの「はじめに」を参照してください: データプロバイダーはREST API を双方向データベーステーブルとして、XML/JSON ファイル（ローカルファイル、一般的なクラウドサービスに保存されているファイル、FTP サーバー）を読み取り専用のビューとしてモデル化します。HTTP Basic、Digest、NTLM、OAuth、FTP などの主要な認証スキームがサポートされています。認証についての詳細は、ヘルプドキュメントの「はじめに」を参照してください。
URI を設定し、認証値を指定したら、Format を"XML" または"JSON" に設定して、データ表現をデータ構造により厳密に一致させるようにDataModel を設定します。
DataModel プロパティは、データをどのようにテーブルに表現するかを制御するプロパティで、以下の基本的な設定を切り替えます。
- Document （デフォルト）：REST データのトップレベルのドキュメントビューをモデル化します。データプロバイダーはネストされたエレメントをデータの集計として返します。
- FlattenedDocuments：ネストされたドキュメントとその親を単一テーブルとして暗黙的に結合します。
- Relational：階層データから個々の関連テーブルを返します。テーブルには、親ドキュメントにリンクする主キーと外部キーが含まれます。
リレーショナル表現の構成について詳しくは、「REST データのモデル化」を参照してください。次の例で使用されているサンプルデータもあります。データには、人、所有している車、およびそれらの車で行われたさまざまなメンテナンスサービスのエントリが含まれています。The data includes entries for people, the cars they own, and various maintenance services performed on those cars.
<Resource name="jdbc/rest" auth="Container" type="javax.sql.DataSource" driverClassName="cdata.jdbc.rest.RESTDriver" url="jdbc:rest:DataModel=Relational;URI=C:/people.xml;Format=XML;" maxActive="20" maxIdle="10" maxWait="-1" factory="com.jaspersoft.jasperserver.tomcat.jndi.JSBasicDataSourceFactory"/> -
jasperserver-pro Web アプリケーションのweb.xml に以下の参照を追加します。これはアプリケーションの［WEB-INF］サブフォルダに配置されています。
REST データ JSP jdbc/rest javax.sql.DataSource Container - サーバーを再起動します。
REST JDBC データソースの作成
ドライバーを配布したら、JNDI 接続を作成してバンドルされたあらゆるドライバーと同じように接続できます。
- JasperReports Server にログインして［Create］>［Data Source］をクリックします。
- ［Type］メニューで［JNDI Data Source］を選択します。
- ［Service Name］ボックスにREST に定義したJDNI ルックアップを入力します。例では、ルックアップは jdbc/rest です。
ドメイン の作成
データのドメインはJaspersoft のメタデータレイヤです。アドホックな分析および帳票で使うことができます。
- ［Create］>［Domain］をクリックし、ドメインにID を入力します。
- ［Data Source］セクションで［ブラウズ］をクリックし、作成したREST のデータソースを選択します。
- ［Domain Design］セクションで［Create with Database Designer］をクリックします。［Select Database Schema］ダイアログが表示されます。
- REST のデータソースを選択します。
- ［Tables］タブの［Data Source］ペインでテーブルを選択し、矢印をクリックして［Selected Tables］に追加します。
- ［Display］タブの［Resources］ペインでREST エンティティを選択し、矢印をクリックしてリソースを［Sets and Items］ペインに追加します。
ドメインにView Based を作成
ドメインを使ってREST のビジネスビューを作成したら、データに関連あるサブセットを表示するビューを作成します。下記の手順に従って、［Ad Hoc Editor］の［Ad Hoc view］にビューを作成します。
- ［Create］>［Ad Hoc View］をクリックします。
-
ダイアログが表示されたら、作成したREST ドメインを選択します。
-
［Choose Data］ページで、ビューで使いたいカラムを選択します。［Select Fields］セクションでは、フィルターおよび入力用のプロンプトユーザーを作成できます。［Display］セクションでは、フィールドおよびフィールド名の並び順を変更できます。
- ウィザードを完了したら、ビューの種類を選択しビューにカラムを追加できます。JasperSoft はドライバーのメタデータを使って、利用可能なdimensions およびmeasures をデータの種類に基づいて検出します。 ［Columns］ および［Rows］ボックスにdimensions およびmeasures をドラッグします。例えば、チャートを作成するには［Columns］ボックスに［excol#1］を、［Rows］ボックスに［excol#2］をドラッグします。
- ビューを保存します。
帳票の作成
これでドメインから帳票を作成できます：
関連コンテンツ
