Timed Event Node

Overview

The Timed Event node triggers specific actions when a task or sub-process doesn't complete in a specified time. Once the workflow reaches a Task or Sub-Process node, the Timed Event node begins tracking the time spent on that task.

Examples of when you would use the Timed Event node include:

  • A CSS (customer support specialist) needs to complete a response to a ticket within four hours after it enters their queue. After two hours, they receive an email reminding them to complete their work in two hours. After three hours, the customer support specialist and their manager receive an email. When the four hours expire, the workflow reassigns the task for the manager to complete.

  • A user begins signing up for coverage but leaves the site before completing it. After three days, they receive an email from marketing to complete the form.

It's important to note that:

  • You cannot add a Timed Event node to the Automated swimlane. But, it can trigger a node that exists in the Automated swimlane.

  • You can add Timed Event nodes onto a Sub-Process node. The countdown timer starts if the optional condition is true and when the workflow navigates to any node in the Sub-Process node.

What You'll Learn

After completing this unit, you’ll know when to use the Timed Event node, how to configure its most commonly used settings and understand the best practices.

Similar Workflow Nodes

While the names are similar, the Timed Event node differs from the Conditional Event, Timer, and Timer Start nodes.

Here are the nodes compared:

  • Timed Event node: Triggers specific actions when a task or sub-process doesn't complete in a specified time.

  • Conditional Event node: Using conditional logic, redirect a workflow in a Sub-Process node to another path.

  • Timer node: Pauses a routine event or submission for a set time.

  • Timer Start node: Automates the start of a scheduled workflow.

Settings Menu Description

Let's explore the node's Settings Menu. When you select the node, this menu displays as a blue menu bar, either above or below the node. The Timed Event node has the following settings:

Setting

Description

Edit

Takes you to the Edit Timed Event window, where you can configure related settings.

Delete

Removes the node from the workflow.

Edit Timed Event Window DescriptionA static image displaying the Timed Event Window.

Click the Edit button to display the Timed Event window.

The following settings are available in the Edit Timed Event window:

Setting

Description

Label

The name of the node. By default, the Label displays as timedEvent-1. The label you enter here is optional and displays below the node on the workflow canvas.

Define your labels by associating them with the role of the node.

Activate When...

By default, a Timed Event node activates when the workflow reaches its associated step.

You may also define a Boolean validation of the submission data to trigger the Timed Event node. For example, if user_state=”New York” is entered in this field, the Timed Event begins only when the workflow enters the step and user_state=”New York”.

Actions

A Timed Event node can take two different types of actions. These include sending an email message and sending the workflow to a new task.

Send a Message

You can define an unlimited number of email messages that can be sent if the workflow doesn’t complete the task or sub-process after a specified amount of time. Each message can have a delivery method, receiver, subject, content, and duration.

This process works in the same way as the Message node.

Send Workflow to New Task After Certain Duration

By linking a task or sub-process to the Timed Event node, your workflow moves on to that task after a specified time if the associated task or sub-process isn't completed. Once linking a task to the Timed Event Node, you can edit the link to define a label and time before the workflow moves on to that specified task.

While you can define unlimited email messages sent using a Timed Event node, you can only assign a single workflow change. That way, the Timed Event is no longer valid once the workflow moves the new task.

Close (X)

Closes the Edit Timed Event window, returning your focus to the pool.

Adding a Timed Event Node

In this example, set up a workflow for a CSS support ticket intake process. It will consist of three swimlanes:

Because critical (P1 - High) tickets should be resolved on time, a Timed Event node will send various email messages based on the following configuration:

1. The CSS receives a reminder email if the critical ticket isn't resolved in two hours.
2. If the critical ticket isn't resolved in three hours, the CSS receives another reminder email, and their manager receives an email that the ticket isn't resolved.
3. If the critical ticket isn't resolved in four hours, it is reassigned to the manager.

If the CSS tries to complete the ticket after four hours, they receive an error message. This error message confirms that the task is no longer available because it has been reassigned to the manager.

What You Need

To configure this CSS support intake process, you need:

Workflows include a Start node by default. The Start node doesn't need any additional configuration.

You also need to set up the following swimlanes:

  Assigned Role

1

Authenticated

2

Administrator

3

Automated

Configure the Authenticated Task Node

First, add a Task node to the Authenticated swimlane. This first Task node lets your end-user submit a support ticket.

1. Drag and drop a Task node into the Authenticated swimlane.
2. Click Edit.
3. In the Label field, enter Ticket Details.
4. From the Module drop-down, enter or select SLA Reporting: Ticket Details.
5. Click X (Close).
6. Connect the output port (right) of the Start node to the input port (left) of the Ticket Details Task node.

You'll connect the remaining Task node at a later time.

Configure the Administrator Task Nodes

Add two Task nodes to the Administrator swimlane. Both Task nodes use the same SLA Reporting: Ticket Summary module. But, the first Task node lets the CSS select the ticket (In Progress). You'll associate the Timed Event node to this Task node later. The second Task node provides a ticket summary after completing the ticket (Complete).

1. Drag and drop two Task nodes into the Administrator swimlane.
2. Click Edit and configure each Task node as follows:

Label

Path

Module

Ticket - In Progress

ticketinprogress

SLA Reporting: Ticket Summary

Ticket - Complete

ticketcomplete

SLA Reporting: Ticket Summary

3. After editing each Task node, click X (Close).

You'll connect these Task nodes at a later time.

Configure the Automated Task Nodes

Next, add three Task nodes to the Automated swimlane. The first Task node contains an API module that assigns the submitted ticket to the CSS. If the CSS completes the ticket in four hours, they navigate to the second Task node, which confirms the ticket is complete. If the CSS doesn't complete the ticket in four hours, they navigate to the third Task node. At this point, they can't complete the task because it is reassigned to the manager. You'll connect the Timed Event node to this third Task node later.

1. Drag and drop a Task node into the Automated swimlane.
2. Click Edit and configure each Task node as follows:

Label

Path

Module

Assignment

assignment

SLA Reporting: Assignment

Met SLA

metsla

SLA Reporting: Met SLA

Missed SLA

missedsla

SLA Reporting: Missed SLA

3. After editing each Task node, click X (Close).
4. Connect the output port (right) of the Ticket Details Task node to the input port (left) of the Assignment Task node.
5. Connect the output port (right) of the Assignment Task node to the input port (left) of the Ticket- In Progress Task node.
6. Connect the output port (right) of the Ticket - In Progress Task node to the input port (left) of the Met SLA Task node.
7. Connect the output port (right) of the Met SLA Task node to the input port (left) of the Ticket - Complete Task node.

Configure the Timed Event Node

Add a Timed Event node onto the Ticket - In Progress Task node to configure the four-hour completion window. This configuration only applies to critical tickets submitted by your end-user. You'll then connect its output to the Missed SLA Task node to reassign the ticket if it's not completed in four hours. You'll also set up three emails to be sent by the Timed Event node at specific times.

For the email messages, use your email address for each to test the Timed Event.

1. Drag and drop a Timed Event node onto the Ticket - In Progress Task node.
2. Click Edit.

3. In the Label field, enter Timed Event - Critical.
4. Click Add a Message. The Add a Message modal A modal is a window that appears on top of the content you are currently viewing. displays.
5. In the Message Label, enter Reminder: Complete Support Ticket.
6. From the Send Message Via drop-down, select Email.
7. In the Subject field, enter Reminder: Complete Support Ticket.
8. In the To field, enter your email address. This email address represents the email address of the CSS.
9. In the Send Message After This Duration section, use the  (up)/  (down) arrows to select 2 Hours.
10. In the Message Template field, enter Please complete the support ticket in two hours.
11. Click Save.
12. Repeat these steps twice more with the following information:

Message Label

Send Message Via

Subject

To Send Message After This Duration Message Template

Reminder: Complete Support Ticket

Email

Reminder: Complete Support Ticket

Your email address (CSS)

3 hours

Please complete the support ticket in one hour.

Notice: Incomplete Support Ticket

Email

Notice: Incomplete Support Ticket

Your email address (Manager)

4 hours

Your CSS has yet to complete the support ticket. They have one hour to complete the ticket.

13. Click Save after completing each message.

Configure the Timed Event Link

Now you're ready to set up the Timed Event and the time limit when the Timed Event expires.

1. Connect the output port (bottom) of the Timed Event - Critical Timed Event node to the input port (left) of the Missed SLA Task node.
2. Click Edit.
3. In the Label field, enter 4 Hours.
4. In the Duration of Timer section, use the  (up)/  (down) arrows to select 4 Hours.

The duration must be greater than or equal to the durations set for the node's messages. Once the workflow moves onto a new task, the Timed Event is no longer valid and cannot send messages.

5. Click X (Close).

Configure the End Node

Finally, add an End node to finish the workflow after the CSS completes the ticket.

1. Drag and drop an End node into the Administrator swimlane.
2. Click Edit.
3. In the Label field, enter End.
4. Connect the output port (right) of the Ticket - Complete Task node to the input port (left) of the End End node.
5. Click X (Close).
6. Click Save....
7. Save your workflow.

Your completed workflow looks like this:

A static image displaying the final Workflow configuration in the Workflow Editor canvas.

Testing Your Timed Event

Now it's time to test your Timed Event. Preview your workflow in Express View Express View is how your end-user views your application. Express View also lets you preview your applications to test your configuration and view the styling. This is also the view your end-users will see when interacting with your application. After configuring a module, click Preview in the Module Builder to interact with the module in Express View..

In the top-right of the page:

1. Click Show.
2. From the Preview As drop-down, select Authenticated.
3. In the Summary* and Description* fields, enter some test information.
4. From the Team* drop-down, select an option.
5. From the Severity* drop-down, select P1 - High. Remember, the Timed Event only works for the P1 - High priority tickets.

6. Click Next.

After the new page loads, from the Preview As drop-down, select Administrator. Do not click Next. In two hours, you'll receive the first email. In three hours, you'll receive the other two emails. After four hours, click Next. An error message displays because the task is no longer available and is reassigned to the manager.

For a faster test, change the message and node durations to one minute.

Resources