Procedure: Creating a new Test Scenario

1. Open the Projects view from the Project Authoring menu.
2. Select the project where the test scenario is to be created.
3. From the New Item dropdown menu on the toolbar, select Test Scenario from the listed options.
4. Enter the Test Scenario name in the pop-up dialog box and click OK.

5. You will be presented with the Test Scenario edit screen.

   

Procedure: Importing a model for the Test Scenario

1. Use the tabs at the bottom of the screen to move between the Test Scenario edit screen and the Config edit screen.
2. The Config screen allows you to specify the model objects that you will be using in this Test Scenario.
3. Data objects from the same package are available by default. For example, if you have a package structure org.company.project, and you have a data object Fact1 in package org.company and a Fact2 in package org.company.project, you will not have to import model objects for Fact1 if you want to create a Test Scenario in package org.company; however, you will need to import Fact2 if you want to use it.
4. To import the data objects that are required for your Scenario, click on the New Item button in the Config screen.
5. These imports can be specific to your project’s data model or generic ones like String or Double objects.

Procedure: Providing Test Scenario Facts

1. After you have imported the data objects, come back to the Test Scenario screen and enter the variables for your Scenario.

2. At the minimum, there are two sections that require input: GIVEN and EXPECT

   • GIVEN: What are the input facts for this Test Scenario?
   • EXPECT: What are the expected results given the input facts from the GIVEN section?

3. GIVEN these input parameters, EXPECT these rules to be activated or fired. You can also EXPECT facts to be present and to have specific field values or EXPECT rules not to fire at all.

   If the expectations are met, then the Test Scenario has passed and your rules have been created correctly. If the expectations are not met, then the Test Scenario has failed and you need to check your rules.

Procedure: Providing Given Facts

1. To add a new fact, click on the green + button next to the GIVEN label. This will bring up the New Input dialog box. Provide your fact data in this window based on the data models that you have imported in the Config screen.

   

   You can select a particular data object from the model and give it a variable name (called Fact Name in the window), or choose to activate a rule flow group instead. If you choose to activate a rule flow group, you are allowing rules from a rule flow group to be tested by activating the group in advance. If you want to add a given fact and activate a rule flow group, you have to add the given fact, click the green + button again, and then add the activation.

2. Depending upon the model that you select, you will be able to provide values to its editable properties as part of your GIVEN fact. For example, if your model was a Product, you might have properties like itemID, productName and price. You get to these properties by clicking on the text Insert Product.

   

   By clicking on the pencil icon next to the property, you can edit the property to provide either a literal value for that property that should form part of your GIVEN fact data or you can provide advanced fact data. See Section 9.3, “Additional Test Scenario Features” for more information.

Procedure: Providing Expected Rules

1. Once you are satisfied with the Given rule conditions, you can expect that rules that will be fired if the Given rule conditions are met when the Test Scenario is run.

2. To do so, click on the green + button next to the EXPECT label. A New expectation dialog box will come up.

   

3. You can provide one of three expectations given the set of data that was created in the Given section. You can:

   • Either type in the name of a rule that is expected to be fired or select it from the list of rules and then click the OK button.
   • Expect a particular instance of a model object (and one or more of its properties) to have a certain value by selecting that instance from the drop down in the Fact Value field. For example, product1 shown in the figure, which is an instance of the fictitious Product model created in the Given section. You specify the property values by first adding that instance by clicking the Add button and then clicking a green arrow to bring up the fields to add. Once you have selected the field to add, you can provide a literal value for that field.

   • Expect a fact model to match your Given facts by selecting it from the Any fact that matches drop down. Instances of data objects are in the working memory, rather than matching what has been set up in the Given section. Rules may change the contents of working memory for example, some facts may be retracted, others inserted, and some will have their properties changed.

     In the figure shown above, you can mandate that instances of the Product’s one or more properties match the Given rule conditions.

Procedure: Reviewing, Saving, and Running a Scenario

1. Once you are satisfied with your Test Scenario’s facts, you can save it by clicking the Save button in the upper right corner. Ensure you regularly save and review your scenarios.

2. You can now run your Test Scenario by clicking the Run scenario button at the top of the Test Scenario screen. The results are displayed at the bottom of this screen in a new panel called Reporting.

   

3. Once you have a bunch of Test Scenarios for a particular package, you can run all of them together by accessing the All Test Scenarios tab and then clicking the Run all scenarios button.