Skip to main content
All docs

End-to-End Tests in Human Readable Language

  • 3 minutes to read

This topic describes the basics of using EasyTest, and the components it comprises. For step-by-step instructions on how to test your XAF applications, refer to the Test an Action topic.

Add EasyTest to Your Project

Refer to the following articles for information on how to integrate EasyTest functional tests to your XAF projects:

Create a Test

Write Tests in Human-Readable Language

Add a new text file to your project, change the file extension to *.ets, and enter a test script in it. Refer to the following topic for a list of available script commands: EasyTest Script Reference.

The code sample below demonstrates a sample test added to newly created XAF applications.

#DropDB DBName 
#Application BlazorAppName 
#Application WinAppName 

    User Name = Admin 

*Action Log In 

*Action Navigation(Student) 

    RowCount = 0 

*Action New 

    First Name = John 
    Last Name = Smith 

*Action Save 

    Full Name = John Smith 

*Action Navigation(Student) 

    RowCount = 1 
    Columns = First Name, Last Name 
    Row = John, Smith 

Use the EasyTest Script Recorder

For the .NET Framework applications, you can use the EasyTest Script Recorder. It can record the actions you perform on a UI and save them to an EasyTest script file.

Script Recorder

Run a Test

With EasyTest, you can test your applications from Visual Studio or integrate functional testing in your CI/CD environment.

For information on how to run tests refer to the following topic: Run Tests.

EasyTest Components

When you create a new XAF solution, the FunctionalTests folder is added to the module project.


This folder contains the EasyTest configuration file and the Sample.ets sample test script file. You can use the sample test script to get a general idea of the script syntax.

EasyTest requires that the Config.xml configuration file is present in the folder containing a test script to be able to perform the test script. This file serves as a central storage for the configuration information required by test scripts. The configuration file created by default contains application definitions for the solution’s application project. You can create test scripts in any folder. However, since the FunctionalTests folder contains the automatically generated configuration file, it is recommended that you store test scripts here. For more information about the configuration file, refer to the EasyTest Configuration topic.

New solutions are created with a separate EasyTest connection string defined in application projects’ configuration files. This connection string is named EasyTestConnectionString. While testing, the applications use the database specified by this connection string.

EasyTest Limitations

  • Administrative privileges may be required to run EasyTest scripts. If a script fails to run, try to start Visual Studio as an administrator.
  • To run EasyTest for an ASP.NET Web Forms application, disable the Browser Link feature. Otherwise, your tests may fail to execute with the “WaitCallback - operation is not finished, pending ‘setTimeout’ handlers“ exception.
See Also