BizTalk で YouTube Analytics に対してストアドプロシージャを実行する
ストアドプロシージャは、SELECT、INSERT、UPDATE、DELETE ステートメントでは表現できない YouTube Analytics のアクションを実装します。この記事では、ストアドプロシージャ用のスキーマを生成する方法を説明します。生成したスキーマを使用して、Send Port からストアドプロシージャを実行できます。
アダプターをプロジェクトに追加する
Add Adapter ウィザードを使用して、Visual Studio の BizTalk Server プロジェクトにアダプターを追加します。アダプターはストアドプロシージャの入力パラメータと結果に関するメタデータを返します。このメタデータはスキーマの作成に必要です。
- Solution Explorer でプロジェクトを右クリックし、Add -> Add Generated Items をクリックします。
- 表示されるダイアログボックスで Add Adapter Metadata を選択します。
- 表示される Add Adapter ウィザードで、リストからアダプターを選択します。
- Port メニューでは、選択を空白のままにします。または、YouTube Analytics Adapter を使用するよう構成された Receive Location か Send Port を選択します。
Connection String ページで、Send Port または Receive Location で構成されていない場合は、認証情報やその他の接続プロパティを入力します。
一般的な接続文字列は以下のとおりです:
ContentOwnerId=MyContentOwnerId;ChannelId=MyChannelId;
YouTube Analytics への接続には、OAuth 認証標準を使います。ユーザーアカウントまたはサービスアカウントで認証できます。組織全体のアクセススコープをCData 製品に許可するには、サービスアカウントが必要です。下記で説明するとおり、CData 製品はこれらの認証フローをサポートします。
ユーザー資格情報の接続プロパティを設定せずに接続できます。次を設定して、接続してください。ChannelId:YouTube チャンネルのId に設定。指定しない場合、認証されたユーザーのチャンネルのデータが返されます。ContentOwnerId:コンテンツ所有者のレポートを生成する場合に設定。接続すると、CData 製品はデフォルトブラウザでOAuth エンドポイントを開きます。ログインして、アプリケーションにアクセス許可を与えます。CData 製品がOAuth プロセスを完了します。
他のOAuth 認証フローについては、ヘルプドキュメントの「OAuth 認証の使用」を参照してください。
スキーマを生成する
Add Adapter ウィザードで接続プロパティを入力すると、Schema ウィザードが表示されます。
- 次のページ(Schema Information)で、YouTube Analytics Adapter を使用するよう構成した Send Port を選択します。
- CData YouTube Analytics Adapter を Solicit-Response Send Port で構成している場合は、One-Way オプションを無効にします。
- Command Type メニューで、Stored Procedure を選択します。
- メニューからストアドプロシージャを選択し、入力パラメータの値を入力します。
- ウィザードに表示されるサマリーで設定を確認し、Finish をクリックして schema.xsd ファイルを生成します。
スキーマの処理
シンプルな BizTalk アプリケーションでスキーマを使用する方法については、チュートリアルを参照してください。