- URL:
- https://<root>/<serviceName>/UtilityNetworkServer/traceConfigurations/alter
- Methods:
POST- Required Capability:
- Requires the ArcGIS Advanced Editing user type extension license
- Version Introduced:
- 10.9
Description
The alter operation provides the ability to alter a single named trace configuration. A named trace configuration can only be altered by an administrator or the creator of the configuration. For example, you can update an existing trace configuration to accommodate changes in the network or address incorrectly set parameters without the need to delete and re-create a trace configuration. This enables existing map services to continue use of the named trace configuration without requiring the map to be republished.
Request parameters
| Parameter | Details |
|---|---|
| Specifies the output format of the response. The default response format is |
(Required) | Specifies the global ID of the named trace configuration to alter. Syntax: |
(Optional) | Specifies the altered name of the trace configuration. Syntax: |
(Optional) | Specifies the altered description of the trace configuration. Syntax: |
(Optional) | The trace type specifies the core algorithm that will be used to analyze the network. Trace types can be configured using the Syntax: Example: |
(Optional) | Specifies the collection of altered trace configuration properties. To reference the collection of trace configuration properties, see traceConfiguration properties. Syntax: |
(Optional) | Specifies the altered types of results to return. Syntax: |
(Optional) | Specifies the altered user-provided tags as an array of strings. Syntax: |
JSON Response syntax
{
“success” : <true | false>,
“error” : { // only if success is false
“extendedCode” : <HRESULT>,
“message” : <error message>,
“details” : [ <detail> ]
}
}Example usage
Alter the name, description, and resultTypes parameter of a named trace configuration in a utility network using the alter operation.
Request URL and parameters:
https
f=json
globalId={FA46F1EB-796C-4FB9-8E7B-B184EC6D43DC}
name=Connected_IncludeContainers_update
description=Connected trace example with containers (updated 112020)
traceType=
traceConfiguration={}
resultTypes=[{"type":"aggregatedGeometry","includeGeometry":false,"includePropagatedValues":false,"networkAttributeNames":[],"diagramTemplateName":"","resultTypeFields":[]}]
tags=JSON response:
{
"success": true
}