Schedule API Tasks

Scheduling an API Task enables you to initiate automations that are independent of Bot Runner infrastructure (users and devices). As API Tasks run on Cloud. it eliminates the need for individual user licenses, thereby saving cost and simplifying automation management. You can schedule available API Tasks to run at specified times.

注: Scheduling API Tasks in Control Room requires Enterprise Platform license. See Enterprise Platform.

前提条件

Ensure that you are logged in to the Control Room as administrator or a user with the following permissions:
注: API Task will fail in the following cases:
  • If any of the API Task dependencies are missing.
  • If you do not have folder privileges on the dependencies.
  • If you do not have scheduling permission.

手順

  1. Log in to Control Room.
  2. Select one of the following methods on the left panel to create a schedule:
    • Click Automation.

      Click the actions menu (vertical ellipsis) to the right of API Task that you want to create a schedule for and click Schedule API Task.

    • Click Manage > Scheduled > Create schedule.
    The Automation and dependencies screen is displayed. You can also click the Choose option to find the specific API Task.
  3. Select the API Task that you want to schedule and click Choose.
    The Create schedule screen with various tabs is displayed.
  4. Use the Automation and dependencies tab to review and update the following fields:
    • Automation file: Displays the selected API Task.

      If you want to select a different API Task, click Choose.

    • Run automation and dependencies using: Select one of the following versions of the API Task to run:
      • Latest version: Schedules the selected API Task and the dependencies using the most recent version.
      • Production label: Schedules the selected API Task and the dependencies using the production version.

      By default, the latest version of the API Task is selected. If the production label option is selected for the parent task, the production label must be assigned by the user to the child task as well. And when you export the parent task, the child task with the production label is also selected automatically. If you have not applied the production label to any of the dependent tasks, the latest version of the API Task is selected.

    • Dependencies: Review the list of dependencies for the selected API Task.
  5. Click Next.
  6. Add the scheduling details to the API Task.
    In the Schedule field, select one of the following options:
    • Run once: Runs the API Task one time at the specified day and hour.

      Use the following options to configure the Run once setting:

      • Start date: Default value is the current day.
      • Start time: Default value is rounded up to the next half-hour.
      • Time zone: System time zone on your local device.
    • Run repeatedly: Use this option to schedule your API Task to run at the specified time on a given day.

      Use the following options to configure the Run repeatedly setting:

      • Start date: Enter the date when you want the schedule to start running the API Task.

        Enter the date either manually in YYYY-MM-DD format or by using the pop-up calendar. The default value of the Start date field is set to the current day that is set on your local device.

      • End date: Enter the date when you want the schedule to end.

        The End date will not be set by default.

      • Start time: Enter the Start time using the drop-down list to set the time value when you want your schedule to start.

        The list contains predefined time values in the 12-hour format at intervals of 15 minutes. You can also manually set the time value in the 12-hour format.

      • Time zone: Select the time zone for both the start and end time.

        The default value is set to the current location your system. A schedule is run based on the time zone selected when creating or editing a schedule.

      • Repeat every: Select this option to repeat the schedule.
    • Frequency: Select one of the following options as the frequency for the schedule to run:
      • Daily: Select the number of days you want the schedule to run.
      • Weekly: Select the weeks and the particular days of the week you want the schedule to run.

        For example, if you want the schedule to run every 2 weeks on Monday and Thursday, increase the count to 2 in the Every option and select the Monday and Thursday check boxes .

      • Monthly: Select one of the following options:
        • Day: Select the day of the months you want the schedule to run.
        • The: Select a particular occurrence of the day of the months you want the schedule to run.

          For example, if you want the schedule to run on the second Thursday of January, May, and September, then select Second, Thursday, and January, May, and September from the given options.

        注: When daylight saving is enabled and if the Start date is scheduled, the date is shown in the time zone to which it belongs to (not per the user's current time zone). However, Next occurrence is shown in the time zone (user's system time zone) per daylight saving time.

        For example, for a schedule created on 15 March in GMT time zone, the Start date is shown as Mar-15th, which belongs to the GMT time zone. Later, when daylight saving is ON and if you edit or view this schedule in the month of August in BST time zone, the next occurrence is shown as August which belongs to the BST time zone.

        If you schedule the task to run from 23/11/2023 9:00 AM to 30/11/2023 9:00 AM, with the frequency set as daily, the task executes daily from 23/11/2023 9 AM and the last task is executed on 30/11/2023 9 AM.

    • In the Missed schedule setting section, select the Redeploy the schedule again check box to redeploy a schedule that was missed because of any Control Room shutdown.

      When the Redeploy the schedule again option is selected, schedules missed because of any Control Room shutdown are automatically redeployed after the Control Room is restarted. An audit log entry is also added showing the Event type as Schedule misfired.

      注: To ensure a successful deployment when using the Redeploy the schedule again option, you must start the compiler service before you restart the Control Room services.
  7. Click Next.
  8. In the Run-as user tab, click Choose to select the user who must run this API Task.
    注: You can only select one user at a time to run the API Task and the system generated user called ApiTaskRunner is selected by default.
  9. Click Next.
  10. オプション: Use the General tab to change the default settings for the following options:
    • Activity name: Edit or rename the API Task.
    • Automation priority: Click the drop-down menu to set the automation priority.

      Medium is the default automation priority, but you can change this so that automations are processed for deployment accordingly.

  11. Click Create schedule.
    The API Task is scheduled. You can view the status of the scheduled API Tasks in the Manage > Scheduled page.