Open Pro Project Items

The Open Pro Project Items step allows you to open existing ArcGIS Pro project items such as maps, layouts, scenes, tasks, and web maps that are configured in the project. If the item is a mapping item, data layers can automatically point to the appropriate job-specific version of the data if one is available.

Note:

You can only run this step type from ArcGIS Pro. For a similar experience in the ArcGIS Workflow Manager web app, use the Open Web App step.

When you run the step, the items defined in the step open in an ArcGIS Pro project. When the step is run, you can perform the following actions:

  • Click the Pause Step button Pause Step to pause the step and close the project items so that you can return to your work at a later time.
  • Click the Complete Step button Complete Step to finish the step and close the project items.

If the step has not been configured with Can Be Skipped, the step must be run or paused at least once before it can be finished.

Configure the step

You can add any combination of ArcGIS Pro maps, layouts, web maps, and tasks to the step. The order of the items opened in ArcGIS Pro is defined by the order in which you add them to the step. Complete these steps to open items in an ArcGIS Pro project:

  1. Create or edit a workflow diagram to access the Step Library panel.
  2. Drag Open Pro Project Items from the Step Library to a connection arrow of a step on the workflow canvas.

    The Step Details panel appears.

  3. Provide a name for the step in the Step Name text box.
  4. Optionally, provide a description for the step in the Step Description text box.
  5. 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.
  6. In the Logic section, click Edit.

    The ArcGIS Pro Mapping Step dialog box appears.

  7. Choose one of the following options in the ArcGIS Pro Project section:
    • Use Current—Use the current project in ArcGIS Pro.
    • Template Project Package URL—Specify the URL of an ArcGIS Pro project template that has been shared to a portal to open the template in ArcGIS Pro.
  8. In the Open Items section, click Open New Item to add the items you want to open in the project.
  9. Provide the name of the item you want to work with in the Name text box.
  10. Choose the type of item you want to work with in the Type drop-down list.
  11. If the Create Version step is used in your workflow diagram to create a job-specific version of your data, check the Repoint Version check box to repoint mapping item data layers to the job-specific version when the step is run.
    Note:

    The Repoint Version check box is unavailable for task items.

  12. Optionally, repeat steps 7 through 10 to add additional items.
    Note:

    To delete an item, hover over it and click the Delete Item button Delete Item.

  13. Optionally, click the Finish tab and check the Reset to Default check box to point the mapping item data layers back to the original version when the step is completed.
    Note:

    The Reset to Default check box is unavailable for task items.

  14. Click the Advanced tab and configure options as necessary.
    • Zoom to Location—Zooms the map items to the job's location if a location has been defined for the job.
  15. Click Save.
    Note:

    The Save button isn't available when parameters are configured with invalid values.

  16. Optionally, click the Help tab and provide help text for the step in the Help text box.
  17. Optionally, click the Style tab to change the shape and color of the step.

Return codes

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:

Return codeDescription

Failure

The step failed to complete successfully.

Success

The step completed successfully.

Related topics