Chapter 3. Setting up a New Project

Procedure: Using Business Central to Create an Organizational Unit

1. In Business Central, go to Authoring Administration.
2. On the perspective menu, click Organizational Units Manage Organizational Units.

3. In the Organization Unit Manager view, click Add.

   The Add New Organizational Unit dialog window opens.

   Figure 3.1. *Add New Organizational Unit*Dialog Window

   
4. Enter the two mandatory parameters (name and default group ID) and click Ok.

Procedure: Using Business Central to Create a Repository

1. In Business Central, go to Authoring Administration.

2. On the perspective menu, click Repositories New repository.

   The New Repository pop-up window is displayed.

   Figure 3.2. *New Repository*Dialog Window

   

3. Specify the two mandatory parameters:

   • repository name

     Note

     Make sure that the repository name is a valid file name. Avoid using a space or any special character that might lead to an invalid name.

   • organizational unit: specifies the location of the newly created repository.
4. Click Finish.

Procedure: Using Business Central to Clone a Repository

1. In Business Central, go to Authoring Administration.

2. On the perspective menu, choose Repositories Clone repository.

   The Clone Repository pop-up window is displayed.

   Figure 3.3. *Clone Repository*Dialog Window

   

3. 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, use file:///PATH_TO_REPOSITORY/REPOSITORY_NAME;

        Note

        The file protocol is only supported for READ operations. WRITE operations are not supported.

      • for a remote or preexisting repository, use https://github.com/USERNAME/REPOSITORY_NAME.git or git://HOST_NAME/REPOSITORY_NAME.

        Important

        It is important to use the HTTPS or Git protocol instead of a SCP-style SSH URL. Business Central does not support the basic SSH URL and fails with Invalid URL format.

   3. If applicable, enter the User Name and Password of your Git account to be used for authentication.

4. Click Clone.

   A confirmation prompt with the notification that the repository was created successfully is displayed.

5. Click Ok.

   The repository is now being indexed. Some workbench features may be unavailable until the indexing has completed.

Procedure: Using Business Central to Create a Project

1. In Business Central, go to Authoring Project Authoring.
2. In the Project Explorer, select the organizational unit and the repository in which you want to create the project.

3. On the perspective menu, click New Item Project.

   The New Project dialog window opens.

   

4. Define the Project General Settings and Group artifact version details of the new project. These parameters are stored in the pom.xml Maven configuration file.

   See the detailed description of the parameters:

   • Project Name: name of the project (for example MortgageProject).
   • Project Description: description of the project, which may be useful for the project documentation purposes.
   • Group ID: group ID of the project (for example org.mycompany.commons).
   • Artifact ID: artifact ID unique in the group (for example myframework). Avoid using a space or any other special character that might lead to an invalid name.
   • Version: version of the project (for example 2.1.1).

5. Click Finish.

   The project screen view is updated with the new project details as defined in the pom.xml file. You can switch between project descriptor files and edit their content by clicking the Project Settings: Project General Settings button at the top of the project screen view.

Procedure: Creating a New Package in Business Central

1. In Business Central, go to Authoring Project Authoring.
2. In the Project Explorer view, select the organizational unit, repository and the project where you want to create the package.

3. On the perspective menu, click New Item Package.

   The Create new Package dialog window opens.

   
4. Define the package details: enter the package name a specify the package.

5. Click Ok.

   A 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. Click Open Project Editor to open the project view.
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):

   1. When adding a maven dependency, a user has to define the Group ID, Artifact ID and the Version ID in the Dependency dialogue window.
   2. 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. Click Authoring Project Authoring and navigate to your project.
2. In the Project Explorer window, click Open Project Editor.
3. Click Project Settings: Project General Settings Knowledge bases and sessions. This view provides a user interface for changing kmodule.xml.

4. Click Add to define and add your bases.

   1. After you enter a name for your Knowledge Base, add Packages. For including all packages, click Add below Packages and enter asterisk *.
5. Below Knowledge Sessions, click Add and enter the name of your session.

6. Mark it Default and select appropriate state.

   For Red Hat JBoss BRMS, you can choose between stateful and stateless sessions. Use stateless if you do not need iterative invocations of the facts. Otherwise, use stateful session.

7. Click Save in the top right corner once you are done.

1. Open the repository view for your project.

   Figure 3.4. Changing to Repository View

   
2. Navigate to /src/main/resources/META-INF . Click on kmodule.xml to edit the file directly.

3. Define your kbases and ksessions. For example:

   <kmodule xmlns="http://www.drools.org/xsd/kmodule" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
     <kbase name="myBase" default="true" eventProcessingMode="stream" equalsBehavior="identity" packages="*">
       <ksession name="mySession" type="stateless" default="true" clockType="realtime"/>
     </kbase>
   </kmodule>

4. Click save in the top right corner.