帳票ツールのCROWNIX でQuickBooks Online データを取り込んだ帳票を作成する

こんにちは！プロダクトスペシャリストの宮本です。

CROWNIX は簡単に基幹系DB や社内で持っているDB データを、さまざまな形式で出力することができる帳票ツールです。
この記事では、CROWNIX に備わっているJDBC インターフェースと CData JDBC Driver for QuickBooksOnline を組み合わせることによりCROWNIX でQuickBooks Online データを活用した帳票を作成する方法を紹介します。

CData JDBC Driver for QuickBooksOnline のインストール

まずCData JDBC Driver for QuickBooksOnline をCROWNIX と同じマシンにインストールします。

1. 以下のパスにJDBC Driver がインストールされます。
   C:\Program Files\CData\CData JDBC Driver for QuickBooksOnline 20xxJ\lib\cdata.jdbc.quickbooksonline.jar
   
2. インストール後、「cdata.jdbc.quickbooksonline.jar」と「cdata.jdbc.quickbooksonline.lic」ファイルをERS Data Server のlib フォルダにコピーします。

データソースへのコネクション設定

続いてERS Data Server で対象のJDBC データソースへのコネクションを構成します。

1. サイドメニューから「データソース」→「Database」→「JDBC」と進み、接続情報を入力します。
   Driver：cdata.jdbc.quickbooksonline.QuickBooksOnlineDriver
   url：jdbc:quickbooksonline:InitiateOAuth=GETANDREFRESH
2. 接続のテストを実行し、成功したら設定を保存します。

登録したサービスの有効化

コネクションの設定が完了したら、サービスの有効化を行いましょう。

1. 「権限設定」→「権限変更」をクリックします。
2. 先ほど作成したデータソースが「すべてのサービスリスト」に表示されているので、選択して左側の「サービスメンバー」に移動して保存します。

Report Designer で帳票レイアウトの作成～データマッピング

それではReport Designer を利用して、実際に帳票を作成してみましょう。

1. Report Designer を起動させ、新規レポートから「表」→データベースの接続方式に「Data Server」を選択したらOK ボタンをクリックします。
2. ヘッダーから表を選択して挿入し、QuickBooks Online に保存しているデータを出力する明細表を作成します。
3. 次は実際にQuickBooks Online にアクセスしてデータを取得します。
   ヘッダーの「データソース」から「データベース接続」をクリックし、ERS Data Server へのURL とアカウント情報を入力後に「認証」ボタンをクリックします。
   接続に成功すると、登録されたサービス名の一覧に先ほど有効化したサービス（データソース）が表示されますので、両方を選択して「接続」ボタンをクリックします。
4. あとは取得したいデータをSQL で定義します。
   クエリの定義をクリックしてクエリ定義画面を表示し、対象のテーブルを選択します。
5. 取得したいカラムを選択します。併せて表示順序の設定を行うため「次へ」ではなく、「整列」タブをクリックします。
6. 以下のように並び順を指定しました。
7. 最後に「クエリを実行してカラム名を読み取り」をチェックします。チェックをすることでReport Designer のデータセットにカラム名だけを表示して扱うことができます。
8. 入力が終わりましたら下にある「SQL検証」ボタンをクリックして、正しくSQL が実行できることを確認し、問題なければOK ボタンをクリックします。
   OK ボタンを押下すると取得対象項目が左側に表示されますので、あとは一つずつドラッグアンドドロップでレイアウト側の該当箇所と紐づけを行います。

プレビュー

それでは作成した帳票を実際に動かしてみましょう。

1. ホームタブから「プレビュー」→「Report Viewer でプレビュー」をクリックします。
2. このようにQuickBooks Online にあるデータが帳票レイアウトにマッピングされて表示されました。プレビューから実際にファイルに出力する場合は、ヘッダーメニューからExcel やPDF などを選択します。
3. 以下は、PDF を選択した場合の出力結果です。

このようにCData JDBC Driver for QuickBooksOnline とCROWNIX を組み合わせることで、簡単にQuickBooks Online データを利用した帳票を作成することができました。ぜひ、30日の無償評価版 をお試しください。