WCF サービスを WCF 送信アダプタと共に使用する場合の考慮事項
このトピックでは、WCF サービスを WCF アダプタと共に使用する際に考慮する必要がある情報を示します。
XML 以外のコンテンツを送信請求メッセージとして送信する場合は、[テンプレート -- テンプレートで指定されたコンテンツ] オプションを使用する
[本文] の WCF アダプター -- BizTalk 応答メッセージ本文 (既定値) オプションでは、文字データやビットマップ イメージなどの XML 以外のメッセージを送信することはできません。 XML 以外のメッセージを送信するには、WCF アダプターの テンプレート オプションで指定されたテンプレート -- コンテンツ を使用できます。 テンプレートの使用方法の詳細については、「 WCF 受信アダプターを使用して WCF サービスを発行するときの考慮事項」を参照してください。
WCF-BasicHttp と WCF-WSHttp 送信ポートは、サービス アドレスが で始まる場合は常にプロキシを無視します http://localhost
サービス アドレスが送信ポートの [プロキシ] タブで構成されているか、送信ハンドラーの [プロキシ] タブでhttp://localhost構成されているかで始まる場合、WCF-BasicHttp と送信ポート WCF-WSHttp は常にプロキシを無視します。 クライアントが同じコンピュータ上のサービスと対話するときにプロキシを通過するようにするには、(localhost ではなく) ホスト名を使用する必要があります。
プロキシ設定が正しく指定されていない場合、WCF-BasicHttp と WCF-WSHttp の送信アダプタはメッセージを保留する
送信ポート の [プロキシ ] タブまたは送信ハンドラーの [プロキシ] タブで、WCF-BasicHttp と送信アダプターの プロキシ 設定を指定 WCF-WSHttp。 このプロキシ設定が正しく指定されていない場合は、WCF アダプタによってメッセージが保留され、「メッセージを受信できるアドレスでリッスンしているエンドポイントがありませんでした」という内容のエラー メッセージがイベント ログに返されます。
WCF-NetMsmq アダプタの WCF 送信ポートに対してアクセス許可を設定する
WCF-NetMsmq アダプターの WCF 送信ポートは、NetMsmqBinding によって公開された Web サービスにメッセージを送信する場合、サービスのキュー マネージャーによって管理されているターゲット キューにこのメッセージの宛先を指定します。 クライアント側のキュー マネージャーは、メッセージを転送キュー (送信キュー) に送ります。 転送キューは、ターゲット キューに転送するためのメッセージを格納する、クライアント側キュー マネージャー上のキューです。
サービスのキュー マネージャーは、それが所有するターゲット キューに宛先指定されたメッセージを受け入れて、格納します。 次に、サービスがターゲット キューからの読み取り要求を行い、キュー マネージャーがメッセージをサービスに配布します。 そのため、送信ポートをホストする BizTalk ホスト インスタンスのサービス アカウントには、転送キューに書き込むためのアクセス許可を与える必要があります。
SOAP Body 要素のコンテンツに文字データが含まれた SOAP メッセージを受信するには、空の XPath 式を使用する
送信請求 - 応答の WCF 送信ポートは、WCF メッセージを応答メッセージとして受信できます。 次の例に示すように、SOAP Body 要素の内容に文字データが含まれる受信応答メッセージから BizTalk メッセージを作成するには、[WCF アダプター トランスポートのプロパティ] ダイアログ ボックスの [メッセージ] タブの [XPath 式] テキスト ボックスを空のままにする必要があります。
<s:Envelope xmlns:s="http://www.w3.org/2003/05/soap-envelope" xmlns:a="http://www.w3.org/2005/08/addressing">
<s:Header>
...
</s:Header>
<s:Body>Contoso</s:Body>
</s:Envelope>
[封筒] または [本文] オプションを選択した場合、アダプターは受信メッセージから BizTalk メッセージを作成しません。 受信 SOAP マーシャリング プロセスでエラーとなったメッセージは保留されないので、このメッセージは保留されません。 [ メッセージ ] タブで XPath 式を使用する方法の詳細については、「 WCF アダプターのメッセージ本文を指定する」を参照してください。
Note
BTSNTSvc.exe.config ファイルを構成すると、Windows SDK の TraceViewer ツール (SvcTraceViewer.exe) を使用できます。 Windows SDK の詳細については、「Windows SDK の新機能」 https://go.microsoft.com/fwlink/?LinkId=75219を参照してください。 TraceViewer ツールの詳細については、「TraceViewer ツール (SvcTraceViewer.exe)」 https://go.microsoft.com/fwlink/?LinkId=75218を参照してください。
BizTalk Server は、カスタム SOAP ヘッダーを表すルート要素とマルチパート メッセージの種類を使用しない
カスタム SOAP ヘッダーが定義されたメタデータに対して BizTalk WCF サービス使用ウィザードを実行した場合、生成後のスキーマには、カスタム SOAP ヘッダーを表すルート要素が生成されます。 また、カスタム SOAP ヘッダーのオーケストレーション内に、マルチパート メッセージの種類も作成されます。 BizTalk Server。 ただし、BizTalk Server は、カスタム SOAP ヘッダーを処理するために、マルチパート メッセージの種類とルート要素を使用しません。
カスタム SOAP ヘッダーにアクセスするには、 InboundHeaders プロパティを使用する必要があります。 カスタム SOAP ヘッダーの受信の詳細については、「 公開された WCF サービスを使用した SOAP ヘッダー」を参照してください。 カスタム SOAP ヘッダーを使用するには、 OutboundCustomHeaders プロパティを使用する必要があります。 カスタム SOAP ヘッダーの送信の詳細については、「 使用済み WCF サービスを使用した SOAP ヘッダー」を参照してください。
プロキシ アドレス/プロキシ資格情報が異なる送信ポートごとに別のホスト インスタンスを作成する
WCF 送信アダプタのパフォーマンスを最大化するには、使用するプロキシ アドレス/プロキシ資格情報が異なる送信ポートごとに別のホスト インスタンスを作成することをお勧めします。 これにより、プロキシ設定の競合を防ぐことができます。