CreatorCon: Building Your First IntegrationHub Spoke ISV Advisory Solution Architect ServiceNow Jonatan ‘Jonny’ Jardi
CreatorCon:Building Your First IntegrationHubSpoke
ISV Advisory Solution ArchitectServiceNow
Jonatan ‘Jonny’ Jardi
2 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.
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 ☺
3 © 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 ☺
4 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.
What You Will Learn
S PO K E D ES I GN CO NS I D ER ATIONS
3
I NTR O D UCTI ON TO I NTEG R ATIONH UB
B UI L D ING S PO K ES
21
5 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.
Flow DesignerAn alternative to Asynchronous business rules
Kingston
• Natural language, codeless Flows
• Discoverability and reuse
• Conditions & record iteration
• Operational troubleshooting
• Content
– CRUD
– Simplified, powerful approvals
– ITSM, CSM, Benchmarks, VTB, Connect
– Notifications
London
• Subflows
• Service Catalog
• Stages– Surfaced that more clearly in the UI that there are only 5 Stages
States
– Are no longer bound to actions
• User can decide the Error State
– Customers can configure the stages states to user friendly names and leverage standard approval stage states
• MetricBase Triggers
• Enhanced guided experience
• APIs
– Asynchronous Call Flows
– Operations
6 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.
IntegrationHub
7 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.
Vision
RES
T
AD, Exchange, SCCM, Windows
*nix,
MFT
CSM, SecOps, ITSM, GRC,
Benchmarks
MID ProxyHub(JavaScript, REST)
8 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.
IntegrationHub VisionA single solution for API Management and Codeless Integration (Data, Files, RPCs)
Data Streaming
Rate Limiting
API / Trigger Design
Inbound Security
Connections &
Credentials
API & Event Mgmt
XML JSONFiles
Governance
HTTPS
https
Direct**
MID Server
Schema Mapping
Ca
llab
le &
Co
de
less
Ac
tio
ns
Ext
ern
al D
ata
RP
Cs,
Da
ta, A
tta
ch
me
nts
Inb
ou
nd
AP
IsOutbound Protocols
Integration Engine
Batch Processing
Data Validation
Schema Design
Reliable Messaging
Data Transformation
MQTT, Kafka
Event Management, &
Time Series
Process & Micro Services
Flow Design
REST
SOAP
JMS / AMQP
PowerShell Probes
SSH
LDAP
SFTP
JDBC
Integration Action Design
9 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.
IntegrationHub
Kingston
• Automating Collaboration - Post Incident, Problem and Change Details as rich messages to:
– MS Teams
– HipChat
– Slack
• Spoke for ServiceNow eBonding
• Ability to call outside the ServiceNow system
– REST Step
– Script Step
London
• Run Actions and Flows on the MID Server– Optimize processing localized to your data and systems
• PowerShell– Automates Windows and Azure environments
• JavaScript on the MID – Orchestrate calls to any of your existing Java libraries
• REST Enhancements– Multi-Part enables new use cases e.g. ability to move files from Box
and DocuSign
– Through MID allows you to configure calls to services hosted on the cloud or on premise
• Integration Spokes– Azure AD
– AD
– Content begins to release out of band…
10 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.
You Will Build
• Microsoft Text Analytics Spoke
• Sentiment Action
Cognitive Services
Text Analytics API
Sentiment
The
ServiceNow
Store is
amazing!
Jonny is
terrible at
making
jokes.
Will I leave
feedback
about this
lab?
Negative
0 10.5
Positive
0.9 0.1 0.4
11 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.
Spokes
12 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.
Spoke → Scoped App
13 © 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
14 © 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
15 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.
Lab 1Create a Scoped Application (a.k.a. Spoke)
https://developer.servicenow.com/app.do#!/creatorcon/CCW0468
In 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/cognitive-services/?api=text-analytics
Once you have the key, keep it handy - you’ll need it throughout this lab.
16 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.
Actions
17 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.
Actions
• Self-contained units of work
• Accept inputs
• Run a series of steps in order
• Can run on platform or make API calls
• Can run on instance or MID server
• Return outputs
Get Current
WeatherZip Code
Temperature
Humidity
Pressure
1. Build Request
2. Send Request
3. Parse Response
4. Map Response
18 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.
Here’s What an Action Looks Like
19 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.
Lab 2a & 2bCreate your first Action
Create a Test Flow
20 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.
Inputs
21 © 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
22 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.
Lab 3Define Action Inputs
23 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.
The REST Step
24 © 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
25 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.
Adding a Step
26 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.
Lab 4The REST Step
27 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.
Connections and
Credentials
28 © 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 Alias
Weather API
Connectiondev.weatherapi.com
Connectiontest.weatherapi.com
Connectionprod.weatherapi.com
Action
Get Current Weather
Uses
29 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.
Lab 5Configure a Connection Alias and Connection
30 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.
The Script Step
31 © 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!
32 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.
Lab 6The Script Step
33 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.
Action Outputs
34 © 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
35 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.
Lab 7Action Outputs
36 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.
Testing & Troubleshooting
37 © 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!
38 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.
F.A.Q
✓ What about Workflow, is it going away?Flow Designer will eventually replace it. Do I need to migrate over? No, workflow will be there for a long time. Madrid will be in parity in terms of functionality... Use Flow designer, unless you have a specific case for using workflow!
Frequently asked questions!!!
✓ How about Orchestration, though?Well, orcherstration is like Integration Hub for Workflow, so same applies. There are some specific cases, like dynamic parallel orch flows that you might consider using it.
✓ Are any other legacy platform integration capabilities going bye-bye?Not really... but all effort is now shifted to Flow designer and Integration Hub, as the strategic product for integrations. In Madrid, big release for Flow designer, New York big for Ihub (reason why Josh couldn't make it! haha)
✓ IntegrationHub looks cool, but I bet there’s some stuff not supported yet, right?Yes! Just like ITOM & SecOps, there will be Box, DocuSign, Jenkings and a long list of other big tech players - see next slide with safe harbour!
✓ I heard you need to pay more to use it, how’s the licensing model?Transactional based, I believe you get 1,000 a month, can't talk about price.. New licensing model in the works. HipChat, MS teams, Slack DO NOT count in the quota!
✓ I’m an ISV, can I build & publish Spokes to the Store?Yeah, why not? Just be mindful of the licensing implications and any dependencies...
✓ Will ServiceNow ever use the Store to publish spokes outside of the bi-annual release cycle?Yes! Just like ITOM & SecOps, there will be Box, DocuSign, Jenkins and a long list of other big tech players…
39 © 2018 ServiceNow, Inc. All Rights Reserved. Confidential.
Top takeaways
S PO K ES AR E JUS T S CO PED APPS
1
B UI L D ACTI O NS TO ENCAPS UL ATE B US I NES S L O G I C
2
D ES I G N H UM AN R EADAB L E ACTI O NS
3
Thank You ☺Jonatan ‘Jonny’ Jardi
ISV Advisory Solution Architect
ServiceNow
Check out the ServiceNow Store: store.service-now.com