...
| Note | ||
|---|---|---|
| ||
JSON Data Bank ツールはバージョン 9.7 で再実装されました。以前の実装は廃止予定です。既存のツールは引き続き動作しますが、ユーザーが追加する新しい JSON Data Bank は新しい実装を使用します。 このセクションでは、現在の JSON Data Bank 実装に焦点を当てています。非推奨の JSON Data Bank の詳細については「JSON Data Bank (非推奨)Deprecated」を参照してください。 |
JSON Data Bank ツールとは
...
追加オプションを設定するためにこのダイアログを使用する方法については、「JSON Selector のリファレンスReference」を参照してください。
手動で JSON Data Bank を設定
...
テスト スイートに少なくとも 2 つツールがあることを確認します。
抽出したいデータのあるツールのノードを右クリックし、ショートカットメニューの [出力の追加] をクリックします。
[出力の追加] ウィザードで、どこから値を抽出したいかを選択し、ツールのリストから JSON Data Bank を選択して [終了] ボタンをクリックします。JSON Data Bank ノードがツールの下に表示されます。
- 次のようにツールを設定します。
抽出したい要素を指定します。要素を抽出するには、 JSON ツリーから値を選択して [要素の抽出] ボタンをクリックします。追加した値は、値に由来するツールの名前を含んだデータ ソース列名と抽出した値とともに、 [選択された要素] のリストに表示されます。
Info icon false title 期待されるメッセージの操作 左側のパネルは、要素を選択できるテンプレートの作成に使用される、期待される JSON レスポンスを表示します。JSON Data Bank が正常な JSON メッセージを受信する場合 (例: トラフィックから、あるいは連結先のクライアント ツールで定義されて)、このパネルは自動的にデータが投入されます。代わりに、サンプル メッセージを [リテラル] タブや [ツリー] タブにコピーすることも可能です。注意: 期待される JSON はデフォルトでは保存されませんが、保存したい場合は、[期待される JSON を保存] オプションをオンにします。
抽出によって参照される要素を後で変更したい場合、[修正] をクリックして変更します。詳細については「JSON Selector のリファレンスReference」を参照してください。
- 実行したい抽出をさらに設定するには、必要に応じてステップ a と b を繰り返します。
- JSON Data Bank のコンフィギュレーション パネル下部で、必要に応じてオプションをカスタマイズします。詳細については、「ツールのオプション」を参照してください。
...
- 期待される JSON の保存: 期待される JSON を保存するかどうかを指定します。
- 変更を許可: 抽出の変更を許可するかどうかを指定します。このオプションがオンの場合、 [選択された要素] の下に [抽出] タブと [変更] タブが表示されます。抽出を変更するには、 [変更を許可] チェックボックスを選択し、 [変更] タブを選択して、[要素の抽出] ボタンをクリックして抽出を追加します。その後、[変更] ボタンをクリックして抽出を変更します。次のオプションを含む [変更] ダイアログが表示されます。
XPath: 選択された XPath を表示します。詳細については「JSON Selector のリファレンスReference」を参照してください。
- 変更のタイプ: 入力する値が JSON を変更する方法を選択できます。後に付加: 変更した値が抽出の最後に追加されます。前に付加: 変更した値が抽出の先頭に追加されます。置換: 変更した値によって抽出全体が置換されます。
- 変更の値: データ ソースを使用して固定値またはパラメータライズされた値を指定できます。
- 空要素の抽出方法: 空の要素を抽出するかどうかを指定します。このオプションが有効な場合、隣のテキスト フィールドで、空の抽出要素の代わりに「プレースホルダー」として追加するテキスト文字列を指定できます。
- 抽出された要素が空文字列の場合に適用されます。たとえば、JSON { "name": "" } は "name" に空文字列を持ちます。
- このオプションを使用するには追加設定が必要です。詳細については、「JSON レスポンスの整合性を維持するために空要素/不足要素を処理する」を参照してください。
- 不足要素の抽出方法: 存在しない要素を抽出するかどうかを指定します。このオプションが有効な場合、隣のテキスト フィールドで、存在しない抽出要素の代わりに「プレースホルダー」として追加するテキスト文字列を指定できます。
- このオプションは、抽出が一致するノードを見つけられなかった場合に適用されます。
- このオプションを使用するには追加設定が必要です。詳細については、「JSON レスポンスの整合性を維持するために空要素/不足要素を処理する」を参照してください。
...
コンソール ビューにテスト実行中に使用された Data Bank 変数を表示できます。コンソール ビューは [ウィンドウ] メニューの [ビューの表示] > [コンソール] から表示できます。詳細は「変数の使用状況をモニタリング」を参照してください。
JSON レスポンスの整合性を維持するために空要素/不足要素を処理する
| Anchor | ||||
|---|---|---|---|---|
|
...