creatorcon: building your first integrationhub spoke · 10/9/2018  · title: isv advisory solution...

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

Email

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

Jonatan.Jardi@servicenow.com

ISV Advisory Solution Architect

ServiceNow

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