Set up Related Items in legacy workspace
- UpdatedAug 3, 2023
- 6 minutes to read
- Vancouver
- Navigation and UI
Set up the items that are related to the open record so that agents can get a better understanding of the record and its impact.
Before you begin
Role required: admin
About this task
- Details—Fields from the open record. You can specify which fields appear.
- Related items—Components other than lists that are related to the open record. Typically, this tab shows the component. For example, you might create cards with record fields to appear in the form pane.
- Related lists—Lists that are related to the open record. These lists are
tables of records.
The following example shows an incident record. The Impacted Services related list shows a list of services that are impacted by this incident. The Child Incidents related list show incidents that are related to this one.
The highlighted section in this image is called the Related Items.
You set up related lists for each table. For example, the related lists that are displayed are the same for all incident records. The related lists that are displayed are the same for all case records but are likely different from those displayed for incident records.
Procedure
- Navigate to the table that you want to create a related list for. For example, in the navigation filter, enter Incident to set up related lists for all incident records.
- Click any of the records to open it.
-
Right-click the menu icon (
) and navigate to Configure > Related List.
- On the Configuring related lists form, move the fields that you want in the related lists section from the Available column to the Selected column.
- (Optional) Select a field in the Selected column and use the vertical arrow heads on the right to move the field in the list order.
- Click Save.
- (Optional)
Change the order of the items in the Related Items.
By default, Details appears on the left.
- Navigate to Workspace Experience > Forms > Workspace View Rules and click New.
-
On the form, fill in the fields.
Table 1. Workspace View Rule form Field Description Name Name for the order of lists in the Related Lists for all records in Table. Table Table that this order of lists pertains to. Whenever a record from this table opens, this form defines the order of the lists in related lists. View View that is shown when the conditions are met. Use Workspace. Application Application that this component applies to. Global means that the component applies to all applications. Workspace Workspace that this rule applies to. Active Toggle to turn on (selected) and off this rule. -
On the Conditions tab, specify the
role users must have and the record field
conditions that must be met for this reordering to appear.
For example, you can select the condition State is resolved.
-
To order the items in the Related Items, on the Form
Tabs tab, clear the Default Tab
Order check box, click the lock icon (
) next to Tab Order.
You can then reorder the items in the Related Items by selecting the lists that you want to move. Then, use the up and down arrow to move them. -
Click Submit unless you want to select which
item in the Related Items appears in the form pane when record view
opens.
If you do want to choose what appears in the form pane when record view opens, right-click the top banner, click Save, and proceed to the next step.
The following example shows that Details is no longer on the left.
- (Optional)
Specify which item in the Related Items appears in the form pane when record
view opens.
By default, the left-most item is in focus when a record opens. You can, however, put a different item in focus.
- Navigate to Workspace Experience > Forms > Workspace View Rules and click the workspace view rule that you want to edit.
- On the Form Tabs tab, open the Default Tab Focus list and select the item that should be in focus when an agent opens a record in the table that is specified in this rule.
-
Click Submit.
The following image shows that Impacted Services/CIs rather than the Affected CIs is in focus when the record opens.
- (Optional)
Automatically jump to a section in the form pane when conditions are met.
By default, when Details is in focus in the Related Items, the first section opens. You can, however, set conditions for the Details to open on a different section. Details usually displays many sections in the form pane that require scrolling to reach. If there is a typical work pattern for agents, you can save agents' time by automatically scrolling to the relevant section when conditions are met. For example, when the condition, State is On hold, is true, automatically scroll to the tenth section in Details because that is a section that agents need for their resolution notes.
- Navigate to Workspace Experience > Forms > Workspace View Rules and click the workspace view rule that you want to edit.
- On the Form Settings tab, click New.
-
On the form, fill in the fields.
Table 2. Workspace Default Form Section form Field Description Name Name of this configuration where a specified section in Details automatically appears instead of the first section. Order Sequential order this rule is evaluated in when there are multiple rules. The lower the Order value means that it's evaluated in the sequence sooner. Active Toggle that turns on this customization. Form Section Section of Details that opens in the form pane instead of the first section. - (Optional) In Conditions, add conditions that limit when the specified section in Form Section opens first.
- Click Submit.
- (Optional) Create an Add button so agents can add records to the related lists.
What to do next