Checklist Pro

How Does Checklist Pro Do It?

Written by Ty Roach | Nov 2, 2023 12:33:25 PM
 Checklist Pro provides no-code, low-code and pro-code options for determining which checklist should appear on a particular record in ServiceNow (any record).
  

But how does it do this?

 Knowing the rules that Checklist Pro applies when creating a checklist is important. This article summarizes how Checklist Pro does it!
  

Two Options:

 1. Programmatically (i.e., by a Checklist Pro API call). This guarantees that a specific Checklist Configuration is created and associated with a target record, regardless of whether or not a person “visits” that record (i.e., using the browser – navigates to that record – which is option #2).
 

2. Conditionally (i.e., by having someone browse to a record where a checklist configuration is defined).

We will cover Options #2 (Conditional Creation) in more detail here.

The following conditions must exist for a checklist to be created on a particular record:

  • The “Checklist Pro” formatter must appear on a form (or on the Service Portal page) for a specific table (note – if there are different views, the Checklist Pro formatter must appear on the view in question, otherwise, it will not trigger the evaluation of whether to create/display a Checklist)

  • The Checklist Pro configuration record must be active (i.e., active=true)

With the above two conditions met, then a Checklist will only be created in the following situations:

  • A person navigates to the form (record)

  • The “Create Conditions” evaluate to TRUE for the specified Checklist Configuration record

The next question is, WHICH Checklist Pro Configuration record will be evaluated and what is the order in which that evaluation takes place?

Checklist Pro Configuration record selection uses the following priorities:
  1. Does this record already have Checklist Items created? If so, then these items will be displayed.

  2. If the record does not already have Checklist Items created see if this is a Shared Checklist Reference (by looking for this record in the Shared Item table).

  3. If neither the standard configuration nor shared reference configuration record is existing, then search through Checklist Pro Configuration records applying the following precedence rules:

Select all ACTIVE Checklist Configurations with a matching table ordered by the ORDER field, then by the NAME field (lowest ordered value first, a-z ordering for the name)

If there is a "Custom Create" script defined, then that condition is applied, otherwise the condition builder expression for "Create Conditions" is evaluated.

The Checklist will only then be created if the conditions to create the checklist (either through the custom script or the condition builder) evaluate to TRUE.