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

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

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

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

CData ODBC ドライバとは？

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

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

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

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

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

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

ODBC 接続プロパティの指定がまだの場合は、DSN （データソース名）の設定を行います。Microsoft ODBC データソースアドミニストレーターを使ってODBC DSN を作成および設定できます。一般的な接続プロパティは以下のとおりです：
- Profile
- ProfileSettings
- Authscheme
- OAuthClientId
- OAuthClientSecret
- CallbackUrl
Microsoft ODBC データソースアドミニストレーターで必要なプロパティを設定する方法は、ヘルプドキュメントの「はじめに」をご参照ください。
まず、Profile 接続プロパティをディスク上のAha! プロファイルの場所に設定します（例：C:\profiles\aha.apip）。次に、ProfileSettings 接続プロパティをAha! の接続文字列に設定します（以下を参照）。

Aha! API プロファイル設定

Aha! API はOAuth ベースの認証を使用します。

まず、Aha! でOAuth アプリを登録する必要があります。これはAha! アカウントの「Settings」>「Personal」>「Developer」>「OAuth Applications」から行えます。また、Aha アカウントのドメイン名にあるDomain を設定します。例えば、Aha アカウントがacmeinc.aha.io の場合、Domain は「acmeinc」となります。

以下の項目を接続文字列に設定すると、接続できるようになります。
- AuthScheme：OAuth に設定します。
- InitiateOAuth：GETANDREFRESH に設定します。InitiateOAuth を使用して、OAuthAccessToken を取得するプロセスを管理できます。
- OAuthClientId：アプリ設定で指定されたclient_id に設定します。
- OAuthClientSecret：アプリ設定で指定されたclient_secret に設定します。
- CallbackURL：アプリ設定で指定したRedirect URI に設定します。
- Domain：ProfileSettings でAha ドメインに設定します。
新しい帳票で、［Create New Connection］>［ODBC］をクリックします。
ウィザードが表示されたら［Select Data Source］をクリックし、［Data Source Name］メニューでDSN を選択します。

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

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

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