動的リストを使用する

API Engine 3.0 は、二つのタイプのXMLリストとJSONリストをサポートしています。どちらのリストを作成するか、モジュール属性を追加する前に決めてください。

動的リスト：複数の値を持つ、1つのモジュール属性が含まれているリストです。複数のアイテムを持つリストがあり、ペイロードでそのうちのいくつかのみを扱う場合は、動的リストを使用します。たとえば、リストに何千ものアイテムがあり、特に最初と最後のアイテムに対してのみモジュール属性を作成する場合です。
静的リスト：各リストアイテムごとにモジュール属性を1つ含むリストです。

複数のアイテムを持つリストがあり、そのすべてをペイロードに表示したい場合は、静的リストを使用します。たとえば、リストに何千ものアイテムがあり、すべてのモジュール属性を手動で作成したくない場合です。

デフォルトで、モジュール属性を初めて追加した際は API Engine 3.0 が動的リストを作成します。

ですが、すでにモジュール属性でリストを作成している場合、 API Engine が同類のモジュール属性を引き続き追加します。つまり、

デフォルトのリストタイプは、リストが静的か動的かを示す ListSupport プロパティで指定されます。

静的リストから動的リストに切り替える

静的リストを動的リストに変換する場合は、次の手順に従ってください。

すべての静的モジュールAttributesを削除します。
API テストメニューで「ドロップダウンを追加する」を開き、「動的リストアイテムでモジュール属性を追加する」を選択してください。

あるいは、 ListSupport プロパティを静的から動的に手動で変更し、「追加する」をクリックすることができます。

モジュール属性を追加する

モジュール属性を追加して、動的リストを作成することができます。

動的リストアイテムを作成する

XMLリストおよびJSONリストに動的モジュール属性を追加すると、 Attribute Assistant が次のアクションを実行します。

デフォルトでリクエスト中の非アクティブノードを削除します。
Dynamic 値で ListSupport プロパティを作成します。
これは、親アイテムの場合は ActionMode を Select に、リクエストのサブ要素の場合は Insert に、レスポンスのサブ要素の場合は Verify に設定します。

動的リストモジュール

モジュール属性を作成すると、TestCaseの動的リストを使用できます。

TestCaseの動的リスト

リストアイテムに対して新しいXTestStepValueを生成すると、値がペイロードに自動的に表示されます。これは、TestStepの Technical View で確認できます。

これで、静的リストの場合と同じように、モジュール属性を操縦するできるようになりました。たとえば、ActionModeの場合は Verify と Constraint です。

ユーザーは、動的リストでインデックスや表記法を設定することはできません。インデックスや表記法を使用するには、静的リストのサポートに切り替えます。