Creating a test fixture
When you have created your guideline you should always test it to make sure that the rules execute as expected. In the GDL2 Editor you can either test the guideline by running single tests in the Execution tab or create, save and load a test fixture that contains of a complete set of tests. This is done in the Test tab.
What to test
Which tests to run depends on the design and complexity of the guideline, but it is good practice to always test:
- All rules in the guidelines
- Edge values
- Extreme values
Exercise all rules
To make sure that the rules that you have created work correctly it is important to exercise all rules by running different tests.
In the Execution tab of the GDL2 Editor, the rightmost section lets you know which rules were run (or fired) in that specific test case.
In the picture below, we have run the BMI guideline with the input values 80 kg and 180 cm. The Execution results section shows what is the calculated BMI value and which classification that correspond to (yellow boxes). The Fired rules section shows that the rules that have been fired (i.e. the rules which this specific test exercises) is Calculate BMI and BMI normal range (red box).
Make sure that the tests you create exercise all rules of the guideline.
Test the edge values
Edge values are values that are on the limit between two separate rules. In the BMI guideline we have created rules to classify the BMI value according to:
BMI <18,50 – underweight
– <16,00 – severe thinness
– 16,00-16,99 – moderate thinness
– 17,00-18,49 – mild thinness
BMI 18,50 – 24,99 – normal range
BMI 25,00-29,99 – overweight/pre-obese
BMI ≥30 – obese
– 30,00-34,99 – obese class I
– 35,00 – 39,99 – obese class II
– ≥40 – obese class III
and this gives us a lot of edge values.
A BMI value of 15.00 will be classified as severe thinness. As will 15.50 and 15.99 but as soon as we reach 16.00, we enter another classification, moderate thinness. So in this case we would want to create tests to make sure that anything below 16.00 is classified as severe thinness, but that 16.00 and above (up to 16.99) is classified as moderate thinness.
Extreme values are tested to ensure that these are handled in the way you have designed them to be. Our BMI guideline is modelled to treat extreme values just like any other value, but some guideline could include preconditions or rules to differentiate between what is thought to be normal and what is thought to be extreme.
For example, if we model a BMI guideline with the purpose of calculating the BMI for adult humans we might want exclude extreme heights, such as 350 cm or 1.8 cm. If that is the case, we need to check that a test with the height input 350 cm does not result in calculating and classifying that BMI.
Example of other tests
Depending on the guideline, there could very well be other types of tests that are relevant to reach full test coverage. These could, for example, be:
- Using different units
- Using a combination of units that are not allowed
- Providing no input in order to test default values
- Providing several instances of the same input with different time stamps to ensure use of the latest value
Create a test fixture
To create a new test fixture the easiest thing to do is to copy the Guideline Fixture that is autoimatically generated when running a test in the Execution tab (red box).
After copying the enitre text section, go to the Test tab and paste the fixture into the Test fixture area. We advise you to rename the test case from the default name case_1 to something more describing. In this case we use Normal range (red box) since the test produces a BMI value that is classified as normal. When clicking on the Execute button, the Test result section shows if the the passed or failed (yellow box).
Now you can go ahead and create more tests and paste them into the Text fixture. Note that the first lines, in this case:
should only exist once, at the top of the fixture file. After that only test cases, starting from -id: xxx should be added. You can see examples of this further down in the tutorial.
The next test we want to create is the edge value between
BMI 17,00-18,49 – mild thinness and
BMI 18,50 – 24,99 – normal range
i.e. BMI = 18.49 kg/m2.
To get BMI 18.49 we use the input values weight 59.9 and height 180 cm.
NOTE, however, that the input 59.9 kg in the Execution tab (red box) is rounded to 60 kg when the guideline is running (yellow box). So the output we receive from this test is not the correct one.
This can be fixed by running the test in the Test tab.
- First, we copy and paste the test new generated test fixture from the Execution tab into the Test tab, just below our first test case. The weight is set to 60 kg (red box).
- Then we change 60 kg to 59.9 kg
- We click on the Execute button and get the following result of a failed test:
- We edit the expected output of our test case according to the new result of our input (red box) and change the name of the test case (yellow box). Note that this output is the one we hoped for when running this test case: BMI 18.49 classified as mild thinness.
- Now we click on Execute again and see that the test passes
Now we can keep adding test cases to the test fixture, like this for BMI 17.00.
Completing the test fixture
When we have created test cases that execute all rules of our guideline, like:
And added some rules for testing extreme values, like:
We can save our test fixture. To do that, we click on the Save button just above the Test fixture area.
We edit the name, if needed, to match the name of the guideline. Here we want to change this to v1. We confirm saving the file by clicking the check mark.