LINQ を使ってPostmark のデータに連携する方法

この記事では、CData ADO.NET Data Provider for API 経由でLINQ を使ってPostmark テーブルにアクセスする方法を説明します。これを行うには、Entity Framework にLINQ を使います。これにより接続を作成し、あらゆる CData ADO.NET Data Providers からLINQ を使ってデータにアクセスできるようになります。

1. Visual Studio の新規プロジェクトで、プロジェクトを右クリックし［新しい項目の追加］を選択します。［ADO.NET Entity Data Model］を追加します。
2. ［データベースから生成］を選択し、［次へ］をクリックします。
3. ［接続の追加］をクリックし、データソースタイプを "CData Postmark Data Source" に変更します。

4. データソースの接続情報を入力します。一般的な接続プロパティは以下のとおりです：

   API キー認証の設定

   Postmark は、リクエストの認証にサーバー API トークンを使用します。各 Postmark サーバーは独自の API トークンを持ち、そのサーバーに関連付けられたメッセージ、バウンス、テンプレート、統計情報へのアクセスを制御します。

   Server API Token を取得するには、Postmark アカウントにログインし、接続したいサーバーに移動します。サーバー設定の API Tokens に移動して、Server API token というラベルのトークンをコピーしてください。

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

   • AuthScheme：APIKey に設定します。
   • APIKey：Postmark の Server API Token に設定します。この値は、すべてのリクエストで X-Postmark-Server-Token ヘッダーとして送信されます。

   接続文字列の例：

   Profile=C:\profiles\Postmark.apip;AuthScheme=APIKey;ProfileSettings="APIKey=your-server-api-token"
   

   Postmark への接続

   認証を設定すると、Postmark に接続して、OutboundMessages、Bounces、Templates などの利用可能なテーブルからデータをクエリできます。

   Below is a typical connection string:

   Profile=C:\profiles\Postmark.apip;AuthScheme=APIKey;ProfileSettings="APIKey=your-server-api-token"


5. エンティティ接続をApp.Config に保存する場合は、エンティティ名を設定します。この例では、APIEntities をエンティティ接続としてApp.Config に設定しています。
6. モデル名を入力し、モデルに含めたいテーブルまたはビューを選択します。

作成したエンティティを使って、選択、更新、削除、および挿入コマンドが実行できます。例：

APIEntities context = new APIEntities();
var bouncesQuery = from bounces in context.Bounces  select bounces;
foreach (var result in bouncesQuery) {
	Console.WriteLine("{0} {1} ", result.Id, result.);
}
	

サポートされたLINQ のクエリ例は、ヘルプドキュメントの「LINQ およびEntity Framework」をご参照ください。