PowerBuilder からAdobe Target のデータに接続してみた

CData ADO.NET providers は、PowerBuilder を含むMicrosoft .NET をサポートするあらゆるプラットフォームまたは開発テクノロジーから使用できる、使いやすい標準準拠のデータプロバイダーです。 この記事では、CData ADO.NET Provider for AdobeTarget をPowerBuilder で使う方法について説明します。

CData ADO.NET Provider for AdobeTarget を使ってデータを取得し読み書きを実行する基本的なPowerBuilder アプリケーションを作成する方法について説明します。

1. 新規WPF Window Application ソリューションで、接続プロパティに必要なすべてのビジュアルコントロールを追加します。一般的な接続文字列は次のとおりです：

   Tenant=mycompanyname;

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

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

   1. Adobe Experience にログインします。URL は「https://experience.adobe.com/#/@mycompanyname/preferences/general-section」です。
   2. 「/#/@」の後の値を抽出します。この例では「mycompanyname」です。
   3. 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 で指定された場所に保存され、接続間で確実に保持されます。

2. .NET コントロールからDataGrid コントロールを追加します。
3. DataGrid コントロールのカラムを設定します。Account テーブルからいくつかのカラムを以下に示します：

   
   <DataGrid AutoGenerateColumns="False" Margin="13,249,12,14" Name="datagrid1" TabIndex="70" ItemsSource="{Binding}">
   <DataGrid.Columns>
       <DataGridTextColumn x:Name="idColumn" Binding="{Binding Path=Id}" Header="Id" Width="SizeToHeader" />
       <DataGridTextColumn x:Name="nameColumn" Binding="{Binding Path=Id}" Header="Id" Width="SizeToHeader" />
   		...
   	</DataGrid.Columns>
   </DataGrid>
   

4. CData ADO.NET Provider for AdobeTarget アセンブリへの参照を追加します。

DataGrid 接続

ビジュアルエレメントが設定されたら、Connection、Command、およびDataAdapter のような標準のADO.NET オブジェクトを使ってSQL クエリの結果をDataTable に表示することができます：

System.Data.CData.AdobeTarget.AdobeTargetConnection conn
conn = create System.Data.CData.AdobeTarget.AdobeTargetConnection(connectionString)

System.Data.CData.AdobeTarget.AdobeTargetCommand comm
comm = create System.Data.CData.AdobeTarget.AdobeTargetCommand(command, conn)

System.Data.DataTable table
table = create System.Data.DataTable

System.Data.CData.AdobeTarget.AdobeTargetDataAdapter dataAdapter
dataAdapter = create System.Data.CData.AdobeTarget.AdobeTargetDataAdapter(comm)
dataAdapter.Fill(table)
datagrid1.ItemsSource=table.DefaultView

上のコードは、指定したクエリからDataGrid にデータをバインドできます。