Query (Trace Configurations)

• URL:https://<traceConfigurations-url>/query(POST only)
  
• Version Introduced:10.9

Description

The query operation returns all properties from one or more named trace configurations in a trace network.

License:

The active portal account must be licensed with theArcGIS Advanced Editing user type extension to use this operation.

Request parameters

Parameter	Details
f	Description: Optional parameter representing the output format of the response. The default response format is html. Values: html | json
globalIds	Description: Optional parameter representing the global IDs of the named trace configurations to be queried; this is provided as an array of strings. Syntax: globalIds=[<guid>] Example: globalIds= ["{K66AC850-832E-42E3-LE5E-ACEE122F1G6B9}", "{CE4E1432-14C2-470D-9FB3-9E1526CB889E}"]
creators	Description: Optional parameter representing the creators of the named trace configurations to be queried; this is provided as an array of strings. Syntax: creators=[<string>]
tags	Description: Optional parameter representing the user tags of the named trace configurations to be queried; this is provided as an array of strings. Syntax: tags=[<string>]
names	Description: Optional parameter representing the names of the named trace configurations to be queried; this is provided as an array of strings. Syntax: names=[<string>]

JSON Response syntax

{ 
  “traceConfigurations” : [ 
    { 
      “name” : <string>, 
      “description” : <string>, 
      “traceType” : “connected” |“upstream” | “downstream” | “shortestPath”,  
      “traceConfiguration” : <traceConfiguration>, 
      “resultTypes” :     [
      { 
       “type” : ”elements” | “aggregatedGeometry”,
       “includeGeometry" : true | false,
       “includePropagatedValues”: true | false,
       “networkAttributeNames" :[“attribute1Name","attribute2Name”,...],
       “diagramTemplateName”: <value>, 
       “resultTypeFields”:[{“networkSourceId”:<long>,”fieldname”:<value>},...]
      }
     ],  
      “minNumStartingPoints” : “none” | “one” | “many”, 
      “tags” : [ <string> ], 
      “creator” : <string>, 
      “globalId” : <guid> 
    } 
  ], 
  “success” : <boolean>, 
  “error” : {                   // only if success is false 
    “extendedCode” : <HRESULT>, 
    “message” : <error message>, 
    “details” : [ <detail> ] 
  } 
}

Example usage

In this example, the query operation is used to return information for a named trace configuration by providing a global ID.

Request URL and parameters:

https://myserver.esri.com/server/rest/services/Landbase/TraceNetworkServer/traceConfigurations/query

{
f=json
globalIds=["{K66AC850-832E-42E3-LE5E-ACEE122F1G6B9}"]
creators=
tags=
names=

JSON response:

{
 "traceConfigurations": [
  {
   "name": "Connected_Basic",
   "description": "Connected trace example",
   "traceType":"connected",
   "traceConfiguration":{
    "includeBarriers":true,
    "validateConsistency":true,
    "ignoreBarriersAtStartingPoints":false,
    "allowIndeterminateFlow":false,
    "shortestPathNetworkAttributeName":"",
    "traversabilityScope":"junctionsAndEdges",
    "conditionBarriers":[],
    "functionBarriers":[],
    "functions":[],
    "outputFilters":[],
    "outputConditions":[],
    "pathDirection":"noDirection"
  },
   "resultTypes:[
    {
    "type":"elements",
    "includeGeometry":false,
    "includePropagatedValues":false,
    "networkAttributeNames":[],
    "diagramTemplateName":"",
    "resultTypeFields":[]
    }
   ],
   "minNumStartingPoints": "one",
   "creationDate": 1605637404000,
   "tags":    "tags": ["tag1,"tag2"],
   "creator": "tnadmin",
   "globalId": "{K66AC850-832E-42E3-LE5E-ACEE122F1G6B9}"
  }
],
 "success": true
}