Skip to main content

Schedulers

Scheduler is the type of event related to date and time to be triggered in order to execute a flow.

A Scheduler handles time intervals which can be useful if we want to repeat it periodically.

Schedulers are events triggered on a certain moment and can be optionally recurrent. The Workflow/Schedulers submenu allows to define a new Scheduler as well as managing the schedulers previously defined.

You can perform operations on schedulers using the Cenit IO API V2. To do this, see the specification of this API in section schedulers.

Add New​

For creating a new scheduler, click the New button (+) in the Generic Menu and fill every input field.

New schedulerThe definition of the Scheduler is pretty easy, yo just need to fill a few fields and activate it.

Schedule fileds

  • Namespace and Name:

    Use namespace and name as the way to referer the event from a Flow or a Task.

  • Activated:

    Set activated true in order to enable the scheduler to be triggered depending on the conditions established by the other parameters. When activated is set to false, the event never ocurrs regardless the conditions have been acomplished.

  • start_at:

    Define the date and time when the event ocurr for the first time. Before that, the event never ocurrs regardless the other conditions have been acomplished. It is set by using a selection box with two possible options:

    • STARTING IMMEDIATLY: The event occur as soon as the the scheduler is activated.

    • STARTING AT: Allow to enter the exact date and time you want the event to ocurr.

  • repeat_every:

    Allow to define if the event is one-time execution, or has a specific periodicity, or will be triggered on appointed dates. It is set by using a selection box with two possible options:

    • REPEAT EVERY: Allow you to define a time interval to be triggered repeatedly, with a specific periodiocity.

    • REPEAT AT: Allow to set appointed dates to trigger the event. So, you can select:

      • the exact date and time you want the event to ocurr if it is one-time execution event.

      • A set of multiple dates, by selecting week days, month days, weeks and months you want the event to ocurr.

  • end_at:

    Define the date and time when the event ocurr for the last time. After that, the event never ocurrs regardless the other conditions have been acomplished.It is set by using a selection box with two possible options:

    • INDEFINITELY: The event has no termination date, it may ocurr indefinitely depending on the value of the repeat every field.

    • ENDING AT: Allow to enter the exact date and time you want the event to stop ocurring.

The pictures below shows some examples of scheduler definitions.

This event is triggered every day at 6 am since April 4th, 2022 at 14:17 :

Daily schedulerThis event might be triggered on January 25 every year but it has starting and ending date on January 2022, so it is triggered only once on January 25, 2022 at 6am:

scheduler one time

This event is triggered twice a month on days 1 and 15 at 6am since it is activated:

scheduler twice a month

Strictly speaking, none of those schedulers ever occur, as you may see in the picture below, because none of them is activated.

List of schedulersYou can manage schedulers from the list, in the same way you do with every other element in Cenit.

Notice​

You should notice that when you define a scheduler you are not telling Cenit to do anything when the event is triggered. You must associate schedulers to a Flow or to an algorithm Task later.