Difference between revisions of "IT Automation"

From Hornbill
Jump to navigation Jump to search
Line 35: Line 35:
 
Two options are available to expose the properties of the Hornbill Cloud Automation Node. You can either place your mouse pointer over the Cloud Automation node to expose the '''Cog''' icon and click on this icon or double click anywhere on the Could Automation Node.
 
Two options are available to expose the properties of the Hornbill Cloud Automation Node. You can either place your mouse pointer over the Cloud Automation node to expose the '''Cog''' icon and click on this icon or double click anywhere on the Could Automation Node.
  
=== Cloud Automation ===
+
=== IT Automation ===
 
{{Bullet1|Language|Select the language that you want to work in.  This will default to the language set in your profile.  If you have other users that will be viewing the workflow that operate in a different language, you may want to provide translations for them by selecting their language and providing the appropriate translations.}}
 
{{Bullet1|Language|Select the language that you want to work in.  This will default to the language set in your profile.  If you have other users that will be viewing the workflow that operate in a different language, you may want to provide translations for them by selecting their language and providing the appropriate translations.}}
 
{{Bullet1|Display|Give the Cloud Automation node a display name for how it will appear on the business process design canvas}}
 
{{Bullet1|Display|Give the Cloud Automation node a display name for how it will appear on the business process design canvas}}
 +
{{Bullet1|Description|Optional text area that can be used to provide a description detailing the node's function}}
 
<br>
 
<br>
  

Revision as of 13:51, 9 December 2020

Home > Administration > ITOM > Runbooks > IT Automation Index

Introduction

The IT Automation node is used to execute an ITOM package operation in a similar way to that of creating an IT Automation Job. Each time the node is used, a new Job will appear in the Job queue where it can be monitored/managed in the same manner as other ITOM jobs.

Related Articles

Adding the IT Automation Node

BPMITAutomationNode.png
  • From an existing Node within a Business Process
  1. Place the mouse pointer over the node to expose the connection arrows.
  2. From a connection arrow, drag out a new connection line
  3. Select IT Automation
  • From a Connection Line between to nodes
  1. Select the Connection Line and Right Click
  2. Select Add node between connected nodes from the context menu
  3. Select IT Automation
Information
IT Automation Nodes are displayed in Tan; to help differentiate from other node types.


Configuration

HornbillCloudProperties.png

Two options are available to expose the properties of the Hornbill Cloud Automation Node. You can either place your mouse pointer over the Cloud Automation node to expose the Cog icon and click on this icon or double click anywhere on the Could Automation Node.

IT Automation

  • Language
Select the language that you want to work in. This will default to the language set in your profile. If you have other users that will be viewing the workflow that operate in a different language, you may want to provide translations for them by selecting their language and providing the appropriate translations.
  • Display
Give the Cloud Automation node a display name for how it will appear on the business process design canvas
  • Description
Optional text area that can be used to provide a description detailing the node's function


Request

Integration-Call-3.png
  • Connector
This drop down list displays the list of available connectors. By default the Hornbill Integration Bridge connector will be available. If you have configured any Business Process Connectors using Microsoft Orchestrator or HP Operations Orchestration, these will also be available.
  • Method
Clicking on the edit icon allows you to browse the content catalog for the selected Connector. Click and expand each item to see the available Methods and then select the Method that you would like to use
  • Result Reference
If you are using multiple Cloud Automation Nodes in your business process, it is good practice to give each Cloud Automation Node a unique Result Reference. With each Method having the ability to return Output parameters such as an ID, Reference number etc you may want to use these Output parameters in other business process nodes, and they will be identified in your variable picker by their Result Reference name.If a unique name is not given, every result reference option in the variable picker will be represented with the default Integration name.
  • Continue on Error
By default this is set to No and the business process will not continue if the Cloud Automation fails. Change this to Yes if you wish the business process to continue even if the Cloud Automation fails.

Request Credentials

Integration-Call-4.png

If using the Hornbill Integration Bridge, once a method has been selected you will need to select a credential from the Request Credentials list.

  • The available credentials are populated via KeySafe , the list is filtered based on the Authentication Type required by the Integration method.
  • If the list is empty the type of credential is shown by hovering the mouse over the i against the credential. You can go to KeySafe and create a set of credentials for the type of method you are trying to use.
Examples
  • You would need to define in KeySafe the Twitter account credentials you want to tweet from, or the ServiceNow instance you want to create an Incident on, and which user account you want to create the Incident in the context of.
  • You can create multiple set's of credentials for the same Methods, for example if you wanted to tweet from different Twitter Accounts, you can create different request credentials for each Twitter account in KeySafe and then select which one to use from the Request Credentials for the Twitter Methods in each Cloud Automation node you configure.

Parameters

Each Method will have a set of specific request parameters (Inputs). These are the inputs which you can pass to the solution you are integrating too.

  • Request Parameters marked with the red Mandatory marker must be populated
  • You can use the Variable Picker on request parameter fields to pass in variable values from request attributes such as Progressive Capture Answers, Custom Field Values, Task Outcomes, Request Service, Customer attributes.
  • Depending on the method chosen, the request parameter fields may contain Data Provider values from the solution you are integrating too, for example in ServiceNow LogIncident, the actual State, Impact, Urgency values from the ServiceNow Instance specified in the chosen Request Credentials will be available to you to choose from.

Response Parameters

Most methods will return Response Parameters (Outputs) once they complete. You may wish to use these later or further down your business process. For example if you chose to create a new Board using the Trello CreateBoard method, one of the response parameters will be the newly created boards id. This id can then be used as a request(input) parameter for another Cloud Automation, or example if you wanted to add a List or Card to the Trello Board.

  • The Response Parameters will be available to use from the Variable Picker and will be listed under each Result Reference name.


Documentation

Click on the Documentation.png icon to view information relating to the input and output parameters for the method.

More information is also available on each solution via the iBridge page