Working with Object Matching and Related Items

this topic describes how to use object matching to configure a related items search object matching determines the items that are listed in the related items pane object matching is a type of search that allows you to search other business objects while inside a form the search can originate from a field on a form that has an associated search icon an example is the summary field on the details tab for an incident the application displays the results in the related items pane (refer to using related items and object matching docid\ lhjtw6bon4y z3jczkdok ) summary search when you enter a search phrase into the search text box in the search results panel and start the search search box the application ranks the business objects that match the search criteria by how closely they match the current business object the application lists these matching business objects in the search results panel in the form of the current business object the incident , knowledge , and problem business objects have object matching enabled by default when the application searches business objects, the object matching function performs a microsoft sql full text search in all full text indexed fields in the business object tables the microsoft sql engine also ranks the business objects viewing object matching lists the object matching lists workspace lists all of the business objects that use object matching from the configuration console, click build > automation tools > object matching lists to open the object matching lists workspace the application displays a list of object matching business objects open an item from the list to view the object matching parameters creating an object matching configuration follow these steps to create a new object matching configuration from the configuration console, go to build > business objects to open the business objects workspace open the business object to configure object matching for click the layouts tab the application displays a list of all the layouts used for this business object list of layouts determine the layout to use refer to determining the layout to use for an object matching configuration docid\ bd1uox58y rpvlr33t5su to determine which layout to use open the layout the application opens the edit layout workspace under the views in this layout section, click formview to open the form view of the layout (optional) click try our new look! to go to the new for view editor in the layout section, click edit properties the application displays the form view properties editor dialog box check enable matching panel the application displays the business object matching for the layout name layout dialog box business object matching for the layout name dialog box enter information into the following fields field description display name the name of this object matching display run business object matching whenever the field changes the field on which to run object matching choose a field name from the drop down list match keywords from business object 's field the field on which to match keywords choose a field name from the drop down list object name the name of the business object to enable object matching for choose a business object name from the drop down list click edit preview (not set) or edit preview to set the preview format preview item format the next step determines where the information for the object matching panel comes from the business object that you selected in the previous step determines your choices in the next step enter information into the following fields field description title field the title choose from the drop down list preview text field the preview text to display number of preview lines to show the number of preview lines to display select from 1 to 10 highlight matching text in the preview highlights the matching text in the preview form for hover panel the form to display when hovering when you search for a business object, the matching business object appears in the panel on the right side add buttons as needed, by following these steps a click add new button the application displays the create new button dialog box b in the button label field, enter a name for the button c check link matched business object with main business object # d click add field e select a field from the drop down menu f enter the name of a field to update the field with, such as owner, category, status, and service g click save in the preview item format page, click save add more business objects to search in by doing the following the order in which you add the business objects is the order in which these business objects are displayed in the related items panel to change the order of the business objects in the related items panel, delete the business objects and add them back in the order in which you want them to appear a in the search for matches in section, click the add icon b select a business object from the object name drop down list c click edit preview (not set) to set the preview format d enter information into the fields and create buttons as needed in the example below, the user added the knowledge, document, error message, patch, q\&a, and reference business objects to the list of places to search for adding business objects to be searched in in the business object matching for the layout name layout dialog box, click save in the form view properties editor page, click save click save to save the layout editing an existing object matching configuration after you create the object matching configuration, you can edit it from the configuration console, go to build > automation tools > object matching lists the application displays a list of all of the object matching configurations that have been created click an object matching configuration to edit it determining the layout to use for an object matching configuration determine the layout to use by doing the following from the configuration console, click configure > users and permissions > roles and permissions to open the roles and permissions workspace click self service to select the self service role the application displays the role details page click the top level tabs tab the application displays all of the workspaces that appear in the application for this role from the list of top level tabs, click the name of the tab to configure object matching for for example, click my items my items top level tab configuration under the my items configuration section, next to a business object name, click configure if you do not see a list of business object names with the word configure next to them, you cannot create an object matching configuration for this workspace object matching configurations are mostly used for the my items and search workspaces, but can be used on other workspaces the application displays the select business object name objects layout dialog box showing the layouts that are being used list of layouts for this object matching configuration select a layout to configure object matching for click cancel