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
2500_config_apps:0700_add_edit_attributes:0500_ref_attrib [2026/08/13 00:55] – ↷ Page moved from docs:2500_config_apps:0700_add_edit_attributes:0500_ref_attrib to 2500_config_apps:0700_add_edit_attributes:0500_ref_attrib localdev2500_config_apps:0700_add_edit_attributes:0500_ref_attrib [2026/08/13 01:10] (current) – external edit 127.0.0.1
Line 15: Line 15:
 {{  docs:images:reference_grid_with_html_header.png?nolink&600 }} {{  docs:images:reference_grid_with_html_header.png?nolink&600 }}
  
-The instances of the objects related to the instance currently being edited are shown in a table where each row represents an instance of a related object. Table columns show values of certain attributes of the related objects (which attributes will be shown can be defined at the configuration stage – see [[docs:2500_config_apps:0700_add_edit_attributes:0500_ref_attrib#Presentation_Options_for_References|Presentation Options for References]]).+The instances of the objects related to the instance currently being edited are shown in a table where each row represents an instance of a related object. Table columns show values of certain attributes of the related objects (which attributes will be shown can be defined at the configuration stage – see [[2500_config_apps:0700_add_edit_attributes:0500_ref_attrib#Presentation_Options_for_References|Presentation Options for References]]).
  
-The buttons in the rightmost columns of each row allow performing operations with the related instance represented by a particular row. The list of operations is configurable – see [[docs:2500_config_apps:0700_add_edit_attributes:0500_ref_attrib#Presentation_Options_for_References|Presentation Options for References]]. In the example above the''Edit'' operation represented by the “Edit” button brings up a form of a related business object. +The buttons in the rightmost columns of each row allow performing operations with the related instance represented by a particular row. The list of operations is configurable – see [[2500_config_apps:0700_add_edit_attributes:0500_ref_attrib#Presentation_Options_for_References|Presentation Options for References]]. In the example above the''Edit'' operation represented by the “Edit” button brings up a form of a related business object. 
  
 ===== Configuring References ===== ===== Configuring References =====
Line 33: Line 33:
 ====Create==== ====Create====
  
-The “Create” option is available if the new reference attribute is being created or the reference attribute represents the non-matching relationship. Selecting this option will create the matching attribute on the referred business object when changes to the current business object are saved. If you select the “Create” option you must also specify the name of the matching attribute on the referred object (the name must meet the requirements imposed on the attribute names – see [[docs:2500_config_apps:0700_add_edit_attributes:0100_common_props|Common Properties]]). If the referred object is a [[2000_concepts:0200_basics:0600_business_object_groups|business object group]] the matching attribute is created for all members of the group. You can also specify whether the matching attribute created will be "multiple allowed" or not.+The “Create” option is available if the new reference attribute is being created or the reference attribute represents the non-matching relationship. Selecting this option will create the matching attribute on the referred business object when changes to the current business object are saved. If you select the “Create” option you must also specify the name of the matching attribute on the referred object (the name must meet the requirements imposed on the attribute names – see [[2500_config_apps:0700_add_edit_attributes:0100_common_props|Common Properties]]). If the referred object is a [[2000_concepts:0200_basics:0600_business_object_groups|business object group]] the matching attribute is created for all members of the group. You can also specify whether the matching attribute created will be "multiple allowed" or not.
  
 ==== Existing ==== ==== Existing ====
Line 78: Line 78:
 ==== Grid widget ==== ==== Grid widget ====
  
-With this widget type referred instances are represented as a standard table (or grid) This is described in the [[docs:2500_config_apps:0700_add_edit_attributes:0500_ref_attrib:0100_table|Displaying References as a Table]] section.+With this widget type referred instances are represented as a standard table (or grid) This is described in the [[2500_config_apps:0700_add_edit_attributes:0500_ref_attrib:0100_table|Displaying References as a Table]] section.
  
 ==== Drop down widget ==== ==== Drop down widget ====
Line 120: Line 120:
 ==== Displayed columns ==== ==== Displayed columns ====
  
-By clicking on this property you can specify which attribute(s) of the referred object will be displayed in the drop down (usually just one). If you select more than one, they will be separated by spaces if you select the Standard style of display (the Standard radio button). If you select this radio button you can also optionnaly specify the custom template with which the data will be displayed - defining this template is similar to defining custom data template for custom query presentation – see [[docs:2500_config_apps:1100_add_edit_queries:0200_display_results|Displaying Query Results]]. The picture of a custom drop down that uses an image, a bold subject on the first line and the description on subsequent line is shown below:+By clicking on this property you can specify which attribute(s) of the referred object will be displayed in the drop down (usually just one). If you select more than one, they will be separated by spaces if you select the Standard style of display (the Standard radio button). If you select this radio button you can also optionnaly specify the custom template with which the data will be displayed - defining this template is similar to defining custom data template for custom query presentation – see [[2500_config_apps:1100_add_edit_queries:0200_display_results|Displaying Query Results]]. The picture of a custom drop down that uses an image, a bold subject on the first line and the description on subsequent line is shown below:
  
 If you select the “Multii-Column” style the combobox will be displayed with the header at the top that will show the names of the columns (just like a standard grid). Here you can also specify the widths of the columns, column labels and even the template of the data display. Displayed columns in a multi-column drop-down can include attributes of the Picture type. If you select the “Multii-Column” style the combobox will be displayed with the header at the top that will show the names of the columns (just like a standard grid). Here you can also specify the widths of the columns, column labels and even the template of the data display. Displayed columns in a multi-column drop-down can include attributes of the Picture type.
Line 152: Line 152:
 ===== Calendar widget===== ===== Calendar widget=====
  
-Choose this widget type if you want references to be displayed in a calendar-like fashion  (see [[2000_concepts:0700_data_presentation:0300_query_results_calendar|Calendar Form of Query Results]]). Note that only references of the [[docs:2500_config_apps:2700_appoint_objects|Appointment]] type can be presented in this manner. The settings you can specify are similar to the ones you specify when configuring a [[2000_concepts:0700_data_presentation:0300_query_results_calendar|Calendar Form of Query Results]].+Choose this widget type if you want references to be displayed in a calendar-like fashion  (see [[2000_concepts:0700_data_presentation:0300_query_results_calendar|Calendar Form of Query Results]]). Note that only references of the [[2500_config_apps:2700_appoint_objects|Appointment]] type can be presented in this manner. The settings you can specify are similar to the ones you specify when configuring a [[2000_concepts:0700_data_presentation:0300_query_results_calendar|Calendar Form of Query Results]].
  
 ===== Chart widget ===== ===== Chart widget =====
  
-Choose this widget type if you want references to be displayed as a chart (see [[docs:2500_config_apps:1100_add_edit_queries:0200_display_results|Displaying Query Results]]). The settings you can specify are the same as when configuring a chart.+Choose this widget type if you want references to be displayed as a chart (see [[2500_config_apps:1100_add_edit_queries:0200_display_results|Displaying Query Results]]). The settings you can specify are the same as when configuring a chart.
  
 ===== Custom list widget ===== ===== Custom list widget =====
  
-Choose this widget type if you want references to be displayed as a custom presentation of a query (see [[docs:2500_config_apps:1100_add_edit_queries:0200_display_results|Displaying Query Results]]). The settings you can specify are the same as when configuring custom presentation of a query.+Choose this widget type if you want references to be displayed as a custom presentation of a query (see [[2500_config_apps:1100_add_edit_queries:0200_display_results|Displaying Query Results]]). The settings you can specify are the same as when configuring custom presentation of a query.
  
 ===== Timeline widget===== ===== Timeline widget=====
  
-Choose this widget type if you want references to be displayed as a timeline of events – see the picture below. See also the [[docs:2500_config_apps:1100_add_edit_queries:0200_display_results:0500_timeline|Displaying Results as Timeline of Events]]+Choose this widget type if you want references to be displayed as a timeline of events – see the picture below. See also the [[2500_config_apps:1100_add_edit_queries:0200_display_results:0500_timeline|Displaying Results as Timeline of Events]]
  
 {{  docs:images:timeline_widget.png?nolink&600  }}  {{  docs:images:timeline_widget.png?nolink&600  }} 
Line 174: Line 174:
 <code aim>FIND Account WHERE Account.Status='Open' </code> <code aim>FIND Account WHERE Account.Status='Open' </code>
  
-<callout type="primary" icon="true" title="note"> using different filters you can display different referred instances of the same reference attribute. For example, you could show open accounts of a client on one form section and closed accounts on another form section – see [[docs:2500_config_apps:0500_add_edit_objects:0200_defining_forms:0300_form_add_sections|Adding/Editing Form Sections]].</callout>+<callout type="primary" icon="true" title="note"> using different filters you can display different referred instances of the same reference attribute. For example, you could show open accounts of a client on one form section and closed accounts on another form section – see [[2500_config_apps:0500_add_edit_objects:0200_defining_forms:0300_form_add_sections|Adding/Editing Form Sections]].</callout>
  
 ====Existing query==== ====Existing query====
  
-If you select the “Existing query” radio button you must select the existing query  (see [[docs:2500_config_apps:1100_add_edit_queries|Adding/Editing Queries]])+If you select the “Existing query” radio button you must select the existing query  (see [[2500_config_apps:1100_add_edit_queries|Adding/Editing Queries]])
  
 ====Custom query==== ====Custom query====
  
-If you select the “Custom query” radio button you must specify the query  – press the Edit button located next to this option and specify the query details – see [[docs:2500_config_apps:1100_add_edit_queries|Adding/Editing Queries]].+If you select the “Custom query” radio button you must specify the query  – press the Edit button located next to this option and specify the query details – see [[2500_config_apps:1100_add_edit_queries|Adding/Editing Queries]].
  
 Clicking on the attribute in the “Record Sorting” table allows sorting the list of references by the value of the attribute displayed in the column.  Clicking on the attribute in the “Record Sorting” table allows sorting the list of references by the value of the attribute displayed in the column. 
Line 188: Line 188:
 See also: See also:
  
-{{simplenavi>docs:2500_config_apps:0700_add_edit_attributes:0500_ref_attrib}}+{{simplenavi>.:0500_ref_attrib}}