Start integrating with ONEiO for free!
SIGN UP

How to configure ServiceNow for integration with ONEiO

Introduction

This document shows an example of what needs to be done in ServiceNow to make it integration-ready with the endpoint in your ONEiO. Note also, that the number of fields used in integrations might vary. 

In case you have questions related to setting up the integration, send a mail to support@oneio.cloud.

You can sign up for a free trial of ONEiO from the following link: ONEiO Free Trial

Overview

This article gives an overview of the required steps to integrate ONEiO and ServiceNow. In this guide, we cover the following steps required for bi-directional communication between ONEiO and ServiceNow.

  1. Integration user in ServiceNow
  2. Dynamic Update Set
  3. REST Message
  4. Business Rules

Sending messages from ONEiO to ServiceNow

Screenshot_2022-01-28_at_13.44.15.png

ONEiO accesses ServiceNow through the REST API

 

Create Integration user in ServiceNow

Add integration user to ServiceNow. This user is used to send updates and creates to ServiceNow through the Table API interface. The credentials have to match those configured to the ServiceNow adapter configuration in ONEiO.

Go to:

Organization   Users   New

Users___ServiceNow.png

Add user

  • username "oneio(you can choose a different name also, but remember to change it to used business rule conditions)
  • Check "web service access only"

New_Record___User___ServiceNow.png

Roles   Edit

User__Roles__ServiceNow.png

Add roles: itil

  • The user must also have access to the tables integrated, in this example incident and sys_attachment

Edit_Members___User_Role___ServiceNow.png

After the user is created, fill in the same information in the ONEiO UI in the ServiceNow User & Password fields.

At this point please also check the Name, ServiceNow root URL, and Timezone fields and verify your endpoint-specific values.

ONEiO__New_Endpoint.png

Attachment handling

Sending attachments to ServiceNow

ONEiO sends attachments to ServiceNow through ServiceNow's Attachment API. For this operation, the outbound message to ServiceNow needs to include the attribute sys_id, with the target entity's sys_id as the value.

 

Sending messages from ServiceNow to ONEiO

Screenshot_2022-01-28_at_13.44.01.png

ServiceNow communicates with ONEiO through the REST message as part of the REST API. This REST message is preconfigured as part of the Dynamic Integration Set ONEiO provides.

Retrieve Update Set

ONEiO provides a preconfigured update set, that includes everything needed for ServiceNow to communicate with ONEiO. You can download the update set from the button below.

DOWNLOAD

The update set contains:

  • 1 REST message
  • 1 Business Rule for the incident table
  • 2 Business Rules for sending out attachments.

After committing the update set you have to add the outbound credentials to the REST message. These credentials can be retrieved from the ONEiO UI. 

System Update Sets   Retrieve Update Sets   Import Update Set from XML

Retrieved_Update_Sets___ServiceNow.png

Upload the Update set retrieved from the ServiceNow Developer site earlier.

ServiceNow_upload_update_set.png

Open the ONEiO Integration Components

Retrieved_Update_Sets_2__ServiceNow.png

Preview and Commit the Update Set

ONEiO_Integration_Components___Retrieved_Update_Set_Commit__ServiceNow.png

REST Message

For communication from ServiceNow towards ONEiO we use a REST message with ONEiO specific target, HTTP Method & Content-Type. Authentication has to be set on a per endpoint bases.

System Web Services   Outbound   REST Message   ONEiO

REST_Messages___ServiceNow.png

The REST message includes the ONEiO receiver address in the endpoint section. Depending on your ONEiO environment these have to be adjusted.

Endpoint

  • QA: https://rest-receiver-test.service-flow.com/api
  • Production: https://rest-receiver.service-flow.com/api

Screenshot_2022-03-25_at_11.07.52.png

Next up we have to adjust the prefilled Basic Auth Profile.

Screenshot_2022-03-25_at_11.08.12.png

The Username and Password are available from your ServiceNow endpoint UI in ONEiO. The Username is always visible, but you have to enter Edit mode the access the Generate new password button.

ONEiO__Sebastian_Sandbox_User_pass.png

Important

Please save the ServiceNow endpoint in ONEiO after generating a new password

Now that the Authentication is set up, let's test that everything works correctly. For that, we have added a secondary REST message in our Update Set. This REST message is not being populated dynamically with ticket information but has a hardcoded payload just for testing purposes.

Screenshot_2022-03-25_at_11.07.53.png

It is preconfigured to inherent the Authentication type from the parent, so you dont have to configure that part.

Choose the Test link on the left side of the screen.

Screenshot_2022-03-25_at_11.09.26.png

This will send a test payload towards ONEiO and on success return an HTTP 202 and Response ID.

Screenshot_2022-03-25_at_11.10.13.png

This message will also be visible in the ONEiO Message View.

Screenshot_2022-03-25_at_11.10.25.png

Business Rules

Before creating an Incident, let's check the Business Rules included in our Update Set

Business_Rules__2__ServiceNow.png

Three Business Rules are included:

  • ONEiO Incident integration Post for sending from the incident table
  • ONEiO Attachment after Correlation ID handles attachment sending on incident creation
  • ONEiO send attachment for sending attachments as an update

Creating an Incident

Now that the ServiceNow integration is set up we can create our first incident. 

Incident   Create new

Create___Incident___ServiceNow.png

Fill in the required fields such as Caller and Short Description and any other information required for your test scenario. Observe the Assignment group in our example, it use used as a trigger condition in our Business Rule.

The Incident should show up in the ONEiO Message View.

ONEiO__Sebastian_Sandbox_Message_View.png

Congratulations, you have successfully integrated your ServiceNow into ONEiO.

Duplicating the business rules for new processes

If any other processes in ServiceNow should be integrated, cloning and/or extending these rules is all that's needed.

Inside the ONEiO Incident integration Post business rule

  • Rightclick on the top grey menu bar
  • Select Insert and Stay to clone the current rule

Screenshot_2022-09-30_at_9.20.56.png

Return to the Business Rules list view, you can now see two ONEiO Incident integration Post rules.

Screenshot_2022-09-30_at_9.23.29.png

Open the newly created copy and adjust the Name and Table to match your needed process. In our case, we are creating a Problem process.

Screenshot_2022-09-30_at_9.30.22.png

Now we are able to send tickets from the Problem table to ONEiO.

In case your process requires Attachments to be sent as part of your tickets, clone the ONEiO Attachment after Correlation ID business rule and adjust the table from Incident to your required process. 

 

Info

If you want to know more about the ServiceNow endpoint in ONEiO, please read this article.

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

Comments

0 comments

Please sign in to leave a comment.