Scheduling Workflow Runs
  • 12 Feb 2025
  • 4 Minutes to read
  • Dark
    Light
  • PDF

Scheduling Workflow Runs

  • Dark
    Light
  • PDF

Article summary

Axonius supports scheduling a Workflow to run at specified times. This is relevant only for Workflows that are configured with a scheduled triggering Action. You can optionally configure when the schedule plan ends.

Scheduling the Workflow Run

This section describes the schedule plans available for Workflows configured with a Scheduled triggering action.

To schedule a Workflow run

  1. In the Trigger Type pane of a Scheduled action, under the Select a Schedule Plan section, select from the dropdown one of the schedule plans for running the Workflow.

WFScheduledOptions.png

Each schedule plan is explained in the following sections.

Every Global Discovery Cycle (Default)

This schedule plan runs the Workflow on the same schedule as the Global Discovery Cycle, at the end of the cycle. See Discovery Cycle for more information about Discovery Cycles.

Schedule Once

This schedule plan enables a one-time run of the Workflow on a selected date and time.

Note:

If you want to schedule a Workflow to run on the current day, you need to select a time later than the current time.

To set the one-time run

  • In Select date and time, click the Calendar icon, and in the calendar that opens, select the date and optionally the time on which you want to run the Workflow, and then click Ok.

SchedulePlanOnce.png

Weekly on [Current Day]

This schedule plan runs the Workflow once a week on the current day. For example, if you set this schedule on a Wednesday, the dropdown displays a Weekly on Wednesday option.
Under Run time, select the exact hour at which you want the run to occur (the default is 13:00). You can also schedule it to run immediately by selecting Now.
If you have multiple Workflows, it is recommended to schedule them at different times to reduce network traffic.

SchedulePlanWeekly.png

Every 12 Hours

This schedule plan runs the Workflow every 12 hours. The runs occur at 00:00 and 12:00.

Daily

This schedule plan runs the Workflow every day. Under Run time, select the exact hour at which you want the run to occur. The default run time is 13:00.

Custom

Use this schedule plan to set a flexible, custom schedule to run your Workflow. With a custom schedule plan, you can:

  • Repeat runs every X hours, days, weeks, or months.
  • Run the Workflow only on specific days. Upon enabling this toggle, a bar with a tile for each weekday appears. Select the tiles of the run days.
  • Run the Workflow only between specific hours.

SchedulePlanCustom.png

The default option is Repeat every 2 hours. Here you can set specific days and a specific range of hours to run the Workflow. In the example below, the run is set to repeat every two hours on Mondays and Wednesdays, between 08:00 and 14:00:

SchedulePlanCustomExample1.png

Note:

In the Repeat every X hours / days / weeks / months setting, the value of X must be larger than 0, and the maximum value is 24. Fractions are also possible, for example - Repeat every 0.5 hours.

Select Repeat every X days or Repeat every X weeks to set the run time and also set it to run only on specific days.

Note:

When you set the schedule to run every two days and the run day does not fall on one of the selected specific days ()if configured), the Workflow doesn't run on that day.

Select the Repeat every X months to either:

  • Schedule the run to occur on every First/Second/Third/Fourth/Fifth weekday of the month. For example - every second Monday of the month:

SchedulePlanCustomExample2.png

  • Schedule the run to occur on a specific day or several specific days of the month. For example - every 6th and 22th of the month:

SchedulePlanCustomExample3.png

Click the x icon next to each day to remove it from the list.
You can also set the Run Time, as explained above.

Every Successful Adapter Fetch

This schedule plan runs the Workflow following each successful fetch of a single selected adapter connection. This is relevant for adapter fetches from within or outside the Discovery Cycle.
From the Select Connection dropdown of configured adapter connections in the system, select a single adapter connection.

SchedulePlanAdapterFetch.png

Scheduling the Workflow Run for the End of the Cycle

If the scheduled run overlaps with a Discovery Cycle, enabling the Wait until cycle ends option postpones the run until the end of the cycle. This option is available for all schedule plans except for the default Every Global Discovery Cycle and Every successful adapter fetch.
Before choosing Wait until cycle ends, decide whether running the Workflow on up-to-date data significantly justifies delaying its execution.

Note:

The Wait until cycle ends option is not relevant when no Discovery Cycle is running at the scheduled trigger time of the Workflow.

Ending the Workflow Schedule Plan

Note:

This option is not available for the Schedule Once schedule plan.

To set when the schedule plan ends, select one of the following options:

  • Never (default) - The plan never ends.
  • On - Select the date on which the plan will end.
  • After - Choose to end the plan after X months / days / weeks / occurrences.

EndSchedulePlan

After you set the schedule plan to end after a certain time period (the third option), the system displays the time remaining for this plan. For example, if you set it to end after 3 months, the system displays Remaining: 3 Months, and after one month it changes to Remaining: 2 Months. The count starts from the moment you click Save and Run.
To keep the schedule plan for longer, click Reset Count. For example - if you set the plan to end after 3 months, and after one month, you want it to run for 3 more months, click Reset Count and the display will change back to Remaining: 3 Months.

Important

You must click Save and Run to be able to select Reset Count later.


Was this article helpful?