C++Builder でOracle Eloqua Reporting のデータにデータバインドするコントロールを作成

CData ODBC ドライバー for Oracle Eloqua Reporting を使用すると、C++Builder の標準データアクセスコンポーネントを使ってライブのOracle Eloqua Reporting のデータ への接続を簡単に統合できます。この記事では、C++Builder でシンプルな VCL（Visual Component Library）アプリケーションを作成し、Oracle Eloqua Reporting のデータ に接続してクエリを実行し、グリッドに結果を表示する方法を説明します。さらに、FireDAC コンポーネントを使ってコードからコマンドを実行する方法も紹介します。

Oracle Eloqua Reporting のデータへの接続を作成

まだ設定していない場合は、ODBC DSN（データソース名）で接続プロパティを指定します。これはドライバーインストールの最終ステップです。Microsoft ODBC データソースアドミニストレーターを使って ODBC DSN を作成・設定できます。

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

次に、以下の手順に従って Data Explorer を使用し、Oracle Eloqua Reporting への FireDAC 接続を作成します。

1. 新しい VCL Forms アプリケーションで、Data Explorer の FireDAC ノードを展開します。
2. Data Explorer の ODBC Data Source ノードを右クリックします。
3. Add New Connection をクリックします。
4. 接続の名前を入力します。
5. 表示される FireDAC Connection Editor で、DataSource プロパティをOracle Eloqua Reporting の ODBC DSN の名前に設定します。

Oracle Eloqua Reporting のデータに接続する VCL アプリケーションを作成

以下の手順に従って、クエリの結果をグリッドに表示するシンプルな VCL アプリケーションからOracle Eloqua Reporting のデータ のクエリを開始します。

1. TFDConnection コンポーネントをフォームにドロップし、以下のプロパティを設定します：

   • ConnectionDefName：Oracle Eloqua Reporting への FireDAC 接続を選択します。
   • Connected：メニューから True を選択し、表示されるダイアログで資格情報を入力します。

2. TFDQuery コンポーネントをフォームにドロップし、以下のプロパティを設定します：

   • Connection：TFDConnection コンポーネントに設定します（まだ指定されていない場合）。

   • SQL：SQL プロパティのボタンをクリックし、クエリを入力します。例：

     SELECT ,  FROM  WHERE  = ''
     

   • Active：このプロパティを true に設定します。

3. TDataSource コンポーネントをフォームにドロップし、以下のプロパティを設定します：

   • DataSet：このプロパティのメニューで、TFDQuery コンポーネントの名前を選択します。

4. TDBGrid コントロールをフォームにドロップし、以下のプロパティを設定します：

   • DataSource：TDataSource の名前を選択します。
5. TFDGUIxWaitCursor をフォームにドロップします — これは実行時エラーを回避するために必要です。

FireDAC コンポーネントを使ってOracle Eloqua Reporting にコマンドを実行

TFDConnection および TFQuery コンポーネントを使用して、Oracle Eloqua Reporting のデータ にクエリを実行できます。このセクションでは、TFQuery コンポーネントを使ったクエリ実行のOracle Eloqua Reporting 固有の例を紹介します。

Oracle Eloqua Reporting のデータに接続

データソースに接続するには、TFDConnection コンポーネントの Connected プロパティを true に設定します。コードから同じプロパティを設定することもできます：

FDConnection1->ConnectionDefName = "CData Oracle Eloqua Reporting ODBC Source";
FDConnection1->Connected = true;

TFDQuery コンポーネントをOracle Eloqua Reporting のデータ に接続するには、コンポーネントの Connection プロパティを設定します。設計時に TFDQuery コンポーネントを追加すると、上記のアプリケーションのように、その Connection プロパティはフォーム上の TFDConnection を指すように自動的に設定されます。

パラメータ化クエリの作成

パラメータ化クエリを作成するには、以下の構文を使用します：

FDQuery1->SQL->Text = "select * from  where  = :";
FDQuery1->ParamByName("")->AsString = "";
FDQuery1->Open();

上記の例では、文字列型の入力パラメータを名前でバインドし、結果のデータセットを開いています。

ステートメントの準備

ステートメントの準備は、システムリソースと時間の両方でコストがかかります。ステートメントの準備中は、接続がアクティブで開いている必要があります。デフォルトでは、FireDAC は同じクエリを何度もコンパイルすることを避けるためにクエリを準備します。ステートメントの準備を無効にするには、ResourceOptions.DirectExecute を True に設定します。例えば、クエリを一度だけ実行する必要がある場合などです。

クエリの実行

SELECT クエリなど、結果セットを返すクエリを実行するには、Open メソッドを使用します。Open メソッドはクエリを実行し、結果セットを返して開きます。クエリが結果セットを生成しない場合、Open メソッドはエラーを返します。

FDQuery1->SQL->Text = "select * from  where  = :";
FDQuery1->ParamByName("")->AsString = "";
FDQuery1->Open();

関連記事

以下に、RAD Studio、Delphi、C++ Builder で CData ODBC ドライバーを使用するための他の記事を紹介します。

• Delphi でOracle Eloqua Reporting のデータにデータバインドするコントロールを作成
• RAD Studio Data Explorer でOracle Eloqua Reporting のデータを表示
• Oracle Eloqua Reporting のデータ用のシンプルな VCL アプリケーションを作成