JReport Designer でSalesforce Data Cloud のデータを連携

JReport Designer でSalesforce Data Cloud に連携するチャートとレポートを作成します。

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

この記事で実現できるSalesforce Data Cloud 連携のシナリオ

CData

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

CData JDBC Driver for SalesforceDataCloud を使用すると、Salesforce Data Cloud がリレーショナルデータベースであるかのようにダッシュボードやレポートからリアルタイムデータにアクセスでき、使い慣れたSQL クエリを使用してSalesforce Data Cloud] をクエリできます。ここでは、JDBC データソースとしてSalesforce Data Cloud に連携し、JReport Designer でSalesforce Data Cloud のレポートを作成する方法を説明します。

Salesforce Data Cloud のデータに接続

C:\JReport\Designer\bin\setenv.bat を編集し、JAR ファイルの場所をADDCLASSPATH 変数に追加します。

...
set ADDCLASSPATH=%JAVAHOME%\lib\tools.jar;C:\Program Files\CData\CData JDBC Driver for SalesforceDataCloud 2016\lib\cdata.jdbc.salesforcedatacloud.jar;
...

［File］［New］［Data Source］と進み、新しいデータソースを作成します。
表示されるダイアログで、データソースの名前(CData JDBC Driver for SalesforceDataCloud) を作成し、JDBC を選択して［OK］をクリックします。
［JDBC Connection Information］ダイアログで、JDBC ドライバーへの接続を構成します。
- Driver:［Driver］ボックスにチェックがついていることを確認し、ドライバーのクラスの名前を入力します。 cdata.jdbc.salesforcedatacloud.SalesforceDataCloudDriver
- URL:jdbc:salesforcedatacloud: から始まり、その後にセミコロンで区切られた接続プロパティのリストが続くJDBC URL を入力します。
  Salesforce Data Cloud は、OAuth 標準による認証をサポートしています。
  
  OAuth
  
  AuthScheme をOAuth に設定します。
  
  デスクトップアプリケーション
  
  CData は、デスクトップでの認証を簡略化する埋め込みOAuth アプリケーションを提供します。
  
  また、Salesforce Data Cloud コンソールで設定および登録するカスタムOAuth アプリケーションを介してデスクトップから認証することもできます。詳しくは、ヘルプドキュメントのカスタムOAuth アプリの作成を参照してください。
  
  接続する前に、次のプロパティを設定します。
  - InitiateOAuth：GETANDREFRESH。InitiateOAuth を使えば、繰り返しOAuth の交換を行ったり、手動でOAuthAccessToken を設定する必要はなくなります。
  - OAuthClientId （カスタムアプリケーションのみ）：カスタムOAuth アプリケーションの登録時に割り当てられたクライアントID。
  - OAuthClientSecret （カスタムアプリケーションのみ）：カスタムOAuth アプリケーションの登録時に割り当てられたクライアントシークレット。
  接続すると、本製品はデフォルトブラウザでSalesforce Data Cloud のOAuth エンドポイントを開きます。ログインして、アプリケーションにアクセス許可を与えます。
  
  以下のようにドライバーがOAuth プロセスを完了します。
  - コールバックURL からアクセストークンを取得します。
  - 古いトークンの期限が切れたときは、新しいアクセストークンを取得します。
  - OAuthSettingsLocation にOAuth 値を保存し、接続間で永続化します。
  - User:認証に使用するユーザー名は、通常空白のままにします。
  - Password:User と同様に認証に使用するパスワードも、通常は空白のままにします。
- ［Add Table］ダイアログで、レポート（またはこのデータソースを使用する予定のレポート）に含めるテーブルを選択し、［Add］をクリックします。
  
  ダイアログがテーブルのロードを完了したら、［Done］をクリックします。
- ［Catalog Browser］では、レポートの作成に使用するクエリを作成できます。今すぐ、またはレポートの作成後に作成できますが、どちらにしても、データソース(CData JDBC Driver for Salesforce Data Cloud) を展開()し、［Queries］を右クリックして［Add Query］を選択します。
- ［Add Table/View/Query］ダイアログで、JDBC URL とTables を展開() し、クエリで使用するテーブルを選択して［OK］をクリックします。
- ［Query Editor］ダイアログで、含めるカラムを選択するか、［SQL］ボタンをクリックして以下のようにカスタムクエリを手動で入力できます。
```
SELECT [Account ID], [Account Name] FROM Account WHERE EmployeeCount > 250
```
  クエリが作成されたら、［OK］をクリックして［Query Editor］ダイアログを閉じます。この時点で、Salesforce Data Cloud を新規または既存のレポートに追加する準備が整いました。
  
  NOTE: クエリが作成されると、クエリに基づいて［Business View］を作成できます。［Business View］を使用すると、クエリに基づいてWeb レポートまたはライブラリコンポーネントを作成できます。これについてのより詳しい情報は、JReport のチュートリアルを参照してください。