Data Navigation Dialog Box

Relevant for: API testing only

This dialog box enables you to set the data navigation properties for your test loop. You can set the direction in which to use the data, from where to begin, and the condition for selecting data.

To access
  1. Do one of the following:

    • Ensure that an API test or component is in focus in the document pane.

    • In the solution explorer, select an API test or component.

  2. In the Properties pane, link a property to a data source .

  3. In the canvas, select the Test Flow or another test loop.

  4. In the Properties pane, Open the Data Sources tab .

  5. Select a data source in the list and click Edit.

Relevant tasks

Navigate within a data source

User interface elements are described below:

UI Elements

Description

Start

The location from where to begin taking data from the data source.

  • Start at. The row of data from which to begin: First row, Last row, Specific row, Random row, or First row matching.

  • Row. The row number from which to begin (only available when selecting Specific row).

  • Condition. The condition the data row must meet in order to start the looping (only available when selecting the First row matching option):

    • Column. One of the data source's columns.

    • Comparison operator. =, !=, >, >=, <, <=, Starts, Ends, Contains, or Regex (depending on the row's data type).

    • Value. The value to be matched in order to use this row of data.

Move

The direction and amount of rows by which to advance within the data.

  • Move by. The number of rows to advance (not relevant for Direction > To a random row).

  • Direction. The direction in which to move: Forward, Backward, or To a random row.

End

When to stop the looping through the data: First row, Last row, Specific row, or First row matching.

  • Row. The row number in which to end (only available when selecting Specific row).

  • Condition. The condition the data row must meet in order to end the looping (only available when selecting the First row matching option):

    • Column. One of the data source's columns.

    • Comparison operator. =, !=,>, >=, <, <=, Starts, Ends, Contains, or Regex (depending on row's data type).

    • Value. The value to be matched in order to use this row of data.

This setting stops the looping only when the loop type is set to 'For Each' and the current data source whose navigation settings you are editing, is the same data source that is linked to the loop.

This setting is only relevant when the Move direction is set to Forward or Backward. For the To a random row option, each row is visited once in random order. The navigation ends after all of the rows were visited.

Upon reaching the last row - Action:(Move Forward)

The action to take when reaching the last row of data.

  • Keep using that row. Keep using the last row of data for all subsequent loops.

  • Wrap around. Start again from the first row of data.

Upon reaching the first row - Action:(Move Backward)

The action to take when reaching the first row of data.

  • Keep using that row. Keep using the first row of data for all subsequent loops.

  • Wrap around. Start again from the last row of data.