Find Network Features (Network Diagrams)

  • URL:http://<diagram-url>/findNetworkFeatures
  • Version Introduced: 10.6

Description

The findNetworkFeatures operation is performed on a Diagram resource. It returns an array of network feature globalIDs.

This is the operation to use to search for the diagram features referenced in the diagram resource that are associated with a set of utility network features or a set of diagram features represented in another network diagram.

License:
The ArcGIS Utility Network Management extension is required 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

moment

Description: The session moment.

Syntax: moment=<moment>

Example: moment=1490867969324

fromFeatures

Required

An array of diagram network feature Global IDs

Syntax: fromFeatures=["<DgFeatglobalID1>", ...,"<DgFeatglobalIDN>"]

Example: fromFeatures=["{34740A9C-F8B4-4812-B08F-187139EA9547}"]

includeAggregations

Required

Boolean

  • True—The operation returns all the network features associated with the diagram features specified in the fromFeatures parameter whether those features are reduced or collapsed in the diagram resource.
  • False—The operation only returns the network features associated with diagram features specified in the fromFeatures parameter which are not reduced nor collapsed in the diagram resource; that is, it only returns the network features associated with the specified diagram features which are visibly represented in the diagrams.

Syntax: includeAggregations=<true | false>

Example: includeAggregations=true

f

Description: The response format. The default response format is html.

Values: <html | json>

Example Usage

Retrieving the utility network features associated with the diagram feature which Global ID is "{1EE98487-730C-4193-8510-8BF975332237}" in the "DiagramTest1" diagram resource; that is, executing the findNetworkFeatures operation on the "DiagramTest1" diagram resource with:

  • fromFeatures=["{1EE98487-730C-4193-8510-8BF975332237}"],
  • includeAggregations=true

http://batz.esri.com/server/rest/services/Naperville/NetworkDiagramServer/diagrams/DiagramTest1/findNetworkFeatures?gdbVersion=&sessionId=&moment=&fromFeatures=%5B%22%7B1EE98487-730C-4193-8510-8BF975332237%7D%22%5D&includeAggregations=true&f=pjson

JSON Response Syntax

{
 "features": [
  {
   "globalID": "<globalID1>", // GUID of the associated network feature
   "featureOID": <featureOID1>, // ObjectID of the associated network feature (int)
   "networkSourceID": <networkSourceID1>, // ID of the associated network feature source class (int)
   "geometryType": <0 | 1 | 2 | 3 | 4> // geometry type of the associated network feature 0: edge, 1: point, 2:?, 3:?, 4:polygon
  },
  ...
  {
   "globalID": "<globalIDN>",
   "featureOID": <featureOIDN>, 
   "networkSourceID": <networkSourceIDN>,
   "geometryType": <0 | 1 | 2 | 3 | 4>
  }
 ]
}

JSON Response Example

Example usage's response

{
 "features": [
  {
   "globalID": "{AF41424F-1073-4640-A596-220AC3A33DA6}",
   "featureOID": 3094,
   "networkSourceID": 6,
   "geometryType": 1
  }
 ]
}