SAP Crystal Reports で Wave Financial ののデータをレポートに出力

Dibyendu Datta
Lead Technology Evangelist

レポートウィザードを使用して、Wave Financial のデータに基づいたレポートを作成します。

Crystal Reports にはリモートデータへのデータ処理をオフロードするためのさまざまなオプションが用意されており、リアルタイムレポートを実現できます。Crystal Reports がJDBC に対応しているため、CData JDBC Driver for Wave Financial によってこの機能をCrystal Reports で利用できるようになります。この記事では、レポート実行時にデータを更新するWave Financial のデータレポートを作成する方法を紹介します。

以下の表は、この記事で使用するツールとバージョンです。

アプリケーション名	バージョン
SAP Crystal Reports 2020	SP3
JDBC Driver	23.0.8565

JDBC Driver のデプロイ

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

CRConfig.xml ファイルのデフォルトの場所はC:\Program Files (x86)\SAP BusinessObjects\SAP BusinessObjects Enterprise XI 4.0\java ですが、インストールによって多少異なる場合があります。ドライバーJAR はインストールディレクトリのlib サブフォルダにあります。

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

Wave Financial のデータに接続

Wave FinancialのJDBC Driver をデプロイしたら、レポートウィザードを使用して新しいレポートにWave Financial のデータを追加できます。

File -> New -> Standard Report をクリックします。
Create New Connection の下にあるJDBC (JNDI) を展開し、Make a New Connection をダブルクリックします。
CData JDBC Driver for Wave Financial を使用して接続文字列を作成します。

JDBC URL の構成については、Wave Financial JDBC Driver に組み込まれている接続文字列デザイナーを使用してください。JAR ファイルをダブルクリックするか、コマンドラインからjar ファイルを実行します。

java -jar cdata.jdbc.wavefinancial.jar

Wave Financial 接続プロパティの取得・設定方法

Wave Financial は、データに接続する手段として、API トークンを指定する方法とOAuth 認証情報を使用する方法の2つを提供しています。

API トークン

Wave Financial アカウントにログインします。
左ペインのManage Applications に移動します。
トークンを作成するアプリケーションを選択します。最初にアプリケーションを作成する必要がある場合があります。
API トークンを生成するには、Create token をクリックします。

OAuth

AuthScheme

OAuth

ヘルプドキュメントでは、以下の3つの一般的な認証フローでのWave Financial への認証について詳しく説明しています。

デスクトップ：ユーザーのローカルマシン上でのサーバーへの接続で、テストやプロトタイピングによく使用されます。組み込みOAuth またはカスタムOAuth で認証されます。
Web：共有ウェブサイト経由でデータにアクセスします。カスタムOAuth でのみ認証されます。
ヘッドレスサーバー：他のコンピュータやそのユーザーにサービスを提供する専用コンピュータで、モニタやキーボードなしで動作するように構成されています。組み込みOAuth またはカスタムOAuth で認証されます。

カスタムOAuth アプリケーションの作成についての情報と、組み込みOAuth 認証情報を持つ認証フローでもカスタムOAuth アプリケーションを作成したほうがよい場合の説明については、ヘルプドキュメントの「カスタムOAuth アプリケーションの作成」セクションを参照してください。

接続プロパティを入力し、接続文字列をクリップボードにコピーします。

組み込みの接続文字列デザイナーを使用してJDBC URL を生成（例はSalesforce）

JDBC URL を設定する際に、Max Rows 接続プロパティを設定することもできます。これにより返される行数が制限され、レポートやビジュアライゼーションをデザインする際のパフォーマンス向上に役立ちます。

ウィザードでJDBC 接続URL を入力します。
```
jdbc:wavefinancial:
```
ドライバークラス名を設定します。
```
cdata.jdbc.wavefinancial.WaveFinancialDriver
```
レポートに必要なテーブルを選択します。
SAP Crystal Reports でWave Financial のデータのテーブルをリンクすることもできます。テーブル間のリンクを追加したら、NEXT をクリックします。
テーブルを選択したら、選択したテーブルからレポートに表示するフィールドを選び、NEXT をクリックします。
レポート上の情報をグループ化するために「Group By」フィールドを選択します。
集計合計に基づいてグループを並べ替え、NEXT をクリックします。

その後、グループ化、並べ替え、集計を設定できます。集計とサマリーを使用してチャートを作成するには、次のセクションを参照してください。

チャートの作成

グループ化するカラムを選択した後、標準レポート作成ウィザードでチャートを作成するオプションが表示されます。以下の手順に従って、Id カラムの値を集計するチャートを作成します。

標準レポート作成ウィザードで、Bar Chart オプションを選択し、「On change of」メニューでグループ化したカラムを選択します。
Show Summary メニューで、作成した集計を選択します。
必要に応じてフィルターとテンプレートを選択し、ウィザードを完了します。

レポートのテンプレートを選択すると、完成したレポートをプレビューし、データが入力されたチャートを表示できます。

完成したレポート

レポートに最初に指定したすべてのフィールドが含まれていることを確認できます。

リモートデータの操作

データの更新を確認するには、File をクリックし、「Save Data with Report」オプションをオフにします。レポートを操作すると（例えば、詳細にドリルダウンすると）、Crystal Reports はレポートの表示に必要なデータを取得するためにSQL クエリを実行します。すでに取得したデータを再読み込みするには、レポートを更新または再実行します。

詳細要素を非表示にし、サーバー側グループ化を有効にすることで、ドライバーに処理をオフロードできます。これを行うには、レポート作成ウィザードでグループ化するカラムを選択する必要があります。

File -> Report Options をクリックし、「Perform Grouping On Server」オプションを選択します。
Report -> Section Expert をクリックし、レポートのDetails セクションを選択します。「Hide (Drill-Down OK)」オプションを選択します。

詳細を非表示にしてレポートをプレビューすると、Crystal Reports はGROUP BY クエリを実行します。チャートのカラムをダブルクリックして詳細にドリルダウンすると、Crystal Reports は必要なデータのみを取得するSELECT WHERE クエリを実行し、読み込み時間を短縮します。

これで、SAP Crystal Reports とCData JDBC Driver を使用して、Wave Financial のデータに基づくSAP Crystal レポートが作成できました。CData JDBC Driver for Wave Financial の詳細と無料トライアルのダウンロードについては、Wave Financial JDBC Driver ページをご覧ください。ご不明な点がございましたら、サポートチームまでお問い合わせください。