シミュレーションを作成する
シミュレーションとは、テスト環境で利用できない実際のサービスに代わって使用できる一連の仮想サービスと接続のことを意味します。仮想サービスでは、サービスと通信するために接続が必要です。これは、シミュレーションで接続先として指定した宛先や場所、例えばURLやポートなどからデータが送信または受信されることを意味します。
以下の方法でシミュレーションを作成することができます。
-
シミュレーションレジストリにて、シミュレーションの必須メッセージ要素をすべて手動で入力します。
-
相互に通信している2つのサービスのトラフィックをキャプチャし、このトラフィックをシミュレーションレジストリにシミュレーションとして保存します。
-
学習モードでは、リクエストを現実世界のサービスに転送し、その応答を記録します。この方法により、シミュレーションは現実世界のサービスの動作をキャプチャし、新しいやりとりを学習しながら自動更新します。
-
シミュレーションレジストリにシミュレーションとして保存したAPIテストから。
-
テキストエディタまたは選択した統合開発環境(IDE)で、必須メッセージ要素をすべて手動で入力します。
シミュレーションファイルを作成する
-
以下のシミュレーションファイルのトップレベル要素を使用して、シミュレーションの動作を定義します。
主要要素
説明
例
connections
サービスとの通信に必要な接続。
includes
他のシミュレーションファイルへのリンク。他の複数のシミュレーションでシミュレーションを再利用できるため、作業をやり直す必要はありません。ファイルパスは、絶対パスまたは現在のスキーマの場所に対する相対パスのいずれかにすることができます。
C:\my_simulations\test.yaml
name
シミュレーションの名前。
My simulation
resources
異なるサービス間で共有したいリソース。
schema
シミュレーションYAMLファイルに適用されるスキーマのバージョン名。このプロパティは必須であり、値はSimV1でなければなりません。
SimV1
services
シミュレーションしたいバーチャルサービス。
バーチャルサービス内で再利用可能なメッセージ、接続、またはサービスを適用します。これらのメッセージと接続はbasedOnプロパティを使用して、サービスはuseプロパティを使用して参照します。
myMessage、
myConnection
myService
-
シミュレーションファイルには、サービスと通信するための接続が 1 つ以上含まれていなければなりません。これらを定義するには接続プロパティを使用します。
-
送信するメッセージの内容を定義するには、メッセージプロパティを使用します。
-
データ構造などのリソースを参照するには、シミュレーションファイル内でリソースプロパティを使用します。
-
メッセージを送信または受信する順序を指定するには、サービスプロパティを使用します。
-
サービスのプロセスを定義するには、ステップを使用します。
-
送信または受信したいメッセージを選択するには、ルールを定義します。
-
プロパティとその指定方法を定義するためにどの値を使用できるかを確認します。
シミュレーションファイルはYAMLファイルで、YAMLのパターンに従います。YAMLファイルの取り扱いに関する情報は、YAMLのドキュメントをご覧ください。
シミュレーションファイルの例で、さまざまなシナリオでプロパティを使用する方法を詳しくご覧ください。