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

古川えりか
コンテンツスペシャリスト

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

Crystal Reports には、ODBC 標準向けのサポートが組み込まれています。CData ODBC Driver for API は、Crystal Reports でレポート作成ウィザードやその他のツールを使ってfreee へのアクセスを可能にします。この記事では、freee の機能を持つシンプルな帳票を作成する方法を説明します。

CData ODBC ドライバとは？

CData ODBC ドライバは、以下のような特徴を持ったリアルタイムデータ連携ソリューションです。

freee をはじめとする、CRM、MA、会計ツールなど多様なカテゴリの270種類以上のSaaS / オンプレミスデータソースに対応
多様なアプリケーション、ツールにfreee のデータを連携
ノーコードでの手軽な接続設定
標準 SQL での柔軟なデータ読み込み・書き込み

CData ODBC ドライバでは、1.データソースとしてfreee の接続を設定、2.Crystal Reports 側でODBC Driver との接続を設定、という2つのステップだけでデータソースに接続できます。以下に具体的な設定手順を説明します。

CData ODBC ドライバのインストールとfreee への接続設定

まずは、本記事右側のサイドバーからAPI ODBC Driver の無償トライアルをダウンロード・インストールしてください。30日間無償で、製品版の全機能が使用できます。

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

ODBC 接続プロパティの指定がまだの場合は、DSN （データソース名）の設定を行います。Microsoft ODBC データソースアドミニストレーターを使ってODBC DSN を作成および設定できます。一般的な接続プロパティは以下のとおりです：
- Profile
- ProfileSettings
- '
- Authscheme
- InitiateOAuth
- OAuthClientId
- OAuthClientSecret
- CallbackUrl
Microsoft ODBC データソースアドミニストレーターで必要なプロパティを設定する方法は、ヘルプドキュメントの「はじめに」をご参照ください。
まずは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 を取得するプロセスを管理できます。
新しい帳票で、［Create New Connection］>［ODBC］をクリックします。
ウィザードが表示されたら［Select Data Source］をクリックし、［Data Source Name］メニューでDSN を選択します。

freee のデータに連携する帳票をデザイン

ODBC 接続をfreee に追加したら、レポート作成ウィザードを使ってfreee を帳票に追加できます。

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