Adobe Target のデータ用のシンプルな VCL アプリケーションを構築

Dibyendu Datta
Lead Technology Evangelist

CData ODBC Driver for Adobe Target を使用して RAD Studio でAdobe Target のデータを表示するシンプルな VCL アプリケーションを構築する方法を説明します。

Embarcadero RAD Studio は、Delphi および C++Builder アプリケーション用の開発環境を提供します。CData ODBC Driver for Adobe Target を使用すると、RAD Studio 内からリアルタイムAdobe Target のデータにアクセスでき、データをテーブル、ビュー、ストアドプロシージャとして抽象化してAdobe Target のデータの取得が可能です。この記事では、Adobe Target に接続し、フォームデザイナを使用してシンプルな VCL アプリケーションを作成する方法を説明します。

Adobe Target のデータへの接続を作成

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

Adobe Target に接続するには、以下に記載されているOAuth 接続プロパティとともにTenant プロパティを指定する必要があります。他の接続プロパティは処理動作に影響を与える可能性がありますが、接続には影響しません。

以下のステップでTenant 名を確認できます。

Adobe Experience にログインします。URL は「https://experience.adobe.com/#/@mycompanyname/preferences/general-section」です。
「/#/@」の後の値を抽出します。この例では「mycompanyname」です。
Tenant 接続プロパティをその値に設定します。

ユーザーアカウント（OAuth）

すべてのユーザーアカウントフローでAuthScheme をOAuthClient に設定する必要があります。

注意：OAuth を介したAdobe 認証では、2週間ごとにトークンを更新する必要があります。

すべてのアプリケーション

CData では、OAuth 認証を簡素化する組み込みOAuth アプリケーションを提供しています。または、カスタムOAuth アプリケーションを作成することもできます。詳細については、ヘルプドキュメントの「カスタムOAuthアプリの作成」をご確認ください。

OAuth アクセストークンの取得

接続するには以下のプロパティを設定します：

InitiateOAuth：GETANDREFRESH に設定して、OAuth 交換を自動的に実行し、必要に応じてOAuthAccessToken を更新します。
OAuthClientId：アプリを登録した際に割り当てられたクライアントID に設定します。
OAuthClientSecret：アプリを登録した際に割り当てられたクライアントシークレットに設定します。
CallbackURL：アプリを登録した際に定義されたリダイレクトURI に設定します。例：https://localhost:3333

これらの設定により、プロバイダーはAdobe Target からアクセストークンを取得し、それを使用してデータを要求します。OAuth値はOAuthSettingsLocation で指定された場所に保存され、接続間で確実に保持されます。

次に、以下の手順で Data Explorer を使用してAdobe Target のデータへの FireDAC 接続を作成します。

新しい VCL フォームアプリケーションで、Data Explorer の FireDAC ノードを展開します。
Data Explorer で ODBC Data Source ノードを右クリックします。
［新しい接続の追加］をクリックします。
接続の名前を入力します。
表示される FireDAC Connection Editor で、DataSource プロパティに Adobe Target 用 ODBC DSN の名前を設定します。

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

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

TFDConnection コンポーネントをフォームにドロップし、以下のプロパティを設定します。
- ConnectionDefName:Adobe Target のデータへの FireDAC 接続を選択します。
- Connected: メニューから True を選択し、表示されるダイアログで資格情報を入力します。
TFDQuery コンポーネントをフォームにドロップし、以下のプロパティを設定します。
- Connection: まだ指定されていない場合は、このプロパティを TFDConnection コンポーネントに設定します。
- SQL: SQL プロパティのボタンをクリックしてクエリを入力します。例:
```
SELECT Id, Name FROM Activities WHERE Type = 'AB'
```
- Active: このプロパティを true に設定します。
TDataSource コンポーネントをフォームにドロップし、以下のプロパティを設定します。
- DataSet: このプロパティのメニューで、TFDQuery コンポーネントの名前を選択します。
TDBGrid コントロールをフォームにドロップし、以下のプロパティを設定します。
- DataSource: TDataSource の名前を選択します。
TFDGUIxWaitCursor をフォームにドロップします。これはランタイムエラーを回避するために必要です。