- URL:
- https://<root>/<serviceName>/TraceNetworkServer/traceConfigurations/query
- Methods:
GET
- Version Introduced:
- 10.9
Description
The query
operation returns all properties from one or more named trace configurations in a trace network.
Request parameters
Parameter | Details |
---|---|
| The output format of the response. The default response format is
|
(Optional) | Specifies the global IDs of the named trace configurations to be queried; this is provided as an array of strings.
Example: |
(Optional) | Specifies the creators of the named trace configurations to be queried; this is provided as an array of strings.
|
(Optional) | Specifies the user tags of the named trace configurations to be queried; this is provided as an array of strings.
|
(Optional) | Specifies the names of the named trace configurations to be queried; this is provided as an array of strings.
|
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
{
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
}