Iterate

The Iterate element can iterate over data items that it references. It is a Composite element and for each iteration it will execute its sequence of elements. It will update a variable named after its ID with the data that the current iteration represents. Child elements to the Iterate element can access this data at runtime. This is best used for testing data in an array.

Add Iterate to the Test Scenario by dragging it from the tool palette. This opens the Insert a new Iterate element popup. Here are the fields available when setting up this element:

ID

This is the label name you want assigned

Description

An optional description of the Test Element.

Referenced ID

points to the Referenceable element ID within this Test Scenario. There is a drop down if selecting a name that already exist. Could be the ID to a Functional Test palette or a SQL Select palette element.

Important

If you do not see your ID that was created make sure the Test Scenario was saved since the ID was created.

Data item path

An optional data path that points out the data in the Referenceable element to use for the iteration.

  • If the Referenced ID is lowest level, this field will not be needed as would occur with a SQL Select ID.
  • If the Referenced ID is not the lowest level, as in a Functional Test palette that has multiple levels of a copybook to get to the array, you need to specify the rest of the path name here. Once the Referenced ID is selected, the Data Items Path tree appears for you to select.

OK / Cancel 

Click OK to save your element.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*