Adorners

Use this table along with the ENPS Fields table to configure rules-based adorners, such as custom color-coding in rundown columns and rows. Such adorners are displayed as colored borders around the target column and/or rows.

Example use cases include:

• coloring a specific column according to the story's status

• coloring a specific cell according to a story's approval status and whether it has been signed off by an executive producer

• highlighting an entire row if a story needs to be checked by the legal department

Create an Adorner

Pre-requisites

You need full access to System Maintenance to create adorners. If you do not have access to System Maintenance, or only the staff management piece of System Maintenance, you will need to request adorners through your ENPS System Adminstrator or whoever else has full access to System Maintenance.

For a Rundown Column

Step 1 - Enable adorners for a column

First, set that a rundown column (field) can have adorners applied to it:

• If the field already exists in the Site Fields table in System Maintenance, tick the Adorner checkbox for that field and save the table.

• If it is a System Field, navigate to the System Fields table in System Maintenance, select the field and click the Override button. Open the Site Fields table where the field definition will now appear as an editable row. Tick the Adorner checkbox and save your changes.

Step 2 - Create rules

Next, create a rule(s) that defines how adorners are applied to the chosen rundown column (field):

1. In the System Maintenance > Adorners table, create a new entry and give it a suitable and unique ID.

2. Under System Maintenance > Adorner Location, select the field you configured a moment ago.

3. Next choose the color under the Color column.

4. In the Visibility Criteria column define the rules that will cause the color to be applied. See Settings for details.

5. Enter a value in Order to set the order in which multiple rules are evaluated.

If you have a separate Central Server, meaning your Primary Server is not your Central Server, you would now click NOM Maintenance > Sync now. If you relaunch the ENPS client and adorners are not showing up then consider reloading Global tables in News Object Manager (NOM).

For a Rundown Row

Rather than choosing a specific rundown column (field), you can choose to have the color applied to an entire row.

If so, follow the same instructions as in For a Rundown Column, but skip the section on setting up the column (field). When setting the rule, choose RO Row for the Adorner location.

Examples

Here are some example adorners that you may find useful, with detailed setup steps. Keep in mind that column names can be whatever suits your newsroom.

Story Status

Let’s say you want to color cells in a Story Status column depending on the status of the story.

Desired behavior:

• If a Story Status is Incomplete then the cell is given a yellow adorner.

• If a Story Status is Written then the cell is given a silver adorner.

• If a Story Status is Edited then the cell is given an orange adorner.

• If a Story Status is Approved then the cell is given a green adorner.

• If a Story Status is Embargoed then the cell is given a red adorner.

First, enable adorners for the Story Status column:

1. Open the local Fields table (not the System Fields table).

2. Tick the Adorner checkbox for the Story Status row.

   This allows adorners for the Story Status rundown column.

   Add the Story Status row first if it doesn't already exist.

3. Click Save.

Second, create adorner rules for the Story Status column:

1. Open the Adorners table.

2. Create a rule for when the Story Status is Incomplete, which colors the Story Status cell border yellow.

   

   To do so, add a new row in the Adorners table with the following values:

   ID	INCOMPLETE
   Adorner Location	Story Status
   Color	Yellow
   Visibility Criteria	StoryStatus='Incomplete'
   Order	0

3. Create a rule for when the Story Status is Written, which colors the Story Status cell border silver.

   

   To do so, add a new row in the Adorners table with the following values:

   ID	WRITTEN
   Adorner Location	Story Status
   Color	Silver
   Visibility Criteria	StoryStatus='Written'
   Order	1

4. Create similar rules for the Edited, Approved and Embargoed statuses.

   As these five rules affect the same column (Story Status), the Order value defines which rule is evaluated first.

   In our example, the INCOMPLETE rule has an Order of 0, the highest possible priority, so will be evaluated first. If its Visibility Criteria does not evaluate as true then the WRITTEN rule with an Order of 1 will be evaluated next. And so on for each rule.

5. Click Save.

If you have a separate Central Server, meaning your Primary Server is not your Central Server, you should now click NOM Maintenance > Sync now. If you relaunch the ENPS client and adorners are not showing up then consider reloading Global tables in News Object Manager (NOM).

Story Approval

Let’s say you want or already have a column called EP where your Executive Producer puts their initials when they approve a story. Let’s say you also have a 'final approval' column that already turns from red to green when ticked. We can create adorners that tie together the final approval column and the EP column.

Desired behavior:

• If the EP cell is empty it is not given an adorner.

• If the EP cell contains the Executive Producer's initials the cell is given a red adorner.

• If the EP cell contains the Executive Producer's initials and the Final approval checkbox is ticked, the cell is given a green adorner.

First, enable adorners for the EP column:

1. Open the local Fields table (not the System Fields table).

2. Tick the Adorner checkbox for the EP row.

   This allows adorners for the EP rundown column.

   Add the EP row first if it doesn't already exist.

3. Click Save.

Second, create adorner rules for the EP column:

1. Open the Adorners table.

2. Create a rule for when initials are entered/present in a rundown's EP column but there is no final approval, which colors the EP cell border red.

   

   To do so, add a new row in the Adorners table with the following values:

   ID	EPCHANGED
   Adorner Location	EP
   Color	Red
   Visibility Criteria	((EP!=null) AND (Approved!=true))
   Order	0

3. Create a rule for when initials are present in a rundown's EP column and the story has had final approval, which colors the EP cell border green.

   

   To do so, add a new row in the Adorners table with the following values:

   ID	EPNOTNULL
   Adorner Location	EP
   Color	Green
   Visibility Criteria	EP!=null
   Order	10

   As both rules affect the same column (EP), the Order value defines which rule is evaluated first.

   In our example, the EPCHANGED rule has an Order of 0, the highest possible priority, so will be evaluated first. If its Visibility Criteria does not evaluate as true then the EPNOTNULL rule with an Order of 10 will be evaluated next.

4. Click Save.

If you have a separate Central Server, meaning your Primary Server is not your Central Server, you should now click NOM Maintenance > Sync now. If you relaunch the ENPS client and adorners are not showing up then consider reloading Global tables in News Object Manager (NOM).

MOS Devices

The ability to create adorners based on MOS devices will be introduced in a future version of ENPS.

Settings

Setting	Description
ID	Unique name for the Adorner
Adorner Location	Where the colour should be applied. Options that relate to ENPS are 'RO Row' and any field that has been defined as an Adorner.
Color	Adorner color. Choose a colour from the colour wheel.
Icon	In Storytelling, a built-in icon to show as the adorner.
Icon URL	In Storytelling, an external icon to show as the adorner.
Visibility Criteria	The rule that must be True to activate the Adorner, e.g. FieldID='SomeDesiredValue'. The value being evaluated must be encapsulated within apostrophes ('), unless the value is a null. For example: ScriptStatus='Ready' Null values can be evaluated by using the word null with no apostrophes ('). For example: ScriptStatus=null Checkbox fields are either True or False, and multiple operators can be combined using AND and OR. An example might be: ScriptStatus='Ready' AND VideoApproved=True. Additional comparison operators are available, which operate based on text comparisons of the value (not dates or other complex type object comparisons): Operator Description > More than. It will compare if the first value is more than the second value. If one or both values are text they will be compared alphabetically. < Less than. It will compare if the first value is less than the second value. If one or both values are text they will be compared alphabetically. >= More than or equal to. It will compare if the first value is more than or equal to the second value. If one or both values are text they will be compared alphabetically. <= Less than or equal to. It will compare if the first value is less than or equal to the second value. If one or both values are text they will be compared alphabetically. = Equal to. It will compare if the first value is equal to the second value. != Not Equal to. It will compare if the first value is NOT equal to the second value.
Order	Priority of rules should more than one Adorner be defined for the same column/row.