次の方法で共有


WCF-Custom 送信ハンドラーを構成する方法

WCF-Custom アダプターが、machine.config 以外の場所からカスタム動作拡張機能を検索する場合は、送信ハンドラーのプロパティを構成する必要があります。

WCF-Custom アダプターが machine.config 以外の場所からカスタム動作拡張機能を検索する理由

BizTalk Serverによって使用されるカスタム動作拡張機能は、machine.config に登録されます。動作拡張機能を読み込む前に、WCF-Custom アダプターは、machine.config で動作拡張機能を検索します。ただし、machine.config は、特定のコンピューターで実行されているすべてのアプリケーションで必要な構成情報を格納するのに理想的です。 一方、WCF カスタム動作拡張機能は、コンピューター上で実行されているすべてのアプリケーションではなく、BizTalk Serverによってのみ必要になる場合があります。 したがって、machine.config にカスタム動作拡張機能を保存すれば目的にかないますが、ここは最適な場所ではありません。

BizTalk Serverでは、アダプター ハンドラーのプロパティによって、WCF-Custom アダプターがカスタム動作拡張機能を検索できる追加の場所が提供されます。 machine.config で既に利用可能な動作拡張機能を置き換えるものではないことに注意してください。

その他の考慮事項

WCF-Custom 送信ハンドラーのプロパティを構成する際は、次の点を考慮してください。

  • カスタム動作拡張機能は machine.config かアダプター ハンドラーのプロパティのどちらか一方で利用可能にする必要があります。 カスタム動作拡張機能を両方の場所に重複して設定しないでください。

  • カスタム動作拡張機能が既に machine.config で利用できる場合、同じカスタム動作拡張機能をアダプター ハンドラーのプロパティに設定しようとすると、すぐにエラーが発生します。

  • カスタム動作拡張機能が既にアダプター ハンドラーのプロパティに設定されている場合、machine.config を同じカスタム動作拡張機能で更新すると、実行時エラーが発生し、イベント ログにも記録されます。

  • アダプター ハンドラーのプロパティを設定する前に、カスタム動作拡張機能で参照されるアセンブリがグローバル アセンブリ キャッシュ (GAC) に存在する必要があります。

アダプター ハンドラーのプロパティの構成

WCF-Custom 送信ハンドラーを構成するには、このトピックの手順を実行します。

アダプター ハンドラーのプロパティを構成するには

  1. BizTalk 管理コンソールで、[BizTalk Server管理] を展開し、[BizTalk グループ]、[プラットフォームの設定] の順に展開し、[アダプター] を展開します。

  2. 展開されたアダプターの一覧で、[ WCF-Custom] をクリックし、右側のウィンドウで、構成する送信ハンドラーを右クリックし、[ プロパティ] をクリックします。

  3. [ アダプター ハンドラーのプロパティ ] ダイアログ ボックスの [ 全般 ] タブの [ ホスト名 ] の一覧で、送信ハンドラーを関連付けるホストを選択し、[ プロパティ] をクリックします。

  4. [ WCF-Custom Transport Properties]\(WCF カスタム トランスポートのプロパティ \) ダイアログ ボックスの [WCF Extensions]\( WCF 拡張機能\) タブで、次の操作を行います。

    プロパティ 目的
    [インポート] WCF カスタム動作拡張機能が登録されている WCF 構成ファイルをインポートします。 このボタンをクリックすると、[ WCF 構成のインポート ] ダイアログ ボックスが開き、WCF 構成ファイルを参照して見つけます。 有効な WCF 構成ファイルを選択する必要があります。 WCF 構成スキーマの詳細については、 の「Windows Communication Foundation 構成スキーマ」 https://go.microsoft.com/fwlink/?LinkId=163953を参照してください。
    エクスポート WCF カスタム動作拡張機能を WCF 構成ファイルにエクスポートします。 このボタンをクリックすると、[ WCF 構成のエクスポート ] ダイアログ ボックスが開き、WCF 構成ファイルを参照して保存します。
    [クリア] 既存の WCF カスタム動作拡張機能をアダプター ハンドラーのプロパティから消去します。

参照

WCF-Custom アダプターの構成