次の方法で共有

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

  • [アーティクル]

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

Note

次の手順を実行する前に、受信ポートを追加する必要があります。 詳細については、「 受信ポートを作成する方法」を参照してください。

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

HTTP アダプタの構成情報は BizTalk 管理データベース (構成データベース) に書き込まれます。 この構成はカスタム XML プロパティ バッグに保存されます。

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

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

プロパティ名 Type 説明 制限 説明
ResponseContentType string HTTP アダプタによってこの受信場所からクライアントに返送される HTTP 応答メッセージのコンテンツの種類です。 このプロパティは、要求 - 応答の受信ポートに対してのみ有効です。一方向の受信ポートでは無視されます。 String

最小長: 0

最大長: 256		 既定値: Text/XML
ループバック Boolean この場所で受信した要求メッセージが、送信ポートにルーティングされるか、またはこの受信場所にルーティングされて応答として送信されるかを指定します。 このプロパティは、要求 - 応答の受信ポートに対してのみ有効です。 一方向の受信ポートでは無視されます。 なし 既定値: False
ReturnCorrelationHandle Boolean メッセージの送信に成功した場合に、クライアントに対する HTTP 応答で送信されたメッセージの関連付けトークンを HTTP アダプタから送信するかどうかを指定します。 このプロパティは、一方向の受信ポートに対してのみ有効です。要求 - 応答の受信ポートでは無視されます。 なし 既定値: True
SuspendFailedRequests Boolean 失敗した HTTP 要求を中断するかどうかを指定します。 値を True に設定すると、失敗した要求は中断されます。また、一方向の受信ポートの場合はクライアントに "受理" 状態コード (202) が送信され、双方向の受信ポートの場合はクライアントに "エラー" 状態コード (500) が送信されます。 なし 既定値: False
UseSSO Boolean HTTP アダプタが、この受信場所で受信するメッセージに SSO チケットを発行するかどうかを指定します。 なし 既定値: False

これらのプロパティを設定する 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 directory>/BTSHTTPReceive.dll

    /<virtual directory>/BTSHTTPReceive.dll?Purchase%20Order

    この場所 (すべてのサブフォルダを含む) には、複数の ISAPI 拡張 (BTSHTTPReceive.dll) を格納しないでください。

    型: String

    最大長: 256 注: 送信ポートまたは受信場所の URI は 256 文字を超えることはできません。
    パブリック アドレス この受信場所の完全修飾 URI を指定します。 このプロパティの値は、サーバー名と仮想ディレクトリの組み合わせです。 BizTalk メッセージング エンジンは、このアドレスを外部のパートナーに公開します。 指定した URI は、取引先から BizTalk Server へのメッセージの送信時に接続するためのパブリック Web サイト URL を示す必要があります。

    この情報は省略可能で、BizTalk Server では使用されません。 このパラメーターを使用すると、管理者は、受信場所が関連付けられているパブリック URL を記述できます。

    型: String

    最小長: 0

    最大長: 256
    コンテンツ タイプを返す 受信場所からクライアントに返送される HTTP 応答メッセージのコンテンツの種類を指定します。 このプロパティは、要求 - 応答の受信場所に対してのみ有効です。

    既定値: text/xml

    型: String

    最小長: 0

    最大長: 256
    Loopback この場所で受信した要求メッセージが、送信ポートにルーティングされるか、またはこの受信場所にルーティングされて応答として送信されるかを定義します。 このプロパティは、要求 - 応答の受信場所に対してのみ有効です。

    既定値: False

    型： ブール
    成功時に関連付けハンドルを返す (一方向のポート専用) 成功時に、クライアントに対する HTTP 応答で送信されたメッセージの関連付けトークンを受信場所から送信することを定義します。 このプロパティは、一方向の受信場所に対してのみ有効です。

    既定値: True

    型： ブール
    シングル サインオンを使用する エンタープライズ シングル サインオンが使用されることを示します。

    既定値: False

    型：ブール値注: このオプションが有効になっている場合は、SSO システム レベルで [チケットを許可する] オプションも有効にする必要があります。 [チケットの許可] オプションは、SSO 管理 MMC インターフェイスで使用できる [SSO システムのプロパティ] ダイアログ ボックスの [オプション] タブで構成できます。 このオプションが有効で、SSO システム レベルの [チケットの許可] オプションが有効になっていない場合、この受信場所で受信したメッセージはすべて中断されます。
    失敗した要求を中断する 受信処理に失敗した HTTP 要求を中断するかどうかを示します。

    値を False に設定すると、失敗した要求は破棄され、エラー状態コード (401 または 500) がクライアントに送信されます。

    True の値は、失敗した要求を中断し、一方向の受信ポートの場合は "Accepted" 状態コード (200) をクライアントに送信し、双方向受信ポートの場合は "Error" 状態コード (500) をクライアントに送信することを示します。

    既定値: False

    型： ブール

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

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

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

Note

同一プロセスを共有する SOAP と HTTP を使用する IIS 構成は無効です。 プロセスごとに 1 つの分離受信場所のみを指定できます。