Example: Highlighting Certain Incidents in a List

this example explains how to highlight incidents in a list where the incident or a child business object has been modified by someone who is not the owner this lets the owner quickly see where there is something they need to review this procedure involves several steps creating a quick action for the incident business object docid\ s s7ujcygnnegt7ebyt3screating the triggered action business rule on the child business objects docid\ s s7ujcygnnegt7ebyt3screating a formatting style docid\ s s7ujcygnnegt7ebyt3screating the list formatting rule docid\ s s7ujcygnnegt7ebyt3s creating a quick action for the incident business object this example creates a quick action on the incident business object to update the appropriate fields (such as lastmodby and optionally lastmoddatetime ) see creating a new quick action with creating a new quick action docid 2wq6ihun2zxir21ea3m7g or using the classic action designer (cad) docid 6uzt0q86wu3yk3cxzjoar log in to open the incident workspace from the action menu, choose edit actions the application displays the quick action editor under create new actions , click update object enter information into the fields field description enter action name force update lastmodx enter action description quick action for highlighting incidents enter category assign a category as needed field name from the drop down list, select lastmodby field value enter $(currentuserdisplayname()) field name from the drop down list, select lastmoddatetime field value enter $(currentdatetime()) to add additional field names and values, click the add icon click save update lastmodx quick action close the quick action editor and test the quick action creating the triggered action business rule on the child business objects this procedure describes how to create business rules on each of the child business objects to run the quick action on an incident when a record is created or updated from the configuration console, click build > business objects to open the business objects workspace open the business object called task assignment click the business rules tab expand the triggered actions header and click add trigger enter a unique name for the triggered action business rule, such as incidenttaforceupdatelastmodx choose events (for example, on initialize, on insert, on update), add any applicable values, and click next select configure new action and select run for child from the drop down list click next in the child object and relationship field, select incidentassoctaskassignment in the action to run field, select the quick action that you created previously, such as force update lastmodx click save test the business rule in all use cases repeat these steps for each child business object to affect the row highlighting creating a formatting style from the configuration console, click build > user interface styles > highlighter styles to open the highlighter styles workspace click add new\ the application displays the new style workspace enter a name and description for the style drag and drop any styles to format for example, drag the border color property onto the dynamic style definition area, then from the value drop down list, select light yellow (#ffff99) example highlighter styles click save creating the list formatting rule from the configuration console, click build > business objects to open the business objects workspace open the incident business object click the layouts tab the application displays a list of layouts select the layout to apply the format to, ensuring that it is related to the appropriate role for example, select incidentlayout servicedesk click gridview to open the form in the list view editor click edit (next to add new list ) to modify the list list view editor the application only applies styles to the columns that are defined in the list, so add any additional fields as columns to the list, if they are missing for this example, we want to highlight the lastmodby and lastmoddatetime fields, so ensure that both of these fields are displayed as column headers on the list adding the lastmodby field to the list layout while the column is highlighted, on the right, from the style field, select the new style that you created in creating a formatting style docid\ s s7ujcygnnegt7ebyt3s click save test the rule in your incident workspace whenever anyone modifies an incident or an affected child business object of the incident, the application updates the lastmodby field of the incident if the value of the lastmodby field is not the same as the value of the owner field, the application highlights it list highlight results