このセクションでは、9.7 より前の JSON Assertor ツールの実装について説明します。このツールは、JSON メッセージの異なる要素にアサーションを設置することができます。以前の実装は非推奨になりました。既存のツールは引き続き動作しますが、ユーザーが追加する新しい JSON Assertor は新しい実装を使用します。
現在のツール実装については、「JSON Assertor」 を参照してください。
非推奨のツール実装についての説明:
JSON Assertor ツールとは
JSON Assertor ツールは、JSON メッセージ中のデータの正確性を高めるために使用します。このツールは、 JSON メッセージの個別の要素を見て、期待値を満たしているかチェックできます。
JSON Assertor ツールは JSON メッセージを通信する他のツールと接続させることができます。最もよく接続されるのは Messaging Client ツールと REST Client ツールです。
JSON Assertor ツールの構成
JSON Assertor は次の 3 つのメイン タブから構成されます。
- 概要: 設定された JSON アサーションの詳細が表に表示されます。
- 設定: 新しい JSON アサーションの作成や既存の JSON アサーションの編集をします。
- 期待される JSON: すべてのアサーションが比較される、期待される JSON メッセージを指定します。有効な JSON メッセージを JSON Assertor が受け取る場合 (つまり REST Client に連結されている場合)、このタブにはツリー ビューとリテラル ビューの両方で JSON が自動的に表示されます。表示された期待される JSON メッセージは、今後の使用のために保存することができます。
JSON Assertor を使用するには、以下の操作を行います。
- プロジェクト ツリー ノードを選択し、ショートカット メニューの [出力の追加] をクリックします。[出力の追加] ウィザードが表示されます。
- [出力の追加] ウィザードで、左側ペインから [リクエスト/レスポンス] > [トラフィック] を選択し、右側ペインから [JSON Assertor] を選択して [終了] ボタンをクリックします。選択したノードの下に JSON Assertor ノードが追加されます。
- JSON Assertor の [設定] タブで [追加] ボタンをクリックします。[アサーションの選択] ウィザードが表示されます。
- アサーションの種類を選択します。利用可能なアサーション タイプの概要を次に説明します。
- 値アサーション: 次の値アサーションが利用できます。
- 値アサーション: 特定の要素の値を強制します。
- 数値アサーション: 要素の数値を強制します。
- 文字列比較アサーション: 指定された要素のテキスト コンテンツの値を強制します。
- 正規表現アサーション: 要素が正規表現と一致することを強制します。
- カスタム アサーション: カスタム ロジックを用いて要素の値を強制します。
- 構造アサーション: 次の構造アサーションが利用できます。
- Has Content アサーション: 要素にテキスト コンテンツがあることを強制します (例: 文字列の長さ > 0 ) 。
- Has Children アサーション: 要素に 1 つ以上の子要素があることを強制します。
- 複合アサーション: 次の複合アサーションが利用できます。
- AND アサーション: すべて成功しなければならない複数のアサーションをグループ化します。
- OR アサーション: 少なくとも 1 つが成功する必要がある複数のアサーションをグループ化します。
- 条件付きアサーション: 条件を満たす場合にだけアサーションを適用します (条件はこれまでに定義したアサーションの組み合わせです) 。
- 差分アサーション: 次の差分アサーションが利用できます。
- 数値差分アサーション: 特定要素の値に対して数値の差分を強制します。要素の数値が、ユーザー定義のベース値からユーザー定義の数値の分だけ異なることをアサートします。たとえば、摂氏温度の値は氷点下 3 度であるとアサートするには、ベース値を 0、差分を -3 に設定します。
- 範囲アサーション: 次の範囲アサーションが利用できます。
- 数値範囲アサーション: 要素の数値が、数値範囲の包括的な範囲内にあることを強制します。
- 値アサーション: 次の値アサーションが利用できます。
- [次へ] ボタンをクリックします。ツリー ビューが表示されます。
- ツリー ビューで、このアサーションでチェックする要素を選択し、[終了] ボタンをクリックします。
[設定] タブの [追加] をクリックして、メッセージに適用するアサーションをさらに追加できます。
後でアサーションが参照する要素を変更したい場合、[設定] タブの下部にある [要素の変更] をクリックします。ダイアログが開き、グラフィカルに、あるいは手動で要素を編集できます。
