Adding Related Business Object Lists to a Form

about adding related business object lists to a form docid\ obphkbk1hrnyyvf75doyuadding related business object lists to a form docid\ obphkbk1hrnyyvf75doyuexample using the related objects list docid\ obphkbk1hrnyyvf75doyuexample using flex settings to implement a visual indicator docid\ obphkbk1hrnyyvf75doyu about adding related business object lists to a form this control allows contents from related business objects to show on the master object form you can configure additional operations of related items allowable operations included are add new, edit, delete, link, and unlink you select the fields from the related business object that appears to users, define the format, and specify the sorting sequence of the displayed business objects specific formatting is provided for email, notes, and text messages adding related business object lists to a form from the configuration console, click build > business objects to open the business object workspace open a business object select the forms tab a list of forms for that business object appear select a form the form editor appears from the left control pane, expand other , then drag related objects list onto the form on the right side, highlight the words "related objects list" under the control properties tab, for the configuration value, select flex settings the related objects list window appears enter information into the fields field description related object the related object select from the drop down list sort by the field to sort by select it, then select the sort order from the second drop down list operations the operations to allow new edit delete link unlink flex height enables auto resizing of the selected content box see also maximum height, minimum height docid\ obphkbk1hrnyyvf75doyu dimensions of rows contained within the content box are controlled by the show items as width, height docid\ obphkbk1hrnyyvf75doyu multi select maximum height, minimum height the maximum and minimum height in pixels the minimum height is the smallest that the list or content box can appear the maximum height is the largest that the list or content can appear without scroll bars if the content exceeds the maximum height, the application displays scroll bars set these to allow for auto resize of the list or content box, then check flex height note if you check flex height , the application disables these choices and you cannot change them show items as width, height defines how the data is arranged select an option and then enter the width and height of each in pixels rows each item takes up an entire row and the list is displayed from top to bottom blocks each item takes up a certain amount of space and is displayed from left to right shrink to fit depending on the content, this option designates a height to the row, between values set for the height min and height max fields types the type of related object types vary according to the selected related item you can select multiple types, but must configure each type separately journal# journal#email journal#notes journal#remotecontrolsession journal#voiceactivity type configuration show as how the item appears on the form the default is generic this also affects which fields appear in this window click test to see a preview message user name includes the user name in the message message date includes the date in the message message time includes the time in the message text field the text field type choose from the drop down list, or choose none to not include an editable text field text display length the number of pixels for the width of the text field zero means the field does not appear show as html specifies if the related object list is shown as html highlight item click the action that occurs when the user clicks from the drop down list new/edit form the form displayed when the user clicks the edit icon the form can be edited and saved by the user saved searches the saved searches select from the drop down list, or choose none to not include a saved search show attach as available for business objects that can contain attachments (such as journal#email and journal remotecontrolsession) none no attachments will display link attachments display as links (recommended option) block a clip icon appears when there are associated attachments click the icon to display them attach relation displays the relationship to the attachment object the option is available if you selected link or block for the show attach as field attach display field displays the attachment link click save adjust other control properties as needed, then click save example using the related objects list this example shows how to show a list of knowledge articles associated with a specific incident from the configuration console, click build > business objects to open the business object workspace open the incident business object select the forms tab a list of forms for that business object appear select incident webselfservice new on the right side, select a field on the form for the flex list to appear below for example, highlight the summary field from the commands menu in the toolbar, choose insert > insert row below selection this gives you a place in which to put the flex list from the left control pane, expand other , then select related objects list related object list drag the control onto the form into the space you created highlight the words "related objects list" under the control properties tab, for the configuration value, click flex settings control properties flex settings from the related object drop down list, select incidentassocfrs knowledge for the show items as field, select rows under types , check frs knowledge# , then continue selecting data from the remaining fields click save click save view the form on the application to see the related objects list related objects list in example using flex settings to implement a visual indicator in release 2016 2, we introduced a new setting that allows you to add a visual indicator for a flex setting based on an expression this setting is currently used to configure the read and unread flags for journal notes and emails it marks those items with a blue bar that is located on the journal section of the parent form the following shows how to implement the visual indicator on the journal flex setting for an incident from the configuration console, click build > business objects to open the business object workspace open the incident business object select the forms tab the application displays a list of forms for that business object open the incident defaultform form, which is where the journal child business object is embedded click on the journal section on the right pane to select it the box around the property becomes visible and the options under the control properties tab in the left pane appear journal area of a form from the control properties tab on the left pane, for the configuration field, click flex settings the application displays the related objects list dialog box under types , highlight journal#email and ensure that it is checked selecting journal#email under type configuration \[journal#email] , click in the highlight field the application displays the expression editor enter $(isunread & parentowner == currentloginid()) and click save in the with style field, select a background color we recommend selecting bluelabel click save to exit the dialog box click save