External configurations

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

External configurations are pre-defined content which can be used to simplify the integration with Operations Manager i (OMi). They define how Service Management communicates with the external system.

You can apply an external configuration to more than one external system, but each external system can have no more than one external configuration. An external system does not require an external configuration.

To add an external configuration

From the main menu, select Administration > Utilities > Integration > External configurations.

Click

New to open the New External configuration dialog box.

Enter a Name for the external configuration.

Click OK.

In the Details area, select Enabled for the required operations.

For each operation enabled, click the parameter links and select or enter the required parameters.

Parameter	Description
Web method	The following methods are available: POST PUT GET DELETE
URL Suffix	Enter the suffix of the URL (the prefix is taken from the endpoint). This parameter must be HTTP encoded. Select one of the following options: Simple Mode. Enter the required suffix in the text box. Expression Language. Enter an Expression Language phrase that returns the required suffix. Click the Expression Language button to toggle between these options. When the button is selected (green), the field is in Expression Language mode. When it is not selected (white), the field is in Simple mode. For a full list of Expression Language functions, see Expression Language functions and syntax.
Body	This is the body that will be used in the REST call request to the remote server. The Body parameter is only relevant if POST or PUT is selected as the web method. Select one of the following options: Simple Mode. Enter the required text in the text box. Expression Language. Enter an Expression Language phrase that returns the required text. Click the Expression Language button to toggle between these options. When the button is selected (green), the field is in Expression Language mode. When it is not selected (white), the field is in Simple mode. For a full list of Expression Language functions, see Expression Language functions and syntax.
Headers	The REST call request headers provide additional information for the REST call, such as the file type to be returned. Click the Add Item button, which adds a row with two boxes, one for a header name and one for its value. In the first box, enter the required header name. In the second box, select one of the following options: Simple Mode. Enter the header value in the text box. Expression Language. Enter an Expression Language phrase that returns the header value. Click the Expression Language button to toggle between these options. When the button is selected (green), the field is in Expression Language mode. When it is not selected (white), the field is in Simple mode. For a full list of Expression Language functions, see Expression Language functions and syntax.

Click

Save.