ddCreateDatasetFromADatafile (Array Creation & Manipulation)
Compatible with:
- Purpose
- This command can be used to create a new Dataset in memory from a Data File with a Data File name provided in 'Target' with the structure that follows the DataSet name in 'Value'.Status of the Data File can be optionally passed along with the name of the Data File. Allowed values for Status are 'W' and 'A'. If not passed, the status of the Data File is assumed to be W for WIP.
- You can also create a DataSet based on the Data Filter applied to a Data Definition. Pass the filter name along with data file name separated by the pipe symbol ("||").
When the Dataset used in value field is not created anywhere during the run time before this command gets executed, the test run gets aborted saying "For one or more Instructions within the Test Script "<Test Script name>" that use the "<Array Creation & Manipulation Command>" command, the Dataset name provided in the 'Target' field does NOT exist in the scope of the Test Scenario" message. - Syntax
- ddCreateDatasetFromADatafile(dataFileName(status)||dataFilterName(optional),dataSetName)
- Target
- dataFileName(status)||dataFilterName(optional)
- Value
- datasetName - Name of the Dataset.
- Return Value
- Dataset in memory with data from Data File loaded to the memory structure.