View source for Details Component: Display rules

=What Are Display Rules?=
* Display rules allow you to conditionally '''hide, read, and require''' slots on a '''details component'''.

=How To Create A Display Rule=
First, go to the page or record you have a '''details component''' attached.
<br>
Then click the '''Customize Page''' button at the bottom of your bundles navigation side-bar.
[[File:DisplayRules 1.jpg|thumb|center|Example incident record with details component]]

Select '''details''' from the list, then select the '''Edit page attributes''' button:
[[File:DisplayRules 2.jpg|thumb|center|Select 'details' then the 'Edit page attributes' button]]

A slide-out '''Edit Details''' will appear. Here you can see the existing display rules and add new display rules.

[[File:DisplayRules 3.jpg|thumb|center]]

Click on the add record button (+ sign), then a new slide-out will open:

[[File:DisplayRules 4.png|thumb|center|Adding a new display rule slide-out]]

Enabling a display rule will default to '''A Display Rule: Always'''. Switching it to '''any other slot''' will present a '''conditions input'''.
<br>
As an example, I am only going to show the impact level if it is not low impact:
[[File:DisplayRules 5.png|thumb|center|Will not display 'Impact' if it is 'Low']]
To build on this condition, click the + sign on the right side of the condition:
[[File:DisplayRules 6 new.png|thumb|center|Hide slot 'Impact' if 'Impact' is 'Low' and if 'Title' contains 'test']]
Stacking conditions this way will have them be linked by an '''"and"''' logic. To make "or" statements, make a new grouping:
[[File:DisplayRules 7.png|thumb|center|Hide 'Impact' if [Impact is Low, Title contains test] OR [Impact is Medium]]]

Now lets see this display rule in action:
If (Impact is Low and Title contains test) '''OR''' If (Impact is Medium)
<br> When creating a new Incident record, the slot '''Impact''' is present. When changing the '''Title''' slot to 'test' and the Impact level to '''Low''', it will not show up on the form:
[[File:ExampleDisplayRuleCreatingIncident.mp4|thumb|center|Impact becomes hidden because it was set to 'Low' and Title contained 'test']]
When on an existing Incident record:
[[File:ExampleDisplayRuleExistingIncident.mp4|thumb|center|Impact becomes hidden because it was set to 'Medium']]
= Deleting A Display Rule =
First, go to the page or record you have a '''details component''' attached.
<br>
Then click the '''Customize Page''' button at the bottom of your bundles navigation side-bar.
[[File:DisplayRules 1.jpg|thumb|center|Example incident record with details component]]

Select '''details''' from the list, then select the '''Edit page attributes''' button:
[[File:DisplayRules 2.jpg|thumb|center|Select 'details' then the 'Edit page attributes' button]]

A slide-out '''Edit Details''' will appear. Here you can see the existing display rules. Next to them should be a trashcan symbol:

[[File:DisplayRules 3.jpg|thumb|center]]

Clicking on the '''trashcan symbol''' will '''delete the display rule''', but it is still '''recoverable''' if you press on the '''refresh symbol''' next to a deleted display rule. '''Once you exit this slide-out, you will no longer have the option to recover the deleted display rule.'''

= Types of Display Rules =
* Hidden - Slot is no longer visible on record, but exists on it
* Readonly - Slot is no longer writable to
* Mandatory - Slot is now required to be filled with information (can't be left blank)