Previous Topic: Data Set DescriptionsNext Topic: Create Your Own Data Sheet Data Set


Read Rows from a Delimited Data File Data Set

The Read Rows from a Delimited Data File data set assigns values to properties based on the contents of a text file. It is the most commonly used type of data set in DevTest Solutions. The first line of the text file specifies the names of the properties into which the data values are stored. The subsequent lines list the data values to be used for these properties. The text file is created using a simple text editor.

The following example shows a comma-delimited data file. The first row shows the property names in this data set.

Notepad file with month,day,year - example of a Delimited Data File data set

The Data Set Editor is used to define the data set.

Complete the following fields:

Name

Enter the name of the data set.

Local

Designates whether the data set is global or local. Global is the default. Local data sets are created with one for each simulator. Global data sets are created once and shared by all simulators.

Random

Whether the record after the current record (sequential access) is read, or a random record is read. Sequential reading is the default.

Max Records to Fetch

The upper bound on the number of records to fetch for random access. This text field is disabled if the Random check box is not selected.

At End Of Data

Select the action for the end of the data set. You can start over, reading values from the start of the data set, or you can select the step to execute.

File Location

The full path name of the text file, or browse to file with the Browse button.

File Encoding

Accept the default encoding of UTF-8 or select an alternate encoding from the drop-down list. You can also select Auto-detect and click the Detect button to have an encoding type selected for you.

Delimiter

The delimiter being used. Any character can be a delimiter. The drop-down list contains common delimiters.

Click the Test and Keep button to test and load the data. You get a message that confirms that the data set can be read, and shows the first set of data.

LISA--msg_dataset_testandkeepsuccessful