Vous êtes sur la page 1sur 11

Selenium Test Framework - STF

Selenium Test Framework – STF


Application User Manual
Selenium Test Framework - STF

Document History

Date Version Description Author

2017-12-29 1.0 First version Hrvoje Salopek


Selenium Test Framework - STF

Table of contents

About ....................................................................................................................................................... 4
Installation................................................................................................................................................ 5
Application structure ................................................................................................................................ 6
Flow selection ...................................................................................................................................... 6
Web applications manager .................................................................................................................. 7
Datasource selection ........................................................................................................................... 7
Framework execution control ............................................................................................................... 8
Running the framework ........................................................................................................................... 9
Test results ............................................................................................................................................ 11
Selenium Test Framework - STF

About
The iSTF client application is a graphical user interface program that can be used to run the
underlying automation framework in a user-friendly way. It is designed to read from certain
configuration files, giving the user a clear overview of all the possible parameters, while also allowing
their modification via writing to the aforementioned configuration files. Finally, the application can
also use certain custom-made functions to control the execution of the framework.
Selenium Test Framework - STF

Installation
In order to install the application, place the release .zip file in the desired location and extract it.
After extracting, a folder structure should appear as displayed in Picture 1.

Picture 1

The main executable file can be found inside the “bin” subfolder and it is named stf-gui.exe. In order
to simplify subsequent application running, it is recommended to create a desktop shortcut to the
main executable file (Picture 2).

Picture 2

With the shortcut in place, running the application can be done simply by double clicking on it.
Selenium Test Framework - STF

Application structure
The application consists of the following sections (Picture 3):

1. Flow selection
2. Web applications manager
3. Datasource selection
4. Framework execution control

Picture 3

Flow selection
This part of the application is used to select the automation flow that is going to be run. The
application reads the available flows from the “conf” subfolder and displays them as a dropdown
selection (Picture 4).

Picture 4
Selenium Test Framework - STF

Web applications manager


After selecting a flow from the flow selection, the application reads the flow configuration and
prepopulates the fields relevant for the web applications that will be used for the selected flow
(Picture 5):

 Web application name


 URL of the web application
 Username for logging in to the web application
 Password for logging in to the web application

Picture 5

If the flow is using more than one web application, separate tabs will be added automatically (Picture
6).

Picture 6

In order to update the fields, it is enough to fill them with the desired data, the application will
automatically save the new data after running the flow.

Datasource selection
In this part of the application, the user can choose which folder contains the data XLS files. The
default value is the “data” subfolder, but it can be any other folder on the computer to which the
user has full read and write access. The application will automatically select the correct XLS file based
on the flow name and date of creation (oldest files will be processed first) (Picture 7).

Picture 7
Selenium Test Framework - STF

Framework execution control


After all the other information has been filled out, the user can choose from a few different methods
of running the underlying framework (Picture 8):

 Run now
o Runs the selected flow immediately after clicking on the “START” button.
 Run later
o Allows the user to set the date and time for the start of the flow.
o After choosing the date and time, clicking on the “START” button will start the
internal scheduler and the flow will be run at the scheduled time.
 After running, continue monitoring for new data files
o If this checkbox is checked, the application will continue to monitor for the presence
of new data files after running the flow for the first time. If any new data files appear
for the selected flow, the application will automatically run the flow again.

Picture 8
Selenium Test Framework - STF

Running the framework


After selecting a desired flow, filling out the necessary information and choosing the desired run
method, the user should click on the “START” button to begin running the flow. After clicking on the
button, the application goes into run mode, in which it shows the current running process and any
additional information if available (Picture 9).

Picture 9

The application will then run the underlying framework – a browser window will open and the
framework will execute the automation of the selected flow with the provided data from the
datasource file (Picture 10).

Picture 10
Selenium Test Framework - STF

When the framework has finished executing, the browser window will close and the application will
inform the user that the task has been completed. After that, the user can return to the main menu
or close the application alltogether (Picture 11).

Picture 11
Selenium Test Framework - STF

Test results
After the framework has finished executing, it will generate a report. This report contains an
overview of all the run test cases (which test cases passed, which failed and which were skipped),
detailed logs of each test case's execution, aswell as screenshots that were taken during the
execution.

The test reports can be found inside the „output“ subfolder where each framework execution will
generate its own unique report folder (Picture 12).

Picture 12

Inside this report folder there are three files (Error! Reference source not found.):

Picture 13

 test-results.xls
o Contains an overview of the test cases that were run, their status, execution time in
miliseconds, start time and, in case of failure, a screenshot that was taken at the
time of failure
o additional data can also be written to this file, for example generated MSISDN
numbers that were assigned to a customer during execution or contract numbers
 input data xls file
o this is the file that was used as the input datasource for running the framework
o the application automatically moves this file from the „input“ subfolder to the report
folder after finishing
 report.zip
o this archive contains detailed test execution reports and framework logs in HTML
format
o extracing this archive and opening the index.html file shows the above mentioned
information
o this archive should be sent to the vendor in case of any bugs with the software, as it
contains useful log information for debugging

Vous aimerez peut-être aussi