Editing the configuration file

Before you start

STF has a configuration file that is used to set up the tool's functionality, for example, the default environment settings such as filepaths for test reports, and the test modules to be used. For the creation of this file, see Setting up the STF configuration file.

By default, the .ini file is opened in Carbide's text editor. However, it is recommended to use the STF Configuration Editor to enter and modify the values. The changes made to the file in the Configuration Editor are updated to the .ini file in real time.

To open the configuration file for editing, do the following:

  1. In Project Explorer, select the .ini file of your choice.
  2. Right-click the file and select Open With > STF Configuration Editor.
  3. Do either of the following:

    See the sections below for instructions on editing the configuration file.

  4. When you are finished with the edits, close the Configuration Editor view.
  5. To save your changes, click Yes.

Adding and modifying modules

Before you can run your test case, you need to add your test module to the STF configuration file to make it accessible for STF. The modules tab of the STF Configuration Editor provides a graphical interface for these operations. On the Modules tab, you can do the following things:

Modifying the global settings

Editing the global settings by hand can be error-prone. The STF Configuration Editor provides a convenient interface for editing this file. The editor contains a parser that is capable of finding mistakes in global settings (in case of manual modification). Global settings specify options for STF Engine and STF Logger:

Fields that are greyed out have default values and are not present in the .ini file. However, you can still change the values of these fields.

Tip: For details on what the fields contain and what their values can be, click the Source tab and check the descriptions in the text file itself. You can also edit the values in this text file directly. To get code assistance, press CTRL + SPACEBAR as shown below:

Sample of Source page and code assistance

Related tasks