| Both sides previous revision Previous revision Next revision | Previous revision |
| docs:1000_quick_tour:0200_quick_tour [2022/09/13 18:15] – external edit 127.0.0.1 | docs:1000_quick_tour:0200_quick_tour [2025/06/12 03:58] (current) – Change to AwareIM aware_support3 |
|---|
| ====== Configuration ====== | ====== Configuration ====== |
| |
| The first step is to enter into //**Aware IM**// the instructions on how our application should work, in other words to configure the application. To do this we start the Configuration Tool. You can start the Configuration Tool by clicking on the "Start Configurator" button at the top of Aware IM Control Panel. When the Configuration Tool prompts you to enter credentials, enter the name of the application you specified when running Aware IM Control Panel for the first time. Enter ''admin'' as the default user name and enter the word ''password'' as the initial password. | The first step is to enter into //**AwareIM**// the instructions on how our application should work, in other words to configure the application. To do this we start the Configuration Tool. You can start the Configuration Tool by clicking on the "Start Configurator" button at the top of AwareIM Control Panel. When the Configuration Tool prompts you to enter credentials, enter the name of the application you specified when running AwareIM Control Panel for the first time. Enter ''admin'' as the default user name and enter the word ''password'' as the initial password. |
| |
| |
| |
| |
| To create a new business object click on the little plus sign to the left of the business space version 1.1 to see the items it contains, select the "Business Objects" item and choose the "New" command from the toolbar (or select "File/New" in the menu or right click and select "New" from the popup menu). The business object editor appears in the working panel. There is also a list of properties of the object and a list of properties of a selected attribute underneath. Click on the "Name" property in the list of properties of the object and enter 'Customer'. Then click on the icon to enter the attributes of the object. Specify the name of the attribute and choose the type of the attribute. The first three attributes are essential for the purpose of our exercise, as we will see shortly, so when entering the attributes tick the 'Required' checkbox in the list of attribute properties for each of them. This will instruct //**Aware IM**// to validate the data entered by staff members and disallow empty entries. | To create a new business object click on the little plus sign to the left of the business space version 1.1 to see the items it contains, select the "Business Objects" item and choose the "New" command from the toolbar (or select "File/New" in the menu or right click and select "New" from the popup menu). The business object editor appears in the working panel. There is also a list of properties of the object and a list of properties of a selected attribute underneath. Click on the "Name" property in the list of properties of the object and enter 'Customer'. Then click on the icon to enter the attributes of the object. Specify the name of the attribute and choose the type of the attribute. The first three attributes are essential for the purpose of our exercise, as we will see shortly, so when entering the attributes tick the 'Required' checkbox in the list of attribute properties for each of them. This will instruct //**AwareIM**// to validate the data entered by staff members and disallow empty entries. |
| |
| |
| |
| Since our system is going to send e-mails to customers, we need to nominate Customer as an intelligent business object. In //**Aware IM**// intelligent objects are those that can receive and process information (see the "[[docs:2000_concepts:0900_prod_feats:0300_comm_with_other_systems:0100_intelligent_bus_obj|Intelligent Business Objects]]" section for more information on intelligent objects). Communication with such objects is performed via communication channels. In this case we need to define the e-mail channel. Click on the "Communication" property in the list of properties of the object and tick the checkbox next to the "E-mail" communication channel. We then enter the parameters required to connect to the mail server. These are the same parameters you use to set up your e-mail program. When the definition of the Customer object is finished, we click on the "Save" button in the application toolbar to save the object configuration (or select File/Save command from the menu). | Since our system is going to send e-mails to customers, we need to nominate Customer as an intelligent business object. In //**AwareIM**// intelligent objects are those that can receive and process information (see the "[[docs:2000_concepts:0900_prod_feats:0300_comm_with_other_systems:0100_intelligent_bus_obj|Intelligent Business Objects]]" section for more information on intelligent objects). Communication with such objects is performed via communication channels. In this case we need to define the e-mail channel. Click on the "Communication" property in the list of properties of the object and tick the checkbox next to the "E-mail" communication channel. We then enter the parameters required to connect to the mail server. These are the same parameters you use to set up your e-mail program. When the definition of the Customer object is finished, we click on the "Save" button in the application toolbar to save the object configuration (or select File/Save command from the menu). |
| |
| |
| |
| All information processing in //**Aware IM**// is controlled by rules. Most rules are attached to business objects. A single object may have many rules attached to it. Such rules are independent of each other. For example, we may add a validation rule to the Customer object that instructs //**Aware IM**// to disallow registration of customers under 16 years old: | All information processing in //**AwareIM**// is controlled by rules. Most rules are attached to business objects. A single object may have many rules attached to it. Such rules are independent of each other. For example, we may add a validation rule to the Customer object that instructs //**AwareIM**// to disallow registration of customers under 16 years old: |
| <code aim>IF AGE(Customer.DateOfBirth) < 16 THEN | <code aim>IF AGE(Customer.DateOfBirth) < 16 THEN |
| REPORT ERROR 'Customer cannot be under 16 years old' </code> | REPORT ERROR 'Customer cannot be under 16 years old' </code> |
| Similarly we could add as many rules as necessary to the Customer object to instruct //**Aware IM**// on what our system should do when a customer is registered or updated. See the [[docs:2000_concepts:0800_data_processing:0100_rule_evaluation|Rule Evaluation]] section for details on how rules work. | Similarly we could add as many rules as necessary to the Customer object to instruct //**Aware IM**// on what our system should do when a customer is registered or updated. See the [[docs:2000_concepts:0800_data_processing:0100_rule_evaluation|Rule Evaluation]] section for details on how rules work. |
| |
| Next we will define a query, also called "Customer", to allow staff members to find a particular customer. Queries are used in //**Aware IM**// to find information of interest in the system (see the "[[docs:2000_concepts:0600_data_retrieval|Data Retrieval]]" section for more on queries). This simple query will find and display all Customer objects with names containing text entered by the user and sorted by customer's name. To add the query select the "Queries" item in the tree under version 1.1 and choose the "New" command from the application toolbar. The query editor appears in the working area. Enter 'Customer' as the name of the query (using the Name property), select Customer business object from the drop down of business objects in the "What to look for" section of the editor and enter a condition in the ''Where'' section as follows: | Next we will define a query, also called "Customer", to allow staff members to find a particular customer. Queries are used in //**AwareIM**// to find information of interest in the system (see the "[[docs:2000_concepts:0600_data_retrieval|Data Retrieval]]" section for more on queries). This simple query will find and display all Customer objects with names containing text entered by the user and sorted by customer's name. To add the query select the "Queries" item in the tree under version 1.1 and choose the "New" command from the application toolbar. The query editor appears in the working area. Enter 'Customer' as the name of the query (using the Name property), select Customer business object from the drop down of business objects in the "What to look for" section of the editor and enter a condition in the ''Where'' section as follows: |
| |
| |
| * Find Customer. This operation will allow staff members to find registered customers. | * Find Customer. This operation will allow staff members to find registered customers. |
| |
| The menu, as well as many other details related to screen layout and visual settings, can be configured in the visual perspective editor (see the "[[docs:2000_concepts:0300_ui:0100_vp|Visual Perspective]]" section for more information on visual perspectives). Expand the item 'Visual Perspectives' in the tree under version 1.1 and double click on the item named "Administrator". This is the visual perspective provided by //**Aware IM**// for the system with default settings. Expand the 'Top Bar' entry in the table to show the menu of the system. Click on the 'Menu' entry in the tree and then click on the icon to add a new menu item. In the dialog that appears enter 'New Customer' as the name of the new item and click on the Details button next to the Command to execute entry. Select the 'Create Object' as the item type and tick the Customer object as the parameter of the command. Click OK twice to submit the dialogs. The new menu item appears in the table. | The menu, as well as many other details related to screen layout and visual settings, can be configured in the visual perspective editor (see the "[[docs:2000_concepts:0300_ui:0100_vp|Visual Perspective]]" section for more information on visual perspectives). Expand the item 'Visual Perspectives' in the tree under version 1.1 and double click on the item named "Administrator". This is the visual perspective provided by //**AwareIM**// for the system with default settings. Expand the 'Top Bar' entry in the table to show the menu of the system. Click on the 'Menu' entry in the tree and then click on the icon to add a new menu item. In the dialog that appears enter 'New Customer' as the name of the new item and click on the Details button next to the Command to execute entry. Select the 'Create Object' as the item type and tick the Customer object as the parameter of the command. Click OK twice to submit the dialogs. The new menu item appears in the table. |
| |
| To configure the 'Find Customer' operation, select the 'Menu' entry and click on the icon to add another menu item. Enter 'Find Customer' as the item name and select 'Run Query' as the command type. Select the "Customer" query as the parameter of the "Run Query" command. Click on the "OK" button twice to save the changes to the menu and then click on the "Save" button in the application toolbar to save changes to the visual perspective. | To configure the 'Find Customer' operation, select the 'Menu' entry and click on the icon to add another menu item. Enter 'Find Customer' as the item name and select 'Run Query' as the command type. Select the "Customer" query as the parameter of the "Run Query" command. Click on the "OK" button twice to save the changes to the menu and then click on the "Save" button in the application toolbar to save changes to the visual perspective. |
| Let us now add a few configuration elements to prepare the system for sending birthday greeting e-mails. | Let us now add a few configuration elements to prepare the system for sending birthday greeting e-mails. |
| |
| The personalized greeting e-mail is configured as a notification that we will call ''BirthdayEmail''. In //**Aware IM**// notifications are used to send messages to people or other software systems via different channels. The content of notifications is held in attributes, like those of business objects (see the "[[docs:2000_concepts:0900_prod_feats:0300_comm_with_other_systems|Communication with Other Systems]]" section for more details on notifications). Some channels expect certain attributes from notifications sent through the channels. Since we are going to send ''BirthdayEmail'' via the e-mail channel, it should have the following two attributes: | The personalized greeting e-mail is configured as a notification that we will call ''BirthdayEmail''. In //**AwareIM**// notifications are used to send messages to people or other software systems via different channels. The content of notifications is held in attributes, like those of business objects (see the "[[docs:2000_concepts:0900_prod_feats:0300_comm_with_other_systems|Communication with Other Systems]]" section for more details on notifications). Some channels expect certain attributes from notifications sent through the channels. Since we are going to send ''BirthdayEmail'' via the e-mail channel, it should have the following two attributes: |
| |
| * ''Subject'': Plain Text – used as the email subject line | * ''Subject'': Plain Text – used as the email subject line |
| * ''Message'': Plain Text – used as the email body | * ''Message'': Plain Text – used as the email body |
| |
| Unlike business objects, users do not enter the contents of notifications on the screen. Instead, it can be either set upfront or added dynamically by rules. For the BirthdayEmail notification we are going to initialize the required attributes with some contents that //**Aware IM**// can personalize before the e-mail is sent to a customer. | Unlike business objects, users do not enter the contents of notifications on the screen. Instead, it can be either set upfront or added dynamically by rules. For the BirthdayEmail notification we are going to initialize the required attributes with some contents that //**AwareIM**// can personalize before the e-mail is sent to a customer. |
| |
| |
| |
| |
| The tag enclosed in the angle brackets in the first line contains the name of an attribute that //**Aware IM**// will use to replace the tag when the notification is constructed, thereby personalizing the text (see the "[[docs:2000_concepts:0900_prod_feats:0200_working_with_docs_reports:0200_doc_gen|Document Generation]]" section for details on working with tags). Click on the "Create" button to save the notification. | The tag enclosed in the angle brackets in the first line contains the name of an attribute that //**AwareIM**// will use to replace the tag when the notification is constructed, thereby personalizing the text (see the "[[docs:2000_concepts:0900_prod_feats:0200_working_with_docs_reports:0200_doc_gen|Document Generation]]" section for details on working with tags). Click on the "Create" button to save the notification. |
| |
| |
| |
| |
| Now we need to bring together the parts that find birthday customers and send greetings to them. In //**Aware IM**// this is done using processes, which are usually configured as a sequence of rules (more information on processes can be found in the "[[docs:2000_concepts:0200_basics:0300_processes_link_ui_business_logic|Processes as Links between User Interface and Business Logic]]" section. We will call the process ''CongratulateBirthdayCustomers'', and it will contain the following two rules: | Now we need to bring together the parts that find birthday customers and send greetings to them. In //**AwareIM**// this is done using processes, which are usually configured as a sequence of rules (more information on processes can be found in the "[[docs:2000_concepts:0200_basics:0300_processes_link_ui_business_logic|Processes as Links between User Interface and Business Logic]]" section. We will call the process ''CongratulateBirthdayCustomers'', and it will contain the following two rules: |
| |
| <code aim>FIND 'Birthday customers' | <code aim>FIND 'Birthday customers' |
| To configure this process select the "Processes" item in the tree under version 1.1 and choose the "New" command from the application toolbar. The process editor appears in the working area. Enter 'CongratulateBirthdayCustomers' as the process name in the list of process properties and click on the icon to add a new rule. Enter the name of the new rule and then enter the two lines above into the light yellow-colored cells in column Action 1 on the right as actions for Rule 1 and Rule 2 respectively. Note that both rules have no conditions. Click on the "Save" button to save the process. | To configure this process select the "Processes" item in the tree under version 1.1 and choose the "New" command from the application toolbar. The process editor appears in the working area. Enter 'CongratulateBirthdayCustomers' as the process name in the list of process properties and click on the icon to add a new rule. Enter the name of the new rule and then enter the two lines above into the light yellow-colored cells in column Action 1 on the right as actions for Rule 1 and Rule 2 respectively. Note that both rules have no conditions. Click on the "Save" button to save the process. |
| |
| The last element we need to configure is a scheduling rule instructing //**Aware IM**// to start our process on a daily basis, say at 7 o'clock in the morning (see the "[[docs:2500_config_apps:2100_scheduling|Scheduling]]" section for details on how the scheduling works). Click on the "Scheduling" item in the tree under version 1.1 and choose the "New" command from the application toolbar. The scheduling rule editor comes up. Click on the icon to enter a new rule and enter 'Greet customers' as the rule name. The entry for the rule will appear in the list. Select the 'Daily' radio button in the 'Recurrence pattern' section of the rule editor, select the ''CongratulateBirthdayCustomers'' process in the "Actions" section and enter 07:00 as the start time. Click on the "Save" button to save the scheduling rule. | The last element we need to configure is a scheduling rule instructing //**AwareIM**// to start our process on a daily basis, say at 7 o'clock in the morning (see the "[[docs:2500_config_apps:2100_scheduling|Scheduling]]" section for details on how the scheduling works). Click on the "Scheduling" item in the tree under version 1.1 and choose the "New" command from the application toolbar. The scheduling rule editor comes up. Click on the icon to enter a new rule and enter 'Greet customers' as the rule name. The entry for the rule will appear in the list. Select the 'Daily' radio button in the 'Recurrence pattern' section of the rule editor, select the ''CongratulateBirthdayCustomers'' process in the "Actions" section and enter 07:00 as the start time. Click on the "Save" button to save the scheduling rule. |
| |
| The configuration work for our application is done. | The configuration work for our application is done. |