Crystal Reports でfreee のデータに連携して帳票を作成

レポートウィザードを使って、最新のfreee 連携データを使った帳票を作成。

加藤龍彦
デジタルマーケティング
最終更新日：2022-06-11

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

CData

こんにちは！ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。

Crystal Reports には、JDBC 標準向けのサポートが組み込まれています。この記事では、freee の機能を持つ帳票を作成するレポート作成ウィザードの使い方を説明します。

freee JDBC Driver のインストール

CData JDBC Driver for API を、ドライバーのJAR をCrystal Reports のクラスパスに含めてインストール：DataDriverCommonElement の下のClassPath element のパスに、 .jar を含むファイルのフルパスを追加します。

CRConfig.xml は通常C:\Program Files (x86)\SAP BusinessObjects\SAP BusinessObjects Enterprise XI 4.0\java に配置されます。— パスはインストールによって若干異なる場合があります。ドライバーのJAR はインストールディレクトリの［lib］サブフォルダ内にあります。

ClassPath にJAR を追加したら、Crystal Reports を再起動します。

freee のデータに接続

下記の手順に従って、レポート作成ウィザードを使ってfreee 接続を作成します。

新しい空の帳票で、［Create New Connection］>［JDBC (JNDI)］をクリックします。
ウィザードでJDBC 接続URL を選択します。
jdbc:api:Profile=freee.apip;ProfileSettings='CompanyId=1234567;';Authscheme=OAuth;InitiateOAuth=GETANDREFRESH;OAuthClientId=your_client_id;OAuthClientSecret=your_client_secret;CallbackUrl=your_callback_url;
ドライバーのクラス名を設定：
cdata.jdbc.api.APIDriver
まずは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 接続をfreee に追加したら、レポート作成ウィザードを使ってfreee を帳票に追加できます。

帳票に必要なテーブルやフィールドを選択して、データソースを設定します。この例では、Deals テーブルのAmount およびIssueDate カラムを使います。
チャートの種類を設定ウィザードを完了すると、Crystal Reports はfreee のデータに実行されるSQL クエリをビルドします。ドライバーは、ライブfreee のデータに対してクエリを実行します。
必要に応じて、ほかのフィルタや帳票テンプレートを設定します。
データのインポートが終わったら、データをサマライズもしくはソートするチャートやレポートオブジェクトを作成できます。［Insert］>［Chart］をクリックして、チャートエキスパートを開きます。Total IssueDate by Amount を表すグラフを作成するには、Amount を［On Change Of］メニューセレクションの下のボックスに追加してからIssueDate を［Show Values］の下のボックスに追加します。