Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision		 Previous revision
docs:2000_concepts:0200_basics:0600_business_object_groups [2022/08/25 00:00] – ↷ Page moved from 2000_concepts:0200_basics:0600_business_object_groups to docs:2000_concepts:0200_basics:0600_business_object_groups administratordocs:2000_concepts:0200_basics:0600_business_object_groups [2025/06/12 02:09] (current) – Rename to AwareIM aware_support3
Line 1: Line 1:
 +{{tag>business_object_group business_object concepts}}
 [<10>] [<10>]
 ====== Business Object Groups ====== ====== Business Object Groups ======
  
-//Business object groups// in **//Aware IM//** offer you a simple and convenient way to handle similar yet different data. +//Business object groups// in //**AwareIM**// offer you a simple and convenient way to handle similar yet different data. 
  
 Let us consider an application that registers client communication history, such as meetings, phone calls, letters, e-mails, etc. A summary of the history should be presented as a chronological list on the client form. The user should be able to see full details of any list item on a separate form. Let us consider an application that registers client communication history, such as meetings, phone calls, letters, e-mails, etc. A summary of the history should be presented as a chronological list on the client form. The user should be able to see full details of any list item on a separate form.
Line 12: Line 13:
 Another way of going about it could be to create separate business objects for different communication types, like ''Outgoing Emails'', ''Incoming Emails'', ''Outgoing Letters'', etc. Each of these objects would have its own data form. The trouble with separate objects is that it would be very difficult (if not impossible) to show records from separate objects in a single chronologically sorted list, say on a client form, or do a search across multiple objects. Another way of going about it could be to create separate business objects for different communication types, like ''Outgoing Emails'', ''Incoming Emails'', ''Outgoing Letters'', etc. Each of these objects would have its own data form. The trouble with separate objects is that it would be very difficult (if not impossible) to show records from separate objects in a single chronologically sorted list, say on a client form, or do a search across multiple objects.
  
-With the solution that //**Aware IM**// offers you would create separate business objects for different communication types, like ''OutgoingEmail'', ''IncomingEmail'', ''OutgoingLetter'', then create a business object group, say, called ''Communication'', and include all the specific objects as its members. This is all it takes.+With the solution that //**AwareIM**// offers you would create separate business objects for different communication types, like ''OutgoingEmail'', ''IncomingEmail'', ''OutgoingLetter'', then create a business object group, say, called ''Communication'', and include all the specific objects as its members. This is all it takes.
  
 Each member of a group usually contains attributes common to all other members. In the example above the common attributes would be the date when the communication was sent or received and the state of the communication. Each member would also have some specific attributes not found in other group members, for example, telephone number for telephone communication; e-mail address for e-mail communication etc. Each member of a group usually contains attributes common to all other members. In the example above the common attributes would be the date when the communication was sent or received and the state of the communication. Each member would also have some specific attributes not found in other group members, for example, telephone number for telephone communication; e-mail address for e-mail communication etc.
  
-Business object groups are treated in the same way as regular business objects - they can be used in business rules, queries, document templates, and they also appear in the list of available attribute types. So, we would simply add a [[2000_concepts:0200_basics:0400_reference_attributes|multiple reference attribute]] ''ContactHistory'' of type ''Communication'' to ''Client'' to display a list of communication records on the client form. When the user clicks on an item in the list, a form for the specific record will be automatically shown to the user. +Business object groups are treated in the same way as regular business objects - they can be used in business rules, queries, document templates, and they also appear in the list of available attribute types. So, we would simply add a [[docs:2000_concepts:0200_basics:0400_reference_attributes|multiple reference attribute]] ''ContactHistory'' of type ''Communication'' to ''Client'' to display a list of communication records on the client form. When the user clicks on an item in the list, a form for the specific record will be automatically shown to the user. 
  
 Business object groups are useful in the following scenarios: Business object groups are useful in the following scenarios:
  
-  - Business object groups can be used in queries to search the system for objects of different types based on the criteria that use common attributes of the group – see [[2000_concepts:0600_data_retrieval:0000_start|Data Retrieval]]. +  - Business object groups can be used in queries to search the system for objects of different types based on the criteria that use common attributes of the group – see [[docs:2000_concepts:0600_data_retrieval|Data Retrieval]]. 
   - Business object groups can be referred to by reference attributes as shown in the above example – the ''ContactHistory'' attribute on the ''Client'' object refers to a group rather than to a particular object.   - Business object groups can be referred to by reference attributes as shown in the above example – the ''ContactHistory'' attribute on the ''Client'' object refers to a group rather than to a particular object.
-  - Business object groups can be used in business rules – again in this case rules may only use common attributes of the group. For example consider the following rules:<code>FIND Communication WHERE  +  - Business object groups can be used in business rules – again in this case rules may only use common attributes of the group. For example consider the following rules:<code aim>FIND Communication WHERE Communication.SentDate = CURRENT_DATE 
-    Communication.SentDate = CURRENT_DATE + Communication.State = 'SENT' </code>
-Communication.State = 'SENT'</code>+
  
  
 Here the second rule would set the value of the state attribute of any communication object found by a query irrespective of its type. Here the second rule would set the value of the state attribute of any communication object found by a query irrespective of its type.
  
-<note tip>If business rules attached to different members of a group are exactly the same it is better to use group names in the rules rather than names of a particular group member. In this case changes made to a rule attached to one member will be automatically transferred to the equivalent rules attached to other members – see also [[2500_config_apps:0800_add_edit_rules:0000_start|Adding/Editing Rules]].</note>+<callout type="tip" icon="true" title="tip">If business rules attached to different members of a group are exactly the same it is better to use group names in the rules rather than names of a particular group member. In this case changes made to a rule attached to one member will be automatically transferred to the equivalent rules attached to other members – see also [[docs:2500_config_apps:0800_add_edit_rules|Adding/Editing Rules]].</callout>
  
-Configuration of business object groups is explained in the [[2500_config_apps:1000_add_edit_bogs|Adding/Editing Business Object Groups]] section.+Configuration of business object groups is explained in the [[docs:2500_config_apps:1000_add_edit_bogs|Adding/Editing Business Object Groups]] section.
  
  
  
  • Last modified: 2022/09/13 18:07