本記事では CData サポート担当からこんなことを聞かれたらどこを確認すべきか?という観点で、よく頂くお問合せ内容をご紹介します。
記事はこちら →CData JDBC Driver for Square は、Square API への接続をデータドリブンJava アプリケーションに統合します。CData JDBC Driver for Square をBIRT (Business Intelligence Reporting Tools) のプラットホームで使用することで、リアルタイムでデータの変更を反映するBIRT レポートを作成できます。
Square OAuth 認証標準を使用します。OAuth を使用して認証するには、Square にアプリを登録してOAuthClientId、OAuthClientSecret、CallbackURL を入手します。OAuth の使用方法については、ヘルプドキュメントの「はじめに」セクションをご覧ください。
追加でLocationId を指定する必要がある場合があります。Locations テーブルをクエリすることでLocations のId を取得できます。または、クエリの検索項目にLocationId を設定することもできます。
JDBC URL の構成については、Square JDBC Driver に組み込まれている接続文字列デザイナを使用してください。JAR ファイルのダブルクリック、またはコマンドラインからJAR ファイルを実行します。
java -jar cdata.jdbc.square.jar
接続プロパティを入力し、接続文字列をクリップボードにコピーします。
JDBC URL を構成する際に、Max Rows プロパティを定めることも可能です。これによって戻される行数を制限するため、可視化・レポートのデザイン設計時のパフォーマンスを向上させるのに役立ちます。
以下は一般的なJDBC URL です。
jdbc:square:OAuthClientId=MyAppId;OAuthClientSecret=MyAppSecret;CallbackURL=http://localhost:33333;LocationId=MyDefaultLocation;InitiateOAuth=GETANDREFRESH
SELECT Reason, RefundedMoneyAmount FROM Refunds
これによって、BIRT レポートがSquare の更新をすべて取得できるようになります。
レポートをアプリケーションサーバーに公開するには、ドライバーのJAR をBIRT Viewer のクラスパスに追加します。より詳しい説明は、Java アプリケーションサーバーにJDBC Driver をデプロイする方法について、CData KB を参照してください。