Oracle Eloqua Reporting のデータを帳票ツールbiz-Stream で連携利用する方法

宮本航太
プロダクトスペシャリスト

CData JDBC ドライバを使って、帳票ツールのbiz-Stream で Oracle Eloqua Reporting をノーコードで連携。

biz-Stream は、多様な表現が可能なWeb 帳票ソリューションです。

この記事では、biz-Stream からCData JDBC ドライバ経由でOracle Eloqua Reporting のデータにリアルタイムで連携接続して帳票から利用する方法を紹介します。CData Drivers を使うことで、RDB のようにbiz-Stream 内でOracle Eloqua Reporting のデータを扱うことができるようになります。

biz-Stream へのOracle Eloqua Reporting JDBC ドライバーの配置

デフォルトの内容でインストールした場合、以下のパスに jar ファイルが配置されますので、その jar ファイルを biz-Stream の所定のパスにコピーします。

cdata.jdbc.oracleeloquareporting.jar
cdata.jdbc.oracleeloquareporting.lic （試用版では.lic ファイルは不要）

コピー元：C:\Program Files\CData\CData JDBC Driver for OracleEloquaReporting 20xxJ\lib
コピー先：C:\Program Files (x86)\brainsellers\biz-Stream レイアウト・デザイナ\lib_jdbc

biz-Stream からOracle Eloqua Reporting への接続設定

レイアウトデザイナを起動後、リソース定義にて Oracle Eloqua Reporting への接続設定を行います。ドライバー選択のプルダウンに CData OracleEloquaReporting JDBC Driver が表示されますので選択します。

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 アプリケーション登録時に割り当てられたクライアントシークレットを指定します。

サーバURLは以下の形式で入力します。
URL:

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

JDBC Driver の接続文字列デザイナーを使う

JDBC 接続文字列を作るには、Oracle Eloqua Reporting JDBC Driver のビルトイン接続文字列デザイナーを使う方法があります。ドライバーの.jar ファイルをダブルクリックするか、コマンドラインから.jar ファイルを実行します。

Windows:

java -jar 'C:\Program Files\CData\CData JDBC Driver for OracleEloquaReporting 20xxJ\lib\cdata.jdbc.oracleeloquareporting.jar'

MacOS:

java -jar cdata.jdbc.oracleeloquareporting.jar

接続プロパティに値を入力して、生成される接続文字列をクリップボードにコピーします。

接続文字列デザイナーを使って、JDBC URL を生成する (Salesforce is shown.)

次にデータ取得条件を設定します。SQL 定義から定義名を設定し、編集ボタンをクリックします。

上のグレーエリアで右クリック → テーブルリストと選択しますと、Oracle Eloqua Reporting のオブジェクトがリストで表示されます。使用するテーブルを選択します。

ここでは取得対象の項目や条件などを設定することができます。対象項目や条件を指定できたらOKボタンをクリックし、戻った画面で追加ボタンをクリックします。

最後にデータソース設定を行います。データソース定義名に先ほど設定したものを選択し、画面下部にある追加ボタンをクリックします。これでbiz-Stream でOracle Eloqua Reporting のデータを利用する準備ができました。

Oracle Eloqua Reporting のデータをリアルタイムで参照するbiz-Stream 帳票のデザイン

用紙設定を行います。今回は A4 設定にしました。設定後は画面下部にある追加ボタンをクリックします。

ページ設定では新規ボタンをクリックします。

ここではレイアウトデザイナが帳票テンプレートを xml で保存しますので、ファイル名を設定します。

レイアウトにはさまざまなメニューがありますが、今回は表を使用します。表を設定後、Oracle Eloqua Reporting から取得したデータをセットするエリアを作成します。各セルにテキストボックスを挿入し、そのテキストボックス自体に Oracle Eloqua Reporting の項目を紐づけします。
※ヘッダーにもそれぞれテキストボックスを追加します。