Scheduling when a Robotic Process Automation robot runs
Use the Pega RPA Service to schedule when RPA robots start and stop. The schedule is stored in the RpaSchedule.json file, which is located in the C:\programdata\OpenSpan folder. In this file, there is a JSON element for each day of the week. In each JSON element, you specify when the robot will start and how long its session will last. You can schedule one session per day.
There are two methods for scheduling when robots perform work: Scheduled and OnDemand. This article discusses the Scheduled method. For information on the OnDemand method, see Configuring Pega Robot Manager version 6
. You must have Robotic Automation version 8.0 SP1 2019 or later to work with Robot Manager version 6. For best results, upgrade to version 8.0 SP1 2025 or later.
Before you begin
In the local RPAService.config file, you must set the Mode key to Scheduled. Also, make sure the RpaSchedule.json is located in the c:\programdata\OpenSpan folder.
To specify an RPA robot’s schedule, perform the following steps:
- Open the RpaSchedule.json file in a text editor.
- Set the Enabled property to True for the days on which you want the robot to run.
- In the StartTime property, specify the time in HH:MM format at which you want the Pega RPA Service to start looking for jobs to send to the robots.
The Pega RPA Service uses a 24-hour clock. For example, to start the service at 1:30 pm, set the StartTime property to 13:30.
- Set the DurationMinutes property to the number of minutes you want the Pega RPA Service to look for jobs. The following code is an example that shows how you set up a robot to run on Tuesday from 1 a.m. until 5 a.m.:
- Save and then close the file.
Restart the Pega RPA Service any time you change the RpaSchedule.json file settings.
When the Pega RPA Service detects that a robot should be started, the service performs the following tasks:
- Logs in to Windows by using the Windows credentials that are supplied by the Credentials Manager (credmgr.exe) utility. For more information about the Credentials Manager, see Pega Robotic Automation Credentials Manager utility.
- Starts Robotic Automation Runtime as the user specified by the Credentials Manager utility by using the --Runtime flag. If you do not supply Robotic Automation Runtime credentials, the Pega RPA Service starts Robotic Automation Runtime as the user who is logged in to Windows.
It can take up to three minutes to complete the Windows login and Robotic Automation Runtime startup process.
When Robotic Automation Runtime detects that the scheduled session has ended, it performs the following tasks:
- Completes the current work item, if any work is in progress.
- Shuts down Robotic Automation Runtime.
- Logs off Windows.
Published December 8, 2017 — Updated March 27, 2019