Testing and validations

This tutorial shows you how to create and run test cases.


You will need to deploy Developer Topology with Developer and Build VM.

Key concepts

  • Use SysTest Framework to author unit/component test code.
  • Test isolation
  • Test module creation to manage test code and FormAdaptors.
  • Import Task Recorder recordings into Visual Studio to generate test code.
  • Integrate a Test module with a build machine.

Integrate a test module.

Use SysTest Framework to author unit/component test code

You can create new test cases to test the functionality in an application.

  1. Open Visual Studio as an administrator.

  2. On the File menu, click Open > Project/Solution, and then select FleetManagement solution from the desktop folder. If the solution file is not on your computer, the steps to create it are listed in Tutorial: Create a Fleet Management solution file out of the Fleet Management models in the AOT.

  3. In Solution Explorer, right-click the Fleet Management solution, point to Add, and then click New Project.

  4. Choose finance and operations as the project type to create.

  5. Name this new project FleetManagementUnitTestSample, specify the FleetManagement folder on the desktop (C:\Users\Public\Desktop\FleetManagement) as the location, and then click OK.

  6. In Solution Explorer, right-click the new project, and then click Properties.

  7. Set the Model property to FleetManagementUnitTests, and then click OK.

    Model property.

  8. Right-click the FleetManagementUnitTestSample project, point to Add, and then click New Item.

  9. In the Add New Item window, select Class as the type of element to add. Name the new class FMUnitTestSample, and then click Add.

    Add new item.

  10. In the first line of the code for the new class, indicate that the class extends the SysTestCase class.

  11. Add the following code to define the methods for the class. These methods define two additional tests.

    class FMUnitTestSample extends SysTestCase
        public void setup()
            // Reset the test data to be sure things are clean
        public void testFMTotalsEngine()
            FMRental rental;
            FMTotalsEngine fmTotals;
            FMRentalTotal fmRentalTotal;
            FMRentalCharge rentalCharge;
            FMRentalTotal expectedtotal;
            str rentalID = '000022';
            // Find a known rental
            rental = FMRental::find(rentalID);
            // Get the rental charges associated with the rental
            // Data is seeded randomly, so this will change for each run
            select sum(ExtendedAmount) from rentalCharge
                    where rentalCharge.RentalId == rental.RentalId;
            fmTotals = FMTotalsEngine::construct();
            // Get the totals from the engine
            fmRentalTotal = fmTotals.totals(rental);
            // Set the expected amount
            expectedTotal = rental.VehicleRateTotal + rentalCharge.ExtendedAmount;
        public void testFMCarValidateField()
            FMCarClass fmCar;
            fmCar.NumberOfDoors = -1;
            this.assertFalse(fmCar.validateField(Fieldnum("FMCarClass", "NumberOfDoors")));
            fmCar.NumberOfDoors = 4;
            this.assertTrue(fmCar.validateField(Fieldnum("FMCarClass", "NumberOfDoors")));
  12. Save the new class. After the save is complete, you will see the additional two test cases in Test Explorer. Right-click on the FleetManagementUnitTestSample project in Solution Explorer, and then click Build.

  13. On the View menu, open Test Explorer.

  14. Click Run selected test to execute specific test case.

  15. Test Explorer will show the results of test after it is complete.

    Completed test.

Test isolation

For a test to be of high value it must be reliable. A test will pass or fail consistently, independent of other factors such as other tests. One typical cause of unreliable tests is leaking state, such as data left behind in the data base that influences downstream tests. To prevent this type of issue, you can use the SysTestTransaction attribute.

TestTransactionMode Description
AutoRollback Default. This provides the best isolation.

All transactions are rolled back using SQL save points, and all database statements are routed to the main connection, including user connections. No data will be persisted.
LegacyRollback All insert statements are tracked and deleted during clean-up.

All insert statements are downgraded to row-by-row. One typical use case is when testing user connections or concurrency scenarios. This isolation level will clean up setup data, and the recommendation is to wrap each test method in a ttsBegin and ttsAbort.
LegacyRollbackWithUpdateTracking All update, delete, and insert statements are tracked and reverted during cleanup.

All insert, update, and delete statements are tracked and downgraded to row-by-row. This is the slowest isolation level.
None Only use for debugging. This provides no isolation.

This setting can be useful to temporarily to debug a test, as it allows you to use the regular user interface to navigate the data that the test created.


    class MyTestSample extends SysTestCase

Test module creation to manage test code and FormAdaptors

Creating a test specific module helps to keep test code together and manageable.

  1. Open Visual Studio and go to Dynamics 365 > Model Management > Create model.

  2. Enter the model name, select the layer, and then enter any additional details. Note that it's a good idea to include the word Test in the name of the test module. The default build definition is configured to discover all test modules that contain the word Test.

  3. Because this model holds forms from the Application Platform/Foundation, add references to models shown below.

    Model references.

After the base test module is in place, you can import a Task Recorder recording to generate test code. When you import a Task Recorder recording XML, test code is generated using FormAdaptors. Form adaptors are wrapper classes over forms which provide strongly typed API that can be used to test form functionality. We have included pre-generated FormAdapters for each package for built-in forms. In the test module, add a reference to the corresponding Form Adaptor for packages and Test Essentials, which has helper methods to execute test code.

Import a Task Recorder recording into Visual Studio to generate test code

You can generate test code from Task Recorder recording to execute headless (non-UI) test.

  1. Record a scenario in by using Task Recorder.

  2. To import a Task Recording, in Visual Studio, click Dynamics 365 > Addins > Import Task Recording.

  3. In the Import Task Recording dialog, select the Test Module (ISVTestModule) under which you want to import task recording, and browse to recording xml file.

    Test module.

  4. The task recording import process generates test code that is based on the SysTestAdapter and FormAdaptor which can be viewed in Visual Studio IDE. We do not expect you to change any test source code that is generated as part of this step.

  5. After the test code is generated, set up Visual Studio options for test discovery and execution:

    • If you have a 64-bit machine, you can run unit tests and capture code coverage information as a 64-bit process.
    • To configure this, select Test > Test Settings > Default Processor Architecture, and then select X64.
    • You might run into a situation in which the test execution engine opens and locks an assembly in your test project. When this happens, you can’t for example, save changes to the assembly. To fix this, select Test > Test Settings, and then select Keep Test Execution Engine Running.
    • Now that you have test code generated in Visual Studio IDE, it's time to discover the test and try executing them locally.
  6. From menu options, select Test > Windows, and then click Test Explorer. After the Test Explorer window is open, it will try to discover test from test code and list all the available tests as shown below.

    Test explorer.

  7. Select the test and then click Run > Execute selected. This will execute test against the locally deployed environment.

    Execute selected.

Integration of the test module with build process

After the test module is a part of source control, the build process template will discover all test modules, which contain the word Test in the name. The following illustration shows build and test execution as part of Visual Studio Online.

Build and test execution.