Scheduling a script

This section walks you through the process of scheduling scripts.

Before you begin

  • You need to publish the script to the IBM RPA server's repository. See Publishing a script to learn more about that.
  • You must also enable the Allow scheduling option.
  • See Planning for deployment and Planning for scheduling for more information about scheduling and deployment.
  • See how to add computer credentials in Credentials.
  • When the schedule is disabled, updating the schedule status log to "canceled" is the expected behavior.
  • You must have permission to manage scripts. See Default roles for more information on what roles have this permission.

⚠ Attention for IBM RPA on premises offering only: Due to an MSMQ limitation, when you use it as your system queue provider, you must install the IBM RPA server and the client on the same subnet in order to schedule or orchestrate scripts.

See the Scheduling and orchestration processes do not work when using MSMQ troubleshooting page.

Procedure

Define the script

  1. Log in to IBM RPA Control Center.
  2. From the Define menu, click Scripts.
  3. Locate the script that you want to schedule.
  4. Click the vertical ellipsis button ⋮ > Schedule option.
  5. The Create schedule window prompts to the script selected. Enter the following values:
    1. From the Version list, select the script's version.
    2. In the Name field, enter the schedule's name.
    3. Optional: In the Description field, enter the schedule description.
    4. From the Computers list, select the computer to run the script.
    5. Optional: From the Credentials list, select the computer's credentials. You don't need to select a value if your computer already has a credential that is bound to it.
  6. Click Next.

❕ Important: Scheduling does not take into consideration the production version.

Define the schedule

Define the script schedule based on how many times you want the script to run in weekdays. Follow the steps based on your schedule preferences:

Define the schedule to run once a day

  1. In the Execution Type field, select Execute once a day.
  2. In the Weekdays checkbox, select the weekdays you want to run the schedule.
  3. In the Start time field, enter the time that the script must start running.
  4. Optional: Set Unlock machine to On to unlock the machine when the schedule run.

Define the schedule to run more than once a day

  1. In the Execution Type field, select Execute more than once a day.
  2. In the Weekdays checkbox, select the weekdays that you want to run the schedule.
  3. In the Start time field, enter the time that the script must start running.
  4. In the Stop time field, enter the time that the script must stop running.
  5. In the Interval field, enter the time interval that the script must take before to restart running. The script starts again based on the time that it takes to finish its runtime plus the time that is defined as time interval.
    Remember: The time format follows the 24-hour clock convention of time. You define the schedule times in hours and minutes, for example, 09:00 or 16:30.
  6. Optional: Set Unlock machine to On to unlock the machine when the schedule run.

🛈 Remember: If the target machine is a virtual machine, you must set the script to unlock the machine.

❕ Important! If you upload a newer version of the script and you want that version to run, you must create a new schedule. The scheduler does not automatically update to the newer version, and you cannot change the version in the current one.