The Define Location step allows you to identify where work needs to be performed for a job. The location can be a point, line, or polygon in an existing map, in an ArcGIS Pro project, or in a web map in the ArcGIS Workflow Manager web app.
When the step is run in the Workflow Manager web app, the web map configured in the step appears in the job tile. If help text is configured for the step, it appears at the bottom of the job tile. Selectable layers appear on the map, and all additional layers, except for the Job Location layer, are read-only. Use the Manage Layers widget to change the visibility of individual layers and use the Draw A Feature or Select Features widget to define the location for the job.
If the job's location is already defined, it can't be edited, but can be replaced by drawing or selecting new features.
When the step is run in ArcGIS Pro, the Job Location layer is added to the map configured in the step and the Create Features pane appears with the Job Location layer. If help text is configured for the step, it appears at the bottom of the job tile. Use the Create Features pane to define the location for the job.
The type of geometry used for the job's location is based on the geometry type configured in the step. Consider the following conditions when defining a job's location:
- Only features with the correct geometry type can be saved as the job's location.
- If more than one polygon or multiple line features of the correct geometry type are selected, the location is saved as a multipart feature.
- Drawing a location in the Workflow Manager web app removes any existing selections and selecting features removes drawn locations.
When you run the step, you can perform the following actions:
- Define a job location and click Proceed to complete the step.
- Click Cancel to cancel the step without defining the job's location.
Configure the step
Complete these steps to configure the Define Location step:
- Create or edit a workflow diagram to access the Step Library panel.
- Drag Define Location from the Step Library to a connection arrow of a step on the workflow canvas.
The Step Details panel appears.
- Provide a name for the step in the Step Name text box.
- In the Arguments section, click Edit.
The Define Location Step dialog box appears.
- Provide the name of the map you want to work with in ArcGIS Pro in the Map Name text box.
- Provide the URL for the web map you want to work with in the Workflow Manager web app in the Web Map URL text box.
The URL must point to a public web map on ArcGIS Online or a shared web map on the same ArcGIS Enterprise portal as the workflow item.
- Provide information about the task that needs to be performed in the User Prompt text box.
- Click the Location Method drop-down arrow and choose one of the following options for defining the job location:
- Select—Allows a location to be defined by selecting existing features on the map.
- Draw—Allows a location to be defined by creating features with the drawing tools in ArcGIS Pro or the widgets in the Workflow Manager web app.
- Select or Draw—Allows a location to be defined by selecting existing features on the map or by creating features with the drawing tools in ArcGIS Pro or the widgets in the Workflow Manager web app.
- Click the Job Location Geometry Type drop-down arrow and choose a geometry selection type for the job location.
- Click Save.
The Save button isn't available when parameters are configured with invalid values.
- Click the Options tab.
- Configure Step Options as necessary.
- Manual—Run the step manually.
- Optional—Allow the step to be finished without being run.
- Automatic—Run the step as soon as it becomes active.
- Run on a Schedule—Run the step according to a schedule you set.
- Manual—Run the step manually.
- Optionally, provide help text for the step in the Step Help text box.
- Optionally, click the Style tab to change the shape and color of the step.
- Optionally, click the About tab and provide a description for the step in the Step Description text box.
The About tab also contains the step's ID that can be used with dynamic job properties to obtain a step's output.
When the step finishes running, it sends a return code to indicate the result of the step. The return code is evaluated, and the workflow follows all paths that match the step's return value. The following table lists the step's return codes:
The step failed to complete successfully.
The step completed successfully.
When the step finishes running, its output is stored and can be used to determine the path the workflow follows or be used as inputs for other steps throughout the workflow. The following table lists the step's stored output:
The location that was defined when the step was run.