BizTalk で Google Sheets に対してストアドプロシージャを実行する
ストアドプロシージャは、SELECT、INSERT、UPDATE、DELETE ステートメントでは表現できない Google Sheets のアクションを実装します。この記事では、ストアドプロシージャ用のスキーマを生成する方法を説明します。生成したスキーマを使用して、Send Port からストアドプロシージャを実行できます。
アダプターをプロジェクトに追加する
Add Adapter ウィザードを使用して、Visual Studio の BizTalk Server プロジェクトにアダプターを追加します。アダプターはストアドプロシージャの入力パラメータと結果に関するメタデータを返します。このメタデータはスキーマの作成に必要です。
- Solution Explorer でプロジェクトを右クリックし、Add -> Add Generated Items をクリックします。
- 表示されるダイアログボックスで Add Adapter Metadata を選択します。
- 表示される Add Adapter ウィザードで、リストからアダプターを選択します。
- Port メニューでは、選択を空白のままにします。または、Google Sheets Adapter を使用するよう構成された Receive Location か Send Port を選択します。
Connection String ページで、Send Port または Receive Location で構成されていない場合は、認証情報やその他の接続プロパティを入力します。
一般的な接続文字列は以下のとおりです：
Spreadsheet=MySheet;
スプレッドシートに接続するには、Google への認証を行い、Spreadsheet 接続プロパティにスプレッドシートの名前またはフィードリンクを設定します。Google Drive のスプレッドシートの情報一覧を表示したい場合は、認証後にSpreadsheets ビューにクエリを実行します。
ClientLogin（ユーザー名 / パスワード認証）は、2012年4月20日より正式に非推奨となり、現在は利用できません。代わりに、OAuth 2.0 認証規格を使用してください。 個々のユーザーに代わってGoogle API にアクセスするには、埋め込みクレデンシャルを使用するか、独自のOAuth アプリを登録します。
OAuth は、Google Apps ドメインのユーザーに代わって、サービスアカウントを使って接続することもできます。サービスアカウントで認証するには、OAuth JWT 値を取得するためのアプリケーションを登録する必要があります。
Google アカウント、Google Apps アカウント、二段階認証を使用するアカウントなど、様々なアカウントタイプでGoogle スプレッドシートに接続する方法は、ヘルプドキュメントの「はじめに」を参照してください。
スキーマを生成する
Add Adapter ウィザードで接続プロパティを入力すると、Schema ウィザードが表示されます。
- 次のページ（Schema Information）で、Google Sheets Adapter を使用するよう構成した Send Port を選択します。
- CData Google Sheets Adapter を Solicit-Response Send Port で構成している場合は、One-Way オプションを無効にします。
- Command Type メニューで、Stored Procedure を選択します。
- メニューからストアドプロシージャを選択し、入力パラメータの値を入力します。
- ウィザードに表示されるサマリーで設定を確認し、Finish をクリックして schema.xsd ファイルを生成します。
スキーマの処理
シンプルな BizTalk アプリケーションでスキーマを使用する方法については、チュートリアルを参照してください。