SAP Crystal Reports で Oracle Eloqua Reporting ののデータをレポートに出力

Dibyendu Datta
Dibyendu Datta
Lead Technology Evangelist
レポートウィザードを使用して、Oracle Eloqua Reporting のデータに基づいたレポートを作成します。

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

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

アプリケーション名バージョン
SAP Crystal Reports 2020SP3
JDBC Driver23.0.8565

JDBC Driver のデプロイ

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

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

CRConfig.xml ファイルにJDBC ファイルパスを追加

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

Oracle Eloqua Reporting のデータに接続

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

  1. File -> New -> Standard Report をクリックします。 標準レポートを作成
  2. Create New Connection の下にあるJDBC (JNDI) を展開し、Make a New Connection をダブルクリックします。
  3. CData JDBC Driver for Oracle Eloqua Reporting を使用して接続文字列を作成します。

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

    java -jar cdata.jdbc.oracleeloquareporting.jar

    Oracle Eloqua Reporting では、以下の認証方法に対応しています。

    • Basic 認証（ユーザーとパスワード）
    • OAuth 2.0 コードグラントフロー
    • OAuth 2.0 パスワードグラントフロー

    Basic 認証（ユーザーとパスワード）

    ユーザーとパスワードで認証するには、以下のプロパティを設定します。

    • AuthScheme: Basic を指定します。
    • Company: Oracle Eloqua Reporting アカウントに関連付けられた会社名を指定します。
    • User: ログインアカウント名を指定します。
    • Password: ログインパスワードを指定します。

    OAuth 認証（コードグラントフロー）

    OAuth コードグラントフローで認証するには、AuthScheme を OAuth に設定し、カスタム OAuth アプリケーションを作成します。カスタム OAuth アプリケーションの作成方法については、ヘルプドキュメントをご参照ください。

    続いて、以下のプロパティを設定します。

    • InitiateOAuth: GETANDREFRESH を指定します。OAuthAccessToken の自動取得と更新に使用します。
    • OAuthClientId: アプリケーション登録時に割り当てられたクライアント ID を指定します。
    • OAuthClientSecret: アプリケーション登録時に割り当てられたクライアントシークレットを指定します。
    • CallbackURL: アプリケーション登録時に定義したリダイレクト URI を指定します。

    接続すると、デフォルトブラウザで Oracle Eloqua Reporting の OAuth エンドポイントが開きます。ログインしてアプリケーションに権限を付与してください。アクセストークンの有効期限が切れると、ドライバーが自動的に更新します。

    OAuth 認証（パスワードグラントフロー）

    OAuth パスワードグラントフローでは、OAuth アプリケーションの資格情報とユーザー資格情報を組み合わせて認証できます。ブラウザでの手動による権限付与は必要ありません。この認証方法を使用するには、OAuth アプリを作成する必要があります（ヘルプドキュメントを参照）。

    以下のプロパティを設定します。

    • AuthScheme: OAuthPassword を指定します。
    • Company: 会社の一意の識別子を指定します。
    • User: ログインアカウント名を指定します。
    • Password: ログインパスワードを指定します。
    • OAuthClientId: カスタム OAuth アプリケーション登録時に割り当てられたクライアント ID を指定します。
    • OAuthClientSecret: カスタム OAuth アプリケーション登録時に割り当てられたクライアントシークレットを指定します。

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

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

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

  4. ウィザードでJDBC 接続URL を入力します。

    jdbc:oracleeloquareporting:AuthScheme=Basic;User=user;Password=password;Company=MyCompany;

  5. ドライバークラス名を設定します。

    cdata.jdbc.oracleeloquareporting.OracleEloquaReportingDriver
    新しいJDBC（JNDI）接続を作成
  6. レポートに必要なテーブルを選択します。 テーブルを追加
  7. SAP Crystal Reports でOracle Eloqua Reporting のデータのテーブルをリンクすることもできます。テーブル間のリンクを追加したら、NEXT をクリックします。 複数のテーブルを追加 テーブルをリンク
  8. テーブルを選択したら、選択したテーブルからレポートに表示するフィールドを選び、NEXT をクリックします。 表示するフィールドを追加
  9. レポート上の情報をグループ化するために「Group By」フィールドを選択します。 Group By フィールドを追加
  10. 集計合計に基づいてグループを並べ替え、NEXT をクリックします。 グループの並べ替え

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

チャートの作成

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

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

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

テンプレートの種類を選択

完成したレポート

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

完成したレポート

リモートデータの操作

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

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

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

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

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

はじめる準備はできましたか？

Oracle Eloqua Reporting Driver の無料トライアルをダウンロードしてお試しください：

 ダウンロード

詳細：

Oracle Eloqua Reporting Icon Oracle Eloqua Reporting JDBC Driver お問い合わせ

Oracle Eloqua Reportingと連携する強力なJavaアプリケーションを迅速に作成・デプロイできます。

この記事の内容

関連記事