Description
Executes a geoprocessing task asynchronously, allowing the workflow to continue while the task runs in the background. This is suited for long-running or resource-intensive tasks. It requires additional handling to check the task status or retrieve results once completed. This approach enhances workflow responsiveness and scalability.
One advantage is that the workflow starts the geoprocessing task and moves to the next step without waiting for it to complete. The result of the geoprocessing task must be checked later through a callback or polling mechanism. It is designed for long-running or resource-intensive tasks that may take minutes or hours to complete. Examples include performing complex spatial analysis on large data sets or running model builder workflows that chain multiple operations.
It is important to check the execution type of the geoprocessing service and match it with the correct activity type. The Run Geoprocessing (asynchronous) Activity should only be used with asynchronous types.
To verify the execution type:
1.In ArcGIS Online, go to your Content tab.
2.Ensure the correct tab is selected such as My content or My organization.
3.In the Filter section, select Item type > Tools > Geoprocessing tasks.
A filtered list of geoprocessing tasks appears.
4.Click the desired task.
5.On the tool's item page, locate the Service URL (under the URL section or Overview tab) and click the copy URL icon.
6.Paste the URL into your browser. This opens the REST Services Directory for the tool.
7.Look for Execution Type. It is either esriExecutionTypeAsynchronous or esriExecutionTypeSynchronous.
Inputs
Url |
Required Type: String The URL of the ArcGIS Server Geoprocessing service task. For example, http://server/arcgis/rest/services/<serviceName>/GPServer/<taskName>. |
Arguments |
Required Type: Lookup<any> The input arguments accepted by the geoprocessing task. These input parameters are listed in the parameters field of the associated GP task resource. |
Out Spatial Reference |
Optional Type: Number | String | esri.SpatialReference (3.x, 4.x)* The spatial reference of the output geometries. If not specified, the output geometries are in the spatial reference of the input geometries. If processSpatialReference is specified and outputSpatialReference is not specified, the output geometries' spatial reference is processSpatialReference. |
Process Spatial Reference |
Optional Type: Number | String | esri.SpatialReference (3.x, 4.x)* The spatial reference that the model uses to perform geometry operations. If processSpatialReference is specified while outputSpatialReference is not, the output geometries' spatial reference is processSpatialReference. |
* VertiGIS Studio Workflow uses different versions of Esri's ArcGIS API for JavaScript depending on the type of host application. See Underlying Technologies for information.
Outputs
id |
Required Type: String The ID of the geoprocessing job. |
status |
Required Type: String The status of the geoprocessing job. |
messages |
Type: esri.GPMessage[] (3.x, 4.x)* The messages from the geoprocessing job. |
results |
Type: Lookup<any> The results of the geoprocessing job. |
* VertiGIS Studio Workflow uses different versions of Esri's ArcGIS API for JavaScript depending on the type of host application. See Underlying Technologies for information.
Properties
For information about the ID, Display Name, and Description properties, see Properties Common to all Activities.
Connectivity Requirements
This activity does not work when the device has intermittent connectivity to the network.
Version Information
Supported from: Geocortex Viewer for HTML5 2.9, ArcGIS Web AppBuilder 2.4.
See also...
