ValidationAdapter
ValidationAdapter のサンプルは、応答側パブリック プロセスでメッセージに対して特殊な検証ルールを実行する方法を示しています。 Microsoft® BizTalk Accelerator for RosettaNet (BTARN) は、送受信パイプラインとオーケストレーションで検証をネイティブに実行します。 追加の検証を実行する場合は、検証アダプターを作成します。 追加の検証には、クロスフィールド検証ルールや、XSD を使用して実装できないビジネス固有の検証ルールを含めることができます。
検証アダプターを作成するには、ValidationAdapter サンプルに C# コードを追加し、インターフェイスを発行し、アダプターをアグリーメント プロパティに入力します。 その後、BTARN はメッセージ処理中に検証アダプターを呼び出します。
ValidationAdapter はパブリック プロセス オーケストレーションで使用されるため、そのオーケストレーションをホストしている BizTalk ホスト サービスと同じ資格情報の下に実行されます。
ValidationAdapter サンプルは drive><:\Program Files\Microsoft BizTalk <version> Accelerator for RosettaNet\SDK\ValidationAdapter にあります。
対象
ValidationAdapter サンプルは、サービス コンテンツでの電子メール アドレスの検証を示します。 このサンプルでは、 インターフェイスを IValidateRNIFMessageParts 実装しています。 電子メール アドレスが正しい形式でない場合は、 を返 RNIFException します。 XML ドキュメント preambleToValidate、 serviceHeaderToValidate、 deliveryHeaderToValidate、 serviceContentToValidate によって検証が定義されます。
ValidationAdapter では、RNIFerror.IsOkToSendException プロパティを使用して、エラーが発生した場合に送信するメッセージの種類を決定します。 検証に失敗した場合、ValidationAdapter で RNIFerror.ErrorCode がゼロ以外の値に設定されます。 RNIFerror.IsOkToSendException プロパティが True の場合は、否定受信確認応答が送信されます。 RNIF 2.0 では、これは例外メッセージになります。 RNIF 1.1 では、これは受信確認例外メッセージになります。 RNIFerror.IsOkToSendException プロパティが False で、0A1 が設定されている場合は、0A1 メッセージが送信されます。 例外メッセージ、受信確認例外メッセージ、または 0A1 メッセージが送信されると、プロセスは終了します。
RNIFerror.IsOkToSendException プロパティが False で、0A1 が設定されていない場合は、例外も 0A1 も送信されません。 エラーが記録され、プロセスは終了します。
検証に成功すると、ValidationAdapter で RNIFerror.ErrorCode が 0 に設定され、BTARN によりメッセージがプライベート プロセスにルーティングされます。 メッセージがプライベート プロセスにルーティングされるのは、検証が成功した場合のみです。
サンプルの実装
ValidationAdapter サンプルを実装するには、検証アダプタを引数に追加する必要があります。
検証アダプタをアグリーメントに追加するには
[スタート] ボタンをクリックし、[すべてのプログラム] をポイントし、[Microsoft BizTalk Accelerator for RosettaNet] をポイントして、[BizTalk Accelerator for RosettaNet管理コンソール] をクリックします。
BizTalk Accelerator for RosettaNet管理コンソールで、[BizTalk Accelerator for RosettaNet] を展開し、[契約] をクリックします。
検証アダプタを追加するアグリーメントをダブルクリックします。
[検証アダプター] ダイアログ ボックスで、[アセンブリ名] の右側にある省略記号ボタン (...) をクリックし、検証アダプター アセンブリを含む場所に移動し、適切な .dll ファイルを選択して、[開く] をクリックします。
[ クラス名] の下矢印をクリックし、検証アダプター クラスを選択して、[OK] をクリック します。