このセクションでは、トラフィックログにキャプチャされたトラフィックから、パラメータライズされたメッセージレスポンダーを作成する方法の概要について説明します。セクションの内容:

要件

チームのデータリポジトリサーバーがインストールされ実行されている必要があります。詳細については次を参照してください：リモート Data Repository サーバーのインストール
メッセージの内容は整形式でなければなりません。SOAP メッセージレスポンダーには、最上位の XML 要素が 1 つだけ存在しなければなりません。
Data Repository は混合型の JSON 配列のパラメータライズをサポートしていません。JSON 配列に混合型が含まれていない場合、Virtualize は配列のすべての要素が最初の要素と同じ型であるとみなします。

コンソールビューのモニタリング

トラフィックからテストおよび/またはメッセージレスポンダーを作成する際、コンソールビューを開いておくと役立ちます。コンソールビューには、トラフィックファイルの処理中に生成される警告、エラー、および通知メッセージが表示されます。

ウィザードの使用

利用できる作成ウィザードで [トラフィック] > [パラメータライズされたメッセージを生成] を選択します。レウポンダーの追加については「プロジェクト、仮想アセット、レスポンダースイートの追加」を参照してください。
トラフィックウィザードで次の情報を指定します。
1. トラフィックファイルの場所を指定します。定義ファイルが入力されている場合、これはオプションです。
2. 必要に応じて文字エンコーディングを変更します。
3. （オプション）サービス定義ファイルを指定します。サービス定義を提供することで、Virtualize はより良いメッセージグループとデータソース応答条件を作成できます。
4. 以前にテンプレートに保存した設定グループをウィザードに入力したい場合、テンプレートの場所を入力します。Virtualize のテンプレートの作成と使用の詳細については「構成テンプレートによるウィザード設定の再利用と共有」を参照してください。
[次へ] をクリックし、[Parasoft Data Repository Settings] ページで、データを格納するデータリポジトリを指定します。
- [サーバー] フィールドで、接続するサーバーを指定します (リモートサーバーまたは組込みサーバー)。リモートサーバーを選択した場合、[ポート]、[ユーザー]、[パスワード] フィールドは自動的に設定されます。この設定は必要に応じて変更できます。
- 組込みサーバーを選択した場合、[ポート]、[ユーザー]、[パスワード] フィールドはグレー表示になります。
- [リポジトリ名] フィールドで、使用するリポジトリ名を選択または入力します。新しいリポジトリ名を入力すると、その名前でリポジトリが作成されます。
- リポジトリ接続を定義したら、 [検証] をクリックして接続をチェックできます。
[次へ] をクリックし、[メッセージ形式] および [Grouping Strategy] の設定を行います。
1. [リクエストメッセージ形式:] および [レスポンスメッセージ形式:] に正しいフォーマットが設定されていることを確認します。Virtualize は、トラフィックファイルの最初のメッセージに基づいて、リクエストおよびレスポンスのメッセージフォーマットの識別を試みます。1 つのトラフィックファイルでは、すべてのリクエストが同じフォーマットであり、またすべてのレスポンスも同じフォーマットであることが期待されます。リクエストフォーマットとレスポンスフォーマットは異なっていてもかまいません。メッセージフォーマットを検出できなかった場合、プレーンテキストが選択されます。
2. 変換オプションは、EDI やカスタム形式などの一部の形式で使用できます。[変換オプション] ボタンをクリックして、必要な変更を加えます。
3. メッセージグループ化オプションを選択します。詳細については「Message Grouping Options」を参照してください。
4. サービス定義ファイルまたはテンプレートファイルを指定した場合は、[メッセージグループ作成オプション] セクションで [制約] オプションを有効にできます。このオプションを有効にすると、テンプレートファイルとサービス定義ファイルのいずれかで定義されたメッセージグループだけがグループ化されます。他のすべてのメッセージは無視されます。このオプションを無効にすると、Virtualize はトラフィックファイルに表示されるすべてのメッセージをグループ化します。サービス定義ファイルとテンプレートファイルが提供されていて、このオプションが有効になっている場合、グループ化は、サービス定義によって制約される前に、テンプレートファイルに従って制約されます。その結果、メッセージがサービス定義ファイルで定義されていても、テンプレートファイルで定義されていない場合、メッセージは無視されます。[制約] オプションは、デフォルトで有効化されています。
5. サービス定義ファイルまたはテンプレートファイルを指定した場合は、[メッセージグループ作成オプション] セクションで [空のグループ] オプションを有効にできます。このオプションを有効にすると、トラフィックファイルにグループ基準に一致するメッセージが含まれていない場合でも、サービス定義ファイルまたはテンプレートファイルに基づいてグループが作成されます。このオプションを無効にすると、メッセージのないグループは作成されません。トラフィックファイルがサービス定義またはトラフィックテンプレートと一緒に指定されている場合、[空のグループ] オプションはデフォルトで false に設定されます。トラフィックファイルが指定されていない場合、[空のグループ] オプションはデフォルトで true に設定されます。
6. [次へ] をクリックし、[メッセージグループ化の確認] 画面で操作やメッセージの情報を確認します。詳細については、「Message Grouping Review Screen」を参照してください。
[次へ] をクリックします。各グルーウの[ 自動構成] オプションが有効な場合、[データの再利用] 画面が開き、次の手順をスキップできます。
前の画面で [自動構成] オプションが無効になっている場合は、[リクエスト照合] 画面でリクエスト照合オプションを手動で設定する必要があります。「Configuring Request Mapping Options」を参照してください。
インポートしたトラフィックを再利用する方法、またはデータの再利用画面で既存のデータに影響を与える方法を設定します。詳細については、「Configuring Data Reuse Options」を参照してください。
[次へ] をクリックし、[最終オプション] 画面で追加の構成を指定します。
- フォームまたはリテラルモードでメッセージを作成するようにウィザードを設定するには、[ペイロード] セクションで フォーム または リテラル オプションを有効にします。詳細については「フォーム入力」または「リテラル」を参照してください。
- [再利用可能なテンプレートに構成データをエクスポート] オプションを有効にして、ファイル名と場所を指定して、このウィザードで使用した設定をテンプレートとして保存することができます。テンプレートの作成と使用の詳細については「構成テンプレートによるウィザード設定の再利用と共有」を参照してください。
[終了] をクリックします。

結果

要素がパラメータライズされ、レスポンダー応答条件およびデータソース応答条件が設定された Message Responder が追加されます。メッセージが XML または JSON ではなく、パフォーマンスへの影響が予想されるほどメッセージのサイズが大きくない限り、[フォーム入力]/[フォーム JSON] ビューがデフォルトで使用されます。そうでない場合、[リテラル] ビューが使用されます。

(新規データリポジトリの場合) 適用可能なデータセットおよびレコードタイプが追加された Data Repository が追加されます。トラフィックの解析によって識別されたメッセージのグループごとに 1 つのデータセットが追加されます。

(既存のデータリポジトリの場合) 既存のリポジトリに新規データセットおよびレコードタイプが追加されます。

追加されたデータセットごとにリポジトリデータソースが追加され、テストクライアントまたはメッセージレスポンダーは関連するデータソースを使用するよう構成されます。

Virtual Asset フォルダーに .pva が作成された場合、ウィザードが完了すると、仮想アセットは自動的にローカルの Virtualize サーバーにデプロイされます。そうでない場合、ローカルサーバーまたはリモートサーバーに手動でデプロイすることができます。

データリポジトリに格納されたデータの編集および格納については、「リポジトリ構成とコンテンツの参照/修正」を参照してください。

なお、トラフィックファイル中に存在する、カスタムトランスポートヘッダーおよび SOAP ヘッダー (たとえば WS-Security ヘッダー) は、生成されるアセットあるいはデータリポジトリデータセットに自動的に設定されないので注意してください。それらのヘッダーは、生成されたメッセージレスポンダーで指定できます (詳細は「メッセージレスポンダーの概要」を参照)。

メッセージグループ化オプション

[メッセージ形式およびグループ化手法] 画面では、次のメッセージグループ化オプションを使用できます。

操作/タイプに基づく: 操作またはメッセージタイプに基づいてメッセージをグループ化します。このオプションが有用なのは、操作によって、あるいはメッセージタイプ (つまり、SOAP ボディの要素名、プレーン XML メッセージのルート要素、または指定されたメッセージ形式のメッセージタイプ) によって、明確に特定できるメッセージを持つサービストラフィックの場合です。トラフィックファイル中で発見された操作/タイプごとに 1 つのレスポンダーが生成されます。このオプションを選択した場合、トラフィックファイルの解析に基づいて、Virtualize はグループ化の経験則を適用することを推奨します。ユーザーはあらかじめ選択された経験則を変更できます。経験則の詳細については「操作/ タイプによるグループ化の経験則」を参照してください。
類似リクエストに基づく: リクエストメッセージの構造に基づいてメッセージをグループ化します。構造が類似したリクエストに関連するレスポンスを個々のレスポンダーが持つよう、Virtualize はリクエストメッセージの構造を解析し、リクエスト/レスポンスをグループ化してレスポンダーにします。メッセージは、たとえ値が異なっていても、同一の DOM ツリーモデルを持つ場合に " 類似" と見なされます。このオプションは、各メッセージレスポンダー内でレスポンスにリクエストを関連付けるための規則を最適化し簡潔にするために使用されます。
類似レスポンスに基づく: レスポンスメッセージの構造に基づいてメッセージをグループ化します。このオプションを選択すると、Virtualize は、レスポンスメッセージの構造を解析し、リクエスト/レスポンスのペアをグループ化してレスポンダーにすることで、個々のレスポンダーが、構造が類似したレスポンスを持つようにします。メッセージは、たとえ値が異なっていても、同一の DOM ツリーモデルを持つ場合に " 類似" と見なされます。
なし: グループ化しない。トラフィックファイル中のレスポンスメッセージごとにレスポンダーが生成されます。リクエスト/レスポンスのペアごとに個別のメッセージレスポンダーを用意したい場合、このオプションを使用します。

[メッセージグループ化の確認] 画面

[メッセージグループ化の確認] 画面の列は、適用されたグループ化手法に基づいています。テーブルの各行は、グループを定義する条件に対応します。テーブルの各行に 1 つのグループが生成されます。各グループに 1 つのレスポンダーが生成されます。この画面を使用するための詳細については「グループ化条件のカスタマイズ」セクションを参照してください。

応答条件基準は、表に表示されている順番に (上から下に) 処理されます。これらのグループ化の作成方法の詳細については、「操作/ タイプによるグループ化の経験則」を参照してください。

利用できるコントロールを使って、グループ化条件を追加、変更、並べ替え、および削除することができます。条件を変更したら、次のページに進む前に必ず [再グループ化] をクリックしてください。

[自動構成] オプションを使用すると、Virtualizeは、指定されたグループのメッセージレスポンダーを自動的に構成できます。各メッセージグループのメッセージレスポンダーを手動で設定するには、[自動構成] オプションを無効にします（「Configuring Request Mapping Options」を参照）。

1 つのメッセージグループ内に複数のリクエストが存在し、パス、パラメーター、またはボディに差異がある場合は通常、自動構成を利用できます。[自動構成] がグレー表示されている場合、そのグループに対して自動構成を利用することはできません。特定のグループがなぜ自動構成できないかについては、その項目のツールチップを参照してください。

パネルの上部に表示される項目の詳細 (処理されたペア、処理されなかったペア、グループに一致しないメッセージなど) については、関連するハイパーリンクをクリックしてください。

特定のレスポンダーに関連するメッセージを確認するには、あるいはレスポンダーとデータセットの名前を変更するには、[カウント] 列で該当行をクリックします。

リクエスト照合オプションの設定

[リクエスト照合] 画面では、リクエスト/レスポンスペアを再マッピングしたり、仮想アセットのレスポンスメッセージを決定するためにどのパラメーター値を使用するかをカスタマイズしたり、このメッセージに関連付けるサービス定義を指定したりすることができます。[リクエストの照合] 画面でオプションを設定する方法の詳細については、「リクエストの照合と応答条件のカスタマイズ」を参照してください。

データの再利用オプションの設定

定義されたレコード ID は、どのデータが新規で、どの新規データが既存のレコードに一致するかを判断するために使用されます。このデータセットがまだ指定されていない場合、データツリーで ID を追加/変更できます。ツリーは、ID フィールドを緑色の矢印のアイコンで示します。既存のデータセットには注釈が表示されます。再利用の設定の詳細については、「データの再利用と更新の設定」を参照してください。

トラフィックファイルの新規データを使って、既存のリポジトリデータセットをどのように拡張あるいは更新するかを指定できます。

一致するデータ (ID によって既存のレコードタイプに一致するデータ) がある場合、既存のレコードタイプを再利用するか、それとも既存レコードを更新するかを指定できます。

再利用: 一致する既存のレコードを再利用/共有します。更新: 既存のレコードの対応するフィールドをトラフィックのデータで更新し、新規レコードタイプに対応する新規レコードを追加します。
置換: 既存データを削除し、新規データを追加します。
マージ: 既存データを変更せずに、新規データをインポートします。
更新: 一致するレコードを新規データで更新し、必要に応じて新規レコードを作成します。
上書き: 一致するキーを持つ、一致するレコードを新規データで更新します。新規レコードは作成しません。

[次から制約を推論] オプションを使用すると、Virtualize でリポジトリに保存されているデータの特性を判断できます。データまたはサービス定義に基づいて制約を推測できます。

仮想アセットのデプロイ

Virtual Asset フォルダーに .pva が作成された場合、ウィザードが完了すると、仮想アセットは自動的にローカルの Virtualize サーバーにデプロイされます。そうでない場合、ユーザーは準備ができたときにいつでもローカルサーバーまたはリモートサーバーに仮想アセットをデプロイすることができます。デプロイ手順とオプションの詳細については、「仮想アセットのデプロイ - 概要」を参照してください。

仮想アセットのカスタマイズ

メッセージレスポンダーの振る舞いをカスタマイズする方法については、「メッセージレスポンダーの概要」を参照してください。

choice/extension タイプのサポート

ウィザードの最後に WSDL ファイルまたはスキーマファイルを入力しない場合、Virtualize は記録されたトラフィックのデータ構造を使用してデータリポジトリを作成します。記録されたトラフィックで要素のデータ構造が異なる場合、おそらくスキーマでのその要素のタイプは choice です。しかし、ウィザードは明示的に choice タイプをサポートしません。ウィザードは、可能性のあるすべての子要素のシーケンスとして要素のデータ構造を解釈します。たとえば、要素の実際のスキーマが以下であるとします。

<element name="parent">
    <complexType>
        <choice minOccurs="0" maxOccurs="unbounded">
            <element name="child1"/> 
            <element name="child2"/> 
            <element name="child3"/>
        </choice>
    </complexType> 
</element>

Virtualize は以下のデータ構造で要素を表現します。

<element name="parent">
    <complexType>
        <sequence>
            <element name="child1" minOccurs="0" maxOccurs="unbounded"/> 
            <element name="child2" minOccurs="0" maxOccurs="unbounded"/> 
            <element name="child3" minOccurs="0" maxOccurs="unbounded"/>
        </sequence>
    </complexType> 
</element>

記録されたトラフィック中で、子要素の順番が異なるケースがあります。たとえば、あるレスポンスメッセージの "parent" では "child1" の後に "child2" があり、別のレスポンスメッセージでは "child2" の後に "child1" がある、といったケースです。しかし、Virtualize はパラメータライズされたメッセージデータを固定の順番でパラメータライズします。したがって、この例の場合、レスポンスメッセージ内で "child1" と "child2" は常に同じ順序で出現します。

ウィザードの完了: 詳細情報

以下のセクションでは、ウィザードを完了するのに役立つ詳細情報について説明しています。

ビデオチュートリアル: メッセージプロキシで記録したトラフィックから仮想アセットを作成する

この動画では、メッセージプロキシで記録したトラフィックから仮想アセットを作成する方法を学びます。

Page tree

Creating Parameterized Message Responders from Traffic

要件