CreatorCon:

Building Your First

IntegrationHub
Spoke

Jonatan ‘Jonny’ Jardi

ISV Advisory Solution Architect
ServiceNow
Agenda

Quick overview of IntegrationHub

What is a Spoke anyway and how do I build one?

Using the REST Step, Connections & Credentials

Using the Script Step & Action Outputs

Testing, troubleshooting.. and some FAQs ☺

2 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.

Who is this guy?
Name: Jonatan ‘Jonny’ Jardi
Title: ISV Advisory Solution Architect
Company: ServiceNow

• 9 years working with & 6 years working for ServiceNow

• Integrations and Custom Application Development aficionado
• Working with ISV partners to help customers work better through the Now Platform™
• “Immortalised” in the NOW Platform™ with a couple of OOB features
• Born and raised in Argentina…. But living in sunny Brisbane, Australia ☺

3 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.

What You Will Learn

1 2 3
I NT R O D U C TI ON TO B U I L D ING S P O K E S S P O K E D E S I GN
I NT E G R AT IONH UB C O NS I D ER AT IONS

4 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.

Flow Designer
An alternative to Asynchronous business rules

Kingston London
• Natural language, codeless Flows • Subflows
• Discoverability and reuse • Service Catalog
• Conditions & record iteration • Stages
– Surfaced that more clearly in the UI that there are only 5 Stages
• Operational troubleshooting States
– Are no longer bound to actions
• Content • User can decide the Error State
– CRUD – Customers can configure the stages states to user friendly
names and lev erage standard approv al stage states
– Simplified, powerful approvals
– ITSM, CSM, Benchmarks, VTB, Connect • MetricBase Triggers
– Notifications • Enhanced guided experience
• APIs
– Asynchronous Call Flows
– Operations
5 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.
IntegrationHub

6 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.

Vision
MFT

REST
Hub MID Proxy

(JavaScript, REST)

*nix,

CSM, SecOps,
AD, Exchange, SCCM, ITSM, GRC,
Windows Benchmarks

7 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.

IntegrationHub Vision
A single solution for API Management and Codeless Integration (Data, Files, RPCs)

API / Trigger Schema Integration

Design Flow Design
Design Action
Design
Outbound Protocols

Connections & Direct**

RPCs, Data, Attachments

Credentials

Callable & Codeless Actions

JMS /
Data Validation REST AMQP LDAP
HTTPS Rate Limiting

External Data
Inbound APIs

Data Transformation
XML Files JSON
I nbound Security SOAP SSH SFTP
Governance
Schema Mapping
MQTT,
Kafka
Data Streaming https PowerShell JDBC Probes
MID Server
Event Batch Processing
Email Management, &
Time Series
Reliable Messaging

API & Event Mgmt Process & Micro Services Integration Engine
8 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.
IntegrationHub

Kingston London

• Run Actions and Flows on the MID Server

• Automating Collaboration - Post Incident, – Optimize processing localized to your data and systems
Problem and Change Details as rich • PowerShell
messages to: – Automates W indows and Azure environments
– MS Teams • JavaScript on the MID
– HipChat – Orchestrate calls to any of your existing Java libraries

– Slack • REST Enhancements

– Multi-Part enables new use cases e.g. ability to move files from Box
• Spoke for ServiceNow eBonding and DocuSign
– Through MID allows you to configure calls to services hosted on the
cloud or on premise
• Ability to call outside the ServiceNow system
• Integration Spokes
– REST Step – Azure AD
– Script Step – AD
– Content begins to release out of band…

9 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.

You Will Build

• Microsoft Text Analytics Spoke

• Sentiment Action

The Jonny is Will I leave

ServiceNow terrible at feedback Cognitive Services
Store is making about this
amazing! jokes. lab? Text Analytics API
Sentiment

0.9 0.1 0.4 0 0.5 1

Negative Positive

10 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.

Spokes

11 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.

Spoke → Scoped App

12 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.

Spoke Naming Convention

• Add “Spoke” to the end of the app name

• Distinguishable from non-spoke applications
• ”Spoke” is removed when rendering the app name in Flow Designer

13 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.

Spoke Design Considerations

• Generally should be limited to a single API/Service

• Avoid coupling to your business process
• Design with business users in mind
• Should be self contained

14 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.

Lab 1
Create a Scoped Application (a.k.a. Spoke)

https://developer.servicenow.com/app.do#!/creatorcon/CCW0468
I n order to complete this lab, you must obtain a subscription key for the Microsoft Text Analytics API .

Sign up for a free trial key here: https://azure.microsoft.com/en-us/try/cognitiv e-services/?api=text-analytics

Once you hav e the key, keep it handy - you’ll need it throughout this lab.

15 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.

Actions

16 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.

Actions
1. Build Request
• Self-contained units of work
2. Send Request
• Accept inputs
3. Parse Response
• Run a series of steps in order
4. Map Response
• Can run on platform or make API calls
• Can run on instance or MID server
• Return outputs
Temperature

Zip Code Get Current Humidity

Weather Pressure

17 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.

Here’s What an Action Looks Like

18 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.

Lab 2a & 2b
Create your first Action
Create a Test Flow

19 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.

Inputs

20 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.

Inputs
• Allow you to pass data into the action
• Can be mandatory or optional
• Available to action steps via the Data pane

21 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.

Lab 3
Define Action Inputs

22 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.

The REST Step

23 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.

The REST Step

• Make REST calls without writing code

• Can leverage inputs or step outputs
• Inline connections
• Predefined connections
• Can run through MID server

24 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.

Adding a Step

25 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.

Lab 4
The REST Step

26 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.

Connections and
Credentials

27 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.

Connections and Credentials
• Decouple connection information from Actions
• Define a Connection Alias to use in your Actions
• Admins define Connections associated with the alias
• Choose which connection is active for the alias
Connection
dev.weatherapi.com

Action Uses Connection Alias Connection

Get Current Weather Weather API test.weatherapi.com

Connection
prod.weatherapi.com

28 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.

Lab 5
Configure a Connection Alias and Connection

29 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.

The Script Step

30 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.

The Script Step

• Leverage power of platform APIs or your own Script Includes

• Prepare payloads, parse responses
• Map Action inputs to variables
• Very flexible!

31 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.

Lab 6
The Script Step

32 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.

Action Outputs

33 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.

Action Outputs

• Pass data to other actions

• Map step outputs to action outputs

Best Practices
• Outputs should be human readable
• Only define outputs that are needed
• Limit the volume of data you return when possible

34 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.

Lab 7
Action Outputs

35 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.

Testing & Troubleshooting

36 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.

Testing and Troubleshooting
• Use the “Test” button early and often
• Use the Operations View to inspect the result of a flow execution
• You can often find everything you need in one place!

37 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.

F.A.Q
Frequently asked questions!!! ✓ IntegrationHub looks cool, but I bet there’s some
stuff not supported yet, right?
Yes! Just like ITOM & SecOps, there will be Box,
✓ What about Workflow, is it going away? DocuSign, Jenkings and a long list of other big
Flow Designer will eventually replace it. Do I tech players - see next slide with safe harbour!
need to migrate over? No, workflow will be
there for a long time. Madrid will be in parity in ✓ I heard you need to pay more to use it, how’s
terms of functionality... Use Flow designer, unless the licensing model?
you have a specific case for using workflow! Transactional based, I believe you get 1,000 a
month, can't talk about price.. New licensing
✓ How about Orchestration, though? model in the works. HipChat, MS teams, Slack
Well, orcherstration is like Integration Hub for DO NOT count in the quota!
Workflow, so same applies. There are some
specific cases, like dynamic parallel orch flows ✓ I’m an ISV, can I build & publish Spokes to the
that you might consider using it. Store?
Yeah, why not? Just be mindful of the licensing
✓ Are any other legacy platform integration implications and any dependencies...
capabilities going bye-bye?
Not really... but all effort is now shifted to Flow ✓ Will ServiceNow ever use the Store to publish
designer and Integration Hub, as the strategic spokes outside of the bi-annual release cycle?
product for integrations. In Madrid, big release Yes! Just like ITOM & SecOps, there will be Box,
for Flow designer, New York big for Ihub (reason DocuSign, Jenkins and a long list of other big
why Josh couldn't make it! haha) tech players…

38 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.

Top takeaways

1 2 3

SPOKES ARE JUST B U I L D A C T I O NS DESIGN HUMAN

SCOPED APPS TO E NC A P S U L AT E R E A DA B L E A C T I O NS
B U S I NE S S L O G I C

39 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.

 Thank You ☺
Jonatan ‘Jonny’ Jardi
[email protected]
ISV Advisory Solution Architect
ServiceNow

Check out the ServiceNow Store: store.service-now.com