QAF has configuration manager that loads configuration provided using xml or properties file. It expects available under resources directory under project root. If not provided under default location, you can specify location using system property named Refer list of properties used by the framework. QAF supports both properties files and xml files. To provide properties you can use either properties or xml file

To load additional resource for your project, set env.resource property. For example:

env.resource=resources/common; resources/web

in example above, all resources (properties provided using properties file or xml file) from resources/common and resources/web directories will be loaded.

Accessing properties

In Java

To access any properties in code you can use getBundle() method of ConfigurationManager.

import static com.qmetry.qaf.automation.core.ConfigurationManager.getBundle();


String myString = getBundle().getString("my.stringprop");
int myInt = getBundle().getInt("my.intprop");


To access any properties in BDD file, you can provide parameter in step call or meta-data. For example:

Given user login with '${}' and '${admin.user.pwd}'

Parameter Interpolation

Parameters (like ${token}) in property value(s) are automatically resolved when you retrieve property. Here is an example (properties file in this example, but xml configuration file work the same way)

The general syntax of a parameter is ${prefix:name}. The prefix tells Configuration manager that the parameter is to be evaluated in a certain context. The context is the current configuration instance if the prefix is missing.

The following other prefix names are supported by default:

Prefix Description
rnd generates random based on provided format. Format uses a for alphabet and 9 for digit in resulting value
expr evaluates expression

Parameter Examples with prefix:

${expr:com.qmetry.qaf.automation.util.DateUtil.getDate(0, 'MM/dd/yyyy')}

When you retrieve property with parameter, If a parameter cannot be resolved, e.g. because the property with name not available or an unknown prefix is used, it won’t be replaced, but is returned as is including the dollar sign and the curly braces.

parameter within parameter

In case you want to place parameter inside parameter you can use <% %>. For example:

target=${<%a%>.b} #in this case where a=c it should be ${c.b} results in cb${expr:com.qmetry.qaf.automation.util.DateUtil.getDate(1, 'MM/dd/yyyy')} #tomorrow in MM/dd/yyyy format${expr:com.qmetry.qaf.automation.util.DateUtil.getDate(<%rnd:9%>, 'MM/dd/yyyy')} #random date from 10 days from today in MM/dd/yyyy format

Define System properties

Usually, system properties passed at the time of program execution. However if you want to set system property through properties file you can use system prefix. Any property with system prefix will be added into system properties. For example:


this will set system property webdriver.gecko.driver.