You can customize the recent items list in your application by changing the content, style, or the number of items on the list.
The pxRecent section, which you included in your application to display the recent items list, is a final rule and cannot be modified. It contains the pxRecentGrid section, also a final rule, which has a table layout, defines how the recent items list is displayed, and refers another section for displaying a recent items label. To customize the recent items list, complete the following steps:
Save a copy of the pxRecent and pxRecentGrid sections in your ruleset.
Enter pxRecent in the Dev Studio Search bar, and then press Enter.
In the Search results, select the pxRecent section.
In the pxRecent section, click Save as.
Enter a label for the new section. The label cannot start with px, py, or pz.
Specify the Applies To class and ruleset into which you want to save the section.
Click Create and open.
Click Save to save the section.
Repeat steps a through g for the pxRecentGrid section.
Replace the original pxRecentGrid section in your copy of pxRecent section.
Open your copy of the pxRecent section.
Click the Gear icon in the Section Include layout header of the pxRecentGrid section to open the Layout Properties panel.
In Section field on the General tab, enter the name of your copy of the pxRecentGrid section.
Click Save to save a section.
Ensure that your copy of the pxRecent section is configured to automatically refresh whenever a new item is added to the recent items list, deleted from the list, or updated.
In the copy of the pxRecent section, click the Gear icon in the Section Include layout header of the pxRecentGrid section to open the Layout Properties panel.
Ensure that Declare_pzRecentsCache.pxUpdateDateTime is entered in the Refresh condition field.
Replace the original pxRecent section that is included in your section that displays the recent items list.
Open your section that displays the recent items list.
Click the View properties icon of the cell in the section to open the Cell Properties panel.
In the Section field on the General tab, enter the name of your copy of the pxRecent section.
Click Save to save a section.
You can modify your copy of the pxRecentGrid section in the following ways:
- Customizing the content of the list of recent items
By default, items in the Work- and Rule- classes are displayed in the recent items list. However, you can choose to display only rules or only work items in the recent items list.
- Modifying the number of items in the recent items list
By default, the recent items list displays the 20 most recently accessed items. You can customize the recent items list and modify the number of items that it displays.
- Changing the style of the recent items list
You can customize the recent items list and change the list style, for example, you can change the font size or define a border.
- Customizing the data and label that are displayed on the recent items list
To change the information that is displayed on the list of recent items at run time, for example, to add new fields, create a copy of the label section, pxRecentLabel, and modify it.
- Displaying a list of recent items in your application
You can display a list of the most recently accessed cases, rule or data instance records, Create New and Save As forms, landing pages, wizard items, and instance lists in your application. Displaying a list of recent items gives your application users a quick way to view and open recent items.