BizTalk で Backlog に対してストアドプロシージャを実行する

ストアドプロシージャは、SELECT、INSERT、UPDATE、DELETE ステートメントでは表現できない Backlog のアクションを実装します。この記事では、ストアドプロシージャ用のスキーマを生成する方法を説明します。生成したスキーマを使用して、Send Port からストアドプロシージャを実行できます。

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

Add Adapter ウィザードを使用して、Visual Studio の BizTalk Server プロジェクトにアダプターを追加します。アダプターはストアドプロシージャの入力パラメータと結果に関するメタデータを返します。このメタデータはスキーマの作成に必要です。

1. Solution Explorer でプロジェクトを右クリックし、Add -> Add Generated Items をクリックします。
2. 表示されるダイアログボックスで Add Adapter Metadata を選択します。
3. 表示される Add Adapter ウィザードで、リストからアダプターを選択します。
4. Port メニューでは、選択を空白のままにします。または、Backlog Adapter を使用するよう構成された Receive Location か Send Port を選択します。

5. Connection String ページで、Send Port または Receive Location で構成されていない場合は、認証情報やその他の接続プロパティを入力します。

   一般的な接続文字列は以下のとおりです：

   ApiKey=YOUR_API_KEY;Url=https://yourURL.backlog.com;
   

   Backlog への接続に使用できる認証方法は、API キーおよびOAuth の2つです。

   API キー認証

   ApiKey およびURL をログインクレデンシャルに設定します。 ApiKey を取得するには：

   1. Backlog の個人設定ページを開きます。
   2. 「API」セクションをクリックして、「メモ」にAPI キーについての説明を追加し、「登録」ボタンをクリックします。トークンが生成されます。
   3. ApiKey にAPI キーを指定します。
   4. URL はBacklog のテナントURL から取得できます。

   OAuth 認証

   ユーザー名やパスワードへのアクセスを保有していない場合や、それらを使いたくない場合にはOAuth ユーザー同意フローを使用します。認証方法については、ヘルプドキュメントを参照してください。

スキーマを生成する

Add Adapter ウィザードで接続プロパティを入力すると、Schema ウィザードが表示されます。

1. 次のページ（Schema Information）で、Backlog Adapter を使用するよう構成した Send Port を選択します。
2. CData Backlog Adapter を Solicit-Response Send Port で構成している場合は、One-Way オプションを無効にします。
3. Command Type メニューで、Stored Procedure を選択します。
4. メニューからストアドプロシージャを選択し、入力パラメータの値を入力します。
5. ウィザードに表示されるサマリーで設定を確認し、Finish をクリックして schema.xsd ファイルを生成します。

スキーマの処理

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