Create a water utility network

The Water Distribution Utility Network project includes an asset package that defines the baseline configuration of a utility network for water distribution. This asset package defines the schema for common water distribution components and the rules to define network behavior. The asset package is the default geodatabase for this project.

Set up an enterprise geodatabase

To set up an enterprise geodatabase, complete the following steps:

Sign in to Portal with the user that will become the portal utility network owner. The portal account you use to sign in will be used for other operations such as configuring and publishing the utility network.

  1. Start ArcGIS Pro and click Settings to access the project settings.
  2. Click Open and Portal to view content in your portal.
  3. Expand the My Content drop-down arrow and select the Water Distribution Utility Network project package to open it.
  4. Once you open the project, click the Analysis tab on the ribbon. In the Geoprocessing group, click Tools Tools to open the Geoprocessing pane.
  5. In the Geoprocessing pane, browse to the Data Management toolbox. In the Geodatabase Adminstration toolset, click Create Enterprise Geodatabase.
  6. Fill in the tool parameters and run the Create Enterprise Geodatabase tool to create an enterprise geodatabase that you'll use to create and configure the utility network.

  7. Once the enterprise geodatabase is created, on the View tab, in the Windows group, click Catalog Pane Catalog Pane.
  8. In the Catalog pane, on the Project tab, right-click Databases and click New Geodatabase Connection New Geodatabase Connection.
  9. Create a database connection to the newly created enterprise geodatabase.
  10. In the Geoprocessing pane, browse to the Data Management toolbox. In the Geodatabase Adminstration toolset, click Create Database User.
  11. Fill in the tool parameters and run the tool to create a new database user for your database connection.

    This user will be the database utility network owner.

  12. In the Catalog pane, on the Project tab, right-click your enterprise database connection and click Connection Properties to open the Database Connection dialog box.
  13. Enter the username and password created in step 11, and click OK.

Learn about working with SQL Server, Oracle, PostgresSQL on Windows and Linux, or SAP HANA geodatabases and best practices for geodatabase management.

Stage the utility network

Once you've created an enterprise geodatabase and connected to the database using the utility network owner role, the tools in the Utility Network Package Tools toolbox can be used to stage the utility network in the enterprise geodatabase.

To stage the utility network, complete the following steps:

  1. In ArcGIS Pro, open the project referenced in the section above.
  2. On the Analysis tab, in the Geoprocessing group, click Tools Tools.
  3. In the Geoprocessing pane, click the Toolboxes tab to view the toolboxes provided with ArcGIS Pro.
  4. Browse to the Utility Network Package Tools toolbox and click the drop-down arrow to view the tools and toolset in the toolbox.
  5. Click Stage Utility Network to open the tool.
  6. Update the tool with the following parameter information and use the image as an example:

    The Stage Utility Network geoprocessing dialog

    • Set the Input Geodatabase parameter to an enterprise database connection where you will create your utility network.
    • Set the Service Territory Feature Class parameter to a polygon feature class that will define the service area of your utility network. If using the sample data, this is in the water asset package geodatabase.
    • Specify a name for the utility network dataset in the Feature Dataset Name parameter.
    • Specify a name for the utility network in the Utility Network Name parameter.

  7. Click Run.

    When complete, a feature dataset containing the utility network configured to use the geographic extent of the service territory is created.

Apply the asset package

Once you've staged the utility network in the enterprise geodatabase, the water distribution asset package is applied to define the rules and configuration of a utility network and its feature classes.

To apply the asset package, complete the following steps:

  1. On the Analysis tab, in the Geoprocessing group, click Tools Tools.
  2. In the Geoprocessing pane, click the Toolboxes tab to view the toolboxes provided with ArcGIS Pro.
  3. Browse to the Utility Network Package Tools toolbox and click the drop-down arrow to view the tools and toolsets in the toolbox. Expand the Asset Package toolset.
  4. Click Apply Asset Package to open the tool.
  5. Update the tool with the following parameter information and use the image as an example:

    The Apply Asset Package tool with the parameters filled in using the provided sample data

    • Set the Asset Package parameter to the asset package included with the project, or an asset package of your choice.
    • Under the Domain Networks to apply parameter, check all the domain networks you want to apply.
    • Optionally, apply a subset of the asset package in the Configurations to apply section. By default all options are selected and will be included in the resulting utility network. Uncheck a configuration option such as Attachments to exclude it from being applied.
    • Optionally, choose to rename your asset package by selecting a drop-down option from the Rename using parameter.
    • For the Input Utility Network parameter, browse to your enterprise geodatabase and select the utility network created in the Stage Utility Network section above.
    • Check the Load data parameter to load data from your asset package into the utility network.
    • If loading data, the Calculate Spatial Index and Analyze parameter becomes visible and checked by default. This parameter calculates the spatial index for all feature classes and analyzes the feature dataset to improve performance on enable.

  6. Click Run.

    The tool added domain networks, configured the schema and properties of the utility network, and if specified, loaded data into the network.

Configure your utility network

The asset packages provided by Esri are designed to provide a baseline configuration; they are not designed to be all-inclusive data models containing every asset that a utility might have. The baseline schema should not be modified. Certain modifications to the baseline schema can result in undesired network behavior.

With this in mind, you can configure the baseline utility network using tools in the Utility Network and Data Management toolboxes to meet the requirements of your organization. Learn more about tools for configuring a utility network and manually configuring the baseline utility network.

Once you have created your utility network, there are a few post processing steps to complete to fully enable your network.

Top