How to perform an integration with Operations Orchestration

To import Operations Orchestration content and execute the flows, follow these steps:

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

If the Operations Orchestration flow you are importing uses encryption, you must set up encryption between Service Management and the On-Premise Bridge agent before you perform the integration. For more information, see How to set up encryption for an Operations Orchestration integration.

Add an Operations Orchestration endpoint.

From the main menu, select Administration > Utilities > Integration Management. Click the Endpoints tab.
Click Add and enter the endpoint details. For the endpoint type, select Operations Orchestration.
Click Add.

Configure the endpoint.

For more information, see Configure an endpoint. When the endpoint is configured, an automatic synchronization occurs, importing the Operations Orchestration content.

Note

If a change was made to the flow in Operations Orchestration after the endpoint was configured, you must perform the synchronization again manually. Click Sync now on the Endpoints tab.
If you are working with a security hardened Operations Orchestration (OO) server, follow the procedure described in How to configure an agent with a security hardened Operations Orchestration server before proceeding with the integration.

Select the required record in the relevant manager. Select the Task plan/Plan and Execute tab.

Hover over the Start button and click the Edit button. Select Automated task from the pop-up menu.

In the New automatic task dialog box, under Business rule, click Set rule.

In the Set rule dialog box, select Execute Operations Orchestration (OO) flow and click OK.

Click the OO endpoint parameter in the business rule to select the endpoint. Select the endpoint you defined at the beginning of the procedure and click OK.

Click the flow name parameter in the business rule to select the Operations Orchestration flow to execute. Enter a string in the Search window to search for a flow. Select the required flow and click OK.

Click the flow parameters parameter in the business rule to configure the input parameters of the Operations Orchestration flow. For each parameter, enter a value in Simple mode or enter an Expression language phrase.

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.

Parameters marked with an asterisk are required fields. For information on the Operations Orchestration input parameters, refer to Author Using OO Studio.

Note For encrypted parameters, you cannot enter an Expression Language phrase.

When you are done, click OK.

Click the Record fields parameter to map the Operations Orchestration flow output to record fields. For each Operations Orchestration output field, you must select either a record field or predefined user option, as follows:

To map an Operations Orchestration output field to a record field, click Add field to add a row. In the left column, select a field from the drop-down list. In the right column, enter the name of the relevant Operations Orchestration output field.
To map an Operations Orchestration output field to a record user option, click Add user option to add a row. In the left column, enter the name of a predefined user option for this record. In the right column, enter the name of the relevant Operations Orchestration output field.

When you are done, click OK.

After the task runs, you can click the task to open a summary dialog displaying details of the task. The Business rules tab displays the business rule with the selected parameters, the Task start time and end time, and the Task ID. You can click the Task ID to go directly to the flow execution page for the selected flow in Operations Orchestration.