Business Object Examples

The main incident layout contains an AttachmentA file or web URL reference linked to a record. child panel. This panel shows only the attachments directly linked to an incident record. You can define a roll-up relationship to show attachments linked to all changes associated with the incident.

1.

Within the Configuration Console, open the incident business object. (See Viewing Business Objects).

2.

From the toolbar, choose the Layouts tab, then open a layout from the list. For example, IncidentLayout.ServiceDesk. The layout editor appears.

3.

Click formview. The Form View Editor appears.

4.

In the Child Panels table, click an item under the Object column. The Child Panel Relationship Editor opens.

5.

Select Use only rollup relationships to grandchild object(s).

Child Panel Relationship Editor

6.

Click Add New Rollup Sequence. The Add New Rollup Chain window appears.

7.

Enter your information into the fields.

8.

Select the first interim relationship. In this example, select the Change (viaIncidentAssociatesChange) relationship.

9.

Click Add and select the second interim relationship, Attachment (via ChangeContainsAttachment).

10.

Click Save to close the Rollup Chain Editor. The rollup sequence appears in the relationship editor.

11.

Click Save to close the Child Panel Relationship Editor. The toolbar for the Child Panels table in the Attachments row now reads To Rollups Only.

You can add a separate child panel to the incident layout to display the attachments for all problems associated with the current incident.

1.

From the Layout Editor, add a new child panel to the incident layout called ProblemsAttachment.

2.

Define a rollup relationship without a direct relationship.

3.

Define a grid and form for the new child panel.

4.

Save the layout. From the new ProblemsAttachment tab, you can now select the associated problem's attachments from a drop-down menu on the toolbar.

Administrators can configure object search for any business object that is referenced as a link field selector in another business object. A link field is a field that allows you to link one business object to another. For example, the Profile.Employee business object is referenced in incident, change, and service request records as a link selector.

By setting up object search for the Profile.Employee business object, for example, the administrator can decide which fields will display in the search results list. For example, searching on an employee name can display the employee's name, login name, and email in the search list, which helps users select the correct employee in organizations where there are employees with the same name.

The administrator can also set up which fields users can use to search if they select the Advanced Search link from the list.

You can set two new properties on the link selector control to optimize performance in cases where searching with the link field returns a large number of results.

1.

Search for the business object for which you want to set up for object search.

2.

From the business object's Details page, click Object Search.

3.

Configure the Primary Display Fields that appear on the search results menu.

For example, on the Profile.Employee search settings page, the primary display fields are Full Name, Login ID, and Primary Email. These are the fields that the user sees when searching for an employee name when Profile.Employee appears as a link field on another business object.

Change the primary fields as needed:

Add additional fields as needed:

4.

Configure the Advanced Search Settings.

These fields will be available as additional fields for the user to search against.

The following shows the advanced search fields from the Employee link field as they appear on the client application:

Sample Advanced Search fields

5.

Click Save from the toolbar.

Optimize Performance of a Link Field Selector in a Form

You can set two new properties on the link selector control to optimize performance in cases where searching with the link field returns a large number of results.

For example, the Profile.Employee link field selector is used on the incident form. If you have a large number of employees with similar attributes, which might have been used in the search settings for Profile.Employee, you can set one or both of the following two control properties that have been added to the incident form layout:

• Use like search for autocomplete—does a like search only against the search strings entered. If this is set to true, then the results will be returned based on a like search against the contents of the field defined in the display name of the control.
• Do not sort autocomplete result—does not sort the search results if this is set to true.

In this use case, you can optimize search for the Profile.Employee link field selector, which is used in the incident details form.

1.

Open the Incident.DataEntry form.

2.

Select to activate the Customer field. This field is a Profile.Employee link field on the incident details form.

3.

In the Control Properties tab, set the one or both of the following control properties to true:

4.

Click Save from the toolbar.