RazorSQL で FreshBooks のデータ に接続

Jerod Johnson
Jerod Johnson
Director, Technology Evangelism
RazorSQL データベース管理ツールのウィザードを使用して FreshBooks に接続し、GUI で FreshBooks のデータ をクエリします。



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

FreshBooks のデータ 用の 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: で始まり、その後にセミコロンで区切られた接続プロパティが続きます。

      まず、Profile 接続プロパティをディスク上の FreshBooks プロファイルの場所に設定します(例:C:\profiles\FreshBooks.apip)。次に、ProfileSettings 接続プロパティを FreshBooks の接続文字列に設定します(以下を参照)。

      FreshBooks API プロファイル設定

      FreshBooks Developer Dashboard で OAuth アプリケーションを登録し、Client ID と Client Secret を取得します。アプリケーションのコールバック URL にリダイレクト URI を設定します。

      ビルトイン接続文字列デザイナー

      JDBC URL の構築には、FreshBooks JDBC Driver に組み込まれている接続文字列デザイナーを使用してください。JAR ファイルをダブルクリックするか、コマンドラインから jar ファイルを実行します。

      java -jar cdata.jdbc.api.jar
      

      接続プロパティを入力し、接続文字列をクリップボードにコピーします。

      ビルトイン接続文字列デザイナーを使用して JDBC URL を生成(Salesforce の例)

      一般的な JDBC URL は以下のとおりです。

      jdbc:api:Profile=C:\profiles\FreshBooks.apip;Authscheme=OAuth;OAuthClientId=your_client_id;OAuthClientSecret=your_client_secret;CallbackUrl=your_callback_url;InitiateOAuth=GETANDREFRESH;
JAR パス、ドライバークラス、JDBC URL で定義された JDBC データソース。接続プロパティは JDBC URL 内で定義されています(QuickBooks の例)。

FreshBooks のデータ のクエリとテーブルの選択

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

RazorSQL でのクエリ結果(QuickBooks の例)。

はじめる準備はできましたか?

API Driver で FreshBooks のライブデータに接続

FreshBooks に接続