Lifecycle Events triggers and workflow reference
Summarize
Summary of Lifecycle Events triggers and workflow reference
This content explains how Lifecycle Events triggers and workflows function within ServiceNow’s Human Resources (HR) application to manage activity sets during lifecycle event cases. It highlights the process of triggering HR activities when lifecycle event cases change state, the use of timers for condition evaluation, and alternative triggering mechanisms.
Show less
HR Activity Launcher Flow and Triggering Mechanism
- When a lifecycle event case enters the Ready state, all activity sets are processed through the HR Activity Launcher flow. However, individual activities within those sets are not immediately triggered.
- Activity sets that do not depend on others for triggering evaluate their conditions periodically based on a timer called “Wait to reevaluate the Trigger Script,” which defaults to every four hours.
- If conditions are not met at evaluation, the system waits until the next interval to reevaluate, which can cause delays.
- The evaluation interval is controlled by the evaluationinterval field in the snhrleactivityset table and can be adjusted to reduce wait time, though caution is advised to avoid excessive triggering and cancellations.
Alternative Triggering with Condition with Event BR (Demo) Activity Set
- An optional example method uses the Condition with Event BR (Demo) activity set included in demo data to trigger activity sets more responsively.
- This method requires activation of the Human Resources Scoped App: Lifecycle Events for Enterprise (com.snhrlifecycleent) plugin.
- The activity set trigger type must be set to Condition, and it triggers when the lifecycle event case moves to the Work in Progress state.
- The included business rule listens for the state change and broadcasts a checkactivitysettrigger event to the HR Activity Set Trigger Check workflow, prompting immediate reevaluation.
- This setup can be customized to meet specific organizational requirements.
HR Activity Set Trigger Check Workflow
- This workflow was added to the HR Activity Launcher to allow server-side scripts to notify when to check if an activity set is ready to trigger.
- It evaluates trigger conditions regularly but does not directly trigger activities.
- When the checkactivitysettrigger event is received, it immediately rechecks trigger conditions, bypassing the timer delay.
Using the checkactivitysettrigger Workflow Event
- This event can be fired from server-side scripts such as business rules or scheduled jobs to immediately evaluate activity set triggers without waiting for the timer.
- This approach is recommended over setting very frequent evaluation intervals to reduce unnecessary processing and delays.
- It does not work with activity sets triggered immediately or solely by other activity sets.
- To implement, identify the logical point in server-side code where trigger conditions become true, then add a script that broadcasts the checkactivitysettrigger event to the running HR Activity Set Trigger Check workflow.
Practical Implications for ServiceNow Customers
- Understanding and managing the evaluation interval is critical to balancing timely activity triggering with system performance.
- The Condition with Event BR (Demo) provides a flexible, customizable alternative to timer-based triggers for more immediate processing.
- Leveraging the checkactivitysettrigger event allows customers to design efficient server-side logic that promptly triggers activity sets in response to lifecycle event state changes.
- Customization of workflows and business rules enables alignment of lifecycle event processing with specific HR operational needs.
Information about Lifecycle Events triggers and workflow.
HR Activity launcher flow
When a lifecycle event case is changed to the Ready state, all activity sets run through the HR Activity Launcher flow. The activities in each activity set aren’t triggered. When an activity set isn’t dependent on other activity sets to trigger activities, the trigger conditions are analyzed.
If the trigger condition hasn’t been met, it waits for the Wait to reevaluate the Trigger Script timer to run (default is every four hours).
If the trigger condition is met, but after the evaluation interval runs, it has to wait another four hours before the activities set is reevaluated. Waiting for reevaluation can cause delays in an activity set to trigger.
The Wait to reevaluate Trigger Script timer uses the evaluation_interval in the sn_hr_le_activity_set table. The default value is four hours. You can reduce the value in the evaluation_interval field to launch the activity set sooner, see Change the evaluation interval default wait time.
Condition with Event BR (Demo) activity set
- The trigger type for the activity set must be set to Condition.
- The Condition with Event BR (Demo) activity set triggers when the state of primary lifecycle event case moves to Work in progress.
- The Email - Condition with Event BR (Demo) activity is included with the Condition with Event BR (Demo) activity set.
- The Condition with Event BR (Demo) activity set includes the
HR Activity Launcher workflow. It also includes the
Condition with Event BR (Demo) business rule.
- The Condition with Event BR (Demo) business rule runs after the state of an LE case changes to Work in Progress.
- It then looks for the workflows that are running for the LE case until it finds the HR Activity Set Trigger Check workflow and broadcasts the check_activity_set_trigger event to that workflow.
- You can change the Condition with Event BR (Demo) activity set,
Email - Condition with Event BR (Demo) activity, and
Condition with Event BR (Demo) business rule to fit your
requirements.Note:For more information, see Lifecycle Events workflows and Business rules.
HR Activity Set Trigger Check workflow
- The HR Activity Set Trigger Check workflow is called when an activity set isn’t dependent on other activity sets.
- It regularly checks if the trigger condition for an activity set has been met.
- If the trigger conditions haven’t been met, it still waits for the evaluation interval to run.
- If the check_activity_set_trigger event fires, the Activity set trigger conditions are checked immediately.
Check activity set trigger workflow event
- script include
- scheduled job
- import script
After you've determined the server-side location to check the trigger criteria, add the following script to it:
(function executeRule(current, previous /*null when async*/) {
var wf = new global.Workflow().getRunningFlows(current);
while (wf.next()) {
if (wf.getValue('name') !== 'HR Activity Set Trigger Check')
continue;
new global.Workflow().broadcastEvent(wf.sys_id, 'check_activity_set_trigger');
}
})(current, previous);