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

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

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

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

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

以下の手順で、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 アプリケーションで既に構成済みのアダプターを選択していない場合)。一般的な接続文字列は以下のとおりです:
    OAuthClientId=MyOAuthClientId;OAuthClientSecret=MyOAuthClientSecret;CallbackURL=http://localhost:portNumber;
    

    LinkedIn Ads 接続プロパティの取得・設定方法

    LinkedIn Ads はOAuth 認証標準を使用します。CData 製品では組込みOAuth が利用できるので、接続プロパティを設定することなく接続を試行するだけで、ブラウザ経由でAAS に認証できます。詳しくは、ヘルプドキュメントの「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 VisibilityCode, Comment FROM Analytics WHERE EntityId = '238'
    
  6. ウィザードに表示されるサマリーで設定を確認し、Finish をクリックして schema.xsd ファイルを生成します。

スキーマの処理

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

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

詳細:

LinkedIn Ads 連携ソリューション