Skip to main content
Version: 2.6.0

Test Case


A Test Case is a collection of operations to execute on an Application Instance, that are assembled to test some specific aspect of system behaviour.

The Test Case is the third level of the 4-layer framework that is used in MTA. It allows for a Test Suite to be split up into different functional or technical aspects of the tested software, but it is also the level where to choose which app to test and which credentials to test with. From MTA 2.0, it is possible to define Data Variation on the Test Case level. Test Cases are executable, and contain Teststeps that run the underlying Mendix code.

A Test Case is always executed on a Test Application and by an execution user. The name of the execution user that is configured for the Test Case, must exactly match an existing, active and not blocked local user in the Application Instance that is tested. Note that this is not the same user as the Mta Connection User that is used to communicate between the Application environment and MTA.

When the Test Suite execution hits the Test Case, the Test Case's Execution User is used to login to the Test Case's Test application. When the Test Case is finished executing, the Execution user will be logged out again. The consequence of this, is that all data that was not saved to the database (either by a Persist Object Teststep or a Commit action in a Microflow), will be permanently lost. This is important to realize during test scripting, because if a subsequent Test Case retrieves data from a Teststep in this Test Case, this action will fail if the data was not saved to the database.


NameThe name of the Test Case.
Test applicationThe associated test application to execute the Test Case on.
Execution userThe username to execute the Test Case with. Do NOT use the MTA Plugin User account.
Apply securityIf this is set to No, any restrictive permissions set by the Mendix security model for the execution user are ignored (the execution username is however still used for associated data).
Execution time-outThe maximum number of seconds this Test Case is allowed to run. If the execution duration takes longer, the execution is aborted.
Execute with delayThe number of milliseconds to wait with executing this Test Case, after the previous Test Case has finished executing. This is particularly useful when some Mendix code is executed asyncronously in a previous Test Case, and you want to prevent the two Test Cases to run simultaneously.
Rollback after executionIndicates if all database transactions executed in this Test Case should be rolled back. This enables for unittesting without changing anything in the database. Note that when starting or stopping additional transactions in an executed microflow, this property will not work as expected. Setting this property to Yes will lead to Construction Errors if subsequent Test Cases depend on this Test Case.
ObjectiveThe objective of the testcase.
PreconditionsA description of the preconditions of a Test Case.
Expected resultA description of the expected result of a Test Case.

Business rules

Actions on Test Case

View Test Cases in a Test Suite

  • Navigate to the Test Suite that the Test Cases are in.
  • MTA will show the Test Cases in the left pane.

View Test Case details

  • Navigate to the Test Suite that the Test Case is in.
  • Click on the Test Case to select it.
  • Click on Test case details on top of the middle pane.

Create a Test Case

  • Navigate to the Test Suite you want to create a Test Case in.
  • Use the Add button to create a Test Case.
  • Enter a name and other optional information.
  • Select an Application Instance to execute the Test Case on.
  • Select an Execution User to execute the Test Case with.
  • Optionally, change the Execution time-out and Execute with delay.
  • Choose "Save".

Generate a Test Case to test a Microflow

This feature enables you to generate a test just like when inside a test suite, but for multiple microflows at once.

Different then when generating from inside the test suite, you can choose to generate based on random data, or to use from existing data from a database.


Only when choosing from database, MTA will generate "Create object" teststeps for associations as well.

  • Navigate to "Mendix Model" after opening a Test Configuration.
  • Select the microflow(s) to generate a Test Case for.
  • Choose to either generate a Test Case with random data, or from database.
  • When choosing from database, select the application instance.
  • Optionally open and configure (one of) the test case(s) from here.

When generating multiple test cases, best practice is to create a container test suite to create 'draft' versions first, and move them to a 'production' test suite later.

Execute Test Case

  • Use the Execute test case button from the menu or inside a Test Case, to start a new Test Run.

Executing a single Test Case will also execute previous Test Cases that the Test Case depends on.

Note that datavariation still applies when executing a single Test Case. This means that even if there are no variations on attributes or asserts from the Test Case in the datavariation, it will still be executed as many times as there are columns in the datavariation. This applies to both Test Suite datavariation as Test Case datavariation!

Share a Test Case

You can copy the URL to open a Test Case directly from your browser's address bar.

  • Find the Test Case you want to share.
  • Use the button to open the menu.
  • Click to copy the URL to the Test Case to your clipboard.
  • Paste Ctrl+V the URL anywhere to share it.

Note that after using a URL to open the Test Case, each time you hit F5 or Ctrl+R on your browser, you will end up on the same page, until you log out.

Change the order of a Test Case in a Test Suite

  • Click on or under the menu of the Test Case to move it up or down.

Note that it is possible that due to moving a Test Case and dependencies of Teststeps in the Test Case with Teststeps in previous Test Cases, an error will occur prohibiting the execution of the Test Configuration.

Edit a Test Case

  • Click on under the menu in the Test Case to edit it.

Note that it not is possible to change the Test Case Type or associated Test Application after creation.

Delete a Test Case

  • Click on under the menu on the Test Case you want to delete.

Note that it is possible that due to deleting a Test Case and dependencies of Teststeps in the Test Case with Teststeps in previous Test Cases, a Construction Error will occur prohibiting the execution of the Test Configuration.


Missing anything? Let us know!

Last updated 22 November 2023