このセクションの内容:

はじめに

Equifax Message Listener は、Parasoft Virtualize 用のカスタム メッセージ リスナー拡張です。この拡張機能は、Equifax の信用報告サービスを仮想化するために設計されています。そのため、外部の Equifax サービスの振る舞いをエミュレートする仮想アセットを作成できます。この機能は、テストおよび開発環境でサードパーティ製サービスへの依存をなくすことによって、開発およびテストの作業を容易にします。Equifax の仮想化機能は、テスト範囲の拡大、レスポンス データの管理の向上、そして実際の Equifax サービスに影響を与えることなくパフォーマンス テストや負荷テストを実行することを可能にします。

Equifax Message Listener は、仮想アセットを作成および構成するときに、メッセージ構成フォーム ([フォーム入力] または [フォーム XML])、データ ソースのパラメータライズ、およびメッセージ応答条件技術 (XPath) を使用できるように実装されています。この機能を有効にするために、拡張機能は Equifax リクエスト メッセージを XML に、および XML から変換します。

インストール

ツールは UI またはコマンドラインからインストールできます。

UI からのインストール

  1. [Parasoft ] > [設定] を選択し、[システム プロパティ] をクリックします。
  2. [JAR の追加] をクリックし、com.parasoft.virtulaize.listener.equifax<version>.jar ファイルを選択します。
  3. [適用] をクリックします。
  4. SOAtest/Virtualize を再起動します。

コマンドラインからのインストール

設定プロパティ ファイルの system.properties.classpath プロパティに com.parasoft.virtulaize.listener.equifax<version>.jar ファイルを追加します。例:

system.properties.classpath=<PATH_TO_JAR>/com.parasoft.virtualize.listener.equifax-1.0.0.jar

使用方法

Equifax Message Listener を設定するには、Virtualize サーバーに Parasoft Virtual Asset (PVA) を追加し、PVA をダブルクリックして [トランスポート] タブの [カスタム] サブタブに移動し、リスナーを設定します。複数のリスナーがインストールされている場合は、com.parasoft.virtualize.listener.equifax.EquifaxMessageListener を実装メニューから選択する必要があります。

パス

オプション説明
Equifax Input/Output Log File Pathログの記録に使用するファイルへのパスを設定します。入出力ログ ファイルには、Equifax Message Listener の受信リクエストと送信リクエストが含まれます。これらは、Equifax パーサーが構成され、適切に動作しているかどうかを検証するのに役立ちます。
Custom Equifax Request Properties File Path

リクエストプロパティファイルへのパスを設定します。このプロパティファイルには、受信リクエストの各フィールドの場所と長さが含まれています。これにより、Equifax Message Listener は受信リクエストを解析し、応答条件に使用する XML 形式に変換することができます。このファイルの設定例は、examples/ ディレクトリに EquifaxRequestExample.properties としてこの拡張と共に同梱されています。

注意: 空白のままにすると、デフォルトの Equifax リクエスト形式が使用され、examples/ ディレクトリに equifax.xsd として含まれます。

ポート設定

オプション説明
Equifax Incoming Message Port受信 Equifax メッセージをリッスンするポートを設定します。空の場合、リスナーは開始されません。
Out Going Message HostEquifax レスポンスを送信する際に使用するホストを設定します。
Equifax Out Going Message PortEquifax レスポンスを送信する際に使用するポートを設定します。

リクエスト プロパティ

オプション説明
ASCII Decimal
Representation For
Start of Response
Marker (Optional)		レスポンス メッセージの開始を指定する ASCII 文字を設定します。
ASCII Decimal
Representation For
End of Response
Marker (Optional)		レスポンス メッセージの終了を指定する ASCII 文字を設定します。

メッセージ レスポンダーの設定

応答条件の定義

Equifax の応答条件を指定する際、Equifax のリクエスト メッセージが XML に変換されることに注意してください。 XML に変換されたリクエストを使用して、応答条件を実行するための XPath 式を作成できます。 XML に変換されたリクエストの例を以下に示します。

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<subjectFirstName>Frank</subjectFirstName>
<subjectLastName>Park</subjectLastName>
. .
</SOAP-ENV:Envelope>

subjectFirstName の値に応答条件を持たせるように XPath 式を設定する場合は、次のようになります。

/*[local-name(.)="Envelope"]/*[local-name(.)="subjectFirstName"]/text()

要素へのパスは、ルートから始まり、subjectFirstName 要素まで指定されます。その後、テキスト値が応答条件に使用されます。XML に変換されたリクエストは、[イベント詳細] ビューを使用して表示でき、XPath の作成に役立ちます。 詳細については「サーバーイベントの可視化」を参照してください。

レスポンスの定義

目的の Equifax レスポンスメッセージを使用してメッセージ レスポンダーを構成するには、いくつかの方法があります。Equifax パーサーが XML 形式のレスポンスを Equifax 標準のレスポンスに正常に変換できるようにするには、サンプル XML レスポンス ファイルのすべてのセグメントとフィールドで XML 形式を使用する必要があります。