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

この記事では、CData API Driver for ADO.NET をPowerBuilder で使う方法を紹介します。これらの標準準拠コントロールは扱いやすく、Appeon PowerBuilder をはじめ、Microsoft .NET に対応したさまざまなプラットフォームや開発テクノロジーで利用できます。

この記事では、CData API Driver for ADO.NET を使って PowerBuilder からデータを取得する基本的なアプリケーションを作成する方法を紹介します。

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

   Profile=C:\profiles\Outlook.apip;AuthScheme=OAuth;InitiateOAuth=GETANDREFRESH;OAuthClientId=your_client_id;OAuthClientSecret=your_client_secret;TenantId=your_tenant_id;CallbackUrl=http://localhost:33333;

   OAuth 認証の設定

   Microsoft Graph API は認証に OAuth 2.0 を使用します。OAuth 認証情報（Client ID と Client Secret）を取得するには、Microsoft Azure Portal でアプリケーションを登録する必要があります。

   OAuth 認証情報の取得

   1. Azure Portal にログインします。
   2. Azure Active Directory > App registrations に移動します。
   3. New registration をクリックして新しいアプリケーションを作成します。
   4. アプリケーション名を入力し、適切なアカウントの種類を選択します。
   5. Redirect URI をアプリケーションのコールバック URL に設定します（デスクトップアプリの場合は http://localhost:33333 など）。
   6. Register をクリックしてアプリケーションを作成します。
   7. アプリケーションの概要ページで Application (client) ID をコピーします。これが OAuthClientId になります。
   8. Certificates & secrets に移動して、新しいクライアントシークレットを作成します。
   9. クライアントシークレットの値をコピーします。これが OAuthClientSecret になります。
   10. API permissions に移動して、必要な Microsoft Graph API の権限を追加します：
       • Mail.Read - メールメッセージへのアクセス用
       • Contacts.Read - 連絡先へのアクセス用
       • Calendars.Read - カレンダーイベントへのアクセス用
       • Tasks.Read - To Do タスクへのアクセス用
       • offline_access - リフレッシュトークンの取得用
   11. Grant admin consent をクリックして、これらの権限を付与します。

   OAuth での接続

   以下の接続プロパティを設定して接続を確立してください：

   • AuthScheme：OAuth に設定します。
   • InitiateOAuth：GETANDREFRESH に設定します。CData API Profile for Outlook が OAuth プロセスを自動的に進め、アクセストークンを取得します。
   • OAuthClientId：Azure Portal の Application (client) ID に設定します。
   • OAuthClientSecret：Azure Portal のクライアントシークレットの値に設定します。
   • TenantId：Azure AD のテナント識別子（GUID または 'contoso.onmicrosoft.com' のようなドメイン名）に設定します。
   • CallbackURL：アプリ登録で指定したリダイレクト URI に設定します（デスクトップアプリの場合は http://localhost:33333 など）。

   接続文字列の例

   Profile=C:\profiles\Outlook.apip;AuthScheme=OAuth;InitiateOAuth=GETANDREFRESH;OAuthClientId=your_client_id;OAuthClientSecret=your_client_secret;TenantId=your_tenant_id;CallbackUrl=http://localhost:33333;
   

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=}" Header="" Width="SizeToHeader" />
   		...
   	</DataGrid.Columns>
   </DataGrid>
   

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

DataGrid 接続

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

System.Data.CData.API.APIConnection conn
conn = create System.Data.CData.API.APIConnection(connectionString)

System.Data.CData.API.APICommand comm
comm = create System.Data.CData.API.APICommand(command, conn)

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

System.Data.CData.API.APIDataAdapter dataAdapter
dataAdapter = create System.Data.CData.API.APIDataAdapter(comm)
dataAdapter.Fill(table)
datagrid1.ItemsSource=table.DefaultView

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