|
|
| (8 intermediate revisions by 2 users not shown) |
| Line 1: |
Line 1: |
| | + | This document can now be found at its new location in the [https://docs.hornbill.com/ibridge-packages/welcome Hornbill Document Library]. |
| | | | |
| − | <div style="border:1px solid #90C0FF; background:#D0E0FF; width:99%; padding:4px; margin-bottom:10px;">
| + | [[file:hornbill-document-library.png|iBridge Package Reference|link=https://docs.hornbill.com/ibridge-packages/welcome]] |
| − | __NOTOC__[[Main Page|Home]] > [[Integration]] > [[Business Process Automation & Orchestration]] > [[Hornbill iBridge]] > ServiceNow
| + | [[Category:HDOC]] |
| − | </div>
| |
| − | {|style="width: 100%"
| |
| − | |- valign="top"
| |
| − | |style="width:73%"|
| |
| − | [[File:Snow2.png|200px]]
| |
| − | <br>
| |
| − | ==Introduction==
| |
| − | ServiceNow is a Service Management Platform
| |
| − | | |
| − | Create, Update, get information about, and Close Tickets in ServiceNow
| |
| − | | |
| − | ServiceNow is a [[Hornbill_iBridge#Premium_Integrations|Premium Integration]] [[File:Green_Dollar.png|12px|link=https://wiki.hornbill.com/index.php/Hornbill_iBridge#Premium_Integrations|Premium Integration]]
| |
| − | |style="width:5%"|
| |
| − | |
| |
| − | |style="width:22%; border-style: solid; border-width: 1px; border-color:#e6e6e6; background-color:#f2f2f2;"|
| |
| − | | |
| − | == Related Articles ==
| |
| − | :* [[Hornbill iBridge]]
| |
| − | :* [[Hornbill_iBridge#Premium_Integrations|Premium Integrations]]
| |
| − | :* [[Hornbill_KeySafe|KeySafe]]
| |
| − | :* [[Integration Call]]
| |
| − | :* [[Business_Process_Designer|Business Process Designer]]
| |
| − | |}
| |
| − | | |
| − | ==KeySafe Configuration==
| |
| − | [[File:ServiceNow Configuration.png|300px|right]]
| |
| − | In order to integrate with ServiceNow, you will first need to configure, and securely store the authentication credentials for the ServiceNow instance and Accounts you want to use with the Hornbill App.
| |
| − | | |
| − | Configure your '''ServiceNow''' account authentication in '''[[Hornbill_KeySafe|KeySafe]]''' in order to use the ServiceNow options.
| |
| − | | |
| − | In the admin console > System > Security > KeySafe
| |
| − | | |
| − | * Select on '''+''' and select '''ServiceNow Authentication'''
| |
| − | * Give the ServiceNow KeySafe a Title (this is the name / identifier for the ServiceNow account as you will see it when using the Integration Call node in your business process)
| |
| − | * Optionally add a description
| |
| − | * '''Instance Name''' - Define the ServiceNow Instance you wish to connect to (not the full URL)
| |
| − | * '''Username''' - Define the username (from ServiceNow) against which all the actions will be performed (ensure this user has the appropriate rights in ServiceNow to perform the required actions)
| |
| − | * '''Password''' - Store the password for the user
| |
| − | * Select '''Create Key''' to save
| |
| − | | |
| − | | |
| − | '''Managing ServiceNow Configurations'''
| |
| − | | |
| − | * Use KeySafe to create, store and enable integrations with multiple ServiceNow accounts for use in your business processes
| |
| − | * From the Keysafe List, select a ServiceNow account, and use the '''Trash Can''' to delete it
| |
| − | :* Note, this will remove the rights of any existing ServiceNow Integration Calls in your business processes, which are using the now deleted ServiceNow Account, so you will need to edit your business processes accordingly.
| |
| − | | |
| − | ==Business Process==
| |
| − | ===Options (Methods)===
| |
| − | Once you have your ServiceNow Account Authorised, your all set to use it with the '''[[Integration Call]]''' in your business processes. The following options are now available for you to use with ServiceNow:
| |
| − | | |
| − | ===Incidents===
| |
| − | * Create Incidents
| |
| − | * Update Incidents
| |
| − | * Close Incidents
| |
| − | * Get Incident Details
| |
| − | | |
| − | ===Problems===
| |
| − | * Create Problem Records
| |
| − | * Update Problem Records
| |
| − | * Close Problem Records
| |
| − | * Get Problem Record Details
| |
| − | | |
| − | ===Changes===
| |
| − | * Create Changes
| |
| − | * Updates Changes
| |
| − | * Close Changes
| |
| − | * Get Change Details
| |
| − | | |
| − | ===Common===
| |
| − | * Get the last 3 journal updates
| |
| − | | |
| − | Read more about using the '''[[Integration Call]]''' from the Related Articles section, and learn how to work with input and output parameters for each of the ServiceNow options.
| |
| − | | |
| − | With the ServiceNow options (methods) Hornbill have provided data providers for the key input parameters such as '''State''', '''Impact, Urgency, Priority''', so when configuring these inputs in the business process designer you will be presented with the '''Actual''' options as configured on the ServiceNow Instance you are integrating with, and removes the need to know or understand their ServiceNow Database values.
| |
| − | | |
| − | ==Example==
| |
| − | {{#ev:youtube|gLj1_9pwgIo|350|right}}
| |
| − | | |
| − | In this example, we will choose and configure the ServiceNow instance and account to which we will then use to create a new Incident in ServiceNow. We'll need to specify using KeySafe the ServiceNow Instance, and authentication details for the ServiceNow account which has the appropriate rights which will allow the logging of an Incident or other actions you may wish to automate.
| |
| − | | |
| − | Through the business process designer we can then use the Integration Call node to decide where and how often we want to utilize the ServiceNow integration, and which actions we want to perform. Configuring the input parameters on each occasion, to pass the relevant variables to ServiceNow.
| |
| − | | |
| − | In this simple example we will use the Create Incident option, to raise a new Incident in ServiceNow at a specific point in our business process.
| |
| − | | |
| − | Finally we'll use the output parameters and some wiki markup to write the URL of the new ServiceNow Incident to the timeline of the request, this is not a required step but is useful for demonstration purposes or even to act as an audit trail, this could of course be written to a custom field or the external ref number field if required.
| |
| − | | |
| − | [[Category:Integration]] | |
