PowerBuilder から JDBC 経由で Oracle Eloqua Reporting のデータ に接続

CData JDBC ドライバー for Oracle Eloqua Reporting は、 PowerBuilder を含む、JDBC をサポートするあらゆるプラットフォームや開発技術から使用できる標準ベースのコントロールです。 この記事では、PowerBuilder で CData JDBC Driver for Oracle Eloqua Reporting を使用する方法について説明します。

ここでは、CData JDBC Driver for Oracle Eloqua Reporting を使用してデータを取得する基本的な PowerBuilder アプリケーションの作成方法を説明します。

PowerBuilder から Oracle Eloqua Reporting のデータ に接続

以下の手順に従って、Database Painter ツールを使用し、Oracle Eloqua Reporting 用の JDBC URL に基づくデータベースプロファイルを作成します。データベースプロファイルを使用して接続プロパティを保存できます。Database Painter では、データをグラフィカルに操作したり、SQL クエリを実行したりできます。

1. ドライバーの JAR ファイルを PowerBuilder のクラスパスに追加します。CLASSPATH システム環境変数を、インストールディレクトリの lib サブフォルダにあるドライバー JAR へのパスに設定します。

   Note: PowerBuilder Classic を使用している場合は、Tools -> System Options -> Java をクリックしてドライバー JAR へのパスを追加することもできます。

2. Tools -> Database Painter をクリックします。
3. JDBC ノードを右クリックし、New Profile をクリックします。
4. Database Profile Setup ダイアログで、以下の情報を入力します。
   • Profile Name: プロファイルのわかりやすい名前を入力します。
   • Driver Name: ドライバーのクラス名を入力します: cdata.jdbc.oracleeloquareporting.OracleEloquaReportingDriver
   • URL: 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 は以下のとおりです。

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

   
5. テーブルを表示および編集するには、テーブルを右クリックして Edit Data -> Grid をクリックします。

PowerBuilder コントロールで Oracle Eloqua Reporting のデータ を使用

標準の PowerBuilder オブジェクトを使用して JDBC データソースに接続し、クエリを実行できます。以下の例では、Oracle Eloqua Reporting のデータ を DataWindow に取得する方法を示します。以下のコードを open メソッドに追加できます。

SQLCA.DBMS = "JDBC"
SQLCA.AutoCommit = False
SQLCA.DBParm = "Driver='cdata.jdbc.oracleeloquareporting.OracleEloquaReportingDriver',URL='jdbc:oracleeloquareporting:AuthScheme=Basic;User=user;Password=password;Company=MyCompany;";
CONNECT USING SQLCA;
dw_.SetTransObject(SQLCA);
dw_.Retrieve();