次の方法で共有


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

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

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

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 トランスポートのプロパティ ] ダイアログ ボックスの [ WCF 拡張機能 ] タブで、次の操作を行います。

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

こちらもご覧ください

WCF-Custom アダプターの構成