The PlayData step uses normally its own Index (Step.Index) as iteration counter.
For a specific execution, without particular action, this index is never reset.
In order to loop over a sequence that contains a PlayData step, you may want to reset its index. To do so, either:
- Explicitly use the ResetIndex step
- Configure an external Index, using the Edit PlayData Source dialog box, and make sure this index will be reset
Index
The Index source allows you to use a TestStand variable instead of the internal variable Index.
· Mode—Specifies the TestStand variable selection:
- Current step—Step.Index (Default value).
- Other loop step—OtherLoopStepID.Index.
- Any other step—AnyOtherStepID.Index.
- Expression—Any TestStand variable which refers to a number.
· Default value—Specifies the Index value if the Loop has been disabled. The default value is 0 (first row)
|
|
Note The Default value selector is enable only in Other loop step mode. |
· Step—Name of a step from current sequence Main group.
|
|
Note The Step selector appears only in Other loop step or Any other step mode. |
· Expression—Specifies the TestStand variable used to evaluate the PlayData Index.
|
|
Note The content of Expression field can be modified only in Any other step or Expression mode. |
Values
The Values source allows you configure the origin of data TestStand will use.
· Mode—Specifies the Source values Mode:
- Current step— PlayData values are stored in step properties (Default value).
- File—PlayData values are loaded from an external file. In that case, you may configure the followings:
· File Format—PlayData support two kind of file format:
TXT— ASCII file with separator
(Tabulation, Comma, Semicolon)
Excel 2003 XML—Excel file format allowing
spreadsheet formulas evaluated at data loading.
· Separator—If file format is TXT, allow to specify the separator.
· File Name— Expression to specify the file name to read. The file has to be located in directories listed in TestStand Search Directories options. If the file is found, its absolute path is displayed in the indicator below.
|
|
Note The File Name is a string parameter. It can include relative or absolute path if the backslash character is properly escaped (\\). Using absolute path is NOT recommended. |
Spreadsheet file format
In order to be properly interpreted by TS+, the spreadsheet data must comply with the following. These requirements apply to both TXT and Excel 2003 XML files:
The
first row in the file contains a header
Following
rows contain data
Each
header cell must be formatted with at least the Channel name
If
there is a Unit, it is given in parenthesis, with a space character between the
Channel name and the parenthesis. Example: Vdd (mV)
Decimal
separator for numeric values must be a period (apply to TXT files only)
|
|
Note The TXT file created with ExportData step is in the expected format for PlayData TXT file. |
See Also
