Using Custom Data

You can specify custom data to be used by the agent during testing using the Data page. Each data file contains one or more records, each of which specifies the values for a given domain object or application form. The file name defines the name of the business object or application form.

The agent will use your custom data anytime it encounters a form or domain object within a form that matches the name or implied schema of the data file. You can also use custom data in flows using the notation "input-field" = $data.data-filename[selector], where selector is either the zero-based index of a record in the file or an attribute=value filter like that used in CSS attribute selectors.

Each record should contain a valid property (boolean) so the agent can anticipate the expected results when using the data. If the valid property is missing, the data is assumed to be valid.

Custom Data File Format

Custom data is specified using JSON in the following format:

[
	{
		"field-name": "field-value",
		...
	},
	...
]

For example, a "Users" file might contain the following:

[
	{
		"valid": true,
		"email": "name@example.com",
		"password": "testpassword"
	},
	{
		"valid": false,
		"email": "invalid email",
		"password": "invalid password"
	}
]

Like other assets, data files can be active, inactive, or invalid. Inactive and invalid data files will not be used by the agent, and flows that use them will fail.