Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
3400_how_to:0100_awareim_basics [2026/08/13 07:33] – Imported by DokuWiki Advanced Plugin aware_support33400_how_to:0100_awareim_basics [2026/08/13 07:43] (current) – Imported by DokuWiki Advanced Plugin aware_support3
Line 4: Line 4:
  
 <anchor id="go_about_system_configuration"> <anchor id="go_about_system_configuration">
-<accordion-item title="go about system configuration" type="primary">+<accordion-item title="go about system configuration">
 We recommend that you follow these steps when configuring your application (the order of steps is essential): We recommend that you follow these steps when configuring your application (the order of steps is essential):
  
Line 19: Line 19:
  
 <anchor id="start_configuring_the_system"> <anchor id="start_configuring_the_system">
-<accordion-item title="start configuring the system" type="primary">+<accordion-item title="start configuring the system">
   - Start the Configuration Tool. If you have just installed //**AwareIM**// you will see your business space with two business space versions - one in the ''CURRENT'' state and another one in the ''NEW'' state – see the “[[2500_config_apps:0200_work_bsv:0100_bsv_lifecycle|Lifecycle of a Business Space Version]]” section.   - Start the Configuration Tool. If you have just installed //**AwareIM**// you will see your business space with two business space versions - one in the ''CURRENT'' state and another one in the ''NEW'' state – see the “[[2500_config_apps:0200_work_bsv:0100_bsv_lifecycle|Lifecycle of a Business Space Version]]” section.
   - Expand the node of the version in the ''NEW'' state (its number must be 1.1) and start defining business objects, business rules etc in the newly created version – see the “[[2500_config_apps:0300_work_config_elements|Working with Configuration Elements]]” section.   - Expand the node of the version in the ''NEW'' state (its number must be 1.1) and start defining business objects, business rules etc in the newly created version – see the “[[2500_config_apps:0300_work_config_elements|Working with Configuration Elements]]” section.
Line 27: Line 27:
  
 <anchor id="define_database_tables_and_database_columns"> <anchor id="define_database_tables_and_database_columns">
-<accordion-item title="define database tables and database columns" type="primary">+<accordion-item title="define database tables and database columns">
 In //**AwareIM**// you are not dealing with database tables or database columns. Instead of defining tables and columns you are defining business objects and their attributes (see the “[[2000_concepts:0200_basics:0100_business_objects_as_carriers_of_data|Business Objects as Carriers of Data]]” section).  In //**AwareIM**// you are not dealing with database tables or database columns. Instead of defining tables and columns you are defining business objects and their attributes (see the “[[2000_concepts:0200_basics:0100_business_objects_as_carriers_of_data|Business Objects as Carriers of Data]]” section). 
  
Line 34: Line 34:
  
 <anchor id="define_links_between_database_tables"> <anchor id="define_links_between_database_tables">
-<accordion-item title="define links between database tables" type="primary">+<accordion-item title="define links between database tables">
 In //**AwareIM**// you do not define links between database tables. //**AwareIM**// encourages you to think in terms of business objects and relationships between them rather than in terms of linking database tables through a particular column or creating special relationships tables.  In //**AwareIM**// you do not define links between database tables. //**AwareIM**// encourages you to think in terms of business objects and relationships between them rather than in terms of linking database tables through a particular column or creating special relationships tables. 
  
Line 47: Line 47:
  
 <anchor id="set_up_calculated_fields"> <anchor id="set_up_calculated_fields">
-<accordion-item title="set up calculated fields" type="primary">+<accordion-item title="set up calculated fields">
 To get //**AwareIM**// to calculate the value of an attribute of a business object you have to define a business rule that will perform the required calculation. The rule should be attached to the business object that owns the calculated attribute. See the “[[2500_config_apps:0800_add_edit_rules|Adding/Editing Business Rules]]” section. To get //**AwareIM**// to calculate the value of an attribute of a business object you have to define a business rule that will perform the required calculation. The rule should be attached to the business object that owns the calculated attribute. See the “[[2500_config_apps:0800_add_edit_rules|Adding/Editing Business Rules]]” section.
  
Line 59: Line 59:
  
 <anchor id="set_up_business_rules"> <anchor id="set_up_business_rules">
-<accordion-item title="set up business rules" type="primary">+<accordion-item title="set up business rules">
 Most business rules should be attached to business objects. The rules will be automatically evaluated when this object is created or modified. See the “[[2000_concepts:0200_basics:0200_business_rules_carriers_business_logic|Business Rules as Carriers of Business Logic]]” and “[[2500_config_apps:0800_add_edit_rules|Adding/Editing Business Rules]]” sections. Most business rules should be attached to business objects. The rules will be automatically evaluated when this object is created or modified. See the “[[2000_concepts:0200_basics:0200_business_rules_carriers_business_logic|Business Rules as Carriers of Business Logic]]” and “[[2500_config_apps:0800_add_edit_rules|Adding/Editing Business Rules]]” sections.
 </accordion-item> </accordion-item>
  
 <anchor id="test_the_configured_system"> <anchor id="test_the_configured_system">
-<accordion-item title="test the configured system" type="primary">+<accordion-item title="test the configured system">
 When you finish configuring your application (or part of it) you can test how the system will work before you deploy it for production use. To test the system you must make the business space version, containing the configuration you want to test, available for testing. To do this: When you finish configuring your application (or part of it) you can test how the system will work before you deploy it for production use. To test the system you must make the business space version, containing the configuration you want to test, available for testing. To do this:
  
Line 74: Line 74:
  
 <anchor id="deploy_the_configured_system"> <anchor id="deploy_the_configured_system">
-<accordion-item title="deploy the configured system" type="primary">+<accordion-item title="deploy the configured system">
 Any application configured with //**AwareIM**// is operated over the web using any web browser such as Internet Explorer or Firefox. Before the final application is deployed the business space version containing the application configuration needs to be published – see the “[[2500_config_apps:0200_work_bsv:0700_publishing_bsv|Publishing Business Space Version]]” section. Any application configured with //**AwareIM**// is operated over the web using any web browser such as Internet Explorer or Firefox. Before the final application is deployed the business space version containing the application configuration needs to be published – see the “[[2500_config_apps:0200_work_bsv:0700_publishing_bsv|Publishing Business Space Version]]” section.
  
Line 86: Line 86:
  
 <anchor id="create_records"> <anchor id="create_records">
-<accordion-item title="create records" type="primary">+<accordion-item title="create records">
 In //**AwareIM**// records are created in the operation mode. In //**AwareIM**// terminology creating a record is creating an instance of a business object. For users to be able to create instances of business objects the application must be configured to have the menu item of the “Create Object” type (see the “[[2500_config_apps:1500_add_edit_vp:0100_working_with_vp_editor:0500_defining_layout_of_content_panels:1100_setting_menu_item_props|Setting Menu Item Properties]]” section). When a user selects the menu item of this type in the Operation Mode the default form of the business object is displayed. When the user fills out the form and submits it, the instance of the business object is created in the system. In //**AwareIM**// records are created in the operation mode. In //**AwareIM**// terminology creating a record is creating an instance of a business object. For users to be able to create instances of business objects the application must be configured to have the menu item of the “Create Object” type (see the “[[2500_config_apps:1500_add_edit_vp:0100_working_with_vp_editor:0500_defining_layout_of_content_panels:1100_setting_menu_item_props|Setting Menu Item Properties]]” section). When a user selects the menu item of this type in the Operation Mode the default form of the business object is displayed. When the user fills out the form and submits it, the instance of the business object is created in the system.
  
Line 95: Line 95:
  
 <anchor id="edit_records"> <anchor id="edit_records">
-<accordion-item title="edit records" type="primary">+<accordion-item title="edit records">
 In //**AwareIM**// records are modified in the operation mode. In //**AwareIM**// terminology editing a record is editing an instance of a business object. In order to edit an instance of a business object the user has to find the instance first. This can be achieved by running a query – see [[3400_how_to:0100_awareim_basics]].  If a query displays its results in a standard manner the instance of a business object can be edited by pressing the Edit button (see the “[[2000_concepts:0700_data_presentation:0100_query_results_grid|Standard Form of Query Results]]” section). This will bring up a form of the business object so that the user can change the attribute values on this form and submit it.  In //**AwareIM**// records are modified in the operation mode. In //**AwareIM**// terminology editing a record is editing an instance of a business object. In order to edit an instance of a business object the user has to find the instance first. This can be achieved by running a query – see [[3400_how_to:0100_awareim_basics]].  If a query displays its results in a standard manner the instance of a business object can be edited by pressing the Edit button (see the “[[2000_concepts:0700_data_presentation:0100_query_results_grid|Standard Form of Query Results]]” section). This will bring up a form of the business object so that the user can change the attribute values on this form and submit it. 
  
Line 109: Line 109:
  
 <anchor id="look_for_records"> <anchor id="look_for_records">
-<accordion-item title="look for records" type="primary">+<accordion-item title="look for records">
 In //**AwareIM**// terminology looking for records is looking for instances of a business object. A user can find instances of a business object in the operation mode by running a query. There are several ways of running a query in the operation mode. See the “[[2000_concepts:0600_data_retrieval:0200_queries_op_mode|Running Queries in the Operation Mode]]” section for details. In //**AwareIM**// terminology looking for records is looking for instances of a business object. A user can find instances of a business object in the operation mode by running a query. There are several ways of running a query in the operation mode. See the “[[2000_concepts:0600_data_retrieval:0200_queries_op_mode|Running Queries in the Operation Mode]]” section for details.
 </accordion-item> </accordion-item>
  
 <anchor id="delete_records"> <anchor id="delete_records">
-<accordion-item title="delete records" type="primary">+<accordion-item title="delete records">
 In //**AwareIM**// terminology deleting records is deleting instances of a business object. To allow the user to delete instances of a business object in the operation mode either a process that finds an instance of a business object and uses the ''[[ref:a_f:a:delete|DELETE]]'' action to delete it, has to be configured (see the “[[2500_config_apps:0900_add_edit_processes|Adding/Editing Processes]]” section), or an operation of the Delete Object type has to be defined for the object (see the “[[Adding/Editing Form Menu]]” section). In //**AwareIM**// terminology deleting records is deleting instances of a business object. To allow the user to delete instances of a business object in the operation mode either a process that finds an instance of a business object and uses the ''[[ref:a_f:a:delete|DELETE]]'' action to delete it, has to be configured (see the “[[2500_config_apps:0900_add_edit_processes|Adding/Editing Processes]]” section), or an operation of the Delete Object type has to be defined for the object (see the “[[Adding/Editing Form Menu]]” section).
 </accordion-item> </accordion-item>
  
 <anchor id="change_default_database_used"> <anchor id="change_default_database_used">
-<accordion-item title="change default database used" type="primary">+<accordion-item title="change default database used">
 Select “Database” from the Settings menu in the //**AwareIM**// Control Panel. In the Database Settings dialog choose the database engine you want. Set the properties of the database engine. Click OK and restart //**AwareIM**//. Select “Database” from the Settings menu in the //**AwareIM**// Control Panel. In the Database Settings dialog choose the database engine you want. Set the properties of the database engine. Click OK and restart //**AwareIM**//.
 </accordion-item> </accordion-item>