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 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 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.
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 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 selecting features 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 can't be edited, but can be replaced by drawing or selecting new features.
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.
- 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 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.
- 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 table lists the step's return codes:
The step failed to complete successfully.
The step completed successfully.