tSponsors

Sameer ChabungbamPrincipal Program Manager, Microsoft

Connector API Apps

BizTalk Summit 2015 – LondonExCeL London | April 13th & 14th

Microsoft Azure

What we will see today

•What are Connectors and API Apps?

•Building your first Connector

•Make your Connector work for Logic App

• Implementing a Trigger

•Summary

Microsoft Azure

API APPS

Easily build and consume APIs in the cloud

WEB APPSWeb apps that scale with your

business

LOGIC APPS

Automate business process across SaaS and on-premises

MOBILE APPS

Build Mobile apps for any device

Azure App Service

Microsoft Azure

A powerful platform for building and

managing APIs

Build once and consume any type of

app anywhere, at any time

A rich ecosystem for distributing and

monetizing APIs

Azure App Service API Apps

Microsoft Azure

Build on top of Azure App Service Web App

Support all kinds of REST APIs, new or existing

Simple yet powerful authentication support. Free your

API up from complex authentication handling

Expose API definition for metadata driven clients and

SDK code-gen

Powerful Platform

Microsoft Azure

One API platform for Web App, Mobile App and Logic

App. Maximize the value of the API.

Easy to optimize for each type of apps.

Integrated experience across different types of apps.

Build Once Consume Everywhere

Microsoft Azure

Public gallery for certified partners and community

developers.

Organization gallery with RBAC for enterprise.

Distribution and monetization channel to all Microsoft

cloud customers.

Rich Ecosystem

• Box

• Chatter

• Dropbox

• Azure HD Insight

• OneDrive

• SharePoint Server

• SharePoint Online

• SQL Server

• Office 365

• Oracle DB

• QuickBooks

• Salesforce

• SugarCRM

• SAP

• Azure Service Bus

• Azure Storage Blob

• Twilio

• Twitter

• IBM DB2

• Informix

• Websphere MQ

• Azure Web Jobs

• Yammer

• Facebook

• HTTP, HTTPS

• File

• FTP

• SFTP

• POP3

• SMTP

• Flat File Encoder

• Validate

• Extract (XPath)

• Transform

• X12

• EDIFACT

• AS2

• TPM

• Rules

Connectors

Protocols BizTalk Services

Built-in API Apps

And more on the way…

Microsoft Azure

Building your first ConnectorThe Basics

Microsoft Azure

DemoBuilding a Storage Queue Connector

Microsoft Azure

What we saw

• Tools and SDK• Visual Studio 2013• Azure SDK 2.5.1 or above

•Write a Web API•Make it into an API App

• Add Azure API App SDK• Edit ApiApp.json

• Test locally using Swagger UI• Publish your API App

11

Microsoft Azure

Connector for Logic AppsThe Essentials

12

Microsoft Azure

Optimize for Logic Apps

•Display names

•Response type

•Advanced operations and properties

For Operation:

“summary”

For Parameters and Properties:

“x-ms-summary”

“default” response field

“x-ms-visibility” extension:

“advanced”

“internal”

Microsoft Azure

Swashbuckle

•Generates swagger metadata for your API App

• Allows you to customize swagger generation• Operation Filters

• Schema Filters

• Document Filters

• All in SwaggerConfig.cs

14

Microsoft Azure

DemoAdd summary and XML Documentation

Add default response

Microsoft Azure

Dynamic Swagger

•Generate metadata depending on API App Configuration• Discover entities

• Provide a strongly typed API• Operations can be dynamically added• Input and output parameters can be

strongly typed

• Enhances user experience• Allowed values as enumerations

Microsoft Azure

DemoDiscover Queues in the configured Storage Account

Microsoft Azure

What we saw

•Add summary and other documentation in your API Metadata

•Enable XML Comments

•Use Operation Filters to customize your swagger

18

Microsoft Azure

Triggers

• Triggers define when Logic Apps are run• Manual or Schedule or WebHooks• Connector Triggers – Polling or Push

• Connector Triggers (Polling)• 200: Data is available, run the logic• 202: No data is available, check again later• ‘triggerState’ parameter to externalize state

•Optimize for Logic Apps• Hide trigger specific properties

Microsoft Azure

DemoAdd Trigger to run when Message is available

Microsoft Azure

Next Steps

•Debugging your API App

•Writing a Hybrid API App

•Using OAUTH

•Adding diagnostics and error handling

•Packaging your API App

Microsoft Azure

Key Takeaways

• A powerful platform for APIs

• A rich ecosystem for distributing and monetizing APIs

• Build your own API App or use from Marketplace

•Optimize your API Apps for Logic Apps

•Get involved – feedback, build your connector!

Microsoft Azure 23

Thank You

Contact: sameerch@microsoft.com