Birst でfreee請求書 データのビジュアライゼーションを構築
Birst は、組織が複雑なプロセスを迅速に理解し、最適化することを支援するクラウドビジネスインテリジェンス（BI）ツールおよび分析プラットフォームです。CData JDBC Driver for API と組み合わせると、Birst Cloud Agent を経由してリアルタイムfreee請求書 のデータ に接続し、ビジュアライズを構築できます。ここでは、Cloud Agent を使用してfreee請求書 に連携し、Birst で動的レポートを作成する方法を段階的に説明します。
強力なデータ処理機能により、CData JDBC Driver はBirst のfreee請求書 のデータ 操作に高いパフォーマンスを提供します。Birst からfreee請求書 への複雑なSQL クエリを発行すると、ドライバーはフィルタや集計などのサポートされているSQL 操作を直接freee請求書 にプッシュし、組込みSQL エンジンを利用してクライアント側でサポートしない操作を処理します。組み込みの動的メタデータクエリにより、JDBC ドライバーはネイティブのBirst データ型を使用してfreee請求書 のデータ を視覚化および分析することを可能にします。
Birst でfreee請求書 データへのJDBC 接続を設定
Birst プロジェクトを作成する前に、JDBC Driver を操作するためのBirst Cloud Agent をインストールする必要があります。また、JDBC ドライバーのJAR ファイル(および存在する場合はLIC ファイル)をCloud Agent のインストール場所の/drivers/ ディレクトリにコピーします。
ドライバーとCloud Agent のインストールが完了したら、開始できます。
- Birst で新しいプロジェクトを作成します。
- 接続に名前を付けます。(e.g. CDataAPI)
- Live Access を選択します。
- エージェントを選択します。
- Database Type をOther に設定します。
- SQL タイプをMSSQL に設定します。
- 接続文字列を設定します。
まずは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 接続プロパティを設定することもできます。これによって戻される行数を制限するため、可視化・レポートのデザイン設計時のパフォーマンスを向上させるのに役立ちます。
以下はfreee請求書 の一般的なJDBC 接続文字列です。
jdbc:api:Profile=freeeinvoice.apip;ProfileSettings='CompanyId=1234567;';Authscheme=OAuth;InitiateOAuth=GETANDREFRESH;OAuthClientId=your_client_id;OAuthClientSecret=your_client_secret;CallbackUrl=your_callback_url;
- Driver Name cdata.jdbc.api.APIDriver を設定し、［Save］をクリックします。
NOTE freee請求書 への認証は接続文字列に管理されるため、［Security Credentials］は空白でも問題ありません。
freee請求書 データオブジェクトを設定
接続が構成されたら、データセットのスキーマを構成し、ビジュアライズするテーブル、ビュー、そしてカラムを選択することができるようになります。
- スキーマを選択します。 (e.g. API)
- ［Tables］や［Views］をクリックしてこれらのエンティティに接続し、［Apply］をクリックします。
- アクセスする［Tables］と［Columns］を選択し、［Done］をクリックします。
オブジェクトが構成されたら、Pronto Prepare and Relate ツールを用いて、データ準備の実行やデータのリレーションを検出できるようになります。
ビジュアライゼーションを構築
データを準備し、接続されたオブジェクト間のリレーションを定義することで、ビジュアライゼーションを構築することができるようになります。
- メニューから、Visualizer ツールを選択します。
- オブジェクトからMeasures & Categories を選択します。
- 選択したMeasure(s) に適切なビジュアライゼーションを選択し、構成します。
CData JDBC Driver for API をCloud Agent やBirst とともに用いることにより、freee請求書 で簡単に堅牢なビジュアライゼーションとレポートを作成できます。30日の無償評価版をダウンロードし、Birst ビジュアライゼーションの構築を開始してください。