Search for	Example	Results
A single word	`cat`	Topics that contain the word "cat". You will also find its grammatical variations, such as "cats".
A phrase. You can specify that the search results contain a specific phrase.	`"cat food"` (quotation marks)	Topics that contain the literal phrase "cat food" and all its grammatical variations. Without the quotation marks, the query is equivalent to specifying an OR operator, which finds topics with one of the individual words instead of the phrase.

Search for	Operator	Example
Two or more words in the same topic	`AND` `and` `+` (plus symbol) `&` (ampersand)	`cat AND dog` `"cat food"+milk` `"cat food"&"dog food"`
Either word in a topic	`OR` `or` `\|` (pipe)	`cat OR dog` `cat \| dog`
Topics that do not contain a specific word or phrase	`NOT` `not` `!` (exclamation point)	`NOT cat` `! dog`
Topics that contain one string and do not contain another	`^` (caret)	`cat ^ mouse`
A combination of search types	`( )` parentheses	`cat + (dog \| mouse)` `cat \| dog + (! mouse)`

Universal CMDB11.0

Develop > Developer Reference > Using APIs > Universal CMDB Web Service API > UCMDB Query Methods > executeTopologyQueryByNameWithParameters

executeTopologyQueryByNameWithParameters

The executeTopologyQueryByNameWithParameters method retrieves a topologyMap element that matches the specified parameterized query.

The values for the query parameters are passed in the parameterizedNodes argument. The specified TQL must have unique labels defined for each CINode and each relationNode or the method invocation fails.

See the "Query Example".

Input

Parameter	Comment
cmdbContext	For details, see CmdbContext and the schema documentation for `CmdbContext`.
queryName	The name of the parameterized TQL in the CMDB for which to get the map.
parameterizedNodeList	The conditions each node must meet to be included in the query results. For details, see `ParameterizedNodes`.
queryTypedProperties	A collection of sets of properties to retrieve for items of a specific Configuration Item Type.

Output

Parameter	Comment
topologyMap	For details, see TopologyMap and the schema documentation for `TopologyMap`.
chunkInfo	For details, see ChunkInfo and Processing Large Responses, and the schema documentation for `ChunkInfo`.

Send Help Center feedback