各製品の資料を入手。
詳細はこちら →
freee のデータをASTERIA Warp に繋いでみた
freee をEAI ツールのASTERIA Warp にデータ接続して、データソースとする方法。
最終更新日：2022-03-28
この記事で実現できるfreee 連携のシナリオ
こんにちは！テクニカルディレクターの桑島です。
CData JDBC Driver for API は、JDBC 標準をインプリメントし、BI ツールからIDE まで幅広いアプリケーションでfreee への接続を提供します。この記事では、ASTERIA Warp からfreee に接続する方法を説明します。
freee のデータのJDBC データソースを作成
下記の手順に従って、ASTERIA Warp からfreee に接続して、RDB コネクションを作成します。
- ASTERIA WARP のasteriahome5\system\lib\drivers ディレクトリにCData JDBC ドライバインストールディレクトリの［lib］サブフォルダ内のcdata.jdbc.api.jar ファイルをコピーして配置します。
- 左のコネクションペインで［コネクションの作成］をクリックし、［接続種別］で［RDB］を選択します。
- コネクションの名前を入力して、OKを押します。
右のプロパティペインで接続設定を行います。
- データベースタイプ：Other
- ドライバー：cdata.jdbc.api.APIDriver
-
URL: jdbc:api: に続けてセミコロン区切りで接続プロパティを入力します。
一般的なJDBC URL は次の通りです:jdbc:api:Profile=freee.apip;ProfileSettings='CompanyId=1234567;';Authscheme=OAuth;InitiateOAuth=GETANDREFRESH;OAuthClientId=your_client_id;OAuthClientSecret=your_client_secret;CallbackUrl=your_callback_url;
JDBC Driver の接続文字列デザイナーを使う
JDBC 接続文字列を作るには、freee JDBC Driver のビルトイン接続文字列デザイナーを使う方法があります。ドライバーの.jar ファイルをダブルクリックするか、コマンドラインから.jar ファイルを実行します。
Windows:
java -jar 'C:\Program Files\CData\CData JDBC Driver for API 2019\lib\cdata.jdbc.api.jar'
MacOS:
java -jar cdata.jdbc.api.jar
接続プロパティに値を入力して、生成される接続文字列をクリップボードにコピーします。
左のコネクションペインで右クリックで保存して、［テスト接続］を実施します。これでfreee データ への接続が確立され、ASTERIA WARP 上でRDB としてfreee データ が利用できるようになりました。
ASTERIA Warp 4 以前のバージョンでは、JDBC Forward Only ドライバーの設定が必要です。この設定を行わないと、クエリ実行時に（This driver only supports TYPE_FORWARD_ONLY cursors）が発生します。
-
［フローサービス管理コンソール］＞［サービス］タブ＞［フローエンジン］＞［編集］ボタン＞［JDBC Forward Only ドライバー］欄に以下を追加します。
cdata.jdbc.api.APIDriver
- 保存して設定完了です。
APIのデータを抽出（SELECT）するフローを作成します。
- フローを作成し、RDB Get をドラグ＆ドロップします。
- プロパティ［コネクション名］で設定したコネクションを選択します。
- RDB Get アイコンをダブルクリックして、［SQL ビルダー］を開きます。
- freee の表示されているテーブルから抽出するカラム・テーブルを指定するSQL を書きます。
- ［SELECT テスト］をクリックし、テーブル内容が表示されたら、SQL ビルダーを閉じます。
- フローを実行します。
このようにAPI 内のデータをAPI を書くことなくASTERIA 上で処理することができるようになります。
サポートされるSQL についての詳細は、ヘルプドキュメントの「サポートされるSQL」をご覧ください。テーブルに関する情報は「データモデル」をご覧ください。
関連コンテンツ
