20.1

Starting the Application

To begin, you need to launch the application from qftest. There is a Quickstart Wizard to help you in creating the respective setup sequence.

• ActionOpen a new test suite via the menu item »File« »New test suite...«.
• To open the Quickstart Wizard please use the »Extras«-»Quickstart Wizard...« menu.

The Wizard starts up with a welcome message and some further information.

• ActionAfter saying a short hello please press the Next button to begin.

In step two you can choose the type of application to be tested.

• ActionPlease select the fourth option A native windows application.
• Press Next.

The next step specifies the Windows application executable.

• ActionFor this please use the select button on the right.
• Navigate to the subdirectory qftest-9.0.0/demo/carconfigForms/ of the QF-Test installation.
• Select the CarConfigForms.exe.

The second field can be left empty in our case hence it should be mentioned that it is also possible to connect QF-Test to an already running Windows application by help of its window title. Such can be specified in the second field. Also regular expressions can be used for specifying those window titles.

Note In the figure below we used the QF-Test variable ${qftest:dir.version} to address the version specific directory of the QF-Test installation, which you have already come across in the previous chapter. (Details on special QF-Test variables can be found in the manual chapter Variables).

• ActionPlease press the Finish button, as we do not need to go to the further optional steps for our simple demo.

We directly reach the final summary that explains what will happen after closing the wizard and how to continue.

• Action Please press Finish in order to end the wizard.

The generated setup sequence Launch CarConfigForms appears in the "Extras" section of your test suite and contains three parts:

• Set variable - defines the global client variable used throughout the test suite.
• Wait for client to connect - checks whether the client is already running.
• Launch SUT if not running - starts the System Under Test as client if it is not already running by us of a Start windows application, and wait for its start.

NoteThe information whether the client is already running is stored into a variable "isSUTRunning" in the first Wait for client to connect node and evaluated by the subsequent "If" condition. You can find this in the respective node details. This kind of conditional execution will be explained later in detail.

Now we want to see some action:

• ActionPlease ensure the Setup: Launch CarConfigForms node is selected.
• Then click or simply hit "Enter" Return.

You should see the Windows CarConfigurator application appear on your screen soon. As the focus changes back to QF-Test after the execution, the Demo might be covered by the test suite window.

At the end of this section let's save our test suite.

• Action Press the toolbar button or use the »File«-»Save« menu option with its short-cut Ctrl⁠+⁠S.
• In the file explorer navigate to an appropriate directory where you have write access e.g. Documents in your user home directory.
• Provide a name e.g. MyFirstTests.qft.
• Finish the saving action by pressing on Save.