Jump to content

Integration request - Enboarder


Recommended Posts

Hi @nasimg,

I haven't found any API documentation (API = Application Programmers Interface; the documentation which outlines how a programmer can talk to the program in question) for Enboarder - if you know of a link, then please share and we will have a look.

Link to comment
Share on other sites

Enboarder already have something setup for ServiceNow - are you able to contact them (Enboarder) and see if we can have something similar.

Nasim

Link to comment
Share on other sites

Hi @nasimg,

I've had a look at that document, and it looks like a pretty basic integration - Enboarder just logs new tickets on ServiceNow as part of their Webhooks functionality. Is this the same integration you're after - so an action in Enboarder would log a Service Request in Hornbill Service Manager? If so, then I could help with populating the webhook API call...

Cheers,

Steve

Link to comment
Share on other sites

Hi @Steve G

Thanks for the prompt reply - yes its something would would like to have.

There is some other things we need (ITOM) to allow for AD account creations, but this would be a great start to get the request logged into Service Manager.

Nasim

Link to comment
Share on other sites

Hi @nasimg,

A couple of AD packages are going to be released alongside ITOM, here's a sneak-peek at the operations within the AD User package :)

image.png

 

Regarding the API call to raise a Service Request, you need to follow the instructions in that ServiceNow document, but for the details:

  • Enter URL: The API endpoint for your instance (replacing yourinstanceid with the case-sensitive ID of your Hornbill instance):
    • https://eurapi.hornbill.com/yourinstanceid/xmlmc/apps/com.hornbill.servicemanager/ServiceRequests?method=logServiceRequest
  • Method: POST
  • Headers (replacing yourapikeygoeshere with an API Key generated against a user within Hornbill, to authenticate the API call):
    • Content-Type : text/xmlmc
    • Authorization :  ESP-APIKEY yourapikeygoeshere 
  • Body - this is the payload of the API call, in XML:
<methodCall service="apps/com.hornbill.servicemanager/ServiceRequests" method="logServiceRequest">
	<params>
		<summary>New onboarding request for {{new_hire}}</summary>
		<description>New onboarding request for {{new_hire}}</description>
		<teamId>TEAMID/GOES/HERE</teamId>
		<externalRefNumber>{{externalid}}</externalRefNumber>
	</params>
</methodCall>

 And that's pretty much all there is to it... So that will log a new Service Request on your Hornbill instance on the back of a webhook event in Enboarder, populating the summary, description and external reference number fields, as well as assigning the SR to the team specified in the teamId element. 

To add additional details to the request being logged (service, catalog item, priority, workflow etc) this can be done by adding to the XML payload, as per the API documentation here: https://api.hornbill.com/apps/com.hornbill.servicemanager/ServiceRequests?op=logServiceRequest

Let me know if you need any more information.

Cheers,

Steve

  • Thanks 1
Link to comment
Share on other sites

Create an account or sign in to comment

You need to be a member in order to leave a comment

Create an account

Sign up for a new account in our community. It's easy!

Register a new account

Sign in

Already have an account? Sign in here.

Sign In Now
×
×
  • Create New...