freee のデータをSisense でビジュアライズ

freee にアクセスできるSisense アプリでElastiCube を作成します。

古川えりか
コンテンツスペシャリスト
最終更新日：2022-04-14

この記事で実現できるfreee 連携のシナリオ

CData

こんにちは！ドライバー周りのヘルプドキュメントを担当している古川です。

Sisense を使用すると、データを結合、分析、画像化lし、よりインテリジェントなビジネス決定を行い、効果的な戦略を作成できます。CData JDBC Driver for API は、Sisense に簡単に統合して利用することができます。この記事では、freee に接続するElastiCube の作成方法と、それを使用してSisense のfreee をビジュアライズする方法を説明します。

freee への接続を構成する

ElastiCube を作成する前に、JDBC Driver のJAR ファイル(通常はC:\Program Files\CDatat\CData JDBC Driver for API\lib) のインストール場所をメモするか、jar ファイル(cdata.jdbc.api.API.jar) をSisense JDBC driver ディレクトリの新しいフォルダ(通常はC:\ProgramData\Sisense\DataConnectors\jdbcdrivers)にコピーします。

Sisense アプリケーションの［Data］ページで、新しいElastiCube を作成します(または既存のElastiCube を開きます)。
［Model Editor］で［+ Data］をクリックし、［Add Data］ダイアログボックスを開きます。
［Generic JDBC］をクリックし、［JDBC settings］を開きます。
［Connection String］プロパティをfreee の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 URL を構成する際に、Max Rows プロパティを定めることも可能です。これによって戻される行数を制限するため、可視化・レポートのデザイン設計時のパフォーマンスを向上させるのに役立ちます。

以下は一般的な例です。
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=REFRESH
JDBC JAR フォルダプロパティをCData JDBC Driver JAR ファイルの場所に設定します(上記を参照)。
ドライバーのクラス名をJDBC Driver のクラス名( cdata.jdbc.api.APIDriver) に設定します。
ユーザー名とパスワードのプロパティは空欄にします。
［Next］をクリックします。