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)`

Configuration Management System (CMS)2018.05

Develop > Developer Reference > Using APIs > Universal CMDB Web Service API > UCMDB Update Methods > addCIsAndRelations

addCIsAndRelations

The addCIsAndRelations method adds or updates CIs and relations.

If the CIs or relations do not exist in the CMDB, they are added and their properties are set according to the contents of the CIsAndRelationsUpdates argument.

If the CIs or relations do exist in the CMDB, they are updated with the new data, if updateExisting is true.

If updateExisting is false, CIsAndRelationsUpdates cannot reference existing configuration items or relations. Any attempt to reference existing items when updateExisting is false results in an exception.

If updateExisting is true, the add or update operation is performed without validating the CIs, regardless of the value of ignoreValidation.

If updateExisiting is false and ignoreValidation is true, the add operation is performed without validating the CIs.

If updateExisiting is false and ignoreValidation is false, the CIs are validated before the add operation.

Relations are never validated.

CreatedIDsMap is a map or dictionary of type ClientIDToCmdbID that connects the client's temporary IDs with the corresponding real CMDB IDs. For details, see the schema documentation for ClientIDToCmdbID.

See the "Update Example".

Input

Parameter	Comment
cmdbContext	For details, see CmdbContext and the schema documentation for `CmdbContext`.
updateExisting	Set to true to update items that already exist in the CMDB. Set to false to throw an exception if any item already exists.
CIsAndRelationsUpdates	The items to update or create. For details, see Update the CMDB.
ignoreValidation	If true, no check is performed before updating the CMDB.
dataStore	Changer information.

Output

Parameter	Comment
createdIDsMapList	The list of client IDs mapped to CMDB IDs. For details, see the description above.
comments	For internal use only.

Send Help Center feedback