Ready! API スタートガイド - XLsoft Corporation · 2017. 7. 18. · API...

SoapUI NG Pro : API 機能テストツール LoadUI NG Pro : API 負荷テストツール Secure Pro : API セキュリティテストツール ServiceV Pro: サービス仮想化ツール VirtServer: 仮想サービスサーバー

Ready! API スタートガイド

For Ready! API 1.8

エクセルソフト株式会社作成： 2016. 8. 12

－ 2 ― 目次

目次 Ready! API スタートガイド ................................................................................................ 1

目次.................................................................................................................................. 2

はじめに ........................................................................................................................... 4

第 1 章: SoapUI NG スタートガイド ................................................................................. 5

1. プロジェクトの作成..................................................................................................... 6 2. テストケースの作成 ................................................................................................. 8 3. 作成したテストの実行 .............................................................................................. 10 4. SoapUI NG テストの変更 ........................................................................................ 13 5. SoapUI NG テストへのアサーションの追加 .............................................................. 16 次のステップ ................................................................................................................ 20

第 2 章: LoadUI NG スタートガイド ............................................................................... 21

負荷テストエディターインターフェイス ......................................................................... 22 1. SoapUI NG テストプロジェクトの作成 ..................................................................... 25 2. 新規負荷テストの作成 ............................................................................................. 26 3. 作成した負荷テストの実行 ....................................................................................... 29 4. テスト結果の表示 .................................................................................................... 31 5. LoadTests の変更................................................................................................... 34 6. テストフローの管理 ................................................................................................ 37 7. 複数のシナリオの実行 ............................................................................................. 39 8. LoadTests へのアサーションの追加 ......................................................................... 41 次のステップ ................................................................................................................ 44

第 3 章: Secure スタートガイド ...................................................................................... 45

1. SoapUI NG テストプロジェクトの作成 ..................................................................... 46 2. セキュリティテストの作成および実行 ....................................................................... 47 3. テスト結果の表示 .................................................................................................... 49 4. セキュリティスキャンへのアサーションの追加 .......................................................... 50 次のステップ ................................................................................................................ 52

第 4 章: ServiceV スタートガイド ................................................................................... 53

1. 空の Ready! API プロジェクトの作成 ...................................................................... 54

© 2016 SmartBear Software http://readyapi.smartbear.com/start

目次－ 3 －

2. 仮想サービスの作成 ............................................................................................... 55 3. サービスレスポンスの設定 ..................................................................................... 56 4. レスポンスディスパッチの設定 ................................................................................ 58 5. API インターフェイスの設定 ..................................................................................... 60 次のステップ ................................................................................................................ 62

第 5 章: VirtServer のチュートリアル ............................................................................ 63

1. VirtServer のインストールと実行 ............................................................................... 64 2. 仮想サービスの展開 ............................................................................................... 66 3. 仮想サービスの実行とテスト .................................................................................... 71 次のステップ ................................................................................................................ 73

サポート .......................................................................................................................... 74

お問合せ先.................................................................................................................. 74


－ 4 ― はじめに

はじめにこのガイドブックは、Ready! API (v1.8.0) ユーザーガイドのスタートガイドに関して説明した部

分を抜粋して翻訳したものです。

SoapUI NG : SoapUI NG スタートガイド

LoadUI NG: LoadUI NG スタートガイド

Secure : Secure スタートガイド

ServiceV : ServiceV スタートガイド

VirtServer : VirtServer チュートリアル

インストールファイルの入手、各機能の詳細を含んだ最新バージョンの Ready! API ユー

ザーガイドは、SmartBear 社の下記のサイトで参照できます。

http://readyapi.smartbear.com/start

© 2016 SmartBear Software. All rights reserved.

Translated by XLsoft Corporation


http://readyapi.smartbear.com/start

第 1 章: SoapUI NG スタートガイド－ 5 －

第 1 章: SoapUI NG スタートガイド Ready! API は、サービスの機能テスト、負荷テスト、およびセキュリティテストをサポートする複

合ツールです。サービス開始前にテストを実行するために、サービスのローカル仮想コピーを作

成することも可能です。

このチュートリアルでは、SoapUI NG での簡単な機能テストの作成の仕方に関する概要を説明

します。本セクションでは、Ready! API でのプロジェクトの作成、API 定義を用いた簡単なテスト

の作成、およびアサートテストの結果に関する説明が記載されています。


－ 6 ― 第 1 章: SoapUI NG スタートガイド

1. プロジェクトの作成

まず始めに、使用する API を含んだプロジェクトを作成します。

• [File] - [New Project] を選択します。

• ダイアログで必要なオプションを選択します。このチュートリアルでは Google Maps の REST サービスを使用しますので、[URI] タブに切り替えます。 Ready! API では、いくつかの方法でプロジェクトに SOAP および REST サービスを追加で

きます。API にアクセスするには WSDL、WADL、Swagger、および Ready! API の内部ブ

ラウザーの使用が可能ですが、このチュートリアルにおいては、説明を簡単にするために REST URI を使用します。


http://readyapi.smartbear.com/_detail/soapui/getting_started/newproject.png?id=soapui:getting_started:createproject

http://readyapi.smartbear.com/_detail/soapui/getting_started/newproject_dialog.png?id=soapui:getting_started:createproject


• 下記の URI にアクセスし、[OK] をクリックします。 http://maps.googleapis.com/maps/api/geocode/xml?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&sensor=false

• Ready! API に [Project is Created] ダイアログが表示されます。

[Continue to describe your API] を選択して API の [Projects] ツールでの操

作を続けます。

または、[Create TestCase] を選択して SoapUI NG テストを作成し、操作を続け

ます。注意: このオプションを選択する場合には、チュートリアルのステップ 3 に進み

ます。

次のステップでは、この API をベースにして SoapUI でテストを作成します。


http://maps.googleapis.com/maps/api/geocode/xml?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&sensor=false

http://maps.googleapis.com/maps/api/geocode/xml?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&sensor=false

http://readyapi.smartbear.com/_detail/soapui/getting_started/newrestproject_dialog.png?id=soapui:getting_started:createproject


2. テストケースの作成

前のステップでは、Google Maps の Web サービスにリクエストしてプロジェクトを作成しまし

た。これからは、ボタンをクリックしてサービスに個別のリクエストを送信できます。サービスか

らのレスポンスは、Ready! API で表示されます。

たとえば一度に複数のリクエストを送信する場合や、データドリブンテスト (data-driven tests ) を作成する場合などにテストを自動化するには、SoapUI NG テストを作成します:

• [REST Request] を右クリックし、[Add to TestCase] を選択します。

• リクエストを含む TestSuite および TestCase の名前を指定します。SoapUI NG でリク

エストの TestSuite および TestCase が作成されます。


http://readyapi.smartbear.com/soapui/data_driven/start


http://readyapi.smartbear.com/_detail/loadui_ng/getting_started/run_b.png?id=soapui:getting_started:createtest

http://readyapi.smartbear.com/_detail/soapui/getting_started/createdproject.png?id=soapui:getting_started:createtest

http://readyapi.smartbear.com/_detail/soapui/getting_started/addtotestcase.png?id=soapui:getting_started:createtest


• リクエスト名を指定して、その他のオプションはそのままにします。[OK] をクリックします。

Ready! API で SoapUI NG テストが作成されます。次のステップでは、新しく作成したテストを SoapUI NG で実行します。


http://readyapi.smartbear.com/_detail/soapui/getting_started/addrequest_dialog.png?id=soapui:getting_started:createtest


3. 作成したテストの実行

SoapUI NG テストは、複数の場所で実行できます。最適な場所は、テストの複雑さによって決ま

ります。このチュートリアルでは簡単なテストを作成しますので、リクエストから直接実行可能です。

次のステップではテストを変更しますので、続行する前にテストが正常に機能することを確認しま

す。

リクエストからのテストの実行

リクエストウィンドウからテストを実行する場合、選択したリクエストのみがシミュレートされます。

テストの準備をする場合や簡単なテストを実行する際に、即座に返信にアクセスし、リクエストを

変更したりアサーションを追加したりできるので便利です。さらに複雑なテストにおいては、リクエストは以前の TestSteps からのデータに依存することが

多いので、そのようなリクエストは失敗となります。個別のリクエストを実行するには、をクリックします。

TestCases からのテストの実行

TestCases からテストを実行すると、すべての TestCase の TestSteps が順にシミュレートされ

ます。エディターでは、実行したテストを比較したり、テスト履歴を表示したりするなど、 TestStep レベルでは使用できないいろいろな操作が可能です。 TestCase のすべての TestSteps を実行するには、をクリックします。


http://readyapi.smartbear.com/_detail/loadui_ng/getting_started/run_b.png?id=soapui:getting_started:runtest

http://readyapi.smartbear.com/_detail/soapui/getting_started/runrequest.png?id=soapui:getting_started:runtest



TestSuites および Projects からテストを実行

複数の TestCases や複数のテストスイートを実行するには、それぞれのウィンドウのをク

リックします。デフォルトでは、TestCases およびテストスイートは順に実行されます。同時に実行するに

は、をクリックします。


http://readyapi.smartbear.com/_detail/soapui/getting_started/runtestcase.png?id=soapui:getting_started:runtest


http://readyapi.smartbear.com/_detail/soapui/functional_testing/parallel.gif?id=soapui:getting_started:runtest


今回作成したテストにはリクエスト、TestCase ともに１つしか存在しないため、次のステップで

はテストを変更します。


http://readyapi.smartbear.com/_detail/soapui/getting_started/runproject.png?id=soapui:getting_started:runtest


4. SoapUI NG テストの変更

作成したテストでは、1600 Amphitheatre Parkway, Mountain View, CA という住所をリクエスト

送信し、その地理的な位置を受信します。このリクエストは、リクエストエディターの住所フィール

ドに表示されます。

これを変更してみましょう。450 Artisan Way, Somerville, MA とフィールドに入力し、再度テス

トを実行します。

これでレスポンスが変わります。入力情報が有効であれば、Web サービスは正確なデータを返

信します。それから、アサーションを使用して返信データを確認できます。

同じ Web サービスに、2 番目のリクエストを追加して、サービスが正しく機能することを確認す

るために誤ったデータを送信してみましょう。


http://readyapi.smartbear.com/_detail/soapui/getting_started/samplerequest.png?id=soapui:getting_started:modifytest

http://readyapi.smartbear.com/_detail/soapui/getting_started/modifyrequest.png?id=soapui:getting_started:modifytest


• TestCase を右クリックして [Add Step] - [REST Request] を選択します。注意: API のパネルを Navigator にドラッグしてリクエストを作成することもできます。

• 新規 TestStep の名前を指定します。

• [OK] をクリックします。

• [New RestRequest] ダイアログから新規の TestStep がリクエストを送信する REST メソッドを選択して [OK] をクリックします。SoapUI NG がデフォルトのリクエストアドレスを

使って新規の TestStep を開きます。

• ここで、たとえば 81a35s72z36 のようなランダムな記号と特殊文字の組み合わせを入力し

てをクリックします。レスポンスは ZERO RESULTS となり、リクエストに一致する結果が見


http://readyapi.smartbear.com/_detail/soapui/getting_started/addrestrequest.png?id=soapui:getting_started:modifytest

http://readyapi.smartbear.com/_detail/soapui/getting_started/addrestrequest_dialog.png?id=soapui:getting_started:modifytest

http://readyapi.smartbear.com/_detail/loadui_ng/getting_started/run_b.png?id=soapui:getting_started:modifytest


つからなかったことを意味します。

注意: 両方のリクエストを 1 つのテストで送信するには、両方のリクエストを含む TestCase を実

行します。

次のステップでは、アサーションを作成し、テストが SLA に従って実行され、一貫して同様の操

作を行うことを確認します。


http://readyapi.smartbear.com/_detail/soapui/getting_started/zeroresultsrequest.png?id=soapui:getting_started:modifytest


5. SoapUI NG テストへのアサーションの追加

アサーションとは、対象となる Web サービスの機能を確認するテスト結果に適用される検証規

則です。

対象となる Web サービスが制限時間以内に返信することを確認するアサーションを作成しま

しょう。

• 最初に作成したリクエストに切り替えます。

• [Assertions] タブを開きます。

• [ Add Assertion] をクリックします。


http://readyapi.smartbear.com/_detail/soapui/getting_started/assertion/main.png?id=soapui:getting_started:addassertions

http://readyapi.smartbear.com/_detail/soapui/getting_started/assertion/tab.png?id=soapui:getting_started:addassertions

http://readyapi.smartbear.com/_detail/icon/system/add.png?id=soapui:getting_started:addassertions


• [Add Assertion] ダイアログで [SLA] - [Response SLA] を選択し、[Add] をクリックしま

す。

• アサーションがトリガーされるまでのレスポンスタイムを指定し、 [OK] をクリックします。

これで、TestStep が指定されたミリ秒以上の時間を要した場合、アサーションがトリガーされてテ

ストは失敗となります。

レスポンスで返された場所が一致することも確認しましょう:

• [Assertions] タブを開いて再度 [ ] をクリックします。

• [Add Assertion] ダイアログで [Property Content] - [XPath match] を選択し、[Add] をク

リックします。


http://readyapi.smartbear.com/_detail/soapui/getting_started/slaassertion.png?id=soapui:getting_started:addassertions

http://readyapi.smartbear.com/_detail/soapui/getting_started/configuresla.png?id=soapui:getting_started:addassertions

http://readyapi.smartbear.com/_detail/icon/system/add.png?id=soapui:getting_started:addassertions


• [ ] をクリックしてレスポンスからノードを選択します。


http://readyapi.smartbear.com/_detail/soapui/getting_started/xpathassertion.png?id=soapui:getting_started:addassertions

http://readyapi.smartbear.com/_detail/soapui/getting_started/selectxpath_b.png?id=soapui:getting_started:addassertions

http://readyapi.smartbear.com/_detail/soapui/getting_started/xpathassertiondialog.png?id=soapui:getting_started:addassertions


• [geometry[1]/location[1]/lat[1]] を選択して [OK] をクリックします。

• SoapUI NG でレスポンスアイテムにアクセスするための XPath expression が作成され、

最後のレスポンス結果を期待する結果として取得します。[Save] をクリックしてアサーショ

ンを作成します。

これで、レスポンスが変更した場合、アサーションがトリガーされて TestStep は失敗となります。


http://readyapi.smartbear.com/_detail/soapui/getting_started/selectxpathdialog.png?id=soapui:getting_started:addassertions

http://readyapi.smartbear.com/_detail/soapui/getting_started/xpathassertiondialogwithresponse.png?id=soapui:getting_started:addassertions


次のステップ

SoapUI NG のチュートリアルはこれで終了です。このスタートガイドが SoapUI NG の理解に役

立つことを願っています。いくつかのヘルプトピックを次に示します。

トピック説明

Data-Driven Testing SoapUI NG でのデータドリブンテストの作成方法

Point And Click Testing SoapUI NG で Point And Click Testing を使ってリクエストか

ら別のリクエストに素早くデータを追加する方法.

Discovery Web サービスのテストをレコーディングする方法

Property Expansions テスト実行中に動的にプロパティ値を挿入する方法

Authentication SoapUI NG テストでの認証の使用方法

その他の Ready! API ツール

その他の Ready! API ツールを使って API テストを改善することもできます。ツールの概要につ

いては、下記のチュートリアルを参照してください。

トピック説明

ServiceV スタートガイドライブのサービス開始前にローカルの仮想サービスを作成

し、テストを作成する方法について

Secure スタートガイドサービスに使用するセキュリティテストの作成方法について

LoadUI NG スタートガイド SoapUI 機能テストでの負荷テストの作成方法について



http://readyapi.smartbear.com/features/get_data/start

http://readyapi.smartbear.com/features/get_data/start

http://readyapi.smartbear.com/projects/discovery/rest/about

http://readyapi.smartbear.com/features/expansions/start

http://readyapi.smartbear.com/soapui/auth/start

第 2 章: LoadUI NG スタートガイド－ 21 －

第 2 章: LoadUI NG スタートガイドこのチュートリアルでは、 Load Test エディターのインターフェイスについて説明し、LoadUI NG を使った負荷テストの作成方法を示します。このチュートリアルのセクションは、Ready! API での

負荷プロジェクトの作成方法、簡単なテストの実行 (run a simple test)、およびテスト結果の解

析 (analyze the results) に関する説明を含みます。テストはサンプルの SoapUI NG テストを

エミュレートします。


http://readyapi.smartbear.com/loadui_ng/getting_started/running_load_test

http://readyapi.smartbear.com/loadui_ng/getting_started/viewing_test_results

－ 22 ― 第 2 章: LoadUI NG スタートガイド

負荷テストエディターインターフェイス

LoadUI NG では、Load Test エディターを使って負荷テストを表示、編集、実行できます。Load Test エディターのサンプル表示です:

Load Editor ツールバー

エディターのツールバーでは、テストの継続時間 (test duration) を設定します。LoadUI NG は、対象となる Web サーバーへのリクエストを指定したタイムアウトが発生するまで、またはそ

の他の理由でテストが停止するまでシミュレートします。タイムアウトが指定されていない場合は、

テストを手動で停止する必要があります。

エディターの上部にある進行状況バーは、テストの進行状況を表示します。

[Running Requests] には、使用中の仮想ユーザーおよび使用可能な仮想ユーザーの最多

人数が表示されます。

Load Editor ページ

エディターにはいくつかのページがあります:

• Load - このページでは、テストの負荷タイプ (load type) および負荷プロファイル (load profile) の選択、テスト結果を検証するアサーション (assertions) の作成などの負荷テス


http://readyapi.smartbear.com/loadui_ng/configure/duration/start

http://readyapi.smartbear.com/loadui_ng/configure/types/start

http://readyapi.smartbear.com/loadui_ng/configure/profiles/start

http://readyapi.smartbear.com/loadui_ng/configure/profiles/start

http://readyapi.smartbear.com/loadui_ng/configure/assertions/about

http://readyapi.smartbear.com/_detail/loadui_ng/getting_started/load_test_editor_ui_overview.png?id=loadui_ng:getting_started:load_test_editor_interface


トの設定を行います。テスト設定に関する詳細については「Configuring LoadTests」セク

ションを参照してください。

• Scheduler - 負荷テスト中にシナリオを使用する時間を設定します。詳細については

「Load Scheduler」を参照してください。

• Log - 特定の条件に応じてリクエストを記録します。詳細については「Transaction Log Page」を参照してください。

• Distribution - リモートコンピューターでテストを実行するためのリモートエージェントを

設定します。詳細については「About Distributed Load Testing」を参照してください。

• Monitoring - テスト実行時におけるサーバーのモニタリング設定をします。収集データ

は他のテスト結果と一緒に保存されます。詳細については「About Server Monitoring」を参照してください。

• Statistics – 対象となる Web サービスにおける、テスト間のパフォーマンスメトリックの変

化を確認できます。テスト実行の統計情報に関する詳細は、「Test Results」を参照してくだ

さい。

• Scripts – テストの開始時および終了時に使用されるスクリプトを設定します。詳細につい

ては「Setup and Teardown Scripts」を参照してください。

注意: LoadUI NG Free では、Load ページのみにアクセスできます。その他のページを使用す

るには、LoadUI NG Pro license が必要になります。

Load Scenarios パネル

このパネルでは、負荷タイプを選択し、負荷テストのシナリオを設定できます。

[Load Type] ドロップダウンリストでは、負荷テストで使用する load type を選択します:

• VUs - LoadUI NG が、対象となる Web サービスにリクエストを送信する仮想ユーザーを

シミュレートします。

• Rate - LoadUI NG が、対象となる Web サービスに特定の割合でリクエストを送信しま

す。

シミュレートした負荷を編集するには、編集する負荷シナリオをクリックし、Editor パネルの

Scenario セクションで値を編集します。

アサーションを作成するには、アサーションを作成するシナリオまたは TestStep をクリックし、

Editor パネルで作成します。


http://readyapi.smartbear.com/loadui_ng/configure/start

http://readyapi.smartbear.com/loadui_ng/configure/scenarios/scheduler

http://readyapi.smartbear.com/loadui_ng/results/log/start


http://readyapi.smartbear.com/loadui_ng/distributed/start

http://readyapi.smartbear.com/loadui_ng/monitor/start

http://readyapi.smartbear.com/loadui_ng/results/statistics/start

http://readyapi.smartbear.com/loadui_ng/configure/script/start

http://smartbear.com/product/ready-api/loadui/pricing/



Metrics パネル

TestSteps Metrics パネルは、各 TestStep の詳細メトリックを表示します。たとえば、ステップを

完了するのに要する最短および最長時間を確認できます。 Global Metrics パネルでは、総合的なテスト結果のグラフが表示されます。たとえば、リクエスト

処理のピークタイムを確認できます。また、これらのグラフに表示されるメトリックのテストアサー

ションを参照できます。また、ドロップダウンリストを使って、テスト実行中に使用した別のシナリオのメトリックに切り替え

ることもできます。注意: これらのパネルに表示される結果は、進行中のテストのみです。過去のテスト情報、また

はその他のメトリックを参照するには、Statistics ページのグラフを使用します。

Editor パネル

シナリオ、TestCase、または TestStep レスポンスをクリックすると、Editor パネルが表示されま

す。このパネルでは、選択したオブジェクトを編集できます。たとえば、負荷シナリオの負荷プロ

ファイルを設定したり、TestStep レスポンスにアサーションを追加したりできます。


http://readyapi.smartbear.com/loadui_ng/results/statistics/start


1. SoapUI NG テストプロジェクトの作成

LoadUI NG 負荷テストは、SoapUI NG で作成した TestCases を使用して負荷をシミュレートし

ます。

そのため、負荷テストを作成する前に SoapUI NG テストプロジェクトを作成する必要がありま

す。テストプロジェクト作成の詳細については、「SoapUI NG スタートガイド」を参照してくださ

い。

チュートリアルを簡潔にするために、Ready! API に含まれる Sample-Data-driven-project.xml というサンプルプロジェクトをインポートします:

• メインメニューから [File] - [Import Project] を選択し、<Ready! API インストールディ

レクトリ>¥tutorials ディレクトリを参照します。

• Sample-Data-driven-project.xml というファイル名のサンプルプロジェクトを選択し、

[Open] をクリックします。

または、

• Ready! API スタートページの [Data Driven Sample Project] をクリックします。

プロジェクトツリーにプロジェクトの内容が表示されます:


http://readyapi.smartbear.com/_detail/loadui_ng/getting_started/soapui_project.png?id=loadui_ng:getting_started:creating_soapui_project


2. 新規負荷テストの作成

[LoadUI NG] ツールを選択します。

• プロジェクトツリーで、負荷テストを作成するプロジェクトを右クリックし、コンテキストメニューから [New LoadUI NG Test] を選択します。[New Load Test] ダイアログが表示

されます。

• 使用する負荷テスティングシナリオがわかっている場合、負荷テストテンプレートを使って

特定の testing scenario の負荷テストを作成できます。このチュートリアルでは、より早くテ

ストを実行するために Manual アプローチを使って負荷テストの設定をします。Manual タブに切り替えます。

• このタブでは、テストターゲットを選択できます。たとえば、先ほどインポートした SoapUI NG テストケースを使用できます。単一の API リクエストを選択することも、URL を指定し

てのちに負荷テストを迅速に作成することもできます。SoapUI NG test case と、先ほどイ


http://readyapi.smartbear.com/loadui_ng/practices/scenarios/start

http://readyapi.smartbear.com/_detail/loadui_ng/getting_started/new_loaduitest.png?id=loadui_ng:getting_started:creating_load_test

http://readyapi.smartbear.com/_detail/loadui_ng/getting_started/new_loaduitest_dialog.png?id=loadui_ng:getting_started:creating_load_test


ンポートしたテストを選択します。

• 負荷テストの名前を付けます。

• [OK] をクリックします。

これで終了です。作成したテストを LoadUI NG で開きます:


http://readyapi.smartbear.com/_detail/loadui_ng/getting_started/new_loaduitest_dialog_select_test_case.png?id=loadui_ng:getting_started:creating_load_test

http://readyapi.smartbear.com/_detail/loadui_ng/getting_started/new_loaduitest_dialog_test_name.png?id=loadui_ng:getting_started:creating_load_test

http://readyapi.smartbear.com/_detail/loadui_ng/getting_started/new_loaduitest_dialog_ok.png?id=loadui_ng:getting_started:creating_load_test


これで、次のステップの「作成した負荷テストの実行」ができます。


http://readyapi.smartbear.com/_detail/loadui_ng/getting_started/created_load_test.png?id=loadui_ng:getting_started:creating_load_test


3. 作成した負荷テストの実行

デフォルトでは、新規に作成した負荷テストは VUs 負荷タイプおよび 5 人の仮想ユーザーをシ

ミュレートする Fixed プロファイルを使用します。

ここでは、テストの負荷タイプおよび負荷プロファイルパラメーターはデフォルト値のままにし、

テストの継続時間のみを設定します。読み込み時間フィールドに 60 と入力します。LoadUI NG で自動的に 1 分に変換され、1 分間リクエストをシミュレートします:

必要なプロセスをスタートするのに時間がかかるため、最初の数秒間はリクエストに対するサー

バーのレスポンスが正しく反映されません。そのような結果を記録することを回避するために、テ

ストのウォームアップに要する時間を指定します。 Scenarios パネルの任意の場所をクリックして Load Test エディターを開きます。Warm-up Time フィールドに 5 秒と入力します。



http://readyapi.smartbear.com/loadui_ng/configure/profiles/fixed_rate

http://readyapi.smartbear.com/_detail/loadui_ng/getting_started/default_load_profile_parameters.png?id=loadui_ng:getting_started:running_load_test

http://readyapi.smartbear.com/_detail/loadui_ng/getting_started/test_duration_limit.png?id=loadui_ng:getting_started:running_load_test


[Run] をクリックしてテストを実行します。

テストの実行には、ユーザーの操作は不要です。LoadUI NG は、基になる SoapUI NG の TestCase の TestSteps をシミュレートします (エディターの Target セクションで名前を確認

できます)。対象となる Web サービスにリクエストを送信し、レスポンスを取得します。テスト開始

後には、テスト結果が表示されます。LoadUI では、テスト実行中およびテスト終了後の両方の

結果が表示されます。


http://readyapi.smartbear.com/_detail/loadui_ng/getting_started/warmup.png?id=loadui_ng:getting_started:running_load_test

http://readyapi.smartbear.com/_detail/loadui_ng/getting_started/run_b.png?id=loadui_ng:getting_started:running_load_test


4. テスト結果の表示

LoadUI NG が負荷テストを実行中に、サービスパフォーマンスのデータが収集されます。収集

されたデータは、Global Metrics グラフ、TestSteps Metrics テーブル、および Statistics ペー

ジで表示されます。

Global Metrics グラフでは、対象となる Web サービスのさまざまなパフォーマンスメトリックの経時的な変化が表示されます。VUs/s (1 秒ごとにサーバーに到達するユーザー数)、Time taken (各リクエストに要した時間)、TPS (1 秒あたりのトランザクション数) および BPS (バイト/秒) メトリックを分析し、対象となるサービスのパフォーマンス情報を得られます。

TestSteps Metrics テーブルは、各ステップをシミュレートするのに要した最長および最短時間

など、個々の TestSteps におけるパフォーマンス値を表示します。

テストの他の統計を表示、確認するには Statistics ページに切り替えます。この操作には LoadUI NG Pro のライセンスが必要となります。弊社の Web サイトから評価版をお申込みく

ださい。

注意: このページでは、サーバーのモニターを設定し (configure server monitors)、サーバーメトリックを解析することもできます。


http://readyapi.smartbear.com/loadui_ng/monitor/intro/quickstart

http://readyapi.smartbear.com/_detail/loadui_ng/getting_started/metrics.png?id=loadui_ng:getting_started:viewing_test_results


デフォルトでは、Statistics ページは空になっています。1 秒あたりのリクエスト送信数を表示す

るグラフを追加しましょう:

• をクリックします。

• Add Statistic ダイアログで [Scenarios] - [ScenarioName] - [Scenario Statistics] - [Test case runs] - [Per Second] を選択し、[OK] をクリックします。

注意: Search フィールドに Test case runs と入力すると、迅速に統計情報を得られます。

操作は以上です。LoadUI NG の Statistics ページに新しくグラフが追加されます。選択したテ

ストにおいて 1 秒ごとに対象となる Web サービスに送信されるリクエスト数が即座に見られま

す。


http://readyapi.smartbear.com/_detail/loadui_ng/getting_started/statistics_panel_overview.png?id=loadui_ng:getting_started:viewing_test_results

http://readyapi.smartbear.com/_detail/loadui_ng/getting_started/add_graph_view_to_statistics.png?id=loadui_ng:getting_started:viewing_test_results

http://readyapi.smartbear.com/_detail/loadui_ng/getting_started/add_statistics_dialog.png?id=loadui_ng:getting_started:viewing_test_results


注意: 複数のテストを実行した場合、[Run] ドロップダウンリストから必要なテストを選択します。

デフォルトでは、LoadUI NG には最後に実行した 5 つのテストが保存されます。

テスト実行中には、統計情報はリアルタイムで更新され、新しくシミュレートしたリクエストが反映さ

れます。


http://readyapi.smartbear.com/_detail/loadui_ng/getting_started/request_statistics.png?id=loadui_ng:getting_started:viewing_test_results

http://readyapi.smartbear.com/_detail/loadui_ng/getting_started/4rundropdown.png?id=loadui_ng:getting_started:viewing_test_results


5. LoadTests の変更

最初の負荷テストの実行に成功しました。いくつかのパラメーターを変更し、異なる負荷プロファ

イルでテストを再実行してみましょう:

• Load Test エディターの Load ページに切り替えます。

• [Load Type] ドロップダウンリストで、[VUs] (simulate user behavior) を選択します。こ

の負荷タイプ (load type) を選択すると、負荷プロファイル設定で同時に動作する仮想

ユーザーの人数を指定できます。

• 負荷シナリオをクリックすると、Editor パネルが表示されます。



http://readyapi.smartbear.com/_detail/loadui_ng/getting_started/5loadscenario.png?id=loadui_ng:getting_started:modifying_load_tests


• [Load profile] ドロップダウンリストで、[Burst] プロファイルを選択します。プロファイルの

アイコンが表示するとおりに、テスト実行中に異なる負荷をシミュレートします:

• [Base VUs] には、たとえば 5 ユーザーのように、シミュレートする仮想ユーザーの最少

人数を入力します。

• [Burst VUs] には、たとえば 10 ユーザーのように、シミュレートする仮想ユーザーの最多

人数を入力します。

注意: LoadUI NG の基本バージョンでは、最高 10 人までの仮想ユーザーを同時にシミュレー

トできます。さらに多くの人数をシミュレートするには、LoadUI NG Pro のライセンスが必要となり

ます。評価版を無料でご利用いただけます。

• [Base duration] には、たとえば 1 秒のように、LoadUI NG が最少人数の仮想ユー

ザーをシミュレートする時間を入力します。

• [Burst duration] には、たとえば 5 秒のように、LoadUI NG が最多人数の仮想ユー

ザーをシミュレートする時間を入力します.

• [Wait time] には、たとえば 1 秒のように、各仮想ユーザーのテストを再実行するまでの

LoadUI NG の待ち時間を入力します。再実行の必要な理由: 何人かの仮想ユーザーのシミュレーションが終了すると、同時使用

ユーザーの人数が減ります。この人数がプロファイルに指定された人数より少ない場合、

LoadUI NG は必要人数に達するまで新規の仮想ユーザーを増やします。

テストを実行します。テスト実行中に、LoadUI NG で指定された最多人数に達するまで仮想

ユーザーの人数が増えます。その後、LoadUI NG はテストが終了するまで仮想ユーザーの人

数を増減し続けます:


http://readyapi.smartbear.com/_detail/loadui_ng/getting_started/ramp_up_parameters.png?id=loadui_ng:getting_started:modifying_load_tests


• テスト結果をもとに、対象となる Web サービスのパフォーマンスの負荷下における変化を

確認します。

LoadUI NG ツールバーの[Add Scenario] もしくはをクリックしてテストにシナリオを

追加します。このシナリオは最初のシナリオと並行してシミュレートされるため、複雑な負荷形状

を作成できます。上記と同じ方法で設定してください。


http://readyapi.smartbear.com/_detail/loadui_ng/getting_started/ramp_up_results.png?id=loadui_ng:getting_started:modifying_load_tests

http://readyapi.smartbear.com/_detail/loadui_ng/configure/new_b.png?id=loadui_ng:getting_started:modifying_load_tests

http://readyapi.smartbear.com/_detail/loadui_ng/getting_started/5newscenario.png?id=loadui_ng:getting_started:modifying_load_tests


6. テストフローの管理

負荷テスト実行中には、１つのシナリオの中でいくつかの TestCases を繰り返してシミュレート

する必要が頻繁にあります。たとえば、1 つの TestCase がログインの正しいユーザー動作をシ

ミュレートし、別の TestCase はログイン中のユーザーによる繰り返しの動作をシミュレートし、3 つめの TestCase はユーザーをログアウトするとします。いくつかのターゲットをシナリオに追加し

て、ループを設定してみましょう。

• [Targets] ツールバーのをクリックします。

• [Add Target] ダイアログで追加する TestCase を選択し、[OK] をクリックします。

• 複数の TestCases が存在する場合、同様に追加します。

これで、各仮想ユーザーがすべてのテストターゲットを連続してシミュレートします:

をクリックしてループを追加します。Add Flow ダイアログが表示されます。繰り返しのユー

ザー動作をシミュレートするには、[From:] と [To:] 両方のドロップダウンリストで同じ TestCase を選択し、[Number of loops] フィールドに 5 と入力して [OK] をクリックします。


http://readyapi.smartbear.com/_detail/icon/system/add.png?id=loadui_ng:getting_started:controlling_test_flow

http://readyapi.smartbear.com/_detail/loadui_ng/getting_started/scenariochain.png?id=loadui_ng:getting_started:controlling_test_flow

http://readyapi.smartbear.com/_detail/loadui_ng/addloop_b.png?id=loadui_ng:getting_started:controlling_test_flow

http://readyapi.smartbear.com/_detail/loadui_ng/getting_started/addflowdialog.png?id=loadui_ng:getting_started:controlling_test_flow


これで、シナリオフィールドに新しいループが表示されます。負荷テストを開始すると、次のテス

トターゲットに移る前に、ループされた TestCase は各仮想ユーザーにつき 5 回シミュレートさ

れます。

次のトピックでは、別のシナリオを作成していくつかの TestCases を並行してシミュレートしま

す。


http://readyapi.smartbear.com/_detail/loadui_ng/getting_started/scenarioloop.png?id=loadui_ng:getting_started:controlling_test_flow


7. 複数のシナリオの実行

いくつかの TestCases を並行してシミュレートするには、負荷テストにシナリオを追加します。

Load Scenarios パネルの [Add Scenario] ボタンか、 LoadUI NG ツールバーの

をクリックします。「LoadTests の変更」トピックでの説明と同じ要領で新しいシナリオを

設定すると、LoadUI NG でシナリオが並行してシミュレートされます。

いくつかのシナリオを同時に使用する場合、各シナリオに個別に割り当てるのではなく、1 つの

フィールドから負荷を割り当てることができます。[Load Allocation] ドロップダウンリストから [Relative] (percentage of VUs) を選択します。下の新しい VUs フィールドで、たとえば 10 などのように、シナリオが参照するベースとなる

ユーザー数を指定します。

各シナリオの隣のフィールドに、シミュレートされるベースユーザーの比率を入力します:

• 最初のシナリオでは、負荷を 200% に設定します。これで、このシナリオの Burst プロ

ファイルは 20 人の仮想ユーザーでシミュレートします。ベースとなる仮想ユーザー数は

シナリオで設定されています。


http://readyapi.smartbear.com/_detail/loadui_ng/configure/new_b.png?id=loadui_ng:getting_started:running_multiple_scenarios

http://readyapi.smartbear.com/_detail/loadui_ng/getting_started/5newscenario.png?id=loadui_ng:getting_started:running_multiple_scenarios

http://readyapi.smartbear.com/_detail/loadui_ng/getting_started/allocation.png?id=loadui_ng:getting_started:running_multiple_scenarios


• 2 つめのシナリオでは、負荷を 50% に設定します。これで、このシナリオは 5 人の仮想

ユーザーでシミュレートします。


http://readyapi.smartbear.com/_detail/loadui_ng/getting_started/relativeallocation.png?id=loadui_ng:getting_started:running_multiple_scenarios


8. LoadTests へのアサーションの追加

アサーション (Assertions) とは、テスト実行中に、対象となる Web サービスの機能を確認する

テスト結果に適用される検証規則です。

1 つの TestStep の平均シミュレーションタイムが制限時間を超過しないことを確認するアサー

ションを作成しましょう:

• アサーションを作成する TestStep の [Response] をクリックします。Editor パネルが表

示されます。

• Editor パネルの [Assertions] セクションでをクリックします:


http://readyapi.smartbear.com/loadui_ng/configure/assertions/about

http://readyapi.smartbear.com/_detail/loadui_ng/getting_started/propertyeditor.png?id=loadui_ng:getting_started:adding_assertions

http://readyapi.smartbear.com/_detail/icon/system/add.png?id=loadui_ng:getting_started:adding_assertions


• 次の [Add Assertion] ウィンドウの Statistic: では [Time Taken]、Type: では [Median] をそれぞれのドロップダウンリストから選択します:

• その他のアサーションパラメーターを設定します:

[Maximum] エディットボックスに TestStep が平均して要する最多回数を入力しま

す。

[Tolerance] セクションで、エラーをログに記録する前にアサーションがトリガーされる

最多回数を設定します:

• [OK] をクリックすると、LoadUI NG の負荷テストにアサーションが追加されます:


http://readyapi.smartbear.com/_detail/loadui_ng/getting_started/assertion_panel.png?id=loadui_ng:getting_started:adding_assertions

http://readyapi.smartbear.com/_detail/loadui_ng/getting_started/add_assertion_dialog.png?id=loadui_ng:getting_started:adding_assertions


• 再度テストを実行します。レスポンスに時間がかかりすぎると、LoadUI NG はエラーをレ

ポートします。アサーションエラーは、Global Metrics グラフおよび TestSteps Metrics テーブルで表示されます:


http://readyapi.smartbear.com/_detail/loadui_ng/getting_started/added_assertion.png?id=loadui_ng:getting_started:adding_assertions

http://readyapi.smartbear.com/_detail/loadui_ng/getting_started/assertion_failures.png?id=loadui_ng:getting_started:adding_assertions


次のステップ

LoadUI NG のチュートリアルはこれで終了です。このスタートガイドが LoadUI NG の理解に役

立つことを願っています。いくつかのヘルプトピックを下に示します。

Server Monitoring

テスト実行中のサーバーのモニター方法について説明します。

Creating Distributed LoadTests

リモートコンピューターで実行するテストの作成方法を説明します。

Creating Distributed Cloud Tests

クラウドマシンで実行するテストの作成方法を説明します。

Exporting Test Results

LoadUI NG テストの結果をエクスポートする方法を説明します。

Transaction Log Page

シミュレートされたリクエスト情報のログの仕方について説明します。

Testing Scenarios

負荷シナリオの概要と、ストレステストの作成など、LoadUI NG でシミュレートする方法を説明し

ます。


http://readyapi.smartbear.com/loadui_ng/monitor/intro/quickstart

http://readyapi.smartbear.com/loadui_ng/distributed/intro/create

http://readyapi.smartbear.com/loadui_ng/distributed/intro/cloud

http://readyapi.smartbear.com/loadui_ng/results/export/start


http://readyapi.smartbear.com/loadui_ng/practices/scenarios/start

第 3 章: Secure スタートガイド－ 45 －

第 3 章: Secure スタートガイドこのチュートリアルでは、Ready! API Secure ツールを使ったセキュリティテストの作成方法に

ついて説明します。


－ 46 ― 第 3 章: Secure スタートガイド

1. SoapUI NG テストプロジェクトの作成

セキュリティテストは、SoapUI NG の TestCases でのリクエストを使用して実行します。

そのため、セキュリティテストを作成する前に SoapUI NG テストプロジェクトを作成する必要

があります。テストプロジェクト作成の詳細については、「第 1 章 SoapUI NG スタートガイド」

を参照してください。

チュートリアルを簡単にするために、Ready! API に含まれる Sample-Data-driven-project.xml というサンプルプロジェクトをインポートします:

1. メインメニューから[File] - [Import Project] を選択し、Ready! API のサンプルディレクト

リを参照します。Ready! API のサンプルは、<Ready! API インストールディレクトリ

>¥tutorials ディレクトリに入っています。

1. Sample-Data-driven-project.xml というファイル名のサンプルプロジェクトを選択し、

[Open] をクリックします。

プロジェクトツリーにプロジェクトの内容が表示されます:

次のステップでは、Google Maps API のセキュリティをチェックするテストを作成します。


http://readyapi.smartbear.com/_detail/loadui_ng/getting_started/import_soapui_project.png?id=secure:getting_started:createproject

http://readyapi.smartbear.com/_detail/loadui_ng/getting_started/soapui_project.png?id=secure:getting_started:createproject


2. セキュリティテストの作成および実行

Ready! API プロジェクトをインポートしたら、[Secure] ツールに切り替えます。新規のセキュリ

ティテストを作成するには:

• をクリックします。

• [New Security Test] ダイアログで [TestCase] を選択し、不要なスキャンを選択解除しま

す。[OK] をクリックします。 Secure Pro では、さらに多くのスキャンや API リクエストや URL のセキュリティをチェック

する機能が提供されます。

• これで、セキュリティテストが作成できました。をクリックしてテストを実行します。Ready! API Secure が更新された値をサービスに送信し、レスポンスを評価します。


http://readyapi.smartbear.com/_detail/secure/getting_started/newsecuretest_b.png?id=secure:getting_started:createtest

http://readyapi.smartbear.com/_detail/secure/getting_started/newsecuretest.png?id=secure:getting_started:createtest

http://readyapi.smartbear.com/_detail/secure/getting_started/newsecuretest_dialog.png?id=secure:getting_started:createtest

http://readyapi.smartbear.com/_detail/loadui_ng/getting_started/run_b.png?id=secure:getting_started:createtest


次のステップでは、セキュリティテストの結果について説明します。


http://readyapi.smartbear.com/_detail/secure/getting_started/runtest.png?id=secure:getting_started:createtest


3. テスト結果の表示

テスト実行中にスキャンに失敗すると進行状況バーがオレンジ色に変わりますが、スキャンが終

了するまでテストは続行します。

テストの終了後、[Transaction log] ページに切り替えます。このページには、セキュリティテスト中に送信されたリクエストのログがすべて表示されます。

左の列には、サービスに送信されたリクエストの情報が含まれます。右の列には、サービスからのレスポンスと、リクエストのステータス情報が含まれます。

アサーションが失敗すると、[FAILED] というステータスが表示されます。リクエストが予期しない結果をもたらすと、 [WARNINGS] ステータスになりますが、失敗にはなり

ません。

[FAILED] もしくは [WARNINGS] ステータスが表示されているスキャンのレスポンスを選択する

と、プロパティエディターでアラートテストが表示されます:

[Message] セクションを展開すると、このリクエストに対するサービスのレスポンスが表示されま

す。

次のステップでは、さらにアサーションを追加し、サービスが SLA 内で返信することを確認しま

す。


http://readyapi.smartbear.com/_detail/secure/getting_started/progressbar.png?id=secure:getting_started:testresults

http://readyapi.smartbear.com/_detail/secure/getting_started/warningresult.png?id=secure:getting_started:testresults


4. セキュリティスキャンへのアサーションの追加

セキュリティスキャンの終了後、予期しない入力によってサービスのレスポンスに時間がかかり

すぎないように確認しましょう。

• [Boundary Scan] の [Response] をクリックします。

• アサーションのプロパティエディターでをクリックします。

• [Add Assertion] ダイアログで、[SLA] - [Response SLA] を選択し、[Add] をクリックしま

す。


http://readyapi.smartbear.com/_detail/secure/getting_started/responseassertion.png?id=secure:getting_started:addassertions

http://readyapi.smartbear.com/_detail/icon/system/add.png?id=secure:getting_started:addassertions

http://readyapi.smartbear.com/_detail/secure/getting_started/asserioneditor.png?id=secure:getting_started:addassertions

http://readyapi.smartbear.com/_detail/secure/getting_started/addassertiondialog.png?id=secure:getting_started:addassertions


• アサーションがトリガーされるまでのレスポンスタイムを指定し、 [OK] をクリックします。

これで、スキャン中のレスポンスが 200 ミリ秒以上の時間を要した場合、アサーションがトリガー

されてセキュリティテストは失敗となります。


http://readyapi.smartbear.com/_detail/secure/getting_started/configuresla.png?id=secure:getting_started:addassertions


次のステップ

Secure のチュートリアルはこれで終了です。このスタートガイドが Secure の理解に役立つこと

を願っています。いくつかのヘルプトピックを下に示します。

Security Scans

使用可能なセキュリティスキャンについて説明します。

Security Assertions

使用可能なアサーションについて説明します。

Command-Line Runner

セキュリティテストを自動化する方法を説明します。

Reports

セキュリティテストの結果に関するレポートの作成方法を説明します。


http://readyapi.smartbear.com/secure/scans/start

http://readyapi.smartbear.com/secure/assertions/start

http://readyapi.smartbear.com/secure/automation/start

http://readyapi.smartbear.com/secure/reports/start

第 4 章: ServiceV スタートガイド－ 53 －

第 4 章: ServiceV スタートガイドこのチュートリアルでは、仮想サービスを作成し、API を構成してアクセスします。


－ 54 ― 第 4 章: ServiceV スタートガイド

1. 空の Ready! API プロジェクトの作成

ServiceV は Ready! API の一部で、Web サーバーの仮想コピーを作成して API のレスポン

スをモック (模倣) できます。これにより、API を稼働させる前にアプリケーションを開発し、テスト

することができます。

仮想サービスを作成する前に、Ready! API プロジェクトを作成する必要があります:

1. メインメニューから[File] - [New Project] を選択します。

2. [Create an empty project] タブに切り替えて [OK] をクリックします。

これで、Ready! API は空のプロジェクトを作成します。次のステップでは、このプロジェクトに仮

想サービスを追加します。


http://readyapi.smartbear.com/_detail/servicev/getting_started/newproject.png?id=servicev:getting_started:create_project

http://readyapi.smartbear.com/_detail/servicev/getting_started/newprojectdialog.png?id=servicev:getting_started:create_project


2. 仮想サービスの作成

新規の仮想サービスを作成するには、[ServiceV] タブに切り替えてプロジェクトエクスプロー

ラーの中にあるプロジェクトを右クリックし、[New Virt] を選択します。 [New Virt] ダイアログ

が開きます。

仮想サービスを作成するには、必要に応じて複数の方法があります:

• すでに現行の Web サービスが存在する場合には、WSDL もしくは WADL のいずれか

の定義を選択し、[OK] をクリックしてアドレスを指定します。Ready! API がサービスからデ

フォルトの応答を取得し、それらのレスポンスおよび関連する API をプロジェクトに返信す

る仮想サービスを作成します。

• [Record] タブを使って Web サービスとの相互作用をレコーディングすることもできます。

Web サービスとの相互作用のレコーディング方法については、「Discovery」セクションを

参照してください。

• Web サービスが存在しない場合には、[Empty] タブで空の仮想サービスを作成します。

この仮想サービスにはレスポンスがありませんので、手動で作成する必要があります。

このチュートリアルでは、空の REST プロジェクトを作成します。[Empty REST] タブに切り替え

て [OK] をクリックします。[New Rest Virt] ダイアログで仮想サービス名を入力します。

新規作成された仮想サービスは空の状態です。次のステップでは、レスポンスを設定します。


http://readyapi.smartbear.com/projects/discovery/start

http://readyapi.smartbear.com/_detail/servicev/getting_started/newvirt.png?id=servicev:getting_started:create_virt


3. サービスレスポンスの設定

仮想サービスがリクエストに返信するには、仮想アクションを追加する必要があります:

• Project Explorer で仮想サービスを選択し、ServiceV ツールバーのをクリッ

クします。

• [Add new Virt action] ダイアログの [Method:] で[Get] を選択し、[Resource path]

で [/Login] と入力します。[OK] をクリックします。

• これで仮想サービスはリクエストに返信できますが、レスポンスが存在しません。レスポンス

を追加するには、 [Add Response] をクリックしてレスポンスに[LoginSuccess] と名前を

付けます。

• 作成されたレスポンスを選択して、次の設定をします:

[HTTP Status Code] は [200 – OK] を選択します。

[Content | Media type] は [application/json] を選択します。

たとえば次のようなレスポンスのテキストを追加します:


http://readyapi.smartbear.com/_detail/servicev/getting_started/virtaction.png?id=servicev:getting_started:configure_virt

http://readyapi.smartbear.com/_detail/servicev/getting_started/newvirtaction.png?id=servicev:getting_started:configure_virt

http://readyapi.smartbear.com/_detail/servicev/getting_started/newvirtactiondialog.png?id=servicev:getting_started:configure_virt

http://readyapi.smartbear.com/_detail/servicev/getting_started/newresponse.png?id=servicev:getting_started:configure_virt


{

"access_token" : "1/fFAGRNJru1FTz708zhT3Zg",

"expires_in" : 3920,

"token_type" : "Bearer"

}

• [LoginFailed] という名前で次のレスポンスを追加します。このレスポンスは次のように設

定します:

[HTTP Status Code] は [400 - Bad Request] を選択します。

その他のフィールドはデフォルト値のままにします。

これでサービスレスポンスは設定されましたが、仮想サービスはレスポンスを順番に送信するこ

としかできません。リクエストによって送信するレスポンスを変えるには Dispatch を設定する必

要があります。次のステップでは、Dispatch の設定をします。


http://readyapi.smartbear.com/_detail/servicev/getting_started/loginsuccess.png?id=servicev:getting_started:configure_virt


4. レスポンスディスパッチの設定

サービスが返信するレスポンスは、Dispatch の設定によって選択されます。Ready! API では、

サーバーがランダムなレスポンスを返信するように設定したり、またはスクリプトを使ってより複雑

なシナリオを作成したり、いくつかの方法でサービスのレスポンスを選択することができます。このチュートリアルでは、スクリプトを使って着信リクエストを処理し、リクエストが正しいデータを

含む場合には LoginSucess、そうでない場合には LoginFailed と設定する方法を説明します。

Dispatch 列の [SEQUENCE] をクリックして [Dispatch Style] で [SCRIPT] を選択します。

Script ウィンドウに次のコードを追加します:

// Get the query from the request

def queryString = mockRequest.getRequest().getQueryString()

// Split the request from the URL save it to a variable

String[] fields = queryString.split("&");

String[] kv;

HashMap params = new HashMap();

// Split the parameters of the request and save them to a list

for (int i = 0; i < fields.length; ++i){

kv = fields[i].split("=");

if (2 == kv.length)

params.put(kv[0], kv[1]);

}

// Assign parameters to individual vaiables

def response_type = params.get("response_type");

def client_id = params.get("client_id");


http://readyapi.smartbear.com/_detail/servicev/getting_started/dispatchstrategy.png?id=servicev:getting_started:configure_dispatch


def scope = params.get("scope");

// Check if the request is formed correctly

if ((response_type == "code") && client_id == "3216546579" &&

(scope == "admin"))

{

return "LoginSuccess"

}

// Return this if a request is malformed

return "LoginFailed"

これで VirtServer が設定されました。をクリックして開始します:

次のステップでは、API をプロジェクトに追加して設定します。


http://readyapi.smartbear.com/_detail/loadui_ng/getting_started/run_b.png?id=servicev:getting_started:configure_dispatch

http://readyapi.smartbear.com/_detail/servicev/getting_started/runvirt.png?id=servicev:getting_started:configure_dispatch


5. API インターフェイスの設定

これでプロジェクトに仮想サービスが含まれましたので、Projects ツールで関連する API を作

成する必要があります:

• 仮想サービスが稼働していることを確認して、[Projects] タブに切り替えます。

• プロジェクトを右クリックして [New REST Services from URL] を選択します。

• [New REST Services from URL] ダイアログで、ポート情報を含む仮想サービスの URL を指定します。この例では、ローカルホストのポート 8080 を使用しているため、URL は http://localhost:8080/login となります。

• リクエストが作成されましたが、まだ空の状態です。[Request] タブに切り替えます。

• をクリックしてリクエストにパラメーターを追加し、デフォルト値を指定します。


http://localhost:8080/login

http://readyapi.smartbear.com/_detail/servicev/getting_started/addwadl.png?id=servicev:getting_started:configure_api

http://readyapi.smartbear.com/_detail/servicev/getting_started/addwadldialog.png?id=servicev:getting_started:configure_api

http://readyapi.smartbear.com/_detail/servicev/getting_started/requesttab.png?id=servicev:getting_started:configure_api

http://readyapi.smartbear.com/_detail/icon/system/add.png?id=servicev:getting_started:configure_api


Name Value Style Level

response_type code QUERY RESOURCE

client_id 3216546579 QUERY RESOURCE

scope admin QUERY RESOURCE

• リクエストは次のように表示されます:

• リクエストが正しく設定されていることを確認するには、をクリックします。リクエストの値が Dispatch のスクリプトと一致する場合には、レスポンスは LoginSuccess となりますが、その

他の場合にはレスポンスは LoginFailed となります。

これで仮想サービス API の設定はすべて終了しました。SoapUI NG もしくは LoadUI NG で仮想サービスを使用できます。


http://readyapi.smartbear.com/_detail/servicev/getting_started/properties.png?id=servicev:getting_started:configure_api

http://readyapi.smartbear.com/_detail/loadui_ng/getting_started/run_b.png?id=servicev:getting_started:configure_api

http://readyapi.smartbear.com/_detail/servicev/getting_started/response.png?id=servicev:getting_started:configure_api


次のステップ

ServiceV のチュートリアルはこれで終了です。このスタートガイドが ServiceV の理解に役立つ

ことを願っています。いくつかのヘルプトピックを下に示します。

Getting started with VirtServer

VirtServer を使って別のコンピューターで仮想サービスを実行する方法を説明します。

Getting Started with SoapUI

API を基にした SoapUI NG テストの作成方法を説明します。.

Advanced Virts

より複雑な仮想サービスの作成方法に関する情報が含まれます。

Scripting Virts

スクリプトを使って仮想サービスの動的な動作を作成する方法を説明します。


http://readyapi.smartbear.com/servicev/advanced/start

http://readyapi.smartbear.com/servicev/scripts/start

第 5 章: VirtServer のチュートリアル－ 63 －

第 5 章: VirtServer のチュートリアルこのセクションのトピックでは、VirtServer の使い方、仮想サービスの展開、および VirtServer での実行方法などについて説明します。


－ 64 ― 第 5 章: VirtServer のチュートリアル

1. VirtServer のインストールと実行

VirtServer を使用するには、VirtServer をインストールしてユーザー登録をし、ライセンス認証

をします。

1. VirtServer のインストール

VirtServer をインストールするには、インストーラーを実行して画面の指示に従います。

「VirtServer Installation」を参照してください。

2. VirtServer の実行

VirtServer のプロセスを開始するには、次のファイルを実行します:

• Windows: <VirtServer directory>/bin/virtserver.bat

• Linux または Mac OS: <VirtServer directory>/bin/virtserver.sh

3. ユーザーの作成

ServiceV で VirtServer を操作するには、ユーザー名とパスワードが必要です。ユーザーの作

成は初回のみで、VirtServer を起動するたびに作成する必要はありません。

1.6.0 以降のバージョン

• VirtServer のインストール後初めて起動する際に、ユーザー名とパスワードを指定する必

要があります。画面の指示に従ってください。

• ユーザー登録をすると、さらにユーザーを追加できます。VirtServer を実行してコマンドラインの -a 引数を指定します:

Windows: <VirtServer directory>/bin/virtserver.bat -a userName

Linux または Mac OS: <VirtServer directory>/bin/virtserver.sh -a userName

そのあと、VirtServer でパスワードを指定します。

VirtServer を操作するユーザーごとのユーザー設定をすることを推奨します。


http://readyapi.smartbear.com/about/install/virtserver/start

http://readyapi.smartbear.com/servicev/start


1.5.0 以前のバージョン

VirtServer 1.5.0 以前のバージョンでは、デフォルトでユーザーが作成されます:

User name: defaultUser

Password: svp4ever

パスワードは、virt-server.yml ファイルで設定できます。

4. VirtServer ライセンスの認証

VirtServer を初めて実行する場合、ライセンスファイルを指定してライセンス認証をする必要が

あります。画面の指示に従ってください。「VirtServer License Activation」も参照してください。


http://readyapi.smartbear.com/virtserver/reference/settings

http://readyapi.smartbear.com/about/licenses/activate/virtserver


2. 仮想サービスの展開

1. 仮想サービスの作成

仮想サービスを VirtServer で実行する前に、仮想サービスを作成する必要があります。仮想

サービスは、Ready! API の ServiceV で作成します。仮想サービスの作成方法については、

「第 4 章 ServiceV スタートガイド」を参照してください。

このチュートリアルでは、Sample-Virtualization-project の仮想サービスを使用します。このプ

ロジェクトは製品と一緒にプリインストールされており、<Ready! API>¥tutorials というディレクト

リにあります。Ready! API でこのプロジェクトを開き、[ServiceV] に切り替えます。[ServiceV] パネルの [Local Virts] セクションに 2 つの仮想サービスが表示されます (次に示す画像

を参照)。

2. 仮想サービスの展開

仮想サービスを作成すると（またはファイルから開くと）、VirtServer で展開 (アップロード) でき

ます:

1. Ready! API を開いて [ServiceV] に切り替え、左のプロジェクトツリーでプロジェクトノードを選択します。製品ウィンドウの中央部に VirtServer パネルが表示されます:

2. VirtServer を選択して接続します。ドロップダウン矢印をクリックして使用する VirtServer を選択します:


http://readyapi.smartbear.com/virtserver/intro/start

http://readyapi.smartbear.com/servicev/start

http://readyapi.smartbear.com/servicev/intro/samples

http://readyapi.smartbear.com/_detail/virtserver/tutorial/virtserver-section-of-editor.png?id=virtserver:tutorial:deploying-virt


[Local VirtServer discovery] チェックボックスが選択されていると、ServiceV がローカ

ルネットワークで使用可能な VirtServers を自動的に検索します。

このチェックボックスが選択されていない場合、もしくはリストに VirtServer が存在しない

場合、ボタンをクリックして次のダイアログで VirtServer の動作プロトコル、IP アドレス、

およびポートを指定します。

3. VirtServer に接続します。このチュートリアルの Step 1 で作成したユーザー名とパスワー

ドを指定し、[Connect] をクリックします:

選択した VirtServer で仮想サービスが実行されます。この例では、VirtServer には仮想

サービスがまだ存在しません:


http://readyapi.smartbear.com/_detail/virtserver/tutorial/selecting-virtserver-from-list.png?id=virtserver:tutorial:deploying-virt

http://readyapi.smartbear.com/_detail/icon/system/add.png?id=virtserver:tutorial:deploying-virt

http://readyapi.smartbear.com/_detail/virtserver/tutorial/connecting-to-virtserver.png?id=virtserver:tutorial:deploying-virt


4. エディターの上部にある [Local Virts] セクションから [VirtServer] セクションに仮想サー

ビスをドラッグします:

[VirtServer] セクションで仮想サービスが表示されます:


http://readyapi.smartbear.com/_detail/virtserver/tutorial/virts-on-virtserver-none.png?id=virtserver:tutorial:deploying-virt

http://readyapi.smartbear.com/_detail/virtserver/tutorial/deploying-virt-to-virtserver.png?id=virtserver:tutorial:deploying-virt


注意: 仮想サービスの展開中に NullPointerException エラーが発生した場合には、

Ready! API および VirtServer のバージョンをアップデートしてください。この問題は 1.5.0 以前のバージョンで発生する可能性がありますが、1.6.0 では修正されています。

3. 仮想サービスのポート番号の変更

仮想サービスはポートを使用します。ポートは、エディターの右側にある仮想サービスのプロパ

ティで指定できます(次の画像を参照)。

VirtServer で仮想サービスを展開したのち、ポート番号の変更が必要な場合があります。仮想

サービスに使用するポートが、別の仮想サービスまたはプロセスにより VirtServer で使用され

ている場合などに変更が必要となります。

VirtServer で仮想サービスのポートを変更するには、次の手順に従ってください:

1. エディターの VirtServer セクションで仮想サービスを選択します。

2. 誤って仮想サービスを実行してしまった場合には、実行を停止します。

3. エディターの右側にある [Virt ] プロパティのポート番号を変更し、[Change port] をク

リックします。もしくは、[Auto-assign a free port] をクリックして VirtServer が仮想サービ

スにポートを自動的に選択するようにします:


http://readyapi.smartbear.com/_detail/virtserver/tutorial/deployed-virt.png?id=virtserver:tutorial:deploying-virt


これで、仮想サービスをスタートしてテストを実行する準備が整いました。


http://readyapi.smartbear.com/_detail/virtserver/tutorial/setting-port-number-on-virtserver.png?id=virtserver:tutorial:deploying-virt


3. 仮想サービスの実行とテスト

1. 仮想サービスの実行

VirtServer で仮想サービスを展開して設定を終えると、仮想サービスを実行できます。

仮想サービスを実行するには、ボタンをクリックします:

VirtServer は、指定したポート番号で仮想サービスを実行します。

2. 仮想サービスのテスト

仮想サービスの実行後、Ready! API のテストプロジェクトからテストリクエストを送信できます。

他の API で行うのと同じやりかたで行います。

ヒント

仮想サービスにテストを作成する際に、VirtServer が使用するポートが不明の場合があります。

テストにポート番号をハードコード化した場合、仮想サービスの展開後にポート番号を変更する

必要があります。回避策として、仮想サービスのアドレスおよびポート値を保存するプロジェクトレベルもしくはテストスイートレベルのプロパティを作成し、この変数をテストリクエストの



http://readyapi.smartbear.com/_detail/loadui_ng/getting_started/run_b.png?id=servicev:getting_started:configure_api

http://readyapi.smartbear.com/_detail/virtserver/tutorial/running-virt.png?id=virtserver:tutorial:running-and-testing-virt


Endpoint プロパティとして指定することができます。ポート番号が変更した場合、すべてのリク

エストの Endpoint プロパティをアップデートするのではなく、プロジェクトレベル (もしくはテス

トスイートレベル) のプロパティを変更する必要があります:


http://readyapi.smartbear.com/_detail/virtserver/tutorial/set-endpoint.png?id=virtserver:tutorial:running-and-testing-virt


次のステップ

VirtServer のチュートリアルはこれで終了です。このスタートガイドが VirtServer の理解に役立

つことを願っています。

下のトピックでは、よく使うタスクの実行方法を説明しています:

VirtServer の実行

Different Ways to Run VirtServer

Running VirtServer as Service

仮想サービスの設定

Updating Virt Ports On VirtServer

Editing Deployed Virts

Using Virts With DataSources on VirtServer

VirtServer の設定

Managing VirtServer Users

VirtServer Settings

VirtServer Command-Line Arguments



http://readyapi.smartbear.com/virtserver/using/starting-virtserver

http://readyapi.smartbear.com/virtserver/using/running-as-service

http://readyapi.smartbear.com/virtserver/using/virt-ports

http://readyapi.smartbear.com/virtserver/using/editing-deployed-virts

http://readyapi.smartbear.com/virtserver/using/datasources

http://readyapi.smartbear.com/virtserver/using/users

http://readyapi.smartbear.com/virtserver/reference/settings

http://readyapi.smartbear.com/virtserver/reference/command-line

－ 74 ― サポート

サポート

お問合せ先

エクセルソフト株式会社

http://www.xlsoft.com/jp/services/contact.html

SmartBear

https://support.smartbear.com/product-list/


http://www.xlsoft.com/jp/services/contact.html

https://support.smartbear.com/product-list/

Ready! API スタートガイド - XLsoft Corporation · 2017. 7. 18. · API...

Documents

Transcript of Ready! API スタートガイド - XLsoft Corporation · 2017. 7. 18. · API...