- URL:
- https://<root>/<serviceName>/UtilityNetworkServer/unitIdentifiers/insertGap
- Methods:
GETPOST- Version Introduced:
- 11.5
Description
The insert operation on the unit resource inserts a gap into the NextUnitID sequence of a unit container feature's containment hierarchy in a telecom domain network. When a gap is inserted at the end of the sequence, the NEXTUNITID attribute value for the unit container increases. If a gap is inserted into the middle of an existing sequence, the system will attempt to shift existing records to accommodate the reserved space. The operation will fail and return an error if the reservation requires regrouping an object or occurs in the middle of a connectivity assignment.
Learn more about reserving unit identifiers
Request parameters
| Parameter | Details |
|---|---|
| The output format of the response. The default response format is |
(Optional) | Specifies the name of the geodatabase version. The default value is Syntax: |
(Optional) | Specifies the token guid used to lock the version. If the calling client is editing a named version, the Syntax: |
(Optional) | Specifies the session moment. The default value is the version's current moment. This should only be specified by the client when they do not want to use the current moment. Syntax: Example: |
(Optional) | The unit identifiable features or objects being reset. Syntax: Example: |
(Optional) | The first unit for the gap to be introduced.
|
(Optional) | The number of units in the gap.
|
Example usage
Use the insert operation to reserve unit identifiers on the tail of the NEXTUNITID sequence, updating the NextUnitID attribute value on the unit container feature from 13 to 15.
Request URL and parameters:
https
f=json
gdbVersion=sde.Default
object= {
"sourceId": 16,
"globalId": "{B97653FC-99C7-4DBF-954D-F38EA214C692}"
}
firstUnit=13
numUnits=2JSON Response syntax
{
"exceededTransferLimit": false,
"serviceEdits": [
{
"id": 5,
"editedFeatures": {
"spatialReference": {
"wkid": 3498,
"latestWkid": 3498,
"xyTolerance": 0.003280833333333333,
"zTolerance": 0.001,
"mTolerance": 0.001,
"falseX": -117608900,
"falseY": -91881400,
"xyUnits": 3048.0060960121929,
"falseZ": -100000,
"zUnits": 10000,
"falseM": -100000,
"mUnits": 10000
},
"updates": [
[
{
"attributes": {
"objectid": 13,
"assetgroup": 1,
"assettype": 2,
"associationstatus": 1,
"terminalconfiguration": "Default",
"containersourceid": null,
"containerglobalid": null,
"nextunitid": 7,
"rootcontainerstate": null,
"clusterkey": null,
"globalid": "{B97653FC-99C7-4DBF-954D-F38EA214C692}",
"created_user": null,
"created_date": null,
"last_edited_user": "unadmin",
"last_edited_date": 1736878108000
},
"geometry": {
"x": 6812288.661061972,
"y": 1843640.8011838943,
"z": 0,
"m": null
}
},
{
"attributes": {
"objectid": 13,
"assetgroup": 1,
"assettype": 2,
"associationstatus": 1,
"terminalconfiguration": "Default",
"containersourceid": null,
"containerglobalid": null,
"nextunitid": 15,
"rootcontainerstate": null,
"clusterkey": null,
"globalid": "{B97653FC-99C7-4DBF-954D-F38EA214C692}",
"created_user": null,
"created_date": null,
"last_edited_user": "unadmin",
"last_edited_date": 1736878175000
},
"geometry": {
"x": 6812288.661061972,
"y": 1843640.8011838943,
"z": 0,
"m": null
}
}
]
]
}
}
],
"moment": 1736878175375,
"success": true
}