- URL:https://<diagram-url>/appendFeatures
- Version Introduced: 10.6
Description
The appendFeatures operation is performed on a Diagram resource. The result of this operation is a Diagram JSON Information object, and the moment (date) the appendFeatures operation happens for a stored diagram.
It is used to append a set of utility network feature to the diagram resource.
License:
The active portal account must be licensed with the ArcGIS Utility Network user type extension or the ArcGIS Trace Network user type extension to use this operation.Request Parameters
| Parameter | Details |
|---|---|
| gdbVersion | Description: The name of the geodatabase version. Syntax: gdbVersion=<version> Example: gdbVersion=ABV1 |
| sessionId | Description: The token (guid) used to lock the version. Syntax: sessionId=<guid> Example: sessionId=44G259DE-87B0-407D-8F2E-DCB7665DD0F0 |
| addedFeatures | Required Description: An array of utility network feature Global IDs, those features being those to append to the diagram resource. Syntax: addedFeatures = ["<globalID1>", ...,"<globalIDN>"] Example: addedFeatures = ["{BAF7AC0F-47CB-479A-A916-827D18890375}"] |
| f | Description: The response format. The default response format is html. Values: <html | json> |
Example Usage
Appending a utility network edge—which Global ID is {BAF7AC0F-47CB-479A-A916-827D18890375}—to the diagram called DiagramTest1; that is:
- URL: https://myserver.esri.com/server/rest/services/Naperville/NetworkDiagramServer/diagrams/DiagramTest1/appendFeatures
- Parameters:
gdbVersion= sessionId= addedFeatures= ["{BAF7AC0F-47CB-479A-A916-827D18890375}"] f=pjson - Sent URL (GET): https://myserver.esri.com/server/rest/services/Naperville/NetworkDiagramServer/diagrams/DiagramTest1/appendFeatures?gdbVersion=&sessionId=&addedFeatures=%5B%22%7BBAF7AC0F-47CB-479A-A916-827D18890375%7D%22%5D&f=pjson
JSON Response Syntax
A JSON object composed of a Diagram JSON Information object and a moment: {"diagramInfo": Diagram JSON Information, "moment": <moment>}
Note:
The moment is only returned for a stored diagram.
JSON Response Example
{
"diagramInfo": {
"tag": "",
"isStored": true,
"canStore": false,
"canExtend": true,
"isSystem": false,
"creator": "acb7352",
"creationDate": 1503065870000,
"lastUpdateBy": "acb7352",
"lastUpdateDate": 1503066050000,
"containerMargin": 0.5,
"junctionCount": 17,
"edgeCount": 16,
"containerCount": 3,
"aggregationCount": 0,
"isHistorical": false,
"access": "esriDiagramPublicAccess",
"diagramExtent": {
"xmin": 1034221.5694996789,
"ymin": 1871808.4880382791,
"xmax": 1034521.7178495117,
"ymax": 1871863.5430462807,
"spatialReference": {
"wkid": 102671,
"latestWkid": 3435
}
},
"networkExtent": {
"xmin": 1034222.0694986805,
"ymin": 1871808.4880382791,
"xmax": 1034521.2178505138,
"ymax": 1871863.0430472791,
"spatialReference": {
"wkid": 102671,
"latestWkid": 3435
}
},
"name": "DiagramTest1",
"id": "{22C1EEB8-1152-440F-B2FF-6B7C6A43076E}",
"template": "Basic"
},
"moment": 1503066050261
}