RazorSQL で freee工数管理 のデータ に接続

CData JDBC Driver for freee工数管理 は、IDE のウィザードからデータ管理・分析ツールまで、サードパーティツールからの標準ベースのアクセスを可能にします。この記事では、RazorSQL のウィザードを使用して freee工数管理 に接続する方法を説明します。

freee工数管理 のデータ 用の JDBC データソースを作成

1. RazorSQL アプリケーションを開き、「Connections」メニューから「Add Connection Profile」->「Other」->「JDBC」を選択します。
2. 表示される「Connection Wizard」で、以下のプロパティを設定します。
   • Driver Location：インストールディレクトリ内の lib サブフォルダへのパスを設定します。
   • Driver Class：ドライバークラスを cdata.jdbc.api.APIDriver に設定します。
   • Username：ユーザー名を入力します（このプロパティは JDBC URL 内でも設定できます）。
   • Password：パスワードを入力します（このプロパティは JDBC URL 内でも設定できます）。

   • JDBC URL：接続パラメータを入力します。JDBC URL は jdbc:api: で始まり、その後にセミコロンで区切られた接続プロパティが続きます。

     まずは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 URL は以下のとおりです。

     jdbc:api:Profile=freeepm.apip;ProfileSettings='CompanyId=1234567;';Authscheme=OAuth;InitiateOAuth=GETANDREFRESH;OAuthClientId=your_client_id;OAuthClientSecret=your_client_secret;CallbackUrl=your_callback_url;

freee工数管理 のデータ のクエリとテーブルの選択

接続が確立されると、ウィザードが閉じ、接続パネルで接続が利用可能になります。その後、テーブルをクエリできます。