HTTPSolicitResponse サンプルでは、オーケストレーション データの処理に役立つ ASP.NET アプリケーションを利用する Microsoft BizTalk Server オーケストレーションを作成する方法を示します。 このサンプルでは、オーケストレーションは要求/応答ポートを使用して、ASP.NET アプリケーションにメッセージを送信し、応答を取得します。 HTTP アダプターを使用して、BizTalk Server オーケストレーションと ASP.NET アプリケーションの統合を実現します。 詳細については、「 HTTP アダプター」を参照してください。
このサンプルが何をするか
このサンプルは、乗算する 2 つの数値を含む要求を受信し、次の一連の手順を使用してその要求を満たす BizTalk Server オーケストレーションで構成されています。
BizTalk Server オーケストレーションは、特定のフォルダーから .xml 入力ファイルを取得します。
オーケストレーションは、HTTP リクエストを使用して、ファイルから ASP.NET 乗算アプリケーションに XML を転送します。
アプリケーション ASP.NET 乗数は、乗算を実行し、HTTP 応答で結果を XML として返すことによって、HTTP 要求に応答します。
オーケストレーションは、HTTP 応答で結果を XML として受け取り、その結果を特定のフォルダー内の .xml ファイルに書き込みます。
このサンプルを検索する場所
< サンプル パス>\AdaptersUsage\HTTPSolicitResponse
次の表に、このサンプルのファイルとその目的を示します。
| ファイル(複数可) | 説明 |
|---|---|
| Cleanup.bat | アセンブリを展開解除し、グローバル アセンブリ キャッシュ (GAC) からアセンブリを削除します。は、送受信ポートを削除します。は、必要に応じて Microsoft インターネット インフォメーション サービス (IIS) 仮想ディレクトリを削除します。 |
| HttpSolicitResponse.btproj、HttpSolicitResponse.sln | BizTalk プロジェクトのオーケストレーションを含み、乗算ASP.NET アプリケーションや関連するスキーマを使用するプロジェクトファイルとソースファイルを提供します。 |
| HttpSolicitResponseBinding.xml | ポート バインドなどの自動セットアップを提供します。 |
| MultiplyRequest.xsd、MultiplyResponse.xsd | 乗算要求と応答 XML メッセージのスキーマをそれぞれ提供します。 |
| MultiplyTwoIntegers.odx | 乗算操作を要求する .xml ファイルを受信し、要求を乗算 ASP.NET アプリケーションに転送し、その応答をファイルに書き込む BizTalk Server オーケストレーションを提供します。 |
| request_in.xml | サンプル入力ファイル。 |
| Setup.bat | このサンプルをビルドして初期化します。 |
| \Multiplier フォルダー内: Multiplier.aspx、Multiplier.aspx.cs、Multiplier.sln |
乗数サービスを実装する ASP.NET アプリケーションを構成するファイル (プロジェクトファイル、ソリューション ファイル、ASPX ファイル、Microsoft Visual C# .NET ソース ファイルなど) が含まれます。 |
サンプルのビルドと初期化
HTTPSolicitResponse サンプルをビルドして初期化するには、次の手順に従います。
注
このサンプルは、受信場所の名前に大文字が含まれている場合は機能しません。
サンプルをビルドして初期化するには
コマンド ウィンドウで、次のフォルダーに移動します。
< サンプル パス>\AdaptersUsage\HTTPSolicitResponse
次のアクションを実行するファイル Setup.batを実行します。
このサンプルの入力フォルダーと出力フォルダーを作成します。
< サンプル パス>\AdaptersUsage\HttpSolicitResponse\HttpSolicitResponseInput
< サンプル パス>\AdaptersUsage\HttpSolicitResponse\HttpSolicitResponseOutput
このサンプルで使用されるASP.NET乗算アプリケーションをコンパイルおよび構成します。
注
IIS マネージャーでアプリケーション プールを作成するときに、 DefaultAppPool .NET Framework のバージョンを .Net Framework v4.0 に設定します。
このサンプルで使用する BizTalk Server オーケストレーションをコンパイルして展開します。
必要な BizTalk Server 受信場所とポートを作成してバインドします。
注
このサンプルでは、ポートを作成してバインドするときに、次の警告が表示されます。
注
Warning: Receive handler not specified for receive location "HttpSolicitResponseReceiveLocation"; updating with first receive handler with matching transport type.注
Warning: Host not specified for orchestration "Microsoft.Samples.BizTalk.HttpSolicitResponse.MultiplyTwoIntegers"; updating with first available host.受信場所を有効にし、送信ポートを開始します。
注
このサンプルのオーケストレーションでは、ASP.NET アプリケーションとの HTTP 操作に双方向ポートを使用します。
注
このサンプルを実行する前に、BizTalk がビルドおよび初期化プロセス中にエラーを報告していないことを確認する必要があります。
注
ファイル Setup.batを実行せずにこのサンプルのプロジェクトを開いてビルドする場合は、まず .NET Framework 厳密名ユーティリティ (sn.exe) を使用して厳密な名前キー ペアを作成する必要があります。 このキー ペアを使用して、結果のアセンブリに署名します。
注
Setup.batによって行われた変更を元に戻すには、Cleanup.bat実行します。 2 回目 Setup.bat 実行する前に、Cleanup.bat を実行する必要があります。
サンプルの実行
HTTPSolicitResponse サンプルを実行するには、次の手順を使用します。
サンプルを実行するには
ファイル request_in.xml のコピーを HttpSolicitResponseInput フォルダーに貼り付けます。
HttpSolicitResponseOutput フォルダーに作成された .xml ファイルを確認します。 この .xml ファイルの名前は、メッセージ ID GUID に基づいています。 このファイルには、乗算演算の XML 形式の結果が含まれています。
注
入力ファイル内のオペランド値を変更して、別の乗算演算を実行できます。
コメント
このサンプルは、HTTP インターフェイスを公開する別の外部システムと通信するように調整できます。
MultiplyRequest.xsd ファイルと MultiplyResponse.xsd ファイルは、アプリケーション ASP.NET 乗数の入力データと出力データの形式を定義する XML スキーマです。 オーケストレーションでは、これらのファイルを使用して、要求メッセージと応答メッセージの種類を定義します。