前提条件
- パラメータライズされたテスト クライアントまたは Message Responder をトラフィックから作成するには、Data Repository Server がインストールされ、実行中である必要があります。詳細については、 Installing a Remote Data Repository Server
- メッセージ コンテンツは整形式でなければなりません (たとえば、XML の場合は整形式であること。EDI の場合は有効な EDI メッセージであることなど)。整形式でない場合、トラフィックからのテストの自動生成が失敗する可能性があります。SOAP メッセージ/Message Responder には、最上位の XML 要素が 1 つだけ存在しなければなりません。
- メッセージ グループ化オプションの注意事項: Data Repository は混合型の JSON 配列のパラメータライズをサポートしていません。 JSON 配列に混合型が含まれない場合、SOAtest または Virtualize は、配列のすべての要素が最初の要素と同じ型であると仮定します。
| Tip | ||
|---|---|---|
| ||
トラフィックからテストおよび/またはメッセージ レスポンダーを作成する際、コンソール ビューを開いておくと役立ちます。コンソール ビューには、トラフィック ファイルの処理中に生成される警告、エラー、および通知メッセージが表示されます。 |
ウィザードの使用
利用できる作成ウィザードで [トラフィック] > [パラメータライズされたメッセージを生成] を選択します。詳細については次の章を参照してください:
- トラフィック ウィザードの先頭ページで以下の設定を行います。
- トラフィック ファイルの場所を指定します。
- 必要に応じて文字エンコーディングを変更します。
以前にテンプレートに保存した設定グループをウィザードに入力したい場合、テンプレートの場所を入力します。
Virtualize のテンプレートの作成と使用の詳細については「Using Configuration Templates to Reuse and Share Wizard Settings - Virtualize」を参照してください。
[次へ] をクリックします。
[Parasoft Data Repository Settings] ページで、 テスト クライアントまたはメッセージ レスポンダーのパラメータライズに使用されるデータを格納するデータ リポジトリを指定し、[次へ] をクリックします。
[サーバー] フィールドで、接続するサーバーを指定します (組込みサーバーまたはリモート サーバー)。組込みサーバーを選択した場合、[ポート]、[ユーザー]、[パスワード] フィールドはグレー表示になります。リモート サーバーを選択した場合、[ポート]、[ユーザー]、[パスワード] フィールドは自動的に設定されます。この設定は必要に応じて変更できます。
- [リポジトリ名] フィールドで、使用するリポジトリ名を選択または入力します。新しいリポジトリ名を入力すると、その名前でリポジトリが作成されます。
リポジトリ接続を定義したら、 [検証] をクリックして接続をチェックできます。
[メッセージ形式] および [Grouping Strategy] ページの設定を完了したら、[次へ] をクリックします。
[リクエスト メッセージ形式:] および [レスポンス メッセージ形式:] に正しいフォーマットが設定されていることを確認します。フォーマットが正しくない場合、適切なフォーマットを選択します。
Virtualize は、トラフィックファイルの最初のメッセージに基づいて、リクエストおよびレスポンスのメッセージ フォーマットの識別を試みます。1 つのトラフィック ファイルでは、すべてのリクエストが同じフォーマットであり、またすべてのレスポンスも同じフォーマットであることが期待されます。リクエスト フォーマットとレスポンス フォーマットは異なっていてもかまいません。メッセージ フォーマットを検出できなかった場合、プレーン テキストが選択されます。選択されたフォーマット (たとえば EDI やカスタム フォーマット) に対して利用可能な変換オプションを設定するには、フォーマットの右側にある [変換オプション] ボタンをクリックし、任意の変更を加えます。
目的のメッセージ グループ化オプションを指定し、[次へ] をクリックします (詳細については下記枠内の「メッセージ グループ化オプション」を参照してください)。
Info title メッセージ グループ化オプション 以下のオプションを利用できます。
操作/タイプに基づく: 操作またはメッセージ タイプに基づいてメッセージをグループ化します。このオプションが有用なのは、操作によって、あるいはメッセージ タイプ (つまり、SOAP ボディの要素名、プレーン XML メッセージのルート要素、または指定されたメッセージ形式のメッセージ タイプ) によって、明確に特定できるメッセージを持つサービス トラフィックの場合です。トラフィック ファイル中で発見された操作/タイプごとに 1 つのレスポンダーが生成されます。このオプションを選択した場合、トラフィック ファイルの解析に基づいて、Virtualize はグループ化の経験則を適用することを推奨します。ユーザーはあらかじめ選択された経験則を変更できます。経験則の詳細については「 Understanding Heuristics for Grouping by Operation - Type」を参照してください。
類似リクエストに基づく: リクエスト メッセージの構造に基づいてメッセージをグループ化します。構造が類似したリクエストに関連するレスポンスを個々のレスポンダーが持つよう、Virtualize はリクエスト メッセージの構造を解析し、リクエスト/レスポンスをグループ化してレスポンダーにします。メッセージは、たとえ値が異なっていても、同一の DOM ツリー モデルを持つ場合に " 類似" と見なされます。このオプションは、各メッセージ レスポンダー内でレスポンスにリクエストを関連付けるための規則を最適化し簡潔にするために使用されます。
類似レスポンスに基づく: レスポンス メッセージの構造に基づいてメッセージをグループ化します。このオプションを選択すると、Virtualize は、レスポンス メッセージの構造を解析し、リクエスト/レスポンスのペアをグループ化してレスポンダーにすることで、個々のレスポンダーが、構造が類似したレスポンスを持つようにします。メッセージは、たとえ値が異なっていても、同一の DOM ツリー モデルを持つ場合に " 類似" と見なされます。
なし: グループ化しない。トラフィック ファイル中のレスポンス メッセージごとにレスポンダーが生成されます。リクエスト/レスポンスのペアごとに個別のメッセージ レスポンダーを用意したい場合、このオプションを使用します。
[メッセージ グループ化の確認] ページで、操作についての情報と検出されたメッセージを確認します。
表示される列の種類は、適用されたグループ化方法によって異なります。
表の各行は、グループを定義するための条件を表します。1 行に対して 1 つのグループが生成されます。そして 1 つのグループに対して 1 つのレスポンダーが生成されます。
応答条件基準は、表に表示されている順番に (上から下に) 処理されます。 これらのグループがどのように作成されたかについては、「Understanding Heuristics for Grouping by Operation - Type」を参照してください。
利用できるコントロールを使って、グループ化条件を追加、変更、並べ替え、および削除することができます。 Virtualize でのグループ化基準の構成の詳細については、「Customizing Grouping Criteria Virtualize 」を参照してください。条件を変更したら、次のページに進む前に必ず [再グループ化] をクリックしてください。
すべての [自動構成] チェック ボックスがオンであり、指定したグループに対してメッセージ レスポンダーを自動的に構成したい場合、次のステップをスキップできます。
以下のいずれかの場合、カスタマイズする各メッセージ グループの [自動構成] チェック ボックスをオフにし、[次へ] をクリックします。そして、「Customizing Request Matching and Correlations」で説明しているようにリクエスト照合を設定します。
仮想アセットのレスポンスメッセージを決定するためにどのパラメーター値を使用する かをカスタマイズしたい場合
自動化されたリクエスト/ レスポンスペアの照合を変更 したい場合
WSDL またはスキーマを指定したい場合
1 つのメッセージ グループ内に複数のリクエストが存在し、パス、パラメーター、またはボディに差異がある場合は通常、自動構成を利用できます。[自動構成] が灰色表示されている場合、そのグループに対して自動構成を利用することはできません。特定のグループがなぜ自動構成できないかについては、その項目のツールチップを参照してください。
パネルの上部に表示される項目の詳細 (処理されたペア、処理されなかったペア、グループに一致しないメッセージなど) については、関連するハイパーリンクをクリックしてください。
特定のレスポンダーに関連するメッセージを確認するには、あるいはレスポンダーとデータ セットの名前を変更するには、[カウント] 列で該当行をクリックします。
- [データの再利用] ページで、インポートされたトラフィックをどのように再利用するか、または既存のデータをどのように変更するかを設定し、[次へ] をクリックします。
- 定義されたレコード ID は、どのデータが新規で、どの新規データが既存のレコードに一致するかを判断するために使用されます。このデータセットがまだ指定されていない場合、このページのデータ ツリーで ID を追加/変更できます。
- ツリーは、ID フィールドを緑色の矢印のアイコンで示します。既存のデータ セットには注釈が表示されます。
トラフィックファイルの新規データを使って、既存のリポジトリデータセットをどのように拡張あるいは更新するかを指定できます。
一致するデータ (ID によって既存のレコード タイプに一致するデータ) がある場合、既存のレコード タイプを再利用するか、それとも既存レコードを更新するかを指定できます。再利用: 一致する既存のレコードを再利用/共有します。更新: 既存のレコードの対応するフィールドをトラフィックのデータで更新し、新規レコード タイプに対応する新規レコードを追加します。
Panel title Virtualize のみのオプション 置換: 既存データを削除し、新規データを追加します。
マージ: 既存データを変更せずに、新規データをインポートします。
更新: 一致するレコードを新規データで更新し、必要に応じて新規レコードを作成します。
上書き: 一致するキーを持つ、一致するレコードを新規データで更新します。新規レコードは作成しません。
Virtualize については、「Configuring Data Reuse and Updating Virtualize」を参照してください。
- [テンプレートのエクスポート] ページで、必要に応じてテンプレートのエクスポート設定を指定し、[次へ] をクリックします。
このウィザードで使用した設定を保存したい場合、テンプレートに設定をエクスポートすることができます。[再利用可能なテンプレートに構成データをエクスポート] チェック ボックスをオンにし、ファイル名と保存先を指定します。
テンプレートの作成と使用の詳細については「Using Configuration Templates to Reuse and Share Wizard Settings - Virtualize」を参照してください。(仮想アセットフォルダーで .pva を作成していて、自動デプロイとなる場合) [仮想アセッ トのデプロイ] ウィザード ページで、作成する仮想アセットの名前およびデプロイ パスを指定します。そして [次へ] をクリックします。リストにあるエンド ポイントに仮想アセットがデプロイされます。詳細については「個別の仮想アセットのデプロイメント設定」を参照してください。
- [終了] をクリックします。
次のアイテムが作成および構成されます。
- (新規データ リポジトリの場合) 適用可能なデータ セットおよびレコード タイプが追加された Data Repository が追加されます。トラフィックの解析によって識別されたメッセージのグループごとに 1 つのデータ セットが追加されます。
- (既存のデータ リポジトリの場合) 既存のリポジトリに新規データ セットおよびレコード タイプが追加されます。
- 追加されたデータ セットごとにリポジトリ データ ソースが追加され、テスト クライアントまたはメッセージ レスポンダーは関連するデータ ソースを使用するよう構成されます。
Virtual Asset フォルダーに .pva が作成された場合、ウィザードが完了すると、仮想アセットは自動的にローカルの Virtualize サーバーにデプロイされます。そうでない場合、ローカル サーバーまたはリモート サーバーに手動でデプロイすることができます。
データ リポジトリに格納されたデータの編集および格納については、「Viewing and Modifying the Repository Structure and Contents」を参照してください。
なお、トラフィック ファイル中に存在する、カスタム トランスポート ヘッダーおよび SOAP ヘッダー (たとえば WS-Security ヘッダー) は、生成されるアセットあるいはデータリポジトリ データ セットに自動的に設定されないので注意してください。それらのヘッダーは、生成されたメッセージ レスポンダーで指定できます。
(詳細については「Message Responder Overview」を参照してください)
仮想アセットのデプロイ
Virtual Asset フォルダーに .pva が作成された場合、ウィザードが完了すると、仮想アセットは自動的にローカルの Virtualize サーバーにデプロイされます。そうでない場合、ユーザーは準備ができたときにいつでもローカル サーバーまたはリモート サーバーに仮想アセットをデプロイすることができます。
デプロイ手順とオプションの詳細については、「Deploying Virtual Assets - Overview Virtualize」を参照してください。
仮想アセットのカスタマイズ
メッセージ レスポンダーの振る舞いをカスタマイズする方法については、「Message Responder Overview」を参照してください。
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" は常に同じ順序で出現します。
ウィザードの完了: 詳細情報
以下のセクションでは、ウィザードを完了するのに役立つ詳細情報について説明しています。
| Scroll pdf ignore | ||||
|---|---|---|---|---|
ビデオ チュートリアル: メッセージ プロキシで記録したトラフィックから仮想アセットを作成するこの動画では、メッセージ プロキシで記録したトラフィックから仮想アセットを作成する方法を学びます。
|