Geoprocessing settings

System administrators can manage many ArcGIS Pro user application settings.

The settings described below should be added under the Geoprocessing element in the Pro.settingsConfig file.

Learn more about geoprocessing options

ToolParameters

Use this setting to override the default value of geoprocessing tool parameters. The ToolParameters element should contain one or many Parameter elements, each with the following attributes:

  • toolName—The name of the tool.
  • toolboxAlias—The alias of the toolbox containing the tool.
  • name—The name of the parameter.
  • Islocked—If the parameter value will be locked in the tool dialog box.

Note:

The ToolParameters settings do not have corresponding user interface settings.

The tool name, toolbox alias, and parameter names can be found on each tool's tool reference page, in the Parameters section, on the Python tab.

An example of this setting used to set the Calculate Field tool’s Expression Type (expression_type) parameter default value to Arcade is shown below.

<ToolParameters>
     <Parameter toolName="calculatefield" toolboxAlias="management" name="expression_type" isLocked="true">ARCADE</Parameter>
</ToolParameters>

AddHistoryItem

In the user interface, on the Geoprocessing tab on the Options dialog box, click Logging > Write geoprocessing operations to Geoprocessing History to access the corresponding setting.

Possible values are the following:

  • true (default)
  • false

An example of this setting is shown below.

<AddHistoryItem isLocked="true">false</AddHistoryItem>

AddOutputsToMap

In the user interface, on the Geoprocessing tab on the Options dialog box, click Set options for running geoprocessing tools and scripts > Add output datasets to an open map to access the corresponding setting.

Possible values are the following:

  • true (default)
  • false

An example of this setting is shown below.

<AddOutputsToMap isLocked="true">false</AddOutputsToMap>

BlockNonSystemPythonToolbox

Use this setting to choose whether restrictions or warnings are applied when opening a custom Python toolbox (.pyt file). This setting protects against the potential risks of running third-party code that may be harmful.

Possible values are the following:

  • Always—Always block access to custom Python toolboxes.
  • Ask—Display a warning dialog box before a Python toolbox opens. Selecting Yes on the dialog allows the toolbox code to run, while selecting No blocks access to the Python toolbox. This choice is available per Python toolbox and is remembered for the current session.

An example of this setting is shown below.

<BlockNonSystemPythonToolbox isLocked="true">Ask</BlockNonSystemPythonToolbox>

EnableUndo

In the user interface, on the Geoprocessing tab on the Options dialog box, click Set options for running geoprocessing tools and scripts > Enable Undo toggled on by default to access the corresponding setting.

Possible values are the following:

  • true
  • false (default)

An example of this setting is shown below.

<EnableUndo isLocked="true">true</EnableUndo>

MessageLevelCommandSyntax

In the user interface, on the Geoprocessing tab on the Options dialog box, click Additional information messages > Command syntax to access the corresponding setting.

Possible values are the following:

  • true
  • false (default)

An example of this setting is shown below.

<MessageLevelCommandSyntax isLocked="true">true</MessageLevelCommandSyntax>

MessageLevelDiagnostics

In the user interface, on the Geoprocessing tab on the Options dialog box, click Additional information messages > Diagnostics to access the corresponding setting.

Possible values are the following:

  • true
  • false (default)

An example of this setting is shown below.

<MessageLevelDiagnostics isLocked="true">true</MessageLevelDiagnostics>

MessageLevelProjectionTransformation

In the user interface, on the Geoprocessing tab on the Options dialog box, click Additional information messages > Transformations to access the corresponding setting.

Possible values are the following:

  • true
  • false (default)

An example of this setting is shown below.

<MessageLevelProjectionTransformation isLocked="true">true</MessageLevelProjectionTransformation>

RecordGPHistoryInMetadata

In the user interface, on the Geoprocessing tab on the Options dialog box, click Logging > Write geoprocessing operations to dataset metadata to access the corresponding setting.

Possible values are the following:

  • true (default)
  • false

An example of this setting is shown below.

<RecordGPHistoryInMetadata isLocked="true">false</RecordGPHistoryInMetadata>

RemoveOverwrittenLayers

In the user interface, on the Geoprocessing tab on the Options dialog box, click Set options for running geoprocessing tools and scripts > Remove layers that reference data overwritten by geoprocessing tools to access the corresponding setting.

Possible values are the following:

  • true (default)
  • false

An example of this setting is shown below.

<RemoveOverwrittenLayers isLocked="true">false</RemoveOverwrittenLayers>