Timer Node

Estimated Reading Time:  5 minutes

Overview

A static image displaying the workflow Timer node, the node is selected and the settings menu is displayed.

The Timer node pauses a routine event or submission for a set amount of time. When the timer ends, the workflow resumes. For example, you can add a timer to resume your workflow two minutes after a message sends. After two minutes passes, the workflow resumes and continues to the next node in the workflow.

Here are some examples of when to use Timer node automation:

  • Ingesting papers.

  • Restarting a workflow following a submission failure.

  • Sending an email confirmation receipt.

  • Delaying a submission approval.

You'll find the Timer node in the list of nodes on the left of the Workflow Builder.

What You'll Learn

After completing this article, you’ll know when to use a Timer node, and how to add and configure it in a workflow.

Settings Menu Description

Let's explore the node's Settings Menu. This menu displays as a blue menu bar, either above or below the node, when you select the node itself. The Timer node has the following settings:

Setting

Description

Edit

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

Delete

Removes the node from the workflow.

Edit Timer Window Description

Click the Edit button to display the Timer Event window.

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

A static image displaying the End node on the workflow canvas, and the End node's confiugration panel with default settings.

Setting

Description

Label

The name of the node. By default, the Label displays as timer-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.

Path

The path of the node. By default, the Path displays as timer-1

A path is a unique identifier that other components can reference.

Type

The type of timer to use.

Relative

Toggles the timer start time to Relative. A relative Timer Event repeats when an amount of time passes.

For example, a relative time of nine hours triggers every nine hours.

NOTE  You can enter fractional units of time. For example, a relative time of 3.25 hours triggers every 3.25 hours.

Exact

Toggles the timer start time to Exact. An exact Timer Event repeats at a precise time of day on a frequency of daily, weekly, monthly, or yearly.

For example, an exact time of Weekly at 15:50 starts every seven days at 15:50.

Cron

Toggles the timer to use a Cron Expression. Cron Expressions can run tasks periodically at fixed times, dates, or intervals.

TIP  To learn more about using Cron Expressions, view our Introduction to Cron Expressions article.

Close

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

Adding a Timer Node

In this example, set up a workflow to call modules related to credit score checks and rechecks. Using these modules, your end-user can submit their data. Add the Timer node to kick off a task that sends a final recheck credit score.

What You'll Need

To set up this use case, you need:

Configure the Screen/Task Nodes

First, add the Screen/Task nodes to the Authenticated swimlane. You can connect the Screen/Task nodes to your own modules or use the Enablement Lab training modules listed below.

1. Drag and drop four Screen/Task nodes into the Authenticated swimlane.
2. Click Edit and configure each Screen/Task node as follows:

Label

Path

Module

Credit Check

enablementlabcreditscorecheck

Enablement Lab: Credit Score Check

Recheck Credit Score

enablementlabcreditscorecheck

Enablement Lab: Credit Score Recheck

Reviewed Score

enablementlabfinalrecheckscore

Enablement Lab: Final Recheck Score

Final Score

enablementlabfinalresults

Enablement Lab: Final Results
3. After editing each Screen/Task node, click X (Close).
4. Connect the output port (right) of the Start node to the input port (left) of the Credit Check Screen/Task node.
5. Connect the output port (right) of the Recheck Credit Score Screen/Task node to the input port (left) of the Credit Check Screen/Task node.

NOTE  You'll connect your remaining two Screen/Task nodes at a later time.

Configure the Exclusive Gateway Node

Now, add the Exclusive Gateway node. This Exclusive Gateway splits your workflow for end-users checking their credit score. The workflow continues for your end-users who want to Wait to Recheck their score. The workflow ends for end-users who want their Final score only.

1. Drag and drop an Exclusive Gateway node in the Authenticated swimlane.
2. Click Edit.
3. In the Label field, enter Recheck?.
4. Click X (Close).
5. Connect the output port (right) of the Recheck Credit Score Screen/Task node to the input port (left) of the Recheck? Exclusive Gateway node.

Configure the Timer Node

Add a Timer node to send a final recheck of your end-user's credit score. In this case, you'll set up the Timer node to recheck your end-user's credit score after 1 minute.

1. Drag and drop a Timer node in the Authenticated swimlane.
2. Click Edit.
3. In the Label field, enter Wait To Recheck.
4. In the Path field, enter timer-1.
5. Select Relative.
a. In the Time Amount field, enter 1.
b. In the Time Unit field, enter Minutes.

A static image displaying the Timer node labeled "Wait to Recheck", the Edit Timer Event panel is open and the Type, Time Amount, and Time unit settings are highlighted.

6. Click X (Close).

NOTE  You'll connect the Timer node to your Exclusive Gateway node in the steps below.

Configure the Exclusive Gateway Node with Gateway Links

When you connect an Exclusive Gateway node to another node, the connector becomes a Gateway link. This link is where you enter the logic. So, if your end-user answers Yes in the Recheck Credit Score module, they are directed to re-enter their information and recheck their score. When your end-user clicks Next to resubmit, the submission pauses for one minute and then shows the Final credit score.

When the workflow resumes, your end-user sees the Reviewed Score Screen/Task module. There, they see their score. If your end-user answers No, they proceed to the Final Score Screen/Task node. There, they see their final credit score.

Add and configure the Exclusive Gateway node:

1. Drag and drop an Exclusive Gateway node in the Authenticated swimlane. Position the node after the Recheck Credit Score Screen/Task node.
2. Click Edit.
3. In the Label field, enter Yes.
4. Click X (Close).
5. Connect the output port (right) of the Recheck? Exclusive Gateway node to the input port (left) of the Wait To Recheck Timer node. This connector becomes a Gateway Link.
6. Connect the output port (right) of the Recheck? Exclusive Gateway node to the input port (left) of the Final Score  Screen/Task node. This connector becomes a Gateway Link.
7. Edit your Gateway Links as follows:

Gateway Link

Label

Default

Logic

Recheck? Gateway to Wait To Recheck

Yes

Off

recheckCreditScore="yes"

Recheck? Gateway to Final Score

No

On

none
8. Click X (Close) after editing each Exclusive Gateway link.
9. Connect the output port (right) of the Wait To Recheck Timer node to the input port (left) of the Reviewed Score Screen/Task node.

Configure the End Nodes

1. Drag and drop two End nodes into the Authenticated swimlane.
2. Select the first End node.
3. Click Edit
4. In the Label field, enter End-1.
5. Click X (Close).
6. Connect the output port (right) of the Reviewed Score Screen/Task node to the input port (left) of the End-1 End node.
7. Select the second End node.
8. Click Edit.
9. In the Label field, enter End-2.
10. Connect the output port (right) of the Final Score Screen/Task node to the input port (left) of the End-2 End node.
11. Click X (Close).
12. Click Save....
13. Click Save.

Your workflow looks like the following image when complete:

A static image displaying a completed Workflow using the Timer node.

Resources