Searching the Help
To search for information in the Help, type a word or phrase in the Search box. When you enter a group of words, OR is inferred. You can use Boolean operators to refine your search.
Results returned are case insensitive. However, results ranking takes case into account and assigns higher scores to case matches. Therefore, a search for "cats" followed by a search for "Cats" would return the same number of Help topics, but the order in which the topics are listed would be different.
Words and Phrases
| 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. |
Using Boolean Operators
| Search for | Operator | Example |
|---|---|---|
|
Two or more words in the same topic |
|
|
| Either word in a topic |
|
|
| Topics that do not contain a specific word or phrase |
|
|
| Topics that contain one string and do not contain another | ^ (caret) |
cat ^ mouse
|
| A combination of search types | ( ) parentheses |
|
Output
The Identification output is a JSON string with the following collections of CIs. The format is as shown in Example of configuration item (CI) type input:
| CIs | Description |
|---|---|
|
ambiguousEntities |
CIs for which the service found more than one matching CI in Service Management. Example: an incoming device whose name + domainName combination exists twice in Service Management. Note: in this collection the JSON format differs slightly, as it also includes the ID for all the matching CIs found in Service Management. Example: the following JSON format shows one incoming device that matches four devices in Service Management: "ambiguousEntities":[{
"entity":
{"properties":
{"Name":"na",
"DomainName":"dna",
"DisplayName":"dispb"},
"entityType":"Device",
"matchingEntityIds":["13","7","14","10"]
}
]}
|
|
entitiesToCreate |
CIs the service has identified for which no matching CI was found in Service Management. |
|
entitiesToUpdate |
CIs the service has identified for which exactly one matching CI was found in Service Management, and the matching CI has at least one property value which is different. Note: the service returns these CIs in merged form. See Merged CIs. |
| unchangedEntities | CIs the service has identified for which exactly one matching CI was found in Service Management, and the matching CI has identical property values. |
|
unidentifiableEntities |
CIs the service has been unable to identify as existing in Service Management due to insufficient information. |
Merged CIs
The service creates merged CIs in the entitiesToUpdate collection. The service merges CIs as follows:
| Matched CIs | Merge action |
|---|---|
| Has no matching CIs | The service takes the id from the Service Management CI, and all other properties from the incoming CI. |
| Has at least one matching CI with the Keep property set to true | If a Keep property of a component CI is set to true, the service maintains it, regardless, but allows augmentation of the component CI with additional properties from the incoming CI. |
| Has matching CIs none of which have the Keep property set to true | If no Keep property of a component CI is set to true, the service uses them to augment matching component CIs in the incoming CI. If there are no matching component CIs in the incoming entity, the service deletes the Service Management component CIs. |
Component CIs
The following table lists component CIs with the property which the service uses for matching.
| Component CI | Property to match |
|---|---|
| Cpu | CpuId |
| IpAddress | IpValue |
| FileSystem | FsMountPoint |
| DiskDevice | DiskName |
| NetworkCard |
NetworkCardName or MacAddress Note: one match is sufficient. |
| RunningSoftware |
ProductName or DiscoveredProductName Note: one match is sufficient. |
Related topics
