Blazor でOracle Eloqua Reporting のデータにリアルタイムで連携するアプリを構築

杉本和也
リードエンジニア

ASP.NET Core Blazor C# でOracle Eloqua Reporting にSQL でクエリ。

Blazor は、.NET を使って対話型のクライアント側Web UI を構築するためのフレームワークです。JavaScript の代わりにC# を使って、UI を作れるところが魅力です。また、既存の.NET ライブラリや.NET エコシステムを使うことができる利点があります。

CData ADO.NET Provider for OracleEloquaReporting は、LINQ やEntity Framework などの標準のADO.NET インターフェースを使ってOracle Eloqua Reporting を操作可能にします。Blazor が.NET Core 対応をしているため、Server Side Blazor からADO.NET Provider を使うことができます。この記事では、Server Side Blazor からOracle Eloqua Reporting に接続して直接SQL クエリを実行する方法を説明します。

CData ADO.NET Provider for OracleEloquaReporting のインストール

CData ADO.NET Provider は、通常であればRDB に接続するフレームワークである ADO.NET DataAdapter やLinqToSQL（もしくはDapper などのORM を挟んでもいいです）であり、Oracle Eloqua Reporting のデータへもRDB と同感覚でアクセスが可能になります。

CData のWebsite からProvider をダウンロードして、マシンにインストールします。NuGet からインストールすることも可能です。Oracle Eloqua Reporting ADO.NET Data Provider で検索してください。

NuGet でADO.NET Oracle Eloqua Reporting Provider をインストール

Blazor でOracle Eloqua Reporting にデータ連携するアプリを構築

Blazor にADO.NET Provider for OracleEloquaReporting を接続

Visual Studio を立ち上げて、Blazor アプリのプロジェクトを作成します。

ソリューションエクスプローラーで「依存関係」から右クリックで「プロジェクト参照の追加」をクリック。
参照マネージャーが開くので、「参照」ボタンをクリックして、先ほどインストールしたADO.NET Provider の.dll を選択します。「C:\Program Files\CData\CData ADO.NET Provider for OracleEloquaReporting 2019J\lib etstandard2.0」内のSystem.Data.CData.OracleEloquaReporting.dll」を参照に選びます。

ADO.NET for OracleEloquaReporting の.dll をBlazor アプリから参照

Blazor でOracle Eloqua Reporting のデータをSELECT

サンプルプロジェクトの「Page」→「Index.razor」を開きます。

以下のコードを書きます。使っているクエリはおなじみの標準SQL です。Oracle Eloqua Reporting 固有のAPI を書かなくてもRDB と同感覚でSQL が書けるところがADO.NET Prover for OracleEloquaReporting の強味です。

      @page "/"
      @using System.Data;
      @using System.Data.CData.OracleEloquaReporting;

      <h1>Hello, world!</h1>

      Welcome to your Data app.

      <div class="row">
          <div class="col-12">

              @using (OracleEloquaReportingConnection connection = new OracleEloquaReportingConnection(
                "AuthScheme=Basic;User=user;Password=password;Company=MyCompany;"))
              {
                  var sql = "SELECT ,  FROM  WHERE  = ''";
                  var results = new DataTable();

                  OracleEloquaReportingDataAdapter dataAdapter = new OracleEloquaReportingDataAdapter(sql, connection);
                  dataAdapter.Fill(results);

                  <table class="table table-bordered">
                      <thead class="thead-light">
                          <tr>
                              @foreach (DataColumn item in results.Rows[0].Table.Columns)
                              {
                                  <th scope="col">@item.ColumnName</th>
                              }
                          </tr>
                      </thead>
                      <tbody>
                          @foreach (DataRow row in results.Rows)
                          {
                              <tr>
                                  @foreach (var column in row.ItemArray)
                                  {
                                      <td>@column.ToString()</td>
                                  }
                              </tr>
                          }
                      </tbody>
                  </table>
              }
          </div>
      </div>

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

プロジェクトをリビルドして実行します。このようにOracle Eloqua Reporting からデータを直接取得し、HTML テーブル形式にレンダリングしています。

Blazor アプリからOracle Eloqua Reporting のデータをクエリ

もちろんSaaS データソースへの接続の場合には、RDB 向けのドライバーと違い最終的にはHTTP リクエストが行われるので、サーバーサイド Blazor としてサーバーサイドから実行されるのか、クライアントサイド Blazor として、実行中のブラウザからHTTPリクエストが行われるのかの違いはあります。そのあたりはネットワークやプロキシの設定として注意が必要でしょう。設定はコード内の接続プロパティで可能です。

まとめ

このようにサーバーサイドBlazor アプリから簡単にADO.NET Provider を使ってOracle Eloqua Reporting にリアルタイムでデータ取得を行うアプリを作ることができました。Blazor が.NET Core、フレームワークのツール群を使えるというメリットを活かすことができます。今回はSELECT * でしたが、フィルタリングやJOIN も可能です。是非、30日の無償評価版でシンプルかつパワフルなADO.NET Provider でのサーバーサイドBlazor 連携をお試しください。