1. Navigate to http://localhost:8080/business-central in a web browser. If the user interface has been configured to run from a domain name, substitute localhost for the domain name. For example http://www.example.com:8080/business-central.
2. Log in with the user credentials that were created during installation. For example: User = helloworlduser and password = Helloworld@123.

Procedure 3.1. Creating an organizational unit

1. Open the Administration perspective: on the main menu, click Authoring → Administration.
2. On the perspective menu, click Organizational Units → Manage Organizational Units.
3. In the Organization Unit Manager view, click on the Add button. The Add New Organizational Unit pop-up window opens.
   

   Figure 3.1. Add New Organizational Unit Pop-up

4. Enter the mandatory details:
   • Organizational unit name.
   • Owner.
5. Click OK to create the unit.

Procedure 3.2. Creating a New Repository

1. Open the Administration perspective: on the main menu, click Authoring → Administration.
2. On the perspective menu, click Repositories → New Repository.
3. The Create Repository pop-up window is displayed.
   

   Figure 3.2. Create Repository Pop-up

4. Enter the mandatory details:
   • Repository name.

     Note

     Note that the repository name should be a valid filename. Avoid using a space or any special character that might lead to an invalid folder name.
   • Select an organizational unit in which the repository is to be created from the Organizational Unit drop-down option.
5. Click Create
6. A confirmation prompt with an OK button is displayed which notifies the user that the repository is created successfully. Click OK.

Procedure 3.3. Cloning a repository

1. Open the Administration perspective.
2. On the Repositories menu, select Clone repository.
3. The Clone Repository pop-up window is displayed.
   

   Figure 3.3. Clone Repository Pop-up

4. In the Clone Repository dialog window, enter the repository details:
   1. Enter the Repository Name to be used as the repository identifier in the Asset repository and select the Organizational Unit it should be added to.
   2. Enter the URL of the GIT repository:
      • For a Local Repository: file:///path-to-repository/reponame
      • For a Remote or preexisting Repository: git://hostname/reponame

      Note

      The file protocol is only supported for 'READ' operations. 'WRITE' operations are not supported.
   3. If applicable, enter the User Name and Password to be used for authentication when cloning the repository.
5. Click Clone.
6. A confirmation prompt with an OK button is displayed which notifies the user that the repository is created successfully. Click OK.

1. Open the Project Authoring perspective: on the main menu, click Authoring → Project Authoring.
2. In the Project Explorer, select the organizational unit and the repository where you want to create the project.
3. In the perspective menu, go to New Item → Project.
4. In the Create new Project dialog window, define the project details:
   1. In the Resource Name text box, enter the project name.
      

      Figure 3.4. New Project Screen

      Note

      Note that the project name should be a valid filename. Avoid using a space or any special character that might lead to an invalid folder name.
5. The explorer refreshes to show a New Project Wizard pop-up window.
   

   Figure 3.5. New Project Wizard Pop-up

6. Define the Project General Settings and Group artifact version details for this new project. These parameters are stored inside the pom.xml maven configuration file.
   • Project Name: The name for the project; for example Mortgages
   • Project Description: The description of the project which may be useful for the project documentation purpose.
   • Group ID: group ID of the project; for example org.mycompany.commons
   • Artifact ID: artifact ID unique in the group; for example myframework
   • Version ID: version of the project; for example 2.1.1
   The Project Screen view is updated with the new project details as defined in the pom.xml file. Note, that you can switch between project descriptor files in the drop down-box with Project Settings and Knowledge Base Setting, and edit their contents.

Procedure 3.4. Creating a new package

1. Open the Project Authoring perspective: on the main menu, click Authoring → Project Authoring.
2. In the Project Explorer view, do the following:
   • If in the Project view of Project Explorer, select the organizational unit, repository and the project where you want to create the package.
   • If in the Repository view of Project Explorer, navigate to the project root, where you want to create the package.
3. In the perspective menu, go to New Item → Package.
4. In the Create new Package dialog window, define the package details:
   1. In the Resource Name text box, enter the package name and click OK.
5. The new package is now created under the selected project.

1. Open the Project Editor for the given project:
   1. In the Project Explorer view of the Project Authoring perspective, open the project directory.
   2. In the perspective menu, go to Tools → Project Editor.
2. In the Project Screen view, select in the Project Settings drop-down box the Dependencies item.
3. On the updated Project Screen, click the Add button to add a maven dependency or click the Add from repository button to add a dependency from the Knowledge Store (Artifact repository):
   • When adding a maven dependency, a user has to define the Group ID, Artifact ID and the Version ID in the new row which is created in the dependency table.
   • When adding a dependency from the Knowledge Store, select the dependency in the displayed dialog box: the dependency will be added to the dependency table.
4. To apply the various changes, the dependencies must be saved.

1. Open your project properties with the Project Editor: in the Project Explorer, locate your project root. In the top menu, go to Tools → Project Editor.
2. In the Project Screen tab on the right, select "Knowledge Base Settings: Knowledge bases and sessions" option. This brings up a user interface for editing the kmodule.xml file.
3. Click on Add button to define and add your bases. Scroll down in this screen to add your knowledge sessions.
4. Click the save button in the top right once done.

1. Open up the repository view for your project by clicking the gear icon.
   

   Figure 3.6. Changing to repository view

2. Click on src folder, and then drill down to locate the META-INF folder (/src/main/resources/META-INF). You will see the kmodule.xml file. Click on this file and its raw view will open up in a panel on the right hand side.
3. Define your bases and sessions in this file panel. An example of what you need to enter is shown below.
   <kbase name="TestBase" default="false" eventProcessingMode="stream" equalsBehavior="equality"> <ksession name="TestSession" type="stateless" default="false" clockType="realtime"/> </kbase>
4. Click save button in the top right hand screen once done.

1. Open the Data Modeler: in the Project Authoring perspective, click Tools → Data Modeler on the perspective menu.
2. Create a data object:
   1. In the Objects panel, click the Create button and provide the data object details:
      • Identifier: name of the data object unique within the project.

        Warning

        This identifier name must be unique within the whole project, and not just the package.
      • Label: name of the data object to be displayed in the Objects panel
      • New package: a new package the object should be created in
      • Existing package: an existing package the object should be created in
      • Superclass: a data object to be used as the superclass for the data object (the data objects extends this class, that is, it inherits all its fields)
3. Create fields of the data object:
   1. Select the object in the Objects panel.
   2. In the Create new field part of the Fields panel, define the field properties:
      • Id: field ID unique within the data object
      • Label: label to be used in the Fields panel
      • Type: data type of the field
   3. Click Create.

Procedure 5.1. Creating a new rule

1. In the Project Explorer view, do the following:
   • If in the Project view of Project Explorer, select the organizational unit, repository and the project where you want to create the rule.
   • If in the Repository view of Project Explorer, navigate to src/main/resources/ and the SUBFOLDER/PACKAGE where you want to create the project folder for the rule template.
2. In the perspective menu, go to New Item → Guided Rule.
3. In the Create new Guided Rule dialog window, define the package details:
   1. In the Resource Name text box, enter the Guided Rule name and click OK.
4. The new Guided Rule is now created under the selected project.

Procedure 8.1. Creating a new Test Scenario

1. Open the Projects view from the Authoring menu.
2. Select the project where the test scenario is to be created.
3. From the New 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 8.2. 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. Facts/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 fact/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 do this, you will need to import the model objects required for your Scenario by clicking 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 8.3. Providing Test Scenario conditions

1. After you have imported the model 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 8.4. Providing Given Facts

1. To add a new condition, 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 project models that you have imported in the Config screen.
   
   You can select a particular fact/data object from the model, 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 both 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 object 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.

Procedure 8.5. Providing Expected Rules

1. Once you are satisfied with the Given fact conditions, you can provide the expected rules that will be fired if the Given fact 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 instances of a fact model to match your Given conditions by selecing it from the Any fact that matches drop down. In the figure shown above, you can mandate that instances of Product's one or more properties match the Given conditions. For example, You have a fact 'A' with a String field 'fieldA'. In the test scenario, you set two given facts: 'A' bound to variable 'a1' and 'A' bound to variable 'a2'. Fact 'a1' will have 'fieldA' with value "something", fact 'a2' will have 'fieldA' with value "else". You will add an expectation - any fact that matches A. Add 'fieldA' with value "something" to this expectation. Save the test scenario and run it. It will pass (correctly), even though only 'a1' matches the expectation.

Procedure 8.6. Reviewing, Saving, and Running a Scenario

1. Once you are satisfied with your Test Scenario's conditions, you can save it by clicking the Save button in the upper right corner. Make sure to 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.