各製品の資料を入手。
詳細はこちら →DBArtisan でJDBC 経由でfreee データ をデータ連携利用
DBArtisan のウィザードを使用して、freee のJDBC データソースを作成します。
最終更新日:2022-09-23
この記事で実現できるfreee 連携のシナリオ
こんにちは!ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。
CData JDBC Driver for API は、データベースとしてfreee のデータ に連携できるようにすることで、freee のデータ をDBArtisan などのデータベース管理ツールにシームレスに連携します。ここでは、DBArtisan でfreee のJDBC ソースを作成する方法を説明します。データを直観的に標準SQL で実行できます。
freee データ をDBArtisan Projects に連携
以下のステップに従って、freee をプロジェクトのデータベースインスタンスとして登録します。
- DBArtisan で、[Data Source]->[Register Datasource]とクリックします。
- [Generic JDBC]を選択します。
- [Manage]をクリックします。
- 表示されるダイアログで、[New]をクリックします。ドライバーの名前を入力し、[Add]をクリックします。次に、ドライバーJAR に移動します。ドライバーJAR は、インストールディレクトリのlib サブフォルダにあります。
-
Connection URL ボックスで、JDBC URLに資格情報とその他の必要な接続プロパティを入力します。
まずはOAuth アプリを作成します。https://app.secure.freee.co.jp/developers/applications にアクセスして、「新しいアプリケーションの作成」ボタンをクリックします。アプリケーション名を指定し、リダイレクトURL を設定して登録をクリックします。そうすると、クライアントシークレットとクライアントID が発行されます。
次に、プロファイルをダウンロードしてドライバーがアクセス可能な場所に配置します。こちらからプロファイルをダウンロードして、「C:/profiles/」 などに設置してください。
その後、Companies ビューからCompanyId を取得します。以下の接続プロパティを設定したら、接続する準備ができます。
- AuthScheme:OAuth に設定します。
- OAuthClientID:アプリ設定で指定されたOAuth クライアントID に設定します。
- OAuthClientSecret:アプリ設定で指定されたOAuth クライアントシークレットに設定します。
- CallbackURL:アプリ設定で指定したリダイレクトURI に設定します。
- InitiateOAuth:GETANDREFRESH に設定します。InitiateOAuth を使用してOAuthAccessToken を取得するプロセスを管理できます。
ビルトイン接続文字列デザイナー
JDBC URL の構成については、freee JDBC Driver に組み込まれている接続文字列デザイナーを使用してください。JAR ファイルのダブルクリック、またはコマンドラインからJAR ファイルを実行します。
java -jar cdata.jdbc.api.jar
接続プロパティを入力し、接続文字列をクリップボードにコピーします。
下は一般的な接続文字列です。
jdbc:api:Profile=freee.apip;ProfileSettings='CompanyId=1234567;';Authscheme=OAuth;InitiateOAuth=GETANDREFRESH;OAuthClientId=your_client_id;OAuthClientSecret=your_client_secret;CallbackUrl=your_callback_url;InitiateOAuth=GETANDREFRESH
- ウィザードを終了して、freee に接続します。freee エンティティは、[Datasource Explorer]に表示されます。
ほかのデータベースを使うのと同じように、freee を使うことができます。 freee API にサポートされているクエリについてのより詳しい情報は、ドライバーのヘルプドキュメントを参照してください。
