HTTP 受信場所を構成する方法

HTTP 受信場所アダプター変数は、プログラムまたは BizTalk Server 管理コンソールを使用して設定できます。 受信場所にプロパティが設定されていない場合は、BizTalk Server 管理コンソールで設定された既定の受信ハンドラー値が使用されます。

プログラムで HTTP 受信場所を構成する方法

HTTP アダプターは、その構成情報を BizTalk 管理データベース (構成データベースとも呼ばれます) に格納します。 構成は、カスタム XML プロパティ バッグに格納されます。

BizTalk Explorer オブジェクト モデルは、TransportTypeData の読み取り/書き込みプロパティを持つ IReceiveLocation 構成インターフェイスを公開します。 このプロパティは、名前と値のペアの XML 文字列内の HTTP 受信場所構成プロパティ バッグを受け入れます。

IReceiveLocation の TransportTypeData プロパティを設定する必要はありません。 設定されていない場合は、HTTP 受信場所構成の既定値が使用されます。 次の表に、既定値の一覧と、BIZTalk Explorer オブジェクト モデルで HTTP 受信場所に設定できる構成プロパティの一覧を示します。

これらのプロパティを設定する XML 文字列の形式は次のとおりです。

<CustomProps>  
   <UseSSO vt="11">-1</UseSSO>  
   <SuspendFailedRequests vt="11">-1</SuspendFailedRequests>  
   <ReturnCorrelationHandle vt="11">-1</ReturnCorrelationHandle>  
   <ResponseContentType vt="8">text/xml</ResponseContentType>  
   <LoopBack vt="11">-1</LoopBack>  
</CustomProps>  

BizTalk Server 管理コンソールを使用して HTTP 受信場所を構成する方法

BizTalk Server 管理コンソールを使用して受信場所を構成するには、次の手順に従います。

HTTP 受信場所の変数を構成するには

1. HTTP 受信場所を操作するようにインターネット インフォメーション サービス (IIS) を構成します。 IIS の構成手順については、「 HTTP 受信場所用に IIS を構成する方法」を参照してください。

2. BizTalk Server 管理コンソールで、 BizTalk Server管理を展開し、 BizTalk グループを展開し、 アプリケーションを展開し、受信場所を作成するアプリケーションを展開します。

3. 左側のウィンドウで、[ 受信ポート ] ノードをクリックします。 次に、右側のウィンドウで、既存の受信場所に関連付けられている受信ポート、または新しい受信場所に関連付ける受信ポートを右クリックし、[ プロパティ] をクリックします。

4. [ 受信ポートのプロパティ ] ダイアログ ボックスの左側のウィンドウで [ 受信場所] を選択し、右側のウィンドウで既存の受信場所をダブルクリックするか、[ 新規 ] をクリックして新しい受信場所を作成します。

5. [受信場所のプロパティ] ダイアログ ボックスの [種類] の横にある [トランスポート] セクションで、ドロップダウン リストから [HTTP] を選択し、[構成] をクリックします。

6. [ HTTP トランスポートのプロパティ ] ダイアログ ボックスで、次の操作を行います。

   これを使用する	目的
   仮想ディレクトリと ISAPI 拡張機能	HTTP/HTTPS 受信場所で受信したメッセージを投稿する仮想ディレクトリの名前を指定します。 仮想ディレクトリには、受信場所 DLL の名前とオプションのクエリ文字列が含まれます。 仮想ディレクトリ名の例を次に示します。 /<virtual ディレクトリ>/BTSHTTPReceive.dll /<仮想ディレクトリ>/BTSHTTPReceive.dll?%20Order を購入する この場所には、すべてのサブフォルダーを含めて、BTSHTTPReceive.dll ISAPI 拡張機能を1つ以上含んではいけません。 種類: 文字列 最大長: 256 注: 送信ポートまたは受信場所の URI は 256 文字を超えることはできません。
   パブリック アドレス	この受信場所の完全修飾 URI を指定します。 このプロパティの値は、サーバー名と仮想ディレクトリの組み合わせです。 BizTalk メッセージング エンジンは、このアドレスを外部パートナーに公開します。 指定した URI は、BizTalk Server にメッセージを送信するときに、取引先が接続するパブリック Web サイトの URL を指定する必要があります。 この情報は省略可能であり、BizTalk Server では使用されません。 このパラメーターを使用すると、管理者は受信場所が関連付けられているパブリック URL を文書化できます。 種類: 文字列 最小長: 0 最大長: 256
   コンテンツ タイプを返す	受信場所がクライアントに送り返す HTTP 応答メッセージのコンテンツ タイプを指定します。 このプロパティは、要求/応答の受信場所に対してのみ有効です。 既定値: text/xml 種類: 文字列 最小長: 0 最大長: 256
   ループバック	受信場所で受け取った要求メッセージを、送信ポートまたはこの受信場所にルーティングして応答として送信されるように定義します。 このプロパティは、要求/応答の受信場所に対してのみ有効です。 既定値： 偽 種類: ブール値
   成功した場合、相関ハンドルを返します（一方向ポートのみ）	成功した場合、受信場所が HTTP 応答で送信されたメッセージの関連付けトークンをクライアントに送信することを定義します。 このプロパティは、一方向の受信場所に対してのみ有効です。 既定値： 真 種類: ブール値
   シングル サインオンを使用する	Enterprise Single Sign-On が使用されていることを示します。 既定値： 偽 種類：ブール値注: このオプションが有効になっている場合は、SSO システム レベルでチケットを許可するオプションも有効にする必要があります。 [チケットの許可] オプションは、SSO 管理 MMC インターフェイスで使用できる [SSO システムのプロパティ] ダイアログ ボックスの [オプション] タブで構成できます。 このオプションが有効で、SSO システム レベルの [チケットの許可] オプションが有効になっていない場合、この受信場所で受信したメッセージは一時停止されます。
   失敗した要求を中断する	受信処理に失敗する HTTP 要求を中断するかどうかを示します。 False の値は、失敗した要求を破棄し、エラー状態コード (401 または 500) をクライアントに送信することを示します。 値 True は、失敗した要求を中断し、一方向の受信ポートの場合は "Accepted" 状態コード (200) をクライアントに送信し、双方向受信ポートの場合は "Error" 状態コード (500) をクライアントに送信することを示します。 既定値： 偽 種類: ブール値

7. [OK] をクリックして設定を保存します。

8. [受信場所のプロパティ] ダイアログ ボックスに適切な値を入力して受信場所の構成を完了し、[OK] をクリックして設定を保存します。 [ 受信場所のプロパティ ] ダイアログ ボックスの詳細については、「 受信場所を作成する方法」を参照してください。

   HTTP クライアントが HTTP 場所を呼び出している間、HTTP アダプターは匿名、基本、ダイジェスト、または Windows 統合認証を使用して HTTP クライアントを認証します。 ユーザーが検証されると、ユーザー コンテキストが受信ハンドラーに渡されます。