HTTP アダプター (BizTalk Server サンプル)
HTTP アダプターのサンプルでは、BizTalk Serverで使用される要求/応答と要請/応答の通信パラダイムを実装する方法を示します。
このサンプルの場所
<Samples Path>\AdaptersDevelopment\HttpAdapter\
次の表は、このサンプルのファイルとその目的を示しています。
| ファイル | 説明 |
|---|---|
| \Design-Time\Adapter Management | このアダプターのデザイン時の部分を実装するプロジェクトが含まれます。 |
| \Run-Time\HttpReceive | 要求 - 応答アダプターの通信パターンを実装するプロジェクトが含まれます。 これは分離受信場所です。 |
| \Run-Time\HttpSend | 送信請求 - 応答アダプターの通信パターンを実装するプロジェクトが含まれます。 |
このサンプルの使用方法
このサンプルは、カスタム アダプターを開発するときに使用するフレームワークです。 BizTalk Server はメッセージを特定のカスタム アプリケーションに送信したり、ネイティブ アダプターが存在しないプロトコルを使用する必要がある場合があります。 サードパーティの企業は、追加のプロトコルをサポートするアダプターを作成しています。 カスタム アダプターの作成を決定する前に、プロトコルに対するアダプターが存在するかどうかを確認することをお勧めします。 通信要件をサポートするためのアダプターが見つからない場合は、独自のカスタム アダプターを開発できます。
カスタム アダプターの作成は、難しい作業になる場合があります。 このプロセスを簡略化するために、マイクロソフトはアダプター フレームワークと呼ばれる基礎を開発しました。 このフレームワークを、BizTalk Server SDK のサンプルのアダプター ソース コードと共に開発の基礎として使用できます。 カスタム アダプターとアダプター フレームワークの詳細については、このドキュメントの最後にある 「関連項目」 セクションを参照してください。
サンプル アダプターのビルドおよび初期化
重要
BizTalk 環境が 64 ビットである、またはインストール場所が変更されている場合は、それに合わせて OutboundAssemblyPath、InboundAssemblyPath、および AdapterMgmtAssemblyPath を変更する必要があります。
HTTP アダプターのサンプルをビルドして初期化するには
コマンド ウィンドウで、次のフォルダーに移動します。
<サンプル パス>\AdaptersDevelopment\HttpAdapter
次のアクションを実行するファイル Setup.bat を実行します。
HTTPAdapter とそのすべての依存関係をコンパイルします。
アダプターの受信側で使用されるインターネット インフォメーション サービス (IIS) アプリケーションを作成します。
IIS 7.0 では、この IIS アプリケーションを実行するアプリケーション プールの ID が次のグループのメンバーであることを確認する必要があります。
BizTalk 分離ホスト ユーザー グループ
IIS_WPG グループ
IIS 7.0 では、統合 .NET モードで動作するようにアプリケーションを移行する必要があります。 コマンド ライン ウィンドウから次を使用して、httpHandlers> 構成セクションの<内容を含むアプリケーション構成を移行できます (ウィンドウは管理者として実行されている必要があります)。
%systemroot%\system32\inetsrv\APPCMD.EXE migrate config "Default Web Site/HttpReceive"移行したアプリケーションは、下位レベルのプラットフォームと同様に、クラシック モードと統合 .NET モードのいずれでも実行できます。
Note
このサンプルを実行する前に、ビルド処理および初期化処理でエラーが報告されていないことを確認してください。
Note
ファイル Setup.bat を実行せずにこのサンプルのプロジェクトを開いてビルドする場合は、まず、.NET Framework厳密名ユーティリティ (sn.exe) を使用して厳密な名前キー ペアを作成する必要があります。 このキー ペアは、生成されたアセンブリの署名に使用します。
Note
Setup.bat によって行われた変更を元に戻すには、Cleanup.bat を実行します。 Setup.bat を 2 回目に実行する場合は、その前に Cleanup.bat を実行してください。
サンプル アダプターの登録
HTTP アダプターのサンプルを登録するには
Windows エクスプローラーで、BizTalk Serverのインストール ドライブに移動し、[Samples Path>\AdaptersDevelopment\HTTPAdapter] に<移動します。
サンプル アダプターをレジストリに追加するには、[HTTP] をダブルクリックします 。NET.reg。
Note
HTTP。NET.reg には、BizTalk Serverインストール ディレクトリへのハードコーディングされたパスが含まれています。 既定の場所にBizTalk Serverをインストールしなかった場合、または以前のバージョンのBizTalk ServerからBizTalk Serverインストールをアップグレードした場合は、HTTP ファイルを変更する必要があります。適切なパスを含む NET.reg。 "OutboundAssemblyPath" と "AdapterMgmtAssemblyPath" の値に関連付けられたパスを更新し、指定されたファイルの正しい場所を指すようにします。
重要
BizTalk を 64 ビット コンピューターにインストールする場合は、HKEY_CLASSES_ROOT\CLSID\ レジストリ エントリのすべてのインスタンスを HTTP で HKEY_CLASSES_ROOT\Wow6432Node\CLSID\ に変更します 。NET.reg レジストリ ファイル。
[ レジストリ エディター ] ダイアログ ボックスで、[ はい ] をクリックしてサンプル アダプターをレジストリに追加し、[OK] をクリック します。
Windows エクスプローラーを閉じるには、[ファイル] メニューの [閉じる] をクリックします。
サンプル アダプターのインストール
HTTP アダプターのサンプルをインストールするには
[スタート] メニューをクリックし、[すべてのプログラム] を選択し、[Microsoft BizTalk Server 20xx] を選択し、[BizTalk Server管理] を選択します。
BizTalk Server管理コンソールで、BizTalk Server管理ツリーを展開し、BizTalk グループ ツリーを展開してから、[プラットフォーム設定] ツリーを展開します。
[ アダプター] を右クリックし、[ 新規] をクリックし、[ アダプター] をクリックします。
[ アダプターのプロパティ ] ダイアログ ボックスで、次の操作を行います。
プロパティ 目的 名前 「HTTP.NET」と入力します。 アダプター ドロップダウン リストから [HTTP.NET ] を選択します。 説明 「 サンプル HTTP.NET アダプター」と入力します。 [OK] をクリックします。
これで、BizTalk 管理コンソールの右ウィンドウにあるアダプターの一覧にアダプターが表示されます。
ホスト インスタンスの停止と再起動
HTTP アダプターのサンプルのホスト インスタンスを停止して再起動するには
[スタート] メニューをクリックし、[すべてのプログラム] を選択し、[Microsoft BizTalk Server 20xx] を選択して、[BizTalk Server管理] を選択します。
BizTalk Server管理コンソールで、[BizTalk Server管理] ツリーを展開し、[プラットフォーム設定] を展開して、[ホスト インスタンス] をクリックします。
結果ウィンドウで、ホスト インスタンス (通常はコンピューター名) を右クリックし、[ 停止] をクリックします。
ホスト インスタンスの状態が [停止済み] に変わります。
結果ウィンドウでホスト インスタンスを右クリックし、[ 開始] をクリックします。
これで、アプリケーションで HTTP.NET アダプターを使用する準備が整いました。 アダプターを構成する場合、 Virtual Directory トランスポート プロパティの形式は /httpreceive/httpreceive.aspx?optionalQueryString の形式です。
説明
HTTP.NET アダプターは、Samples Path>\AdaptersDevelopment\BaseAdapter\v1.0 で提供されている< BaseAdapter クラスを使用します。2\. BaseAdapter プロジェクトで提供されるクラスは、アダプターの開発を迅速化するためのものです。 提供されるクラスの詳細については、BaseAdapter コードのコメントを参照してください。
参照
アダプターの登録
アダプタ サンプル – 使用法
カスタム アダプターの開発
アダプター フレームワークについて
アダプター フレームワーク ツールの使用
受信アダプターの開発
送信アダプターの開発
カスタム アダプターを展開する方法
アダプターのデザインに関するヒント
アダプターのデザイン時構成