[postman] collections - run the imported data file of the configuration

You can use data file transfer Postman Value set for use in the collection run . By means of Collection Runner Choose from JSON or CSV Data files , You can test your request with multiple different values in one run .

Use data files to run collections

When you start the collection run , You will see an option to select a data file . choice Postman Right lower corner Runner .
Select your collection , Then select select file next to data on the right to select your data file .

Before you start running , You will see a preview of the data in the file data.json The option to .

[{
    
    "path": "post",
    "value": "1"
  }, {
    
    "path": "post",
    "value": "2"
  }, {
    
    "path": "post",
    "value": "3"
  }, {
    
    "path": "post",
    "value": "4"
  }]

Select run with data file to start running with the values in the file .

Collection Runner The collection request will be run for each iteration in the data file . The output you see will indicate the results of any tests you defined in the collection request .

Accessing data file values

You can reference the values defined in the data file throughout the request , But access them in the script , You need to use different technologies . To use values in data files in test or pre request script code , Please use iterationData, It provides access to the current data file record used to run the request .

//get the 'value' field from the data file for this request run
pm.iterationData.get("value")

Any data you define in the request will be used by the collection runtime , And your request data can reference the value defined in the data file .

Error reading data file

When Postman When trying to read your data file during the collection run , You may encounter errors . If this happens , You can take the following steps .

1. Make sure your data file format is correct , by CSV or JSON.

2. By opening the data file in a text editor and saving the file in a different format , Make sure your data file is encoded correctly .