Enabling AI Business Rules feature

AI Business Rules feature helps you to validate your data based on logical conditions defined using plain English. This section discusses the steps to implement this feature.

Prerequisites

• Download and extract the zip containing the following files required for AI Business Rules implementation:
  • AIBusinessRules.war
  • export_AI_WebForm
  • RuleEngineTables.sql
  • rulesengine.properties
• Ensure that AIMap resource utilization meets the minimum requirements by specifying the following resource limits and requests in the aimap section of the global values.yaml file for the application.

Steps to enable AI Business Rules feature

1. Prepare a Database

   1. Create a MySQL database required for AI Business Rules related tables.

   2. Locate the RuleEngineTables.sql file that was downloaded and extracted as a prerequisite.

   3. Execute the RuleEngineTables.sql to create all the necessary tables for AI Business Rules.

2. Add the required custom properties

   The following table lists the custom properties you need to add to the application:

   *Custom properties table:
   *

   Custom property name	Description
   abpm.services.aimap.adeptiaai.ruleenginedb.url	Enter the URL of database you created for holding the AI Business Rules related tables in the following format: mysql+mysqlconnector://<Domain name>:3306/<DB name>
   abpm.services.aimap.adeptiaai.ruleenginedb.username	Username of the database.
   abpm.services.aimap.adeptiaai.ruleenginedb.password	Password to access the database.

   S****teps to add a custom property in the application

   The steps given below help you add one custom property. To add multiple custom properties, you need to repeat these steps for each custom property you want to add. For the list of properties, refer to the Custom properties table given above.

3. Log in to Adeptia Connect as an Admin.

4. In the application, click Account > Settings.

5. In the left panel, expand Custom.

6. Select Settings.

7. Click ADD Custom Property.

8. On the Add Custom Property window, 

   1. In the Group field, enter Rule_Engine as the Group name.
   2. In the Name field, enter a custom property name, for example, abpm.services.aimap.adeptiaai.ruleenginedb.url.
   3. In the Value field, provide an appropriate value for the property. For description of the custom properties, refer to the Custom properties table.
   4. In the Microservice field, select AIMap as the microservice for which you want to create this property.
   5. In the Description field, enter a description for the property.

9. Click Save.

   After you have added all the properties, restart the aimap microservice.

10. Update and deploy the rulesengine.properties file

    1. Open the rulesengine.properties file and update it by following the steps given below:
       1. In the jdbc.url variable, provide the URL and the name of the database you created for AI Business Rules.  
       2. In the jdbc.user variable, provide the database username.
       3. In the jdbc.pass variable, provide the database password.
       4. Provide the values for the following variables:
          • AI_Oauth_ClientId
          • AI_Oauth_ClientSecret
          • AI_Oauth_Scope
          • AI_Oauth_TokenURI
       5. In the AIServerURL variable, provide the AI Service URL.
       6. Provide Adeptia Connect URL, for example, https://app.adeptia.com, in the following variables:
          • ExecutionRule
          • CONNECT_URL
    2. Place the rulesengine.properties file in the webapps folder.
    3. Restart the portal microservice to bring the changes into effect.

11. Deploy the export_AI_WebForm zip

    1. Log in to Adeptia Connect as an Admin. 
    2. In the application, import the export_AI_WebForm zip using the Solution Promotion wizard.

12. Deploy the AIBusinessRules.war file

    1. In the application, upload the AIBusinessRules.war file to the target environment by navigating to Configure > CUSTOM LIBRARIES > Web Apps.
    2. Restart the portal microservice to bring the changes into effect.

13. Activate the deployed AI Business Rules webform

14. Update the ‘AIDocs_Service_BusinessRules’ Consumer

    1. In the application, open the AIDocs_Service_BusinessRules’ Consumer activity.
    2. In the URL field, replace <Environment DNS> with the actual application domain name, for example, app.adeptia.com.
       
    3. Click Save.