Skip To Content
ArcGIS Developer
Dashboard

Append Features (Network Diagram service)

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

ParameterDetails
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
}