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 Workflow Manager web app.
When the step is run in the Workflow Manager web app, the web map configured in the step template appears in the job tile. If help text was 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 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.
The type of geometry to be saved for the job's location is based on the geometry configured in the step. Consider the following conditions when selecting 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 removes any existing selections and making a selection removes drawn locations.
When you're finished defining a job location, click Proceed to save the job location and close the web map.
To cancel without defining the job's location, click Cancel. The job returns to its previous state and the workflow diagram remains on the current step.
If the job's location has already been defined, it's displayed as a read-only layer.
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 Settings panel appears.
- Provide a name for the step in the Step Name text box.
- Optionally, provide a description for the step in the Step Description text box.
- Configure step options in the Options section as necessary.
- Automatically Executes—Runs the step as soon as it becomes active.
- Can Be Skipped—Allows the step to be finished without being run.
- In the Logic section, click Edit.
The Define Location Step dialog box appears.
- Provide a name for the map you want to work with in ArcGIS Pro in the In ArcGIS Pro open the following map text box.
- Provide the URL for the web map you want to work with in the Workflow Manager web app in the In the web app open the following web map 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.
The URL must point to a public web map on ArcGIS Online
- 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 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 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.
- Optionally, click the Help tab and provide help text for the step in the Help text box.
- Optionally, click the Style tab to change the shape and color of the step.
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 is a list of return codes:
The step failed to complete successfully.
The step completed successfully.