JasperReports Server で Square に連携する帳票を作成
CData JDBC ドライバをJasperReports Server に配置して、Jasper Studio でリアルタイムSquare のデータを連携利用する帳票を作ろう。
加藤龍彦
デジタルマーケティング
最終更新日:2022-06-07
CData
こんにちは!ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。
CData JDBC Driver for Square は企業全体のSquare へのデータ連携を可能にします。この記事では、JasperReports server にドライバーを配布してレポーティングドメイン、ビルディングブロックを作成し、ad hoc 帳票を作成する方法を説明します。
Square ドライバーのJAR を配布
下記の手順に従って、ドライバーのJAR をJasperReports server に配置します。標準的なプロセスに従って、JNDI データソースをTomcat またはJBoss に配布できます。以下の説明にはSquare およびJasperReports Server にバンドルされたTomcat server の詳細が含まれます。
- インストールディレクトリの[lib]サブフォルダ内のドライバーJAR およびlic ファイルを、apache-tomcat フォルダの[lib]サブフォルダにコピーします。
-
以下のリソースエントリーをjasperserver-pro Web アプリケーションのcontext.xml に追加します。これはアプリケーションの[META-INF]サブフォルダに配置されています。必要な接続プロパティをJDBC URL に指定します。
Square OAuth 認証標準を使用します。OAuth を使用して認証するには、Square にアプリを登録してOAuthClientId、OAuthClientSecret、CallbackURL
を入手します。OAuth
の使用方法については、ヘルプドキュメントの「はじめに」セクションをご覧ください。
追加でLocationId を指定する必要がある場合があります。Locations テーブルをクエリすることでLocations のId を取得できます。または、クエリの検索項目にLocationId
を設定することもできます。
<Resource name="jdbc/square" auth="Container" type="javax.sql.DataSource" driverClassName="cdata.jdbc.square.SquareDriver" url="jdbc:square:OAuthClientId=MyAppId;OAuthClientSecret=MyAppSecret;CallbackURL=http://localhost:33333;LocationId=MyDefaultLocation;" maxActive="20" maxIdle="10" maxWait="-1" factory="com.jaspersoft.jasperserver.tomcat.jndi.JSBasicDataSourceFactory"/>
-
jasperserver-pro Web アプリケーションのweb.xml に以下の参照を追加します。これはアプリケーションの[WEB-INF]サブフォルダに配置されています。
Square データ JSP
jdbc/square
javax.sql.DataSource
Container
-
サーバーを再起動します。
Square JDBC データソースの作成
ドライバーを配布したら、JNDI 接続を作成してバンドルされたあらゆるドライバーと同じように接続できます。
- JasperReports Server にログインして[Create]>[Data Source]をクリックします。
- [Type]メニューで[JNDI Data Source]を選択します。
- [Service Name]ボックスにSquare に定義したJDNI ルックアップを入力します。例では、ルックアップは jdbc/square です。
ドメイン の作成
データのドメインはJaspersoft のメタデータレイヤです。アドホックな分析および帳票で使うことができます。
- [Create]>[Domain]をクリックし、ドメインにID を入力します。
- [Data Source]セクションで[ブラウズ]をクリックし、作成したSquare のデータソースを選択します。
- [Domain Design]セクションで[Create with Database Designer]をクリックします。[Select Database Schema]ダイアログが表示されます。
- Square のデータソースを選択します。
- [Tables]タブの[Data Source]ペインでテーブルを選択し、矢印をクリックして[Selected Tables]に追加します。
- [Display]タブの[Resources]ペインでSquare エンティティを選択し、矢印をクリックしてリソースを[Sets and Items]ペインに追加します。
ドメインにView Based を作成
ドメインを使ってSquare のビジネスビューを作成したら、データに関連あるサブセットを表示するビューを作成します。下記の手順に従って、[Ad Hoc Editor]の[Ad Hoc view]にビューを作成します。
- [Create]>[Ad Hoc View]をクリックします。
-
ダイアログが表示されたら、作成したSquare ドメインを選択します。
-
[Choose Data]ページで、ビューで使いたいカラムを選択します。[Select Fields]セクションでは、フィルターおよび入力用のプロンプトユーザーを作成できます。[Display]セクションでは、フィールドおよびフィールド名の並び順を変更できます。
-
ウィザードを完了したら、ビューの種類を選択しビューにカラムを追加できます。JasperSoft はドライバーのメタデータを使って、利用可能なdimensions およびmeasures をデータの種類に基づいて検出します。 [Columns] および[Rows]ボックスにdimensions およびmeasures をドラッグします。例えば、チャートを作成するには[Columns]ボックスに[excol#1]を、[Rows]ボックスに[excol#2]をドラッグします。
- ビューを保存します。
帳票の作成
これでドメインから帳票を作成できます:
関連コンテンツ