Frequently asked questions

Frequently asked questions about the Utility Network Package Tools toolbox are listed for reference.

If you have a question that you think may frequently come up for other users, click the feedback link at the bottom of this page to submit it as a candidate.

Installation

Configuration

General

Installation

Installing the Utility Network Package Tools toolbox using the Python Package Manager is taking awhile to complete. Is this normal?

Yes, this is normal. As part of the installation process, another Python package, pandas, is being updated, which takes a few minutes.

I've already installed the Utility Network Package Tools and would like to get the most current version of the tools. How do I update the untools package?

In the Python Package Manager, click the Update Packages button to see packages available to update. Find the untools package and click the Update button to update the tools.

The untools package will only be available if you are using the most current version of ArcGIS Pro, or no earlier than 2.4. If the most recent version of the untools package is still not listed, install it using the Python Command Prompt and the following command: conda install -c esri untools and make sure the package is being updated to the most current version.

I don't see untools in the Python Package Manager. What should I do?

If you don't see untools in the Python Package Manager, first, verify that you're running ArcGIS Pro 3.0 and created a cloned environment. Once you've cloned your environment, browse to the Add Packages dialog box, and click Refresh Refresh to reload the list of available packages. Follow steps 3 through 6 in the Install the untools through the Python Package Manager.

I followed the steps above and still cannot see the untools. What should I do?

If your network intercepts SSL traffic, conda will fail to refresh the list of available packages in the Python Command Prompt. You can still install the tools, but you need to use the Python Command Prompt. Make sure you've created a cloned environment, and install the tools using the following steps:

  1. In the Windows Start menu, browse to the ArcGIS folder.
  2. Click the drop-down arrow next to ArcGIS and click Python Command Prompt to open the window.
  3. Verify that the first line of code displays the name of your cloned environment before continuing.
  4. Once confirmed, type conda install -c esri untools --insecure and press Enter.
    Python Command Prompt with a path to the cloned environment and the command conda install -c esri untools --insecure
  5. When the installation is complete, close the Python Command Prompt and start ArcGIS Pro to confirm that the Utility Network Package Tools toolbox has been added.

I need to install the untools on a machine that is disconnected from the Internet. Can I install the tools?

Yes. You'll need to manually download the tools, copy them to your machine, and use the Python Command Prompt to install them. To get started, complete the following steps:

  1. Click untools to open the Anaconda Cloud page containing the Utility Network Package Tools toolbox.
  2. Choose a version of the untools that aligns with your version of ArcGIS Pro and download the .tar.bz2 file.
  3. Save the file locally on the machine where you want to install the tools.
  4. In the Windows Start menu, browse to the ArcGIS folder.
  5. Click the drop-down arrow next to ArcGIS and click Python Command Prompt to open the window.
  6. Type conda install "<path to downloaded .tar.bz2 file>" --verbose and press Enter.
  7. When the installation is complete, close the Python Command Prompt and start ArcGIS Pro to confirm that the Utility Network Package Tools toolbox has been added.

The Utility Network Package Tools toolbox installation completed, but I can't find the tools. Did the installation complete successfully?

To view the toolbox, first close all instances of ArcGIS Pro that are running. Then, start ArcGIS Pro again so the geoprocessing cache updates. The tools should now be visible.

Configuration

How can I create my own empty asset package?

The easiest way is to create a new utility network (and domain networks, if necessary) is to export it to an asset package.

How do I rename a domain network in the asset package?

To rename a domain network in an asset package, you'll need to update two items in the asset package. First, update the description of the domain network in the AP_DomainNetworks attribute domain. Be sure to update just the description. Do not change the coded value. Second, rename the prefix on the domain feature classes (Assembly, Device, Junction, Line, and SubnetLine) in the UtilityNetwork dataset of the asset package. If you have attribute rules, you'll also need to update the Input Table name in the B_AttributeRules table.

This is only for domain networks in the asset package; structure networks cannot be renamed.

How can I update the portal utility network owner to another user?

As of ArcGIS Pro 2.4 release, there is a new geoprocessing tool Update Portal Dataset Owner that allows a user to transfer ownership of a utility network.

Why does the following error occur when I'm using the Apply Asset Package and Export Asset Package tools? Parameters are not valid. Error ERROR 000732: Input Utility Network: Dataset <Path to Dataset> does not exist or is not supported.

If you receive this error when exporting or importing a utility network using the Apply Asset Package or Export Asset Package tool, the path to your asset package is too long. Move the asset package to a different folder with a shorter path to resolve this issue.

General

Is it possible to create an asset package with a subset of the data?

When running the Export Asset Package tool, an area can be specified by defining Extent on the Environments tab of the Geoprocessing pane.

How should I update my utility network when I want to make a change, such as adding a rule? Should I make changes to the utility network or the asset package?

The recommended practice is to make the change in the utility network. This can be done by disabling the network topology, necessary changes made, such as adding new rules, and then enabling topology to continue working. If you would like a copy of the updated utility network configuration, run the Export Asset Package tool to create backup.

I'm looking for more information about the Python and ArcGIS Pro. Where can I find more information?

Review the Python in ArcGIS Pro page to learn more about

Where can I go for help?

If you need support for the Utility Network Package Tools toolbox, contact Esri Technical Support. Alternatively, to get help from other utility network community members, post your questions on GeoNet.

Top