このセクションでは、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 を使用するには、以下の操作を行います。

1. プロジェクト ツリー ノードを選択し、ショートカット メニューの [出力の追加] をクリックします。[出力の追加] ウィザードが表示されます。
2. [出力の追加] ウィザードで、左側ペインから [リクエスト/レスポンス] > [トラフィック] を選択し、右側ペインから [JSON Assertor] を選択して [終了] ボタンをクリックします。選択したノードの下に JSON Assertor ノードが追加されます。
3. JSON Assertor の [設定] タブで [追加] ボタンをクリックします。[アサーションの選択] ウィザードが表示されます。
   
   
   
   
4. アサーションの種類を選択します。利用可能なアサーション タイプの概要を次に説明します。
   • 値アサーション: 次の値アサーションが利用できます。
     • 値アサーション: 特定の要素の値を強制します。
     • 数値アサーション: 要素の数値を強制します。
     • 文字列比較アサーション: 指定された要素のテキスト コンテンツの値を強制します。
     • 正規表現アサーション: 要素が正規表現と一致することを強制します。
     • カスタム アサーション: カスタム ロジックを用いて要素の値を強制します。
   • 構造アサーション: 次の構造アサーションが利用できます。
     • Has Content アサーション: 要素にテキスト コンテンツがあることを強制します (例: 文字列の長さ > 0 ) 。
     • Has Children アサーション: 要素に 1 つ以上の子要素があることを強制します。
   • 複合アサーション: 次の複合アサーションが利用できます。
     • AND アサーション: すべて成功しなければならない複数のアサーションをグループ化します。
     • OR アサーション: 少なくとも 1 つが成功する必要がある複数のアサーションをグループ化します。
     • 条件付きアサーション: 条件を満たす場合にだけアサーションを適用します (条件はこれまでに定義したアサーションの組み合わせです) 。
   • 差分アサーション: 次の差分アサーションが利用できます。
     • 数値差分アサーション: 特定要素の値に対して数値の差分を強制します。要素の数値が、ユーザー定義のベース値からユーザー定義の数値の分だけ異なることをアサートします。たとえば、摂氏温度の値は氷点下 3 度であるとアサートするには、ベース値を 0、差分を -3 に設定します。
   • 範囲アサーション: 次の範囲アサーションが利用できます。
     
     • 数値範囲アサーション: 要素の数値が、数値範囲の包括的な範囲内にあることを強制します。
5. [次へ] ボタンをクリックします。ツリー ビューが表示されます。
6. ツリー ビューで、このアサーションでチェックする要素を選択し、[終了] ボタンをクリックします。

[設定] タブの [追加] をクリックして、メッセージに適用するアサーションをさらに追加できます。

後でアサーションが参照する要素を変更したい場合、[設定] タブの下部にある [要素の変更] をクリックします。ダイアログが開き、グラフィカルに、あるいは手動で要素を編集できます。