Geoprocessing widget

The Geoprocessing widget provides a dynamic user interface to execute a geoprocessing task. It provides the ability to configure symbology for input and output layers, as well as overriding default values for parameters.

Configure the Geoprocessing widget

This widget can be set to open automatically when an app starts. To enable this feature, click the Open this widget automatically when the app starts button on the widget, which turns it dark green.

1. Hover over the widget and click the Configure this widget button to open the configuration properties dialog box.
2. Click the Set button and add the geoprocessing service from ArcGIS Enterprise or ArcGIS Server.

   Note:

   The Geoprocessing widget does not support OGC Web Processing Services (WPS).

   The list of Input and Output parameters for the task populates, along with the Layer order and Options sections.

   

3. To configure each Input parameter, click to make it active. The default values, defined by the published geoprocessing service, populate in the Label, Tooltip, and default value areas, such as Input Feature by and Symbol in this case. You can input features with one of the following options:
   • Interactively drawing on the map
   • Use shapefile in local file system
   • Selecting a layer from the map
   • URL

   You may have the option to Use current map extent as input feature for the polygon.

4. Check Visible to display the parameter on the widget interface.

   The content of the default value area varies based on the parameter type. For details, see Geoprocessing parameter types.

5. Click each Output parameter to make it active and configure it. Set the label and tooltip for the output, and check the boxes below to control how the output displays.
   • Ignore this output
   • Turn off this layer by default
   • Output may have different schema, use dynamic schema instead of the predefined
6. Choose the Renderer tab, which is GPFeatureRecordSetLayer in this case.
   1. In the Use section, choose Unique Symbols from the drop-down list.
   2. In the To Show section, choose ToBreak from the drop-down list.
   3. Choose a color pattern.
   4. Click the plus sign (+) to add different values that you want to show in the Add Value box.
   5. For other values not entered in the previous step, click Set Default Symbol and choose a symbol from the Default Symbol preview.



7. Select the fields to display in the Popup window for output features. Check the Enable popup check box to enable the pop-up. Click the Add drop-down arrow to select fields for the pop-up title. Check the check boxes in the Visible column to display the field in the pop-up when a feature is clicked. Reorder fields by clicking the up and down arrows next to the field.

   

8. If the output parameter is GPRecordSet, you can configure the fields to display in the output table.
9. Control the order of the layers (input, output) by clicking the up and down arrows in the Layer order section.
10. In the Options section, check Add result as operational layer to add the output layer to the map's operational layers. Check Allow to export results to export the result locally to a CSV, feature collection, or GeoJSON file as well as to save the result as a feature collection item in My Content tab in the contents page in ArcGIS Online or ArcGIS Enterprise. Additionally, if your geoprocessing service is published with the View result with a map service parameter, the Use the drawing options of result map service option is enabled. You can choose to draw the result with the map service. If you do, the Renderer capability of Output in step 5 is disabled.

    

    If the Output may have different schema, use dynamic schema instead of predefined option is checked, the schema of the output feature set can't be predicted, including the field definition and geometry type. As a result, the renderer is ignored, and the feature set is added as a graphics layer using the default symbol.
11. Click OK to close the dialog box.

Use the Geoprocessing widget

1. Click the widget icon to open the Geoprocessing widget.
2. Enter a value for each of the input parameters. In this example, the drive time analysis geoprocessing task from ArcGIS Online is consumed. The task requires one or more starting locations and a set of space-delimited drive times used to calculate possible distances over time.
3. Most geoprocessing tasks require input using the map to draw geometries to provide as input for the geoprocessing task. Click the symbol icon to activate the drawing tool, and draw a feature on the map. To remove all features and start again, click Clear.

   

4. Once all required input parameters (annotated by an asterisk next to the name) have values, click Execute to submit the task.

   The Output tab is selected and displays a progress indicator until execution completes.

5. Upon completion, the geoprocessing results display on the map. Click Output to view their attributes.

   

6. Click Output to view their attributes.
7. Click the ellipsis (…) to export the results to one of the following formats when the Allow to export results box is checked.
   • Export to CSV file
   • Export to Feature Collection
   • Export to GeoJSON
   • Save to My Content

   The Save to My Content option saves the result as a feature collection item in My Content tab of the contents pane in ArcGIS Online orArcGIS Enterprise.

8. Click Clear on the Input tab to clear the location or X on the Output tab to clear the geoprocessing results from the map.