Find Diagram Features

URL:: https://<root>/<serviceName>/NetworkDiagramServer/diagrams/<diagramName>/findDiagramFeatures
Methods:: POST
Version Introduced:: 10.6

Description

The findDiagramFeatures operation searches for the diagram features referenced in the diagram that are associated with a set of network elements or a set of diagram features represented in another diagram. It is performed on a Diagram resource. It returns an array of diagram feature JSON objects for the input fromDiagram.

Request parameters

Parameter Details

Parameter	Details
`gdbVersion`	The name of the geodatabase version. Syntax: `gdbVersion=<version>` Example: `gdbVersion=ABV1`
`sessionId`	The token (guid) used to lock the version. Syntax: `sessionId=<guid>` Example: `sessionId=44G259DE-87B0-407D-8F2E-DCB7665DD0F0`
`moment`	The session moment. Syntax: `moment=<moment>` Example: `moment=1490867969324`
`fromFeatures` (Required)	Depending on whether you want to retrieve diagram features associated with network elements (case#1) or with diagram features that are represented in another diagram (case#2), an array of network element Global IDs (case#1), or an array of network diagram feature Global IDs (case#2). Syntax: `fromFeatures = ["<globalID1>", ...,"<globalIDN>"]` Example: Case#1—Retrieving the diagram feature Global IDs associated with the specified network Global IDs {E6260A67-94F6-4640-B717-4D3A9E5A0F17} in the diagram resource: Use dark colors for code blocksCopy `1 fromFeatures = ["{E6260A67-94F6-4640-B717-4D3A9E5A0F17}"]` Case#2—Retrieving the diagram feature Global IDs in the diagram resource that are associated with the specified diagram feature Global IDs {FDE3A114-D367-4FA9-BAAC-C4B9B9F57B87}, those features being represented in the specified "testStore" diagram; that is, with Use dark colors for code blocksCopy `1 2 fromDiagram=testStore fromFeatures = ["{FDE3A114-D367-4FA9-BAAC-C4B9B9F57B87}"]`
`fromDiagram`	The name of the diagram the Global IDs specified for the `fromFeatures` parameter belong to, or null when the `fromFeatures` parameter references network elements. Syntax: `fromDiagram=<diagramName>` Example: `fromDiagram=testStore`
`includeAggregations` (Required)	A boolean statement that determines whether to include aggregated network elements. Case#1—When the fromFeatures reference network element Global IDs `true`—The operation returns the diagram features that strictly represent these network elements in the diagram, and the diagram features that are associated with these network elements but not represented in the diagram where they are reduced or collapsed. `false`—The operation only returns the diagram features associated with these network elements that are not reduced nor collapsed in the diagram; that is, it only returns the diagram features associated with these network elements that are visibly represented in the diagram. Case#2—When the fromFeatures reference diagram feature Global IDs represented in another diagram `true`—The operation returns the diagram features associated with the same network elements those diagram features are, whether those features are reduced or collapsed in this other diagram and/or in the diagram. `false`—The operation only returns the diagram features associated with the same network elements that are visibly represented in this other diagram and in the diagram. Syntax: `includeAggregations=<true \| false>` Example: `includeAggregations=true`
`addConnectivityAssociations` (Required)	A boolean statement that determines whether to include the connectivity associations. When the fromFeatures reference utility network feature Global IDs `true`—The operation also adds any connectivity association diagram edges for which it has just retrieved both the "from" and "to" diagram junctions. `false`—The operation doesn't add any connectivity association diagram edges represented in the diagram resource. Syntax: `addConnectivityAssociations=<true \| false>` Example: `addConnectivityAssociations=true`
`addStructuralAttachments` (Required)	A boolean statement that determines whether to include the structural attachments. When the fromFeatures reference network elements Global IDs `true`—The operation also adds any structural attachment diagram edges for which it has just retrieved both the "from" and "to" diagram junctions. `false`—The operation doesn't add any structural attachment diagram edges represented in the diagram resource. Syntax: `addStructuralAttachments=<true \| false>` Example: `addStructuralAttachments=true`
`f`	The response format. The default response format is html. Values: `<html \| json>`

gdbVersion

The name of the geodatabase version.

Syntax: gdbVersion=<version>

Example: gdbVersion=ABV1

sessionId

The token (guid) used to lock the version.

Syntax: sessionId=<guid>

Example: sessionId=44G259DE-87B0-407D-8F2E-DCB7665DD0F0

moment

The session moment.

Syntax: moment=<moment>

Example: moment=1490867969324

fromFeatures

(Required)

Depending on whether you want to retrieve diagram features associated with network elements (case#1) or with diagram features that are represented in another diagram (case#2), an array of network element Global IDs (case#1), or an array of network diagram feature Global IDs (case#2).

Syntax: fromFeatures = ["<globalID1>", ...,"<globalIDN>"]

Example:

Case#1—Retrieving the diagram feature Global IDs associated with the specified network Global IDs {E6260A67-94F6-4640-B717-4D3A9E5A0F17} in the diagram resource:

Use dark colors for code blocksCopy
fromFeatures = ["{E6260A67-94F6-4640-B717-4D3A9E5A0F17}"]

Case#2—Retrieving the diagram feature Global IDs in the diagram resource that are associated with the specified diagram feature Global IDs {FDE3A114-D367-4FA9-BAAC-C4B9B9F57B87}, those features being represented in the specified "testStore" diagram; that is, with

Use dark colors for code blocksCopy
fromDiagram=testStore
fromFeatures = ["{FDE3A114-D367-4FA9-BAAC-C4B9B9F57B87}"]

fromDiagram

The name of the diagram the Global IDs specified for the fromFeatures parameter belong to, or null when the fromFeatures parameter references network elements.

Syntax: fromDiagram=<diagramName>

Example: fromDiagram=testStore

includeAggregations

(Required)

A boolean statement that determines whether to include aggregated network elements.

Case#1—When the fromFeatures reference network element Global IDs

true—The operation returns the diagram features that strictly represent these network elements in the diagram, and the diagram features that are associated with these network elements but not represented in the diagram where they are reduced or collapsed.
false—The operation only returns the diagram features associated with these network elements that are not reduced nor collapsed in the diagram; that is, it only returns the diagram features associated with these network elements that are visibly represented in the diagram.

Case#2—When the fromFeatures reference diagram feature Global IDs represented in another diagram

true—The operation returns the diagram features associated with the same network elements those diagram features are, whether those features are reduced or collapsed in this other diagram and/or in the diagram.
false—The operation only returns the diagram features associated with the same network elements that are visibly represented in this other diagram and in the diagram.

Syntax: includeAggregations=<true | false>

Example: includeAggregations=true

addConnectivityAssociations

(Required)

A boolean statement that determines whether to include the connectivity associations.

When the fromFeatures reference utility network feature Global IDs

true—The operation also adds any connectivity association diagram edges for which it has just retrieved both the "from" and "to" diagram junctions.
false—The operation doesn't add any connectivity association diagram edges represented in the diagram resource.

Syntax: addConnectivityAssociations=<true | false>

Example: addConnectivityAssociations=true

addStructuralAttachments

(Required)

A boolean statement that determines whether to include the structural attachments.

When the fromFeatures reference network elements Global IDs

true—The operation also adds any structural attachment diagram edges for which it has just retrieved both the "from" and "to" diagram junctions.
false—The operation doesn't add any structural attachment diagram edges represented in the diagram resource.

Syntax: addStructuralAttachments=<true | false>

Example: addStructuralAttachments=true

f

The response format. The default response format is html.

Values: <html | json>

Example usage

Example#1—Retrieving the diagram feature Global IDs associated with the utility network feature which Global ID is {AF41424F-1073-4640-A596-220AC3A33DA6} in the "DiagramTest1" diagram resource; that is:

URL: https://myserver.esri.com/server/rest/services/Naperville/NetworkDiagramServer/diagrams/DiagramTest1/findDiagramFeatures

Parameters:

Use dark colors for code blocksCopy
gdbVersion=
sessionId=
moment=
fromFeatures=["{AF41424F-1073-4640-A596-220AC3A33DA6}"]
fromDiagram=
includeAggregations=true
addConnectivityAssociations=false
addStructuralAttachments=false
f=pjson

Sent URL (GET): https://myserver.esri.com/server/rest/services/Naperville/NetworkDiagramServer/diagrams/DiagramTest1/findDiagramFeatures?gdbVersion=&sessionId=&moment=&fromFeatures=%5B%22%7BAF41424F-1073-4640-A596-220AC3A33DA6%7D%22%5D&fromDiagram=&includeAggregations=true&addConnectivityAssociations=false&addStructuralAttachments=false&f=pjson

Example#2—Retrieving in the "Basic_RMT003" diagram resource the diagram feature Global IDs which are associated with the same utility network feature or features as the diagram feature with Global ID {1EE98487-730C-4193-8510-8BF975332237}, which is in the the "DiagramTest1" diagram; that is:

URL: https://myserver.esri.com/server/rest/services/Naperville/NetworkDiagramServer/diagrams/Basic_RMT003/findDiagramFeatures?

Parameters:

Use dark colors for code blocksCopy
gdbVersion=
sessionId=
moment=
fromFeatures=["1EE98487-730C-4193-8510-8BF975332237"]
fromDiagram=DiagramTest1
includeAggregations=true
addConnectivityAssociations=false
addStructuralAttachments=false
f=pjson

Sent URL (GET): https://myserver.esri.com/server/rest/services/Naperville/NetworkDiagramServer/diagrams/Basic_RMT003/findDiagramFeatures?gdbVersion=&sessionId=&moment=&fromFeatures=%5B%22%7B1EE98487-730C-4193-8510-8BF975332237%7D%22%5D&fromDiagram=DiagramTest1&includeAggregations=true&addConnectivityAssociations=false&addStructuralAttachments=false&f=pjson

Example#3—Retrieving the diagram feature Global IDs associated with the utility network points which Global ID are {AF41424F-1073-4640-A596-220AC3A33DA6}, {0B93680B-4B8A-4453-BC28-6763BC0A2184} and {9F09AC2C-E2C4-4B8A-BAE9-1D2405D79389} in the "DiagramTest1" diagram resource, then add the connectivity associations and structural attachment diagram edges that may connect the returned junctions; that is:

URL: https://myserver.esri.com/server/rest/services/Naperville/NetworkDiagramServer/diagrams/DiagramTest1/findDiagramFeatures

Parameters:

Use dark colors for code blocksCopy
gdbVersion=
sessionId=
moment=
fromFeatures=["{AF41424F-1073-4640-A596-220AC3A33DA6}","{0B93680B-4B8A-4453-BC28-6763BC0A2184}","{9F09AC2C-E2C4-4B8A-BAE9-1D2405D79389}"]
fromDiagram=
includeAggregations=false
addConnectivityAssociations=true
addStructuralAttachments=true
f=pjson

Sent URL (GET): https://myserver.esri.com/server/rest/services/Naperville/NetworkDiagramServer/diagrams/DiagramTest1/findDiagramFeatures?gdbVersion=&sessionId=&moment=&fromFeatures=%5B%22%7BAF41424F-1073-4640-A596-220AC3A33DA6%7D%22%2C%22%7B0B93680B-4B8A-4453-BC28-6763BC0A2184%7D%22%2C%22%7B9F09AC2C-E2C4-4B8A-BAE9-1D2405D79389%7D%22%5D&fromDiagram=&includeAggregations=false&addConnectivityAssociations=true&addStructuralAttachments=true&f=pjson

JSON Response syntax

An array of diagram features JSON object:

Use dark colors for code blocksCopy
{
 "features": [
  {
   "globalID": "< DiagFeatGlobalID1 >", //string
   "featureOID": < DiagFeatOID1 >, // int
   "geometryType": < 1 | 2 | 3 >,
   "networkSourceID": < assUNSourceID1 >, //int
  },
  ...
  {
   "globalID": "< DiagFeatGlobalIDN >", //string
   "featureOID": < DiagFeatOIDN >, // int
   "geometryType": < 1 | 2 | 3 >,
   "networkSourceID": < assUNSourceIDN >, //int
  },

 ]
}

JSON Response example

JSON Response Example

Use dark colors for code blocksCopy
{
 "features": [
  {
   "globalID": "{1EE98487-730C-4193-8510-8BF975332237}",
   "featureOID": 10470,
   "geometryType": 1,
   "networkSourceID": 6
  },
  {
   "globalID": "{2FE3062B-BC03-45B6-9B45-ECE680470C92}",
   "featureOID": 10471,
   "geometryType": 1,
   "networkSourceID": 6
  },
  {
   "globalID": "{1D7A1416-EA05-42F4-B8C1-D992F10086EA}",
   "featureOID": 10472,
   "geometryType": 1,
   "networkSourceID": 6
  },
  {
   "globalID": "{43CF9E6F-7F14-4C49-A233-B4CCF884DD38}",
   "featureOID": 11249,
   "geometryType": 3,
   "networkSourceID": 1
  },
  {
   "globalID": "{72745B4E-D05B-48C7-A21F-A68B7DA14954}",
   "featureOID": 11254,
   "geometryType": 3,
   "networkSourceID": 1
  }
 ]
}