Testing and validations

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

Prerequisites

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

Key concepts

  • Use SysTest Framework to author unit/component test code.
  • 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.

    FleetManagementUnitTestSampe

  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
             FMDataHelper::main(null);
         }
    
         [SysTestMethodAttribute]
         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();
             fmTotals.calculateRentalVehicleRate(rental);
    
             // Get the totals from the engine
             fmRentalTotal = fmTotals.totals(rental);
    
             // Set the expected amount
             expectedTotal = rental.VehicleRateTotal + rentalCharge.ExtendedAmount;
    
             this.assertEquals(expectedTotal,fmRentalTotal);
         }
    
         [SysTestMethodAttribute]
         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.

    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 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 Finance and Operations > Model Management > Create model.

    Create model

  2. Enter the model name, select the layer, and then enter any additional details. Note: **It's a good idea that you 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.

    Model name

  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 Finance and Operations > Addins > Import Task Recording.

    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.

    Generate test code

  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.

      Keep 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