次の方法で共有

WCF アダプターを使用して WCF 機能拡張ポイントを有効にする方法

  • [アーティクル]

WCF-Custom アダプターと WCF-CustomIsolated アダプターを使用して、3 つの WCF 拡張ポイント (動作拡張、バインド要素拡張、バインド拡張機能) を有効にします。 そのためには、まず WCF 拡張ポイントを実装するアセンブリをグローバル アセンブリ キャッシュ (GAC) にインストールしてから、コンピューター上の machine.config ファイルを変更してから、BizTalk Server管理コンソールを使用して WCF-Custom または WCF-CustomIsolated アダプターを構成します。

WCF 拡張ポイントの詳細については、「 WCF の拡張 」を参照してください。

前提条件

BizTalk Server Administrators グループのメンバーであるアカウントでサインインします。 BizTalk アプリケーションの展開と管理に必要なアクセス許可 について詳しく説明します。

WCF 拡張ポイントを実装するアセンブリを GAC にインストールする

  1. WCF 機能拡張ポイントを実装するアセンブリを、ローカル コンピューター上のフォルダーにコピーします。

  2. WCF 機能拡張ポイントが使用するアセンブリがある場合、そのアセンブリをローカル コンピューター上のフォルダーにコピーします。

  3. Visual Studio コマンド プロンプトを起動します。

  4. 次のコマンドを入力します。

    gacutil.exe /if "<アセンブリ .dll ファイル>へのパス"

  5. これにより、アセンブリが GAC にインストールされて、同じアセンブリ名を持つ既存のアセンブリは上書きされます。

  6. Visual Studio コマンド プロンプトで、この手順の手順 1 と 2 でコピーしたすべてのアセンブリに対して手順 4 と 5 を繰り返します。

  7. 複数の BizTalk Server ランタイム コンピュータと管理コンピュータがある場合は、すべてのコンピュータで手順 1. ～ 6. を繰り返します。

    Note

    WCF アダプターの WCF 機能拡張ポイントを有効にするには、アダプターを実行している BizTalk ホスト インスタンスが、WCF 機能拡張ポイントが実装されているアセンブリを実行時に読み込む必要があります。

WCF バインド拡張機能の machine.config ファイルを構成する

  1. コマンド プロンプトで、%FrameworkDir%\v4 に移動します。X.XXXXX\CONFIG フォルダーを開き、メモ帳を使用して machine.config ファイルを開きます。

  2. メモ帳で、machine.config ファイルに system.serverModel>\<extensions> 要素がない<場合は、machine.config ファイルの構成要素>内<にそれらの要素を追加し、system.serverModel>\<extensions> 要素内<に WCF バインド拡張機能の bindingExtensions> 要素を追加<します。 たとえば、カスタム バインド拡張機能 netHttpBinding を有効にするには、machine.config ファイルの構成要素>内に<次のコードを追加します。

    <system.serviceModel>  
  <extensions>  
    <bindingExtensions>  
      <add name="netHttpBinding" type="Microsoft.Samples.Channels.NetHttpBindingCollectionElement, NetHttpBinding, Version=3.0.0.0, Culture=neutral, PublicKeyToken=5b637b51c4aaa2a8" />  
    </bindingExtensions>        
  </extensions>  
</system.serviceModel>

    Note

    • 登録するアセンブリの情報は、 gacutil /lr<assembly_name> コマンドを使用して確認できます。
    • この要素 の bindingExtensions を参照してください。

  3. メモ帳で、machine.config ファイルを保存します。

  4. 複数のBizTalk Serverランタイム コンピューターと管理コンピューターがある場合は、すべてのコンピューターで、この手順の手順 1 から 3 を繰り返します。

    Note

    BizTalk ホスト インスタンスとBizTalk Server管理コンソールの WCF 拡張ポイントを処理するには、WCF インフラストラクチャのすべてのコンピューターでこれらの手順を繰り返す必要があります。

BizTalk 管理コンソールを使用して WCF バインド拡張機能を構成する

  1. [BizTalk Server管理] を開きます。

    Note

    BizTalk Server管理コンソールが既に開かれている場合は、BizTalk Server管理コンソールを再起動します。

  2. WCF-Custom アダプターを使用する場合は、BizTalk Server管理コンソールで [プラットフォームの設定] を展開し、[ホスト インスタンス] を展開して、アダプターを実行している BizTalk ホスト インスタンスを再起動します。

  3. WCF-CustomIsolated アダプターを使用する場合は、IIS 管理コンソールで、WCF 受信場所に関連付けられたアプリケーション プールを再起動します。

  4. WCF 拡張ポイントを使用するように受信場所を構成する場合は、BizTalk Server管理コンソールで[BizTalk グループ]、[BizTalkアプリケーション>]、[受信場所] の順に展開<し、右側のウィンドウで [受信場所>] をダブルクリックします<。

    • [ 受信場所のプロパティ ] ダイアログ ボックスの [ 種類 ] ドロップダウン リストで、使用する WCF アダプターに応じて [ WCF-Custom ] または [ WCF-CustomIsolated ] を選択し、[ 構成] をクリックします。

  5. WCF 拡張ポイントを使用するように送信ポートを構成する場合は、BizTalk Server管理コンソールで[BizTalk グループ]、[BizTalkアプリケーション>]、[送信ポート] の順に展開<し、右側のウィンドウで [送信ポート>] をダブルクリックします<。

    • [ 送信ポートのプロパティ ] ダイアログ ボックスの [ 種類 ] ドロップダウン リストで、[ WCF-Custom] を選択し、[ 構成] をクリックします。

  6. [トランスポートのプロパティ] ダイアログ ボックスの [ バインド ] タブで、バインド拡張機能を選択し、トランスポートの残りの設定を構成します。

  7. BizTalk Server管理コンソールで、[OK] ボタンをクリックして開いているすべてのダイアログ ボックスを閉じ、エラー メッセージと誤ったイベント ログが表示されていないことを確認します。

WCF バインド要素拡張子の machine.config ファイルを構成する

  1. コマンド プロンプトで、%FrameworkDir%\v4 に移動します。X.XXXXX\CONFIG フォルダーを開き、メモ帳を使用して machine.config ファイルを開きます。

  2. メモ帳で、machine.config ファイルに system.serverModel>\<extensions> 要素がない<場合は、machine.config ファイルの構成要素>内<にそれらの要素を追加し、system.serverModel>\<extensions> 要素内<に WCF バインド要素拡張機能の bindingElementExtensions> 要素を追加<します。 たとえば、カスタム バインド要素拡張機能の droppingInterceptor を有効にするには、machine.config ファイルの構成要素>内に<次のコードを追加します。

    <system.serviceModel>  
  <extensions>  
    <bindingElementExtensions>  
      <add name="droppingInterceptor" type="Microsoft.ServiceModel.Samples.DroppingServerElement, MessageInterceptor, Version=0.0.0.0, Culture=neutral, PublicKeyToken=098514eef14aa34a"/>  
    </bindingElementExtensions>  
  </extensions>  
</system.serviceModel>

    Note

    • 登録するアセンブリの情報は、 gacutil /lr<assembly_name> コマンドを使用して確認できます。
    • この要素の bindingElementExtensions を参照してください。

  3. メモ帳で、machine.config ファイルを保存します。

  4. 複数のBizTalk Serverランタイム コンピューターと管理コンピューターがある場合は、すべてのコンピューターで、この手順の手順 1 から 3 を繰り返します。

    Note

    BizTalk ホスト インスタンスとBizTalk Server管理コンソールの WCF 拡張ポイントを処理するには、WCF インフラストラクチャのすべてのコンピューターでこれらの手順を繰り返す必要があります。

BizTalk 管理コンソールを使用して WCF バインド要素拡張機能を構成する

  1. [BizTalk Server管理] を開きます。

    Note

    BizTalk Server管理コンソールが既に開かれている場合は、BizTalk Server管理コンソールを再起動します。

  2. WCF-Custom アダプターを使用する場合は、BizTalk Server管理コンソールで [プラットフォームの設定] を展開し、[ホスト インスタンス] を展開して、アダプターを実行している BizTalk ホスト インスタンスを再起動します。

  3. WCF-CustomIsolated アダプターを使用する場合は、IIS 管理コンソールで、WCF 受信場所に関連付けられたアプリケーション プールを再起動します。

  4. WCF 拡張ポイントを使用するように受信場所を構成する場合は、BizTalk Server管理コンソールで[BizTalk グループ]、[BizTalkアプリケーション>]、[受信場所] の順に展開<し、右側のウィンドウで [受信場所>] をダブルクリックします<。

    • [ 受信場所のプロパティ ] ダイアログ ボックスの [ 種類 ] ドロップダウン リストで、使用する WCF アダプターに応じて [ WCF-Custom ] または [ WCF-CustomIsolated ] を選択し、[ 構成] をクリックします。

  5. WCF 拡張ポイントを使用するように送信ポートを構成する場合は、BizTalk Server管理コンソールで[BizTalk グループ]、[BizTalkアプリケーション>]、[送信ポート] の順に展開<し、右側のウィンドウで [送信ポート>] をダブルクリックします<。

    • [ 送信ポートのプロパティ ] ダイアログ ボックスの [ 種類 ] ドロップダウン リストで、[ WCF-Custom] を選択し、[ 構成] をクリックします。

  6. [トランスポートのプロパティ] ダイアログ ボックスの [ バインド ] タブの [ バインドの種類 ] ドロップダウン リストで、[ customBinding] を選択します。

  7. [トランスポートのプロパティ] ダイアログ ボックスの [ バインド ] タブで、[バインド ] ボックスの 一覧のクライアント領域を右クリックし、[ 拡張機能の追加] をクリックします。

  8. [ バインド要素拡張機能の選択 ] ダイアログ ボックスで、バインド要素拡張機能を選択し、[ OK] をクリックします。

  9. [トランスポートのプロパティ] ダイアログ ボックスの [ バインド ] タブで、前の手順で追加したバインド要素拡張機能の種類に応じて、[ バインド ] リストに追加されたバインド要素の順序を次のように調整します。

    • [ バインド ] ボックスの一覧で、バインド要素の拡張機能を右クリックし、[拡張機能を 上へ移動 ] または [ 拡張機能を下へ移動] をクリックします。 [バインド] ボックスの一覧の最も低い バインド 要素の拡張機能は、チャネル スタックの下部コンポーネントに対応します。 [バインド] ボックスの一覧で最も高いバインド要素は、通信スタックの最上位コンポーネントに対応します。

      Note

      カスタム バインドのバインド要素の特定の順序の詳細については、「カスタム バインド」を参照してください。

  10. [トランスポートのプロパティ] ダイアログ ボックスで、トランスポートの残りの設定を構成します。

  11. BizTalk Server管理コンソールで、[OK] ボタンをクリックして開いているすべてのダイアログ ボックスを閉じ、エラー メッセージと誤ったイベント ログが表示されていないことを確認します。

WCF 動作拡張機能の machine.config ファイルを構成する

  1. コマンド プロンプトで、%FrameworkDir%\v4 に移動します。X.XXXXX\CONFIG フォルダーを開き、メモ帳を使用して machine.config ファイルを開きます。

  2. メモ帳で、machine.config ファイルに system.serverModel>\<extensions> 要素がない<場合は、machine.config ファイルの構成要素>内<にそれらの要素を追加し、system.serverModel>\<extensions> 要素内<に WCF 動作拡張機能の behaviorExtensions> 要素を追加<します。 たとえば、カスタム動作拡張機能 schemaValidator を有効にするには、machine.config ファイルの構成要素>内に<次のコードを追加します。

    <system.serviceModel>  
  <extensions>  
    <behaviorExtensions>  
      <add name="schemaValidator" type="Microsoft.ServiceModel.Samples.SchemaValidationBehaviorExtensionElement, MessageInspectors, Version=1.0.0.0, Culture=neutral, PublicKeyToken=ad307e213604f592"/>  
    </behaviorExtensions>  
  </extensions>  
</system.serviceModel>

    Note

    • 登録するアセンブリの情報は、 gacutil /lr<assembly_name> コマンドを使用して確認できます。
    • この要素 の behaviorExtensions を参照してください。

  3. メモ帳で、machine.config ファイルを保存します。

  4. 複数のBizTalk Serverランタイム コンピューターと管理コンピューターがある場合は、すべてのコンピューターで、この手順の手順 1 から 3 を繰り返します。

    Note

    BizTalk ホスト インスタンスとBizTalk Server管理コンソールの WCF 拡張ポイントを処理するには、WCF インフラストラクチャのすべてのコンピューターでこれらの手順を繰り返す必要があります。

BizTalk 管理コンソールを使用して WCF 動作拡張機能を構成する

  1. [BizTalk Server管理] を開きます。

    Note

    BizTalk Server管理コンソールが既に開かれている場合は、BizTalk Server管理コンソールを再起動します。

  2. WCF-Custom アダプターを使用する場合は、BizTalk Server管理コンソールで [プラットフォームの設定] を展開し、[ホスト インスタンス] を展開して、アダプターを実行している BizTalk ホスト インスタンスを再起動します。

  3. WCF-CustomIsolated アダプターを使用する場合は、IIS 管理コンソールで、WCF 受信場所に関連付けられたアプリケーション プールを再起動します。

  4. WCF 拡張ポイントを使用するように受信場所を構成する場合は、BizTalk 管理コンソールで BizTalk グループを展開し、BizTalkアプリケーション>を展開<し、[受信場所] を展開して、右側のウィンドウで [受信場所>] をダブルクリックします<。

    • [ 受信場所のプロパティ ] ダイアログ ボックスの [ 種類 ] ドロップダウン リストで、使用する WCF アダプターに応じて [ WCF-Custom ] または [ WCF-CustomIsolated ] を選択し、[ 構成] をクリックします。

  5. WCF 拡張ポイントを使用するように送信ポートを構成する場合は、BizTalk 管理コンソールで[BizTalk グループ]、[BizTalkアプリケーション>]、[送信ポート] の順に展開<し、右側のウィンドウで [送信ポート>] をダブルクリックします<。

    • [ 送信ポートのプロパティ ] ダイアログ ボックスの [ 種類 ] ドロップダウン リストで、[ WCF-Custom] を選択し、[ 構成] をクリックします。

  6. [トランスポートのプロパティ] ダイアログ ボックスの [ 動作 ] タブで、動作拡張機能の種類に応じて [ ServiceBehavior ] または [EndpointBehavior ] を右クリックし、[ 動作拡張機能の選択 ] ダイアログ ボックスで動作拡張機能を選択し、[ OK] をクリックします。

  7. [トランスポートのプロパティ] ダイアログ ボックスで、トランスポートの残りの設定を構成します。

  8. BizTalk Server管理コンソールで、[OK] ボタンをクリックして開いているすべてのダイアログ ボックスを閉じ、エラー メッセージと誤ったイベント ログが表示されていないことを確認します。

SSL 証明書を使用して WCF-Custom 受信場所を構成する

  • WCF-Custom 受信場所が httpsTransport バインド要素などの HTTP カーネルモード ドライバー (HTTP.sys) を使用する場合、Secure Sockets Layer (SSL) 通信の場合、受信場所にはソケット (IP アドレスとポートの組み合わせ) ごとに証明書が登録されている必要があります。 SSL 証明書をコンピューター上のポートにバインドするには、HttpCfg.exe ツールを使用します。 詳細については、「 方法: SSL 証明書を使用してポートを構成する」を参照してください。