Tutorial

Video Icon

In the near future we will upload videos for every chapter of the tutorial which will lead you step by step through QF-Test.

2.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.
Figure 2.1:  The Quickstart Wizard

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

  • ActionPlease keep the first option A Java application.
  • Press Next.
Figure 2.2:  Type of Application

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

  • ActionPlease keep the first option "A stand-alone executable (launched via .exe, .cmd, .bat, .app,...)"
  • Continue with Next.
Figure 2.3:  Type of Executable

The next step specifies the executable file.

  • ActionFor this please use the select executable Select executable button on the right.
  • Navigate to the subdirectory qftest-4.7.1/demo/carconfig/ of the QF-Test installation.
  • Select the CarConfig.cmd file (or CarConfig.sh on macOS/Linux).

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.
Figure 2.4:  Executable file selection.

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.
Figure 2.5:  Final Information

The generated setup sequence Launch CarConfig 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 SUT client" 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.

Figure 2.6:  Generated Setup Sequence

Now we want to see some action:

  • ActionPlease ensure the Setup: Launch CarConfig node is selected.
  • Then click Play or simply hit "Enter" [Return].

You should see the JCarConfigurator 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.

Figure 2.7:  The JCarConfigurator Demo Window

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

  • Action Press the Save           file 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.