Oracle Eloqua Reporting JDBC Driver を使用した OBIEE でのレポート作成

Jerod Johnson
Jerod Johnson
Director, Technology Evangelism
Oracle Eloqua Reporting JDBC Driver を OBIEE にデプロイして、エンタープライズ全体でリアルタイムレポートを実現します。

CData JDBC Driver for Oracle Eloqua Reporting は、標準的なデータベースドライバーとして、Java ベースのレポーティングサーバーにOracle Eloqua Reporting のデータへのリアルタイムアクセスを統合できます。この記事では、Oracle Business Intelligence Enterprise Edition（OBIEE）にドライバーをデプロイし、変更がリアルタイムに反映されるOracle Eloqua Reporting のデータのレポートを作成する方法を説明します。

JDBC Driver のデプロイ

以下の手順で、JDBC Driver を WebLogic のクラスパスに追加します。

WebLogic 12.2.1 の場合、ドライバーの JAR ファイルと .lic ファイルを DOMAIN_HOME\lib に配置するだけで完了です（例：ORACLE_HOME\user_projects\domains\MY_DOMAIN\lib）。これらのファイルは起動時にサーバーのクラスパスに追加されます。

手動でクラスパスにドライバーを追加することもできます（以前のバージョンでは必須）。setDomainEnv.cmd（Windows）または setDomainEnv.sh（Unix）の PRE_CLASSPATH の先頭に以下を追加します。このスクリプトは、そのドメインのフォルダ内の bin サブフォルダにあります（例：ORACLE_HOME\user_projects\domains\MY_DOMAIN\bin）。 

set PRE_CLASSPATH=your-installation-directory\lib\cdata.jdbc.oracleeloquareporting.jar;%PRE_CLASSPATH%

すべてのサーバーを再起動します（例：DOMAIN_HOME\bitools\bin の stop コマンドと start コマンドを実行）。

Oracle Eloqua Reporting 用 JDBC データソースの作成

JDBC Driver をデプロイしたら、BI Publisher から JDBC データソースを作成できます。

  1. BI Publisher にログインします（URL は例えば http://localhost:9502/analytics）。Administration -> Manage BI Publisher をクリックします。
  2. JDBC Connection -> Add Data Source をクリックします。
  3. 以下の情報を入力します：
    • Data Source Name：ユーザーがレポートで接続を作成する際に使用する名前を入力します。
    • Driver Type：Other を選択します。
    • Database DriverClass：ドライバークラス cdata.jdbc.oracleeloquareporting.OracleEloquaReportingDriver を入力します。
    • Connection String：JDBC URL を入力します。

      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 の構築には、Oracle Eloqua Reporting JDBC Driver に組み込まれた接続文字列デザイナーを使用できます。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行します。

      java -jar cdata.jdbc.oracleeloquareporting.jar

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

      JDBC URL を構成する際、Max Rows 接続プロパティの設定も検討してください。これにより返される行数が制限され、レポートやビジュアライゼーションの設計時のパフォーマンス向上に特に役立ちます。

      一般的な JDBC URL は以下のとおりです：

      jdbc:oracleeloquareporting:AuthScheme=Basic;User=user;Password=password;Company=MyCompany;
    • Username：ユーザー名を入力します。
    • Password：パスワードを入力します。
  4. Security セクションで、許可するユーザーロールを選択します。

リアルタイム Oracle Eloqua Reporting レポートの作成

これで、リアルタイムOracle Eloqua Reporting のデータに基づいたレポートや分析を作成できます。以下の手順で、標準のレポートウィザードを使用して、Oracle Eloqua Reporting のデータの変更がリアルタイムに反映されるインタラクティブなレポートを作成します。

  1. グローバルヘッダーで、New -> Data Model をクリックします。
  2. Diagram タブで、メニューから SQL query を選択します。
  3. クエリの名前を入力し、Data Source メニューで作成した Oracle Eloqua Reporting JDBC データソースを選択します。
  4. standard SQL を選択し、以下のようなクエリを入力します： 
    SELECT ,  FROM  WHERE  = ''
  5. View Data をクリックして、レポート作成に使用するサンプルデータを生成します。
  6. サンプルデータに含める行数を選択し、View をクリックしてから、Save As Sample Data をクリックします。
  7. Create Report -> Use Data Model をクリックします。
  8. Guide Me を選択し、Select Layout ページで含めるレポートオブジェクトを選択します。この例では Chart と Table を選択します。
  9. のような数値カラムを Y 軸の Drop Value Here ボックスにドロップします。 のようなディメンションカラムを X 軸の Drop Label Here ボックスにドロップします。
  10. Refresh をクリックすると、Oracle Eloqua Reporting のデータの変更が反映されます。

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

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

 ダウンロード

詳細：

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

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

この記事の内容

関連記事