CData BizTalk Adapter for MailChimp で SQL コマンドスキーマを生成する方法

Jerod Johnson
Jerod Johnson
Director, Technology Evangelism
CData BizTalk Adapter は、データを XML として返すことで BizTalk でのMailChimp のデータの処理を容易にします。BizTalk でアクセスしたいテーブルの XML スキーマファイルを作成することで、BizTalk オーケストレーションでこのデータを利用できます。

この記事では、CData BizTalk Adapter を使用して取得したMailChimp のデータを処理するためのスキーマ生成方法を説明します。SELECT コマンド用のスキーマを生成します。

このガイドでは、CData BizTalk Adapter for MailChimp を使用して MailChimp への SQL コマンドを実行する方法を解説します。

MailChimp 用アダプターをプロジェクトに追加する

以下の手順で、BizTalk Server プロジェクトにアダプターを追加します。

  1. まだ行っていない場合は、Visual Studio で新しい BizTalk Server プロジェクトを作成します。
  2. Solution Explorer でプロジェクトを右クリックし、Add -> Add Generated Items をクリックします。
  3. 表示されるダイアログボックスで Add Adapter Metadata を選択します。
  4. 表示される Add Adapter ウィザードで、リストからアダプターを選択します。
  5. Port メニューでは、選択を空白のままにします。または、トランスポートタイプとしてアダプターが設定されている Receive Location か Send Port を選択することもできます。

SQL コマンド用のスキーマを生成する

Add Adapter ウィザードでアダプターを選択すると、Schema ウィザードが表示されます。以下の手順で接続プロパティを構成し、コマンドの結果のメタデータを取得します。

  1. Connection String ページで、認証情報やその他の接続プロパティを入力します(BizTalk アプリケーションで既に構成済みのアダプターを選択していない場合)。一般的な接続文字列は以下のとおりです:
    APIKey=myAPIKey;
    

    APIKey をアカウント設定で生成したキーに設定するか、APIKey を提供する代わりにOAuth 標準を使用してアプリケーションを認証できます。OAuth を使用すると、他のユーザーが自身のデータにアクセスできるようになります。OAuth を使って認証するには、MailChimp にアプリを登録してOAuthClientId、OAuthClientSecret、およびCallbackURL を取得する必要があります。

    OAuth の使用については、ヘルプドキュメントの「はじめに」を参照してください。

  2. 次のページ(Schema Information)の General Options セクションで、アダプターの構成に応じて Send Port または Receive Location を選択します。
  3. 結果セット全体のスキーマを生成する場合は、Message Mode メニューで Single Message オプションを選択します。結果セットの各行ごとにスキーマを生成する場合は、Message Per Row オプションを選択し、メッセージのルート要素が 'row' であることを確認します。
  4. Command Type メニューで、SQL Command を選択します。
  5. Statement Information ページの SQL Command Text ボックスに、SQL コマンドを入力します(Receive Location または Send Port を構成済みの場合は、構成した SQL コマンドがボックスに入力されています)。この例では以下のクエリを使用します:

    SELECT Name, Stats_AvgSubRate FROM Lists
    
  6. ウィザードに表示されるサマリーで設定を確認し、Finish をクリックして schema.xsd ファイルを生成します。

スキーマの処理

シンプルな BizTalk アプリケーションでスキーマを使用する方法については、チュートリアルを参照してください。

はじめる準備はできましたか?

詳細:

MailChimp 連携ソリューション