Skip to main content

Job nodes

Learn how to use job nodes to manage your jobs through your workflows.

Job nodes provide the capability to create or delete recurring and scheduled jobs in your workflows.

About jobs​

Jobs in Actioner let you automate both one-time and recurring tasks to optimize your workflows.

  • You can configure recurring jobs to streamline repetitive tasks, such as automating reminders for team updates, fostering continuous connectivity and awareness.
  • You can use scheduled jobs to efficiently manage your one-time tasks, eliminating the need to remember deadlines and allowing you to focus on more meaningful work.

How to configure a job node​

To add a new job node into your workflow

  1. Click + button in your canvas, and then select Jobs node.

    Add job node

  2. On the opening panel, choose one of the following options:

    Job node options

Saving a recurring job​

You can use this option to create or update a recurring job.

Save a recurring job

Updating a recurring job

If you are looking to update a recurring job, provide your job's ID in Job ID field. If a job exists with the ID you provide, that job will be updated.

To create or update a recurring job,

  1. Provide a name for your job.

  2. Optionally, provide an ID for your job. Note that each job has a unique ID and if Job ID is left empty, your job will be created with a random ID.

  3. Select the Timezone for your job. Your job will run at the specified time according to the chosen timezone. By default, your browser's timezone is selected.

  4. On Recurrence time section, configure when your job will run and its frequency.

  5. Click on Job target to specify the workflow that your job will execute. Note that, you can select a workflow from your app.

  6. When a target workflow is selected, its inputs open up on the right panel. Provide the values for the inputs that the target workflow will be executed with.

    To dynamically assign value to an input parameter, use an expression inside double curlies - {{ }}. For non-text fields, click on the gear ⚙ icon right next to the field and then select Dynamic option.

    Recurring job target

  7. On Ends section, select when your job will stop running. Note that recurring jobs have a maximum limit of 100 occurrences.

    • Never: If chosen, your job will run indefinitely.
    • After a specific date: If chosen, your job stops running when the selected date is reached.
    • After a number of occurrences: If chosen, your job repeats until it reaches the specified amount.

  8. Once your workflow is run and your job is saved, it will be listed on the Jobs tab of your app.

Configuring recurrence time​

You can set up your job to run at every minute, hour, day, weekday, week, month, year or provide your custom cron expression to specify recurrence interval.

Below, you can find examples of configuring a recurring job with each option.

Dynamically generating recurring time

To dynamically generate recurrence time values, select Dynamic option from the gear ⚙️ icon and then write an expression inside double curlies - {{ }}.

Expressions let you reference to values in your workflows, such as inputs or trigger events or data in the responses of earlier nodes. Additionally, you can use one-liner JavaScript within your expressions.

Dynamically generating recurrence time

Minute​

This option lets you set your job to run every specified number of minutes. You can specify the repeating interval in minutes.

Recurrence time for a job that will run every two minutes: Minute recurrence

Hour​

This option lets you set your job to run at the chosen minute and repeats at intervals specified in hours.

Recurrence time for a job that will run every two hours at 15 minutes past the hour: Hour recurrence

Day​

This option lets you set your job to run at the specified time and repeats every specified number of days.

Recurrence time for a job that will run at 23:30 (UTC -05:00) everyday: Daily recurrence

Weekdays​

This option lets you set your job to run at the specified time on every weekday.

Recurrence time for a job that will run at 09:00 (UTC -05:00) on weekdays: Weekdays recurrence

Weekly​

This option lets you set your job to run every week on the specified day(s) and at the specified time.

Recurrence time for a job that will run every Tuesday and Thursday at 14:00 (UTC -05:00): Weekly recurrence

Monthly​

This option lets you set your job to run every month on the specified day(s) and at the specified time.

Recurrence time for a job that will run every 1st and 15th of the month at 15:00 (UTC -05:00): Monthly recurrence

Annually​

This option lets you set your job to run every year on the specified months(s), on the specified day(s) and at the specified time.

Recurrence time for a job that will run every Jan 1 and July 1 at 09:00 (UTC -05:00): Annually recurrence

Custom (cron)​

This option lets you set your job to run a recurring schedule that specifies the times at which a recurring job should be executed. For further info and examples, visit cron expression page.

Recurrence time for a job that will run every 30 minutes Monday through Friday: Custom (cron) recurrence

Saving a scheduled job​

You can use this option to create or update a scheduled job.

Save a scheduled job

Updating a scheduled job

If you are looking to update a scheduled job, provide your job's ID in Job ID field. If a job exists with the ID you provide, that job will be updated.

To create or update a scheduled job,

  1. Provide a name for your job.

  2. Optionally, provide an ID for your job. Note that each job has a unique ID and if Job ID is left empty, your job will be created with a random ID.

  3. Select the Timezone for your job. Your job will run at the specified time according to the chosen timezone. By default, your browser's timezone is selected.

  4. Fill out Scheduled time fields. Select the date and time your job will run.

    To dynamically generate scheduled time, select Dynamic option from the gear ⚙️ icon and then write your expression inside double curlies - {{ }}.

    This field expects a Unix timestamp in milliseconds. Ensure that your expression returns a valid value.

    Dynamically generating scheduled time

  5. Click on Job target to specify the workflow that your job will execute. Note that, you can select a workflow from your app.

  6. When a target workflow is selected, its inputs open up on the right panel. Provide the values for the inputs that the target workflow will be executed with.

    To dynamically assign value to an input parameter, use an expression inside double curlies - {{ }}. For non-text fields, click on the gear ⚙ icon right next to the field and then select Dynamic option.

    Scheduled job target

  7. Once your workflow is run and your job is saved, it will be listed on the Jobs tab of your app.

Deleting a job​

You can use this option to delete a recurring or a scheduled job.

To delete a job in your workflow,

  1. Click + button in your canvas, select Jobs node and then select Delete job option.

  2. On the opening left panel, provide the Job ID.

    Delete a job

  3. Once your workflow is run and the job node is executed, the job with the provided ID will be deleted and removed from the list on the Jobs tab of your app.