Configure Pipeline Referencing environment

To prepare for implementation of ArcGIS Pipeline Referencing, follow the steps below to create a new file geodatabase you can use to copy to ArcGIS Enterprise. The included UPDM_PipelineReferencing file geodatabase contains sample data in the USA Contiguous Albers Equal Area Conic USGS projection for you to test ArcGIS Pipeline Referencing. The steps below will walk you through creating a new model which will be configured with the spatial reference you use in your organization.

Note:

If you extended your model using any of the steps in the Configure data model topic, and it resulted in a new data model being created, you will reference that newly created data model in the steps below.

Calculate tolerance and resolution values for your spatial reference

Use the Calculate Tolerances and Resolutions tool to determine the tolerance and resolution values for the spatial reference you will use for your data model.

1. In the Geoprocessing pane, expand the Project toolbox section, expand the Utility Data Management Support toolbox, and expand the APR toolset. Click the Calculate Tolerances and Resolutions tool.
2. In the tool, set the following parameters:
   1. For Spatial Reference, specify the spatial reference you want to apply to the data model.
   2. For Measure Unit, choose the appropriate units you will be using for your linear referencing system.
3. Click Run.
4. Record the tolerance and resolution values output form the tool. You will use these to set the Environments values in the next step.

Use the Change GDB Spatial Reference tool to adjust the spatial reference, and generate a new data model by copying the schema of the data model without the sample data.

Project and remove sample data

Use the Change GDB Spatial Reference tool to create a new copy of the included geodatabase, configured for the spatial reference for your destination enterprise geodatabase.

1. In the Geoprocessing pane, expand the Project toolbox section, and expand the Utility Data Management Support toolbox. Click the Change GDB Spatial Reference tool.
2. In the tool, set the following parameters:
   1. For Geodatabase, specify the UPDM_PipelineReferencing geodatabase.
   2. For Output Spatial Reference, specify the spatial reference you want to apply to the data model.
   3. For Folder Location, set to the location where you want to save your new data model.
   4. For Output Name, specify the name of the output data model.
   5. Click the Environments tab, and enter the values from the previous Calculate Tolerances and Resolutions step.
3. Click Run.

Rename LRS

Use the Modify LRS geoprocessing tool to rename the LRS from APR to your preferred name.

1. In the Geoprocessing pane, expand the System toolbox section, and expand the Location Referencing Tools toolbox, and expand the Configuration and LRS toolsets. Click the Modify LRS tool.
2. In the tool, set the following parameters:
   1. For Input Workspace, specify the customized geodatabase you created in the previous step.
   2. The Current LRS Name will populate with the current name.
   3. For New LRS Name, type in the new name for your LRS.
3. Click Run.

Modify Events or Network

Use the Remove LRS Entity geoprocessing tool to remove any networks, events or intersections from your LRS.

1. In the Geoprocessing pane, expand the System toolbox section, and expand the Location Referencing Tools toolbox, and expand the Configuration toolset. Click the Remove LRS Entity tool.
2. In the tool, set the following parameters:
   1. For LRS Workspace, specify the customized geodatabase you used in the previous step.
   2. For LRS Entity Type choose the entity type you wish to remove.
   3. For LRS Entity Name, choose the entity you wish to remove.
3. Click Run.

   Repeat these steps as necessary to remove all the entities you will not be using.

Modify Event Behavior Rules

Use the Modify Event Behavior Rules tool to modify event behavior rules for any registered event layer or feature class.

1. In the Geoprocessing pane, expand the System toolbox section, and expand the Location Referencing Tools toolbox, then expand the Configuration and LRS Event toolsets. Click the Modify Event Behavior Rules tool.
2. In the tool, set the following parameters:
   1. For Event Feature Class, choose the event feature class you wish to modify the rules for.
   2. Use the Modify Event Behavior Rules documentation to learn about the rule parameters, and set them appropriately.
3. Click Run.

   Repeat these steps as necessary to modify the necessary event rules.

Load data

The following workflows provides steps to load your data into the Pipeline Referencing data model.

Append source data

There are multiple ways to load data into the geodatabase. Review the options below and select one appropriate for you.

• To append events and routes use the Location Referencing tools: Append Events and Append Routes tools.
• Build a data loading workspace using the Data Loading toolset within the Data Management toolbox.
• Use the Append tool within the Data Management toolbox.
• Build your own geoprocessing model using the Data Management toolbox tool and field calculations.
• Use the ArcGIS Data Interoperability extension to build a workbench.
• Use an Esri Business Partner's solution.

Configure editing map

Included with the Pipeline Referencing Foundation solution is a map titled Pipeline Referencing Editor. This map allows you to explore the asset types and asset groups associated with the data model. Use the steps below to help you expand the map to fit your organizational needs.

Update data sources

Use the Update Data Sources tool in the Utility Data Management Support toolbox to update the layer's data source.

1. In the Geoprocessing pane, expand the Project toolbox section, expand the Utility Data Management Support toolbox, and expand the Map toolset. Click the Update Data Sources tool.
2. In the tool, set the following parameters:
   1. For Target Workspace, select the geodatabase that was created in the Create Pipeline Referencing environment section above.
   2. For Maps, check Pipeline Referencing Editor.
3. Click Run.

   Review any warnings and manually correct the layers using their properties page.

Adjust symbology and pop-ups

The Pipeline Referencing Editor map comes with a predefined set of symbology and pop-ups. If you expanded or changed the model, you will need to adjust the map to accommodate for those changes.

Modify map layers

Note:

This workflow is optional and doesn't need to be completed in order to work with the solution.

As you develop your editing map, you may find that you need to explore and modify field parameters for certain asset types. Use the Map Layers to CSV and Set Field Properties from CSV tools in the Utility Data Management Support toolbox to explore and modify the map layers as needed.

1. In the Geoprocessing pane, expand the Project toolbox section, expand the Utility Data Management Support toolbox, and expand the Map toolset. Click the Map Layers to CSV tool.
2. In the tool, set the following parameters:
   1. For Pro Project, it can be left blank, as it will use the current project by default.
   2. For Map, select the Pipeline Referencing Editor map.
   3. For Output folder, select where the CSV file will be output to.
3. Click Run.

Note:

The exported CSV file will contain properties and information about the layers in the map properties. The columns Field Alias, Field Visibility, Read Only, and Search Mode can be updated with new values and then the Set Field Properties from CSV tool can be used to transfer those values back to the map.

Add industry attribute rules

Note:

This workflow is optional and doesn't need to be completed in order to work with the solution.

If you are interested in adding or modifying rules such as asset ID calculation or symbol rotation, you can use this GitHub page to learn how to apply and configure these rules.

Configure multiuser environment

To set up your utility network for multiuser editing in an enterprise environment, you can continue with the Configure a multiuser environment topic.