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.
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 |
|
|
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 |
|
- Integration
- Load Embeddable Widgets
- Configure the BSM Health Indicator (for the Monitoring Widget)
- Configure the Automation Flow Adapter (for the Automation Widget)
- Select and Define Automation Flows (for the Automation Widget)
- Configure Integration with Enterprise View
- Configure the Enterprise View Adapter
- Integrate with ALM (for the Defects Widget)
- Configure Integration with Service Manager
- Configure a Direct Link to Service Manager for a Selected Problem, Incident, or Change Request
- Configure Integration with SiteMinder
- Configure Integration with Configuration Manager
Integrate with ALM (for the Defects Widget)
The following configuration procedures need to be performed to use the Defects widget in the UCMDB Browser:
- In UCMDB, go to Data Flow Management > Integration Studio.
-
Create a new integration point with the following settings:
-
Integration Name. Defects Adapter
-
Adapter. ALMAdapter
-
Protocol. must be http or https
-
HostnameIP. the name or IP address of the machine where ALM is installed
-
Port. the port number of the ALM server
-
Domain. the domain that is defined in ALM
-
Credentials ID. click the browse button and from the list that appears choose credentials for connecting to ALM, or create new credentials
-
- Optional: Click Test Connection to ensure that a connection can be established with the ALM server.
- Click OK.
- Under the Supported and Selected CI Types panel, check the Defect CI type.
- Click the Save Integration Point button.
There are two out-of-the-box mapping properties files, one for attributes and one for severities. The attributes mapping properties files map between names of defect fields in ALM to names of attributes of the class type Defect in UCMDB. The severities mapping properties file maps between severity levels in ALM to the five severity levels in UCMDB, as defined in the DefectSeverity typedef in UCMDB. These files can be accessed by means of the Defects Adapter, by going to Data Flow Management > Adapter Management > ALMAdapter > Configuration Files. The files are called sample.attribute.mappings.properties and sample.severity.mappings.properties.
You may want to create your own customized attributes or severity mapping properties files. This could be necessary if the names of the fields in the out-of-the-box mapping properties files do not match the names in your ALM system, or could be useful if you want to add additional fields that do not exist in the out-of-the-box mapping properties files.
To create a new attribute or severity mapping properties file:
-
If you are creating an attribute mapping properties file:
-
To retrieve the ALM defect attribute field names that you need to create the mapping, go to the following URL:
http://<ALM server>:8080/qcbin/rest/domains/<domain>
/projects/<project>/customization/entities/defect/fields?login-form-required=y -
In the ALM login page, enter your user credentials.
-
In the XML file that appears there is a list of the defect’s fields. Note the Name element in each field, you are going to map the value that appears for the Name element here to the names of attributes of the class type Defect in UCMDB.
-
- In UCMDB, go to Data Flow Management > Adapter Management.
- Click the New button and from the pop-up menu select New Configuration File.
-
Enter a name that starts with ALMAdapter/…, for example: ALMAdapter/attribute.mappings.properties.
Note The custom attribute mappings file should be named attribute.mappings.properties, and the custom severity mappings file should be named severity.mappings.properties. If project-specific mappings files are required, they should be named <project-name>.attribute.mappings.properties and <project-name>.severity.mappings.properties for attributes or severities, accordingly.
- Click the Browse button by the Package field, choose ALMAdapter from the list that appears, and click OK.
-
In the text editor, for attributes mapping each row should contain the name of the ALM field (attribute) on the left side and name of the equivalent CI attribute on the right side in the following manner:
<ALM field name>=<CI attribute>
For severities mapping, each row should contain the ALM severity on the left side and the equivalent UCMDB severity (as defined in the DefectSeverity typedef in UCMDB) on the right side, in the following manner:
<ALM severity>=<UCMDB severity>
- Click OK when you are finished editing the new mapping properties file.
Note
- The name of the CI attribute must exist in the class type Defect.
- For the severities file, if a severity in ALM has a space, a back slash must precede the space as follows: Very\ High.
- In the UCMDB Browser, there are only 5 severity levels (Low, Medium, High, Very High, and Urgent), so all ALM severities must map to one of these 5 levels.
- The type of all custom UCMDB attributes must be String.
The Defects Filter CI that is related to a specific business element represents the ALM filter that is used to retrieve the relevant defects for that business element.
Note You can relate more than one DefectsFilter CI to a business element.
To create the DefectsFilter CI and relate it to the business element:
- Create a filter in ALM (if one has not already been created).
- Copy the filter's text.
- In UCMDB, go to Modeling > IT Universe Manager.
- In the Browse Views tab, click the New CI button.
- From the CI type tree, select the DefectsFilter CI type.
-
Paste the filter text from the ALM filter into the FilterText attribute value.
Note Currently there is a limitation of maximum 885 characters in the FilterText attribute value.
- In ProjectGroup attribute, enter the ALM project name.
-
Optional: Give the filter a custom name by setting the Name attribute value.
- Click Save.
- Relate the DefectsFilter CI to the business element using a containment relationship from the Defects filter to the business element.
Before connecting to the Browser, enable the Defects widget as follows:
- Go to Administration > Infrastructure Settings Manager > UCMDB Browser settings.
- Set the value of Enable the Defects Widget to True.