Schedule geoprocessing tools

Geoprocessing tools can be run immediately or scheduled to run at a later time or with recurrence. Scheduling a geoprocessing tool allows you to do the following:

  • Automate a tool you need to run regularly.
  • Run a long-running or computationally intensive process at a convenient, specified time when you will not be using the machine for other tasks.
  • Run multiple geoprocessing tools concurrently outside the ArcGIS Pro application using a stand-alone Python file.

To schedule a geoprocessing tool, fill in all required tool parameters, click the Schedule command, and specify options about when the scheduled tool should run. You can manage the tools you have scheduled in the Geoprocessing > Scheduled section of the History pane.

Note:

You can use layers from the maps in your project as input to scheduled geoprocessing tools, or you can browse to specify full dataset paths to use as input. Browsing and specifying full paths to input datasets is best practice for scheduling geoprocessing tools. This ensures that the scheduler can find and use the input datasets regardless of the availability and status of the layer's source project. When using a layer as input to a scheduled tool, the layer reference in the scheduled tool requires that the project be saved and present in the location the project existed when the tool was scheduled. Otherwise, when the schedule runs, the tool will fail with an error stating the dataset does not exist.

When scheduling a tool that uses a map as input, specify the map parameter as a full path to the project and map, like C:\Projects\CityStreets.aprx\Map, and save the project prior to scheduling, so that the current map contents will be available to use in the external process. Using only the map name as input will not work and may result in a tool error or unexpected results.

Note:

Scheduling a geoprocessing tool is possible with all ArcGIS Pro licensing levels. However, for Named User licensing, you must check the Sign me in automatically check box when signing in to the user account. This is required for the scheduled tool to run outside the ArcGIS Pro application.

Schedule a tool to run

Every geoprocessing tool can be scheduled. To schedule a geoprocessing tool, complete the following steps:

  1. Find the desired geoprocessing tool and open it.
  2. Specify tool parameters.
  3. Optionally, specify tool environments.
  4. Click the Run button Run split menu and choose Schedule Calendar.
  5. In the Schedule window, specify the task name, start date and time, recurrence, expiration, and other options for how and when the scheduled tool will run. Click OK to finish and schedule the tool.

    The scheduled tool is added to the Geoprocessing > Scheduled Tasks section of the History pane, the tool scheduling is enabled, and the tool will run at the date and time you specified in the Schedule window.

Manage scheduled tools

Scheduled geoprocessing tools are listed in the Geoprocessing > Scheduled section of the History pane. The Scheduled section displays all tools that are scheduled to run on the machine using your user account—regardless of the project from which the tools were scheduled—in alphabetical order. You must be signed in to the machine for scheduled tools to run.

Each tool in the Scheduled section includes a list of the history of the tool. Each time the scheduled tool runs, a new time-stamped item is added below the entry for the scheduled tool with an icon indicating whether the tool completed successfully or failed.

IconStatus
Check mark

The tool completed successfully.

Warning

The tool completed with warnings. Click View Details or hover over the status icon Warning to view the warning messages.

Error

The tool failed. Click View Details or hover over the status icon Error to view the error messages.

You can manage scheduled geoprocessing tools in the following ways using the right-click context menu of your scheduled tools, as well as the quick commands available when you hover over a scheduled tool:

  • Click Edit Schedule to change schedule options such as date and time, recurrence, expiration, and other options.
  • Click Run to immediately run the scheduled tool. This is useful for testing fast-running processes that you have scheduled to run some time in the future, to ensure that the tool can complete successfully.
  • Click Pause Schedule to stop future runs of the scheduled tool. When a scheduled tool is paused, it will not run on the schedule again until the tool is resumed by clicking Resume Schedule.
  • Click Clear Run Log to clear the history of a scheduled tool. This has no effect on future runs of the tool.
  • Click Delete Schedule to disable and remove the scheduled tool and delete the associated scripts, log files, and folders. This stops any scheduled runs of the tool in the future, clears the history of the scheduled tool, and removes the tool from the Scheduled section.

Log scheduled tools

Options for logging geoprocessing operations apply to scheduled tools. In addition to the Scheduled section of the History > Geoprocessing pane, these logging capabilities may be useful for tracking your scheduled tools. If the Write geoprocessing operations to XML log file option is enabled, scheduled tools will create log files in the directory %APPDATA%\ESRI\ArcGISPro\ArcToolbox\History. If the Write geoprocessing operations to dataset metadata option is enabled, scheduled tools will update the Geoprocessing History section of the dataset metadata with details about the scheduled tools.

Extend scheduled geoprocessing

Scheduling a geoprocessing tool creates a folder and several files including a Python script in the user directory %localappdata%\Esri\ArcGISPro\Geoprocessing\<your scheduled tool name>. You can extend the scheduled operation to include multiple geoprocessing tools by editing the Python script in the scheduled tool folder and adding more geoprocessing tools to the script.

Learn more about adding geoprocessing tools to a Python script

Overwrite or create output datasets

When scheduling a geoprocessing tool that creates an output dataset, you must decide whether you want the scheduled tool to overwrite the same output dataset every time the scheduled tool runs, or create an output dataset each time the tool runs.

  • To overwrite the same output dataset every time the scheduled tool runs, use a standard dataset path in the output parameter text box, such as C:\Data\MyOutput.gdb\Output.
  • To create an output dataset every time the scheduled tool runs, use the timestamp variable %t% in your dataset path in the output parameter text box to automatically name the output dataset based on the time the tool ran.

    For example, an output dataset path such as C:\Data\MyOutput.gdb\Output_%t% can be specified, and if the tool ran on March 13, 2020, at 08:30:00 a.m., the output dataset would be created as C:\Data\MyOutput.gdb\Output_03132020083000.

Remote data sources

Input data from remote data sources such as enterprise geodatabases or feature services can be used in your scheduled geoprocessing tools. You can browse to or specify the full path to these data sources as input, or use map layers that refer to those data sources. To use remote data sources that require permissions or credentials in a scheduled tool, when you make a connection to the server, portal, or enterprise geodatabase source of the data, you must save your username and password credentials.

  • For stand-alone services that require credentials, when making the server connection or when prompted for credentials, check the Save Username / Password check box.
  • For portal web layers, when connecting to the portal, check the Sign in Automatically check box.
  • For enterprise geodatabase data, when connecting to the database, check the Save User / Password check box.
Note:

Use these options to save remote data access credentials before scheduling a tool. Otherwise, the scheduled tool may fail, with an error message indicating that the data is not valid or does not exist.

Additional scheduling options

Scheduled geoprocessing uses Windows Task Scheduler to run the tools you've selected at a specified time. You can find the geoprocessing tools you have scheduled within ArcGIS Pro in Windows Task Scheduler under the name of the task you specified in the Schedule window. The schedule settings you specified in ArcGIS Pro are displayed in Windows Task Scheduler.

Windows Task Scheduler provides additional scheduling options that are not available from the Schedule window in ArcGIS Pro.

Note:

To modify additional scheduling options in Windows Task Scheduler, you must be signed in as a user account in the computer's local administrator group. To use the Run whether user is logged on or not option, the account that you specify the task to run with must be in the computer's local administrator group. The computer may have a group policy set by your system administrator that prevents scheduled tools from being run when your user account is not signed in, due to security risk. Contact your system administrator for more information.

These options include the following:
  • Run whether or not the user is signed in.
  • Run with elevated or admin privileges.
  • Stop the task if it runs longer than a specified period of time.
  • Begin the task at sign in, when the computer starts up, or on other events.
  • Send an email or display a message before the task starts or after it completes (both options are marked deprecated by Windows).
  • Run only if the computer is idle.
  • Wake the computer to run.
  • Run only on AC power.
  • If the task fails, retry after a specified period of time.
  • Choices for what happens if a task is still running when the task is scheduled to run again.

Extension tools

If you are using a Concurrent Use license and are using an extension tool directly or as part of a model or script tool, consider the following:

  • If scheduling an extension tool directly or a model tool that includes an extension tool, no special steps are required.
  • If scheduling a script tool that includes an extension tool, the script must include CheckOutExtension calls to check out the appropriate extensions.

If you are using a Named User or Single Use license, extension tools can be used without special considerations.