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 ☺


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 ☺


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


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


IntegrationHub


Vision

RES

T

AD, Exchange, SCCM, Windows

*nix,

MFT

CSM, SecOps, ITSM, GRC,

Benchmarks

MID ProxyHub(JavaScript, REST)


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


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…


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


Spokes


Spoke → Scoped App


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


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


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.

https://azure.microsoft.com/en-us/try/cognitive-services/?api=text-analytics


Actions


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


Here’s What an Action Looks Like


Lab 2a & 2bCreate your first Action

Create a Test Flow


Inputs


Inputs

• Allow you to pass data into the action

• Can be mandatory or optional

• Available to action steps via the Data pane


Lab 3Define Action Inputs


The REST Step


The REST Step

• Make REST calls without writing code

• Can leverage inputs or step outputs

• Inline connections

• Predefined connections

• Can run through MID server


Adding a Step


Lab 4The REST Step


Connections and

Credentials


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


Lab 5Configure a Connection Alias and Connection


The Script Step


The Script Step

• Leverage power of platform APIs or your own Script Includes

• Prepare payloads, parse responses

• Map Action inputs to variables

• Very flexible!


Lab 6The Script Step


Action Outputs


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


Lab 7Action Outputs


Testing & Troubleshooting


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!


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…


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

[email protected]

ISV Advisory Solution Architect

ServiceNow

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

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

Documents