Integration request - Enboarder

[nasimg]

Hi Hornbill

May I request an integration for Enboarder (https://enboarder.com/?nab=0)

This is a HR system for on boarding new staff.

Nasim

[SamS]

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.

[nasimg]

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

Nasim

[nasimg]

Can you have a look at the attached.

Nasim

ServiceNow Integration_1.0 copy.pdf

[Steve G]

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

[nasimg]

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

[Steve G]

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 

 

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

[nasimg]

Hi @Steve G

This is very helpful - I'll pass it on to our Hornbill guru @carlt

Nasim