次の方法で共有

HTTP 送信ポートを構成する方法

HTTP 送信ポートは、プログラムまたは BizTalk Server 管理コンソールを使用して構成できます。

HTTP 送信ポートをプログラムで構成する

HTTP アダプターは、その構成情報を BizTalk 管理データベース (構成データベースとも呼ばれます) に格納します。 カスタム XML プロパティ バッグに構成情報を格納します。 HTTP アダプターの初期化中とその実行時に、サーバーは次のように構成をアダプターに渡します。

  • HTTP 送信ハンドラーの場合、構成情報は IPersistPropertyBag インターフェイスの Load メソッドを呼び出すことによってアダプターに渡されます。

  • HTTP 送信ポートの場合、構成情報はメッセージ コンテキストのプロパティのセットとしてアダプターに渡されます。 HTTP 名前空間は、これらのプロパティをグループ化します。

    BizTalk Explorer オブジェクト モデルは、TransportTypeDataの読み取り/書き込みプロパティを含む送信ポート用のItransportInfo アダプター構成インターフェイスを公開します。 このプロパティは、名前と値のペアの XML 文字列として HTTP 送信ポート構成プロパティ バッグを受け入れます。 BizTalk Explorer オブジェクト モデルでこのプロパティを設定するには、最初に ITransportInfo インターフェイスの Address プロパティに設定する必要があります。

    ITransportInfo インターフェイスの TransportTypeData プロパティを設定する必要はありません。 設定されていない場合、HTTP アダプターは HTTP 送信ハンドラーの既定値を使用します。

    ハンドラーの構成を複製する送信ポート構成プロパティが定義されていない場合は、ハンドラーの構成プロパティが使用されます。 HTTP 送信ハンドラーに構成値がない場合、HTTP 送信アダプターはイベント ログにエラーを記録し、メッセージをバックアップ アダプターに移動します。

    構成プロパティは、メッセージ コンテキストでプログラムで設定できます。 これらのプロパティは、BizTalk Server オーケストレーション スケジュールまたはカスタム パイプライン コンポーネントで設定できます。 これらのプロパティを使用する場合は、次の規則が適用されます。

  • オーケストレーションまたは受信パイプラインのカスタム パイプライン コンポーネントで構成プロパティが設定されている場合は、次のようになります。

    • メッセージが静的送信ポートに送信された場合、プロパティ値は、その送信ポート用に構成された値で上書きされます。

    • メッセージが動的送信ポートに送信された場合、プロパティ値は上書きされません。

  • 構成プロパティが送信パイプラインのカスタム パイプライン コンポーネントで設定されている場合は、次のようになります。

    • この値は、メッセージが静的または動的な送信ポートに送信されるかどうかに関係なく上書きされません。

    次の表に、HTTP 送信場所の BizTalk Explorer オブジェクト モデルで設定できる構成プロパティの一覧を示します。

プロパティ名 タイプ 説明 制約 コメント
RequestTimeout xs:int サーバーからの応答を待機しているタイムアウト期間。 ゼロ (0) に設定すると、システムは要求メッセージのサイズに基づいてタイムアウトを計算します。 最小値: 0

最大値: MAX_LONG		 既定値: 0
コンテンツタイプ xs:string 要求メッセージのコンテンツ タイプ 最小長: 0

最大長: 256		 既定値： Text/XML
MaxRedirects xs:int HTTP アダプターが要求をリダイレクトできる最大回数。 最小値: 0

最大値: 10		 既定値: 5
UseHandlerProxySettings xs:boolean HTTP 送信ポートが送信ハンドラーのプロキシ構成を使用するかどうかを指定します。 無し 既定値： 真

true の場合、送信ポートはハンドラー レベルで指定されたプロキシ設定を使用します。 false の場合、送信アダプターは送信ポートで指定されたプロキシ情報を使用します。
UseProxy の xs:boolean HTTP アダプターがプロキシ サーバーを使用するかどうかを指定します。 プロキシ サーバーは、すべての HTTP 送信ポートで共有できます。 無し 既定値： 偽

UseHandlerProxySettings が True の場合、このプロパティは無視されます。
ProxyName xs:string プロキシ サーバー名を指定します。 最小長: 0

最大長: 256		 既定値： 空

UseHandlerProxySettings プロパティが True に設定されている場合、HTTP 送信アダプターはこのプロパティを無視します。 それ以外の場合、HTTP 送信アダプターは UseProxy が True の場合にのみこのプロパティを使用します。 UseProxy が True の場合は、このプロパティが必要です。
ProxyPort xs:int プロキシ サーバー ポートを指定します。 最小値: 0

最大値: 65535		 既定値: 80

UseHandlerProxySettings が True の場合、HTTP 送信アダプターはこのプロパティを無視します。 それ以外の場合、HTTP 送信アダプターでは、 UseProxy が True の場合にのみこのプロパティが使用されます。 UseProxy が True の場合は、このプロパティが必要です。
ProxyUsername xs:string プロキシ サーバーでの認証のユーザー名を指定します。 最小長: 0

最大長: 256		 既定値: 空

UseHandlerProxySettings が True の場合、HTTP 送信アダプターはこのプロパティを無視します。 それ以外の場合、HTTP 送信アダプターでは、 UseProxy が True の場合にのみこのプロパティが使用されます。
ProxyPassword xs:string プロキシ サーバーで認証するためのユーザー パスワードを指定します。 最小長: 0

最大長: 256		 既定値: 空

UseHandlerProxySettings が True の場合、HTTP 送信アダプターはこのプロパティを無視します。 それ以外の場合、HTTP 送信アダプターでは、 UseProxy が True の場合にのみこのプロパティが使用されます。
AuthenticationScheme xs:string 移行先サーバーで使用する認証の種類。 無し 有効な値:

- 匿名 (既定値)
- 基本
- ダイジェスト
- Kerberos
ユーザー名 xs:string サーバーでの認証に使用するユーザー名。 最小長: 0

最大長: 256		 既定値： 空

この値は、 基本 認証または ダイジェスト 認証を選択する場合に必要です。 UseSSO が True の場合、HTTP アダプターはこのプロパティの値を無視します。
パスワード xs:string サーバーでの認証に使用するユーザー パスワード。 最小長: 0

最大長: 256		 既定値: 空

この値は、 基本 認証または ダイジェスト 認証を選択する場合に必要です。 UseSSO が True の場合、このプロパティの値は無視されます。
EnableChunkedEncoding（チャンクエンコーディングを有効にする） xs:ブール型 (boolean) チャンク エンコードを HTTP アダプターで使用するかどうかを指定します。 無し 既定値：

正しい
証明書 xs:string クライアント SSL 証明書の拇印。 最小長: 0

最大長: 59		 既定値： 空
UseSSO xs:boolean 送信ポートに SSO を使用するかどうかを指定します。 無し 既定値： 偽
AffiliateApplicationName xs:string SSO に使用する関連アプリケーションの名前。 最小長: 0

最大長: 256		 既定値: 空

UseSSO が True の場合は必須。

次のコードは、これらのプロパティの設定に使用する XML 文字列を示しています。

<CustomProps>  
   <ContentType vt="8">text/xml</ContentType>  
   <RequestTimeout vt="3">0</RequestTimeout>  
   <MaxRedirects vt="3">5</MaxRedirects>  
   <UseHandlerProxySettings vt="8">-1</UseHandlerProxySettings>  
   <UseProxy vt="8">-1</UseProxy>  
   <ProxyName vt="8">sdfsd</ProxyName>  
   <ProxyPort vt="3">80</ProxyPort>  
   <ProxyUsername vt="8">Somename</ProxyUsername>  
   <ProxyPassword vt="8">Somepassword</ProxyPassword>  
   <AuthenticationScheme vt="8">Basic</AuthenticationScheme>  
   <Username vt="8">Somename</Username>  
   <Password vt="8">Somepassword</Password>  
   <EnableChunkedEncoding vt="11">1</EnableChunkedEncoding>  
   <Certificate vt="8">AAAA BBBB CCCC DDDD</Certificate>  
   <UseSSO vt="11">0</UseSSO>  
   <AffiliateApplicationName vt="8">Name</AffiliateApplicationName>  
</CustomProps>

BizTalk Server 管理コンソールを使用して HTTP 送信ポートを構成する

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

注

このトピックで説明する構成プロパティは、一方向と要求応答の両方の HTTP 送信ポートに共通です。

  1. BizTalk Server 管理コンソールで、新しい送信ポートを作成するか、既存の送信ポートをダブルクリックして変更します。 詳細については、「 送信ポートを作成する方法 」を参照してください。 すべての送信ポート オプションを構成し、[全般] タブの [トランスポート] セクションの [種類] オプションに HTTP を指定します。

  2. [全般] タブの [トランスポート] セクションで、[種類] の横にある [構成] ボタンをクリックします。

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

    これを使用する 目的
    宛先 URL 必須。 HTTP 要求を送信するアドレスを指定します。 ベース URL に追加されたクエリ文字列を含めます。

    種類: 文字列

    最大長: 256

    詳細については、「 宛先 URL プロパティの制限事項」を参照してください。 手記： 送信ポートまたは受信場所の URI は 256 文字を超えることはできません。
    チャンク エンコードを有効にする チャンク エンコードを使用するように指定します。 このオプションを有効にすると、HTTP アダプターは最大チャンク サイズが 8 KB の HTTP チャンク エンコードを使用します。 HTTP 送信ハンドラーが プロキシを使用するように構成されている場合、チャンク エンコードは暗黙的に無効になります。

    種類: ブール値

    既定値： 真
    要求タイムアウト (秒) HTTP/HTTPS 転送のタイムアウトを秒単位で指定します。 HTTP アダプターがこの時間内に応答を受信しない場合、サービスはエラーをログに記録し、再試行インフラストラクチャに基づいてメッセージを再送信します。

    0 に設定すると、BizTalk メッセージング エンジンは要求メッセージ サイズに基づいてタイムアウトを計算します。 値を指定しない場合は、ハンドラーの値が使用されます。

    種類： ロング

    最小値: 0

    最大値: MAX_LONG
    最大リダイレクト数 送信するメッセージに許可される最大リダイレクト数を指定します。

    既定値: 5

    種類： Int

    最小値: 0

    最大値: 10
    コンテンツ タイプ 要求メッセージのコンテンツ タイプを指定します。

    この値が設定されていない場合は、ハンドラーの値が使用されます。

    種類: 文字列

    最小長: 0

    最大長: 256

  4. [ HTTP トランスポートのプロパティ ] ダイアログ ボックスの [ プロキシ (ハンドラーのオーバーライド)] タブで、次の操作を行います。

    これを使用する 目的
    ハンドラーの既定のプロキシ構成を使用する 送信ポート構成で、HTTP 送信ハンドラーに指定されたプロキシ設定を使用する必要があることを指定します。

    これが既定の設定です。
    プロキシを使用しない HTTP 送信ハンドラーがプロキシ サーバーを使用するかどうかを指定します。

    選択した場合、この送信ポートの HTTP 送信ハンドラーはプロキシ サーバーを使用しません。
    [プロキシを使用する] HTTP 送信ハンドラーがプロキシ サーバーを使用するかどうかを指定します。

    選択した場合、HTTP 送信ハンドラーはプロキシ サーバーを使用します。
    サーバー この送信ポートのプロキシ サーバー アドレスを指定します。

    このプロパティは、[ プロキシを使用 ] が選択されている場合にのみ値を必要とします。

    種類: 文字列

    最小長: 0

    最大長: 256
    ポート この送信ポートのプロキシ サーバー ポートを指定します。

    このプロパティは、[ プロキシを使用 ] が選択されている場合にのみ値を必要とします。

    既定値: 80

    種類： ロング

    最小値: 0

    最大値: 65535
    ユーザー名 プロキシ サーバーでの認証のユーザー名を指定します。

    このプロパティは、[ プロキシを使用 ] が選択されている場合にのみ値を必要とします。

    種類: 文字列

    最小長: 0

    最大長: 256
    パスワード プロキシ サーバーで認証するためのユーザー パスワードを指定します。

    このプロパティは、[ プロキシを使用 ] が選択されている場合にのみ値を必要とします。

    種類: 文字列

    最小長: 0

    最大長: 256

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

    これを使用する 目的
    認証の種類 移行先サーバーで使用する認証の種類を指定します。

    有効なオプションは次のとおりです。

    - アノニマス
    - 基本
    - ダイジェスト
    - Kerberos

    既定値： アノニマス
    資格情報 使用する資格情報の種類を指定します。

    認証の種類が Basic または Digest の場合にのみ使用できます。

    有効なオプションは次のとおりです。

    - シングル サインオンを使用しない
    ユーザー名：
    移行先サーバーでの認証に使用するユーザー名。 [認証の種類] プロパティが [匿名] または [Kerberos] の場合、このオプションは無効になります。 Basic またはDigest が選択されていて、Enterprise Single Sign-On が使用されていない場合、このプロパティには値が必要です。
    最小長: 0
    最大長: 256
    パスワード：
    移行先サーバーでの認証に使用するパスワード。 [認証の種類] プロパティが [匿名] または [Kerberos] の場合、このオプションは無効になります。 Basic またはDigest が選択されていて、Single Sign-On が使用されていない場合、このプロパティには値が必要です。
    最小長: 0
    最大長: 256
    - シングル サインオンを使用する
    単一 Sign-On を使用して、移行先サーバーでの認証用のクライアント資格情報を取得するかどうかを指定します。
    関連アプリケーション
    シングル サインオンに使用する関連アプリケーションを指定します。
    シングル サインオンに含めるアプリケーションを選択します。
    最小長: 0
    最大長: 256
    SSL クライアント証明書の拇印 Secure Sockets Layer (SSL) 接続の確立に使用するクライアント証明書の拇印を指定します。

    最小長: 0

    最大長: 59

  6. [ OK] を クリックし、もう一度 [OK] を クリックして設定を保存します。

こちらもご覧ください

HTTP 送信ポートの構成