HTTPSolicitResponse

[アーティクル]
10/14/2023

HTTPSolicitResponse サンプルは、オーケストレーションデータの処理に役立つ ASP.NET アプリケーションを活用する Microsoft BizTalk Server オーケストレーションを作成する方法を示しています。このサンプルでは、オーケストレーションは要求 - 応答のポートを利用して、ASP.NET アプリケーションにメッセージを送信し、応答を受信します。 HTTP アダプターを使用することにより、BizTalk Server オーケストレーションと ASP.NET アプリケーションを統合できます。詳細については、「 HTTP アダプター」を参照してください。

このサンプルの処理

このサンプルは、以下の手順で、乗算する 2 つの数値を含んでいる要求を受信し、その要求に応答する BizTalk Server オーケストレーションを提供します。

BizTalk Server オーケストレーションが、特定のフォルダーから .xml 入力ファイルを取得します。
次に、BizTalk Server オーケストレーションは、HTTP 要求を使用して、.xml 入力ファイルからマルチプライア ASP.NET アプリケーションに XML を転送します。
マルチプライア ASP.NET アプリケーションが、乗算を実行し、HTTP 応答で結果を XML として返すことにより、HTTP 要求に応答します。
BizTalk Server オーケストレーションが、HTTP 応答で結果を XML として受信し、特定のフォルダーの .xml ファイルに結果を書き込みます。

このサンプルの場所

<サンプルパス>\AdaptersUsage\HTTPSolicitResponse

次の表は、このサンプルのファイルとその目的を示しています。

ファイル	説明
Cleanup.bat	必要に応じて、アセンブリの展開の解除とグローバルアセンブリキャッシュ (GAC) からのアセンブリの削除、送信および受信ポートの削除、Microsoft インターネットインフォメーションサービス (IIS) の仮想ディレクトリの削除などを行います。
HttpSolicitResponse.btproj、HttpSolicitResponse.sln	マルチプライア ASP.NET アプリケーションや関連スキーマなどを使用するオーケストレーションを含む BizTalk プロジェクトのプロジェクトファイルとソースファイルを提供します。
HttpSolicitResponseBinding.xml	ポートのバインドなどの自動化されたセットアップを可能にします。
MultiplyRequest.xsd、MultiplyResponse.xsd	MultiplyRequest.xsd は乗算要求、MultiplyResponse.xsd は乗算応答の XML メッセージのスキーマを提供します。
MultiplyTwoIntegers.odx	乗算演算を要求する .xml ファイルを受信し、その要求をマルチプライア ASP.NET アプリケーションに転送してから、その応答を .xml ファイルに書き込む BizTalk Server オーケストレーションを提供します。
request_in.xml	サンプル入力ファイルです。
Setup.bat	このサンプルを作成および初期化します。
\Multiplier フォルダー内のファイル: Multiplier.aspx, Multiplier.aspx.cs, Multiplier.sln	マルチプライアサービスを実装する ASP.NET アプリケーションを構成するファイル (プロジェクトファイルとソリューションファイル、ASPX ファイル、Microsoft Visual C# .NET ソースファイルなど) を含みます。

サンプルのビルドおよび初期化

次の手順に従って、HTTPSolicitResponse サンプルをビルドおよび初期化します。

Note

受信場所の名前に大文字が含まれている場合、このサンプルは機能しません。

このサンプルをビルドおよび初期化するには

コマンドウィンドウで、次のフォルダーに移動します。

<サンプルパス>\AdaptersUsage\HTTPSolicitResponse
ファイル Setup.bat を実行すると、次のアクションが実行されます。
- このサンプルで使用する入力フォルダーと出力フォルダーを作成します。
  
  <サンプルパス>\AdaptersUsage\HttpSolicitResponse\HttpSolicitResponseInput
  
  <サンプルパス>\AdaptersUsage\HttpSolicitResponse\HttpSolicitResponseOutput
- このサンプルで使用するマルチプライア ASP.NET アプリケーションをコンパイルして構成します。
  
  Note
  
  IIS マネージャーでアプリケーションプールを作成するときに、DefaultAppPool .NET Framework バージョンを .Net Framework v4.0 に設定します。
- このサンプルで使用する BizTalk Server オーケストレーションをコンパイルし、展開します。
- 必要な BizTalk Server 受信場所およびポートを作成してバインドします。
  
  Note
  
  このサンプルは、ポートを作成してバインドする際に、以下の警告を表示します。
  
  注意
  
  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.
- 受信場所を有効にし、送信ポートを開始します。
  
  Note
  
  このサンプルのオーケストレーションは、ASP.NET アプリケーションとの HTTP 通信に双方向ポートを使用します。
  
  Note
  
  このサンプルを実行する前に、BizTalk がビルドプロセス中および初期化プロセス中にエラーを報告していないことを確認してください。
  
  Note
  
  ファイル Setup.bat を実行せずにこのサンプルのプロジェクトを開いてビルドする場合は、まず、.NET Framework厳密な名前ユーティリティ (sn.exe) を使用して厳密な名前キーペアを作成する必要があります。このキーペアは、生成されたアセンブリの署名に使用します。
  
  Note
  
  Setup.bat によって行われた変更を元に戻すには、Cleanup.bat を実行します。 Setup.bat を 2 回目に実行する場合は、その前に Cleanup.bat を実行してください。

サンプルの実行

次の手順に従って、HTTPSolicitResponse サンプルを実行します。

サンプルを実行するには

request_in.xml ファイルのコピーを HttpSolicitResponseInput フォルダーに貼り付けます。
.xml ファイルが HttpSolicitResponseOutput フォルダーに作成されたことを確認します。この .xml ファイルの名前はメッセージ ID GUID に基づいて付けられます。このファイルには、乗算演算の XML 形式の結果が含まれています。

Note

入力ファイルのオペランド値を変更すると、異なる乗算演算を実行できます。

説明

このサンプルは、HTTP インターフェイスを公開する異なる外部システムと通信するようにカスタマイズできます。

MultiplyRequest.xsd ファイルと MultiplyResponse.xsd ファイルは、それぞれ、マルチプライア ASP.NET アプリケーションの入力データおよび出力データの形式を定義する XML スキーマです。オーケストレーションは、これらのファイルを使用して要求メッセージと応答メッセージの種類を定義します。

参照

HTTP アダプターサンプル

次の方法で共有