前提条件
- パラメータライズされたテスト クライアントまたは Message Responder をトラフィックから作成するには、Data Repository Server がインストールされ、実行中である必要があります。詳細については、 リモート Data Repository サーバーのインストール
- メッセージ コンテンツは整形式でなければなりません (たとえば、XML の場合は整形式であること。EDI の場合は有効な EDI メッセージであることなど)。整形式でない場合、トラフィックからのテストの自動生成が失敗する可能性があります。SOAP メッセージ/Message Responder には、最上位の XML 要素が 1 つだけ存在しなければなりません。
- メッセージ グループ化オプションの注意事項: Data Repository は混合型の JSON 配列のパラメータライズをサポートしていません。 JSON 配列に混合型が含まれない場合、SOAtest または Virtualize は、配列のすべての要素が最初の要素と同じ型であると仮定します。
...
利用できる作成ウィザードで [トラフィック] > [パラメータライズされたメッセージを生成] を選択します。詳細については次の章を参照してください: 「 「既存のプロジェクトへの新規 .tst ファイルの追加」「新規テスト スイートの追加」
- トラフィック ウィザードの先頭ページで以下の設定を行います。ウィザードで次の情報を指定し、[次へ] をクリックします。
- トラフィック ファイルの場所を指定します。
- 必要に応じて文字エンコーディングを変更します。
以前にテンプレートに保存した設定グループをウィザードに入力したい場合、テンプレートの場所を入力します。SOAtest でのテンプレートの作成と使用の詳細については「構成テンプレートを使用したウィザード設定の再利用と共有」を、Virtualize でのテンプレートの作成と使用の詳細については「構成テンプレートによるウィザード設定の再利用と共有」を参照してください。
[次へ] をクリックします。
[Parasoft Data Repository Settings] ページで、 テスト クライアントまたはメッセージ レスポンダーのパラメータライズに使用されるデータを格納するデータ リポジトリを指定し、[次へ] をクリックします。 をクリックします。
[サーバー] フィールドで、接続するサーバーを指定します (組込みサーバーまたはリモート サーバー)。組込みサーバーを選択した場合、[ポート]、[ユーザー]、[パスワード] フィールドはグレー表示になります。リモート サーバーを選択した場合、[ポート]、[ユーザー]、[パスワード] フィールドは自動的に設定されます。この設定は必要に応じて変更できます。
- [リポジトリ名] フィールドで、使用するリポジトリ名を選択または入力します。新しいリポジトリ名を入力すると、その名前でリポジトリが作成されます。
リポジトリ接続を定義したら、 [検証] をクリックして接続をチェックできます。
Info title ウィザードが終了するまでのリポジトリのロック リモートの (たとえば組込みではない) Data Repository サーバーで作業している場合、ここで指定するリポジトリはウィザードが終了するまでロックされます。「tmp によってロックされています」ではなく「your_username によってロックされています」と表示させたい場合、[ロックのために認証を設定] チェックボックスをオンにし、使用する CTP サーバーの URL を指定します。そして CTP サーバー用のユーザー名とパスワードを指定します。ロックの詳細については「リポジトリのロックおよびロック解除」を参照してください。
[メッセージ形式] および [Grouping Strategy] ページの設定を完了したら、[次へ] をクリックします。メッセージ フォーマットおよびグループ化手法 の画面で設定を行います:
[リクエスト メッセージ形式:] および [レスポンス メッセージ形式:] に正しいフォーマットが設定されていることを確認します。フォーマットが正しくない場合、適切なフォーマットを選択します。
SOAtest および Virtualize は、トラフィックファイルの最初のメッセージに基づいて、リクエストおよびレスポンスのメッセージ フォーマットの識別を試みます。1 つのトラフィック ファイルでは、すべてのリクエストが同じフォーマットであり、またすべてのレスポンスも同じフォーマットであることが期待されます。リクエスト フォーマットとレスポンス フォーマットは異なっていてもかまいません。メッセージ フォーマットを検出できなかった場合、プレーン テキストが選択されます。選択されたフォーマット (たとえば EDI やカスタム フォーマット) に対して利用可能な変換オプションを設定するには、フォーマットの右側にある 変換オプションは、EDI やカスタム形式などの一部の形式で使用できます。[変換オプション] ボタンをクリックし、任意の変更を加えます。 ボタンをクリックして、必要な変更を加えます。
以下のいずれかのメッセージ グループ化オプションを選択します:
目的のメッセージ グループ化オプションを指定し、[次へ] をクリックします (詳細については下記枠内の「メッセージ グループ化オプション」を参照してください)。
Info title メッセージ グループ化オプション 以下のオプションを利用できます。
操作/タイプに基づく: 操作またはメッセージ タイプに基づいてメッセージをグループ化します。このオプションが有用なのは、操作によって、あるいはメッセージ タイプ (つまり、SOAP ボディの要素名、プレーン XML メッセージのルート要素、または指定されたメッセージ形式のメッセージ タイプ) によって、明確に特定できるメッセージを持つサービス トラフィックの場合です。トラフィック ファイル中で発見された操作/タイプごとに 1 つのレスポンダーが生成されます。このオプションを選択した場合、トラフィック
ファイルの解析に基づいて、Virtualize はグループ化の経験則を適用することを推奨します。ユーザーはあらかじめ選択された経験則を変更できます。経験則の詳細については「 操作/ タイプによるグループ化の経験則」を参照してください。
- 類似リクエストに基づく: リクエスト メッセージの構造に基づいてメッセージをグループ化します。構造が類似したリクエストに関連するレスポンスを個々のレスポンダーが持つよう、Virtualize はリクエスト メッセージの構造を解析し、リクエスト/レスポンスをグループ化してレスポンダーにします。メッセージは、たとえ値が異なっていても、同一の DOM ツリー モデルを持つ場合に " 類似" と見なされます。このオプションは、各メッセージ レスポンダー内でレスポンスにリクエストを関連付けるための規則を最適化し簡潔にするために使用されます。
類似レスポンスに基づく: レスポンス メッセージの構造に基づいてメッセージをグループ化します。このオプションを選択すると、Virtualize は、レスポンス メッセージの構造を解析し、リクエスト/レスポンスのペアをグループ化してレスポンダーにすることで、個々のレスポンダーが、構造が類似したレスポンスを持つようにします。メッセージは、たとえ値が異なっていても、同一の DOM ツリー モデルを持つ場合に " 類似" と見なされます。
なし: グループ化しない。トラフィック ファイル中のレスポンス メッセージごとにレスポンダーが生成されます。リクエスト/レスポンスのペアごとに個別のメッセージ レスポンダーを用意したい場合、このオプションを使用します。
- [次へ] をクリックし、[メッセージ グループ化の確認] ページで、操作についての情報と検出されたメッセージを確認します。 画面で操作やメッセージの情報を確認します。 表示される列の種類は、適用されたグループ化方法によって異なります。
- 含まれている列は、適用されているグループ化方法に基づきます。
- 表の各行は、グループを定義するための条件を表します。1 行に対して 1 つのグループが生成されます。そして 1 つのグループに対して 1 つのレスポンダーが生成されます。
応答条件基準は、表に表示されている順番に (上から下に)
処理されます。
URL パスおよびパラメーターは、レコード タイプのフィールドに対応してパラメータライズされます。フィールド名は自動生成され、[データの再利用] ページ (ウィザードの後のページで表示されます)
に表示されます。
これらのグループ化の作成方法の詳細については、「操作/ タイプによるグループ化の経験則」を参照してください。
利用できるコントロールを使って、グループ化条件を追加、変更、並べ替え、および削除することができます。 SOAtest
でのグループ化基準の構成の詳細については、「でのグループ化条件の詳細については「グループ化条件のカスタマイズ 1
」を参照してください。Virtualize でのグループ化基準の構成の詳細については、「グループ化条件のカスタマイズ 」を参照してください。条件を変更したら、次のページに進む前に必ず 」を参照してください。
Virtualize でのグループ化条件の詳細については「グループ化条件のカスタマイズ」を参照してください。
条件を変更したら、次のページに進む前に必ず [再グループ化] をクリックしてください。
すべての [自動構成] チェック ボックスがオンであり、指定したグループに対してメッセージ レスポンダーを自動的に構成したい場合、
次のステップをスキップできます。このステップをスキップできます。
以下のいずれかの場合、カスタマイズする各メッセージ グループの [自動構成] チェック ボックスをオフにし、[次へ] をクリックします。そして、「リクエストの照合と応答条件のカスタマイズ」で説明しているようにリクエスト照合を設定します。
- 仮想アセットのレスポンスメッセージを決定するためにどのパラメーター値を使用する かをカスタマイズしたい場合
- 自動化されたリクエスト/ レスポンスペアの照合を変更 したい場合
- WSDL またはスキーマを指定したい場合
1 つのメッセージ グループ内に複数のリクエストが存在し、パス、パラメーター、またはボディに差異がある場合は通常、自動構成を利用できます。[自動構成] が灰色表示されている場合、そのグループに対して自動構成を利用することはできません。特定のグループがなぜ自動構成できないかについては、その項目のツールチップを参照してください。
パネルの上部に表示される項目の詳細 (処理されたペア、処理されなかったペア、グループに一致しないメッセージなど) については、関連するハイパーリンクをクリックしてください。
特定のレスポンダーに関連するメッセージを確認するには、あるいはレスポンダーとデータ セットの名前を変更するには、[カウント] 列で該当行をクリックします。WSDL/スキーマを指定する場合、[WSDL/スキーマの構成] をクリックし、次のページで適切な値を指定します。
Info title WSDL またはスキーマを指定するべき場合 WSDL またはスキーマを指定することには次のメリットがあります。
生成されたフォーム入力モデルは指定した WSDL/ スキーマに基づくので、フォーム入力を編集したり保守したりするときに豊富なタイプを利用できます。
サービスの進化や環境条件の変化とユーザーのアセットとを同期しておくために、変更アドバイザーを利用できます (変更アドバイザーについては「変更管理」で説明) 。
生成されたフォーム入力とそのデータ パラメータライズが元のメッセージに一致しない場合、これは「元のメッセージが WSDL/スキーマに完全に一致していないこと」、あるいは「元のメッセージとのマッピングに失敗したこと」を表します。フォーム入力モデルが必ずトラフィック メッセージに完全に一致するよう、WSDL/スキーマを省略してください。
- [次へ] をクリックし、リクエスト照合の画面で設定を行います。
- [リクエスト/レスポンス] タブを使用して、正しい相関関係が作成されていることを確認します。リクエストとレスポンスを結ぶポイントをクリックしてドラッグし、一致を変更できます。
- [リクエスト照合] タブをクリックし、ドロップダウン メニューからレスポンダーを選択します。
- [リクエスト/レスポンス] タブを使用して、正しい相関関係が作成されていることを確認します。リクエストとレスポンスを結ぶポイントをクリックしてドラッグし、一致を変更できます。
- インポートしたトラフィックを再利用する方法、またはデータの再利用画面で既存のデータに影響を与える方法を設定します。データの再利用] ページで、インポートされたトラフィックをどのように再利用するか、または既存のデータをどのように変更するかを設定し、[次へ] をクリックします。
- 定義されたレコード ID は、どのデータが新規で、どの新規データが既存のレコードに一致するかを判断するために使用されます。このデータセットがまだ指定されていない場合、このページのデータ ツリーで ID を追加/変更できます。
- ツリーは、ID フィールドを緑色の矢印のアイコンで示します。既存のデータ セットには注釈が表示されます。
トラフィックファイルの新規データを使って、既存のリポジトリデータセットをどのように拡張あるいは更新するかを指定できます。
置換: 既存データを削除し、新規データを追加します。
追加: 既存のデータを消去せずに新規データを追加します。
一致するデータ (ID によって既存のレコード タイプに一致するデータ) がある場合、既存のレコード タイプを再利用するか、それとも既存レコードを更新するかを指定できます。再利用: 一致する既存のレコードを再利用/共有します。更新: 既存のレコードの対応するフィールドをトラフィックのデータで更新し、新規レコード タイプに対応する新規レコードを追加します。
Panel title Virtualize のみのオプション 置換: 既存データを削除し、新規データを追加します。
マージ: 既存データを変更せずに、新規データをインポートします。
更新: 一致するレコードを新規データで更新し、必要に応じて新規レコードを作成します。
上書き: 一致するキーを持つ、一致するレコードを新規データで更新します。新規レコードは作成しません。
SOAtest での ID の指定とデータの再利用/更新オプションの選択の詳細については「データの再利用および更新の構成」を参照してください。 Virtualize
については「データの再利用と更新の設定」を参照してください。
- [
- 次から制約を推論] オプションを使用すると、Virtualize でリポジトリに保存されているデータの特性を判断できます。データまたはサービス定義に基づいて制約を推測できます。
- ページで、必要に応じてテンプレートのエクスポート設定を指定し、[次へ] をクリックします。 このウィザードで使用した設定を保存したい場合、テンプレートに設定をエクスポートすることができます。[再利用可能なテンプレートに構成データをエクスポート] チェック ボックスをオンにし、ファイル名と保存先を指定します。
テンプレートの作成と使用の詳細については、「] をクリックし、[最終オプション] 画面で追加の構成を指定します。- フォーム モードまたはリテラル モードでメッセージを作成するようにウィザードを構成できます。これらのモードは、フォーム入力ビュー( フォーム入力 )またはリテラル ビュー( リテラル )を表示します。
[再利用可能なテンプレートに構成データをエクスポート] オプションを有効にして、ファイル名と場所を指定して、このウィザードで使用した設定をテンプレートとして保存することができます。
(MQ および JMS のみ) 次の SOAtest ウィザード ページで接続設定を指定します。設定は、このトラフィックから作成されるツールに適用されます。詳細については「MQ オプションの設定」および「JMS オプションの構成」を参照してください。
テンプレートの作成と使用の詳細については、「構成テンプレートによるウィザード設定の再利用と共有」および「SOAtest での構成テンプレートによるウィザード設定の再利用と共有」を参照してください。
(仮想アセットフォルダーで .pva を作成していて、自動デプロイとなる場合) [仮想アセッ トのデプロイ] ウィザード ページで、作成する仮想アセットの名前およびデプロイ パスを指定します。そして [次へ] をクリックします。リストにあるエンド ポイントに仮想アセットがデプロイされます。詳細については「個別の仮想アセットのデプロイメント設定」を参照してください。
(MQ および JMS のみ) 次の SOAtest ウィザード ページで接続設定を指定します。設定は、このトラフィックから作成されるツールに適用されます。詳細については「MQ オプションの設定」および「JMS オプションの構成」を参照してください。
- [終了] をクリックします。
次のアイテムが作成および構成されます。
値がパラメータライズされた 1 つまたはそれ以上のテスト クライアント。メッセージのフォーマットに応じて SOAP Client、REST Client、EDI Client または Messaging Client が作成されます。メッセージが XML または JSON ではなく、パフォーマンスへの影響が予想されるほどメッセージのサイズが大きくない限り、[フォーム入力]/[フォーム JSON] ビューがデフォルトで使用されます。そうでない場合、[リテラル] ビューが使用されます。
要素がパラメータライズされ、レスポンダー応答条件およびデータ ソース応答条件が設定された Message Responder が追加されます。メッセージが XML または JSON ではなく、パフォーマンスへの影響が予想されるほどメッセージのサイズが大きくない限り、[フォーム入力]/[フォーム JSON] ビューがデフォルトで使用されます。そうでない場合、[リテラル] ビューが使用されます。
- (新規データ リポジトリの場合) 適用可能なデータ セットおよびレコード タイプが追加された Data Repository が追加されます。トラフィックの解析によって識別されたメッセージのグループごとに 1 つのデータ セットが追加されます。
- (既存のデータ リポジトリの場合) 既存のリポジトリに新規データ セットおよびレコード タイプが追加されます。
- 追加されたデータ セットごとにリポジトリ データ ソースが追加され、テスト クライアントまたはメッセージ レスポンダーは関連するデータ ソースを使用するよう構成されます。
次の図は、リポジトリの値でパラメータライズされた REST Client の例です。
次の図は、対応するリポジトリの一部分です。
...
なお、トラフィック ファイル中に存在する、カスタム トランスポート ヘッダーおよび SOAP ヘッダー (たとえば WS-Security ヘッダー) は、生成されるアセットあるいはデータリポジトリ データ セットに自動的に設定されないので注意してください。それらのヘッダーは、生成されたメッセージ レスポンダーで指定できます。レスポンダーで指定できます
(詳細については「メッセージ レスポンダーの概要」を参照してください)
...
<element name= "parent" > <complexType> <choice minOccurs= "0" maxOccurs= "unbounded" > <element name= "child1" /> > <element name= "child2" /> > <element name= "child3" /> </choice> </complexType> </element> |
...
<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> |
...
SOAtest ウィザードの入力: 詳細
以下のセクションでは、ウィザードの入力時に役立つ詳細な情報を説明します。
Scroll pdf ignore | ||||
---|---|---|---|---|
ビデオ チュートリアル: メッセージ プロキシで記録したトラフィックから仮想アセットを作成するこの動画では、メッセージ プロキシで記録したトラフィックから仮想アセットを作成する方法を学びます。
|
...