Enable Topology

URL:
https://<root>/<serviceName>/UtilityNetworkServer/enableTopology
Methods:
POST
Required Capability:
Requires the portal utility network owner and ArcGIS Advanced Editing user type extension license
Version Introduced:
10.6

Description

The enableTopology operation enables the network topology for a utility network in the DEFAULT version. When the topology is enabled, all feature and association edits generate dirty areas, which are then consumed when you use validate to update the network topology. When the topology is enabled, the following happens:

  • The topology is built and updated for the full extent of the network.
  • All errors are deleted.
  • Any new errors are added to the dirty areas sublayer of the utility network.
  • The topology is marked as enabled.

You can enable the topology using either an asynchronous or synchronous job. While the network is being enabled, all other sessions connected to the DEFAULT version are blocked from running validate or enable operations. This operation is not supported with named versions.

Request parameters

ParameterDetails

f

Specifies the output format of the response. The default response format is html .

1
f=html | json | pjson

maxErrorCount

(Optional)

The maxErrorCount specifies the threshold of errors that will stop the process of enabling the network topology when met. The default value is 10,000.

Syntax: maxErrorCount=<integer>

Example: maxErrorCount=10000

async

(Optional)

Introduced at ArcGIS Enterprise 10.9.1. If true, the request is processed as an asynchronous job, and a URL is returned that a client can visit to check the status of the job. The default is false.

1
async=true | false

JSON Response syntax

JSON response (when async = false):

1
2
3
4
5
6
7
8
9
{
  "moment" : <datetime>,
  "success" : <true | false>,
  "error" : {                   // only if success is false
    "extendedCode” : <HRESULT>,
    "message" : <error message>,
    "details" : [ <detail> ]
  }
}

JSON response (when async = true):

1
2
3
{
  "statusUrl" : <url>
}

JSON response to the status URL (when pending or in progress):

1
2
3
4
5
{
  "status" : "<Pending | InProgress>",
  "submissionTime" : <datetime>,
  "lastUpdatedTime" : <datetime>
 }

Example usage

Enable the network topology for a utility network using the enableTopology operation.

Request URL and parameters:

https://myserver.esri.com/server/rest/services/LandUse/UtilityNetworkServer/enableTopology

1
2
3
f=json
maxErrorCount=1000
async=false

JSON response:

1
2
3
4
{
 "moment": 1554336000000,
 "success": true
}

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.

You can no longer sign into this site. Go to your ArcGIS portal or the ArcGIS Location Platform dashboard to perform management tasks.

Your ArcGIS portal

Create, manage, and access API keys and OAuth 2.0 developer credentials, hosted layers, and data services.

Your ArcGIS Location Platform dashboard

Manage billing, monitor service usage, and access additional resources.

Learn more about these changes in the What's new in Esri Developers June 2024 blog post.

Close