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

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

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

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

CData

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

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

Misoca 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 を再起動します。

Misoca のデータに接続

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

新しい空の帳票で、［Create New Connection］>［JDBC (JNDI)］をクリックします。
ウィザードでJDBC 接続URL を選択します。
jdbc:api:Profile=Misoca.apip;Authscheme=OAuth;InitiateOAuth=GETANDREFRESH;OAuthClientId=your_client_id;OAuthClientSecret=your_client_secret;CallbackUrl=your_callback_url;
ドライバーのクラス名を設定：
cdata.jdbc.api.APIDriver
まず、OAuth アプリを作成する必要があります。 https://app.misoca.jp/oauth2/applications に移動し、「新しいアプリケーションを作成する」ボタンをクリックしてください。アプリケーション名を入力し、リダイレクトURL を指定して、「登録する」をクリックします。そうすると、クライアントシークレットとクライアントID が表示されます。

次に、プロファイルをダウンロードしてドライバーがアクセス可能な場所に配置します。こちらからプロファイルをダウンロードして、「C:/profiles/」などに設置してください。

以下の接続プロパティを設定した後、接続の準備が整います。
- AuthScheme：OAuth に設定してください。
- OAuthClientID：アプリケーション設定で指定されたOAuth クライアントID に設定してください。
- OAuthClientSecret：アプリケーション設定で指定されたOAuth クライアントシークレットに設定してください。
- CallbackURL：アプリケーション設定で指定したリダイレクトURI に設定してください。
- InitiateOAuth：GETANDREFRESH に設定してください。InitiateOAuth を使用して、OAuthAccessToken を取得するプロセスを管理できます。

帳票をデザイン

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

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