The ListCSVGen Generator loads its list from column data within a CSV file. 

Note: Use ListCSVGen Generator for more than 15 records. Otherwise, it is recommended to use the ListGen Generator

In This Article

Generator Parameters

The following parameters may be configured for the ListCSVGen Generator. Items with an asterisk* are required. 

  • filePath* - Defines the path where the CSV file is located. 
  • fileName* - Defines the name of the CSV file to open. 
  • columnName* - Defines which column in the CSV to read data from.
  • delimiter* - Defines what delimiter is used to separate column data within the CSV file. 
  • waitAmount* - Defines the number of iterations the Generator should wait before moving to the next value in the list. 
  • setLoop* - Defines whether the size of the list should be used to set the Scenario loop value. 
  • sortOrder* - Defines whether the list should be sorted and, if so, in ascending, descending, or random order. 
  • seed - Defines an optional seed for randomization. Using the see will ensure that the same random data is generated each time data is generated. 
  • iterate - Based on the Boolean value, determines when to generate the next value. If the value is true, it generates the next value. If the value is false, it just waits. 
  • list - Stores one value on each line for the list. To add values, type them in and then press the Enter Key. Note that the listed value is only for simulation mode. When running an actual Scenario, the data will be loaded from the specified resource. 
  • startIndex* - Defines the index in the list on where to start from. 
  • jumpAmount* - Defines the amount to add to the index of generated value.

Preview Showing Empty Values - List Parameter

The ListCSVGen generator reads the data from the given CSV file and loads the data while running the Scenario on the user's system locally. 

The list parameter can be used to simulate data displayed in the Preview pane on the GenRocket web app. 

If no values are entered for the list parameter, the preview will show Empty values for each record. 

When users add values to the list parameter, this data is simulated for preview only. The added values will appear in the Preview pane.

Example - Load First Names from CSV File

For this example, the ListCSVGen Generator will be assigned to a firstName Attribute within a User Domain. 

The following ListCSVGen Generator Parameters have been changed before downloading the Scenario and generating the data: 

  • filePath - #(
  • fileName - User.csv
  • columnName - firstName
  • delimiter - comma (,)

CSV File and Generated Output

The ListCSVGen Generator used the following CSV file for the firstName Attribute:


The first names within the generated output file match the first names within the CSV File.