Xtending Nintex Workflow Cloud with Azure Functions

Transcription

1 Xtending Nintex Workflow Cloud with Azure Functions

2 Tom Castiglia Solution Architect DOCFLUIX, LLC Mike Oryszak Managing Director B&R BUSINESS SOLUTIONS, LLC

3 About Tom SharePoint/Office 365 Consultant President of the San Diego SharePoint User Group meetup.com/sanspug Nintex vte (virtual Technical Evangelist) Speaker at various SharePoint Saturday conferences

4 About Mike SharePoint/Office 365/Azure Consultant President of the Triangle SharePoint User Group meetup.com/trispug Speaker at various conferences and events

5 Agenda Azure Functions Open API (Swagger) Solution Overview Azure Portal Demo Function Review Define Xtension in NWC Define Connection in NWC Use the Action Solution Overview NWC Integration Define Xtension in NWC Define Connection in NWC Use the Action More Use Cases Q&A References Overview Logging Compliance Activities to Azure Retrieve GSA Per Diem Rates Next Steps

6 Overview

7 Azure Functions overview Build apps faster with a serverless architecture Accelerate your development with an event-driven, serverless compute experience. Scale on demand and pay only for the resources you consume. Manage your apps instead of infrastructure Don t worry about provisioning and maintaining servers, especially when your workload grows. Functions provides a fully managed compute platform with high reliability and security and they scale on demand. 8

8 Azure Functions overview Develop your way Languages: JavaScript, C#, and F#, and scripting options such as Python, PHP, Bash, Batch, and PowerShell Code directly in Azure portal OR Code in Visual Studio or later (Still in preview) Install Azure Development workload Includes tooling to create Azure Function projects and classes locally and publish Includes Azure CLI (Command Line Interface) which allow you to run and debug your functional locally 9

9 OpenAPI (Swagger) overview When you publish an Azure Function, it creates a REST endpoint for your function OpenAPI allows you to configure the details of your endpoint URL HTTP Methods (GET, POST, PUT, etc.) Inputs Outputs 10

10 OpenAPI (Swagger) overview It s a JSON file Configured using YAML a human friendly data serialization standard for all programming languages YAML Ain t Markup Language Import your function to NWC as a custom connector/action Help available at 11

11 Scenario 1: Logging compliance activities to Azure

12 Logging compliance activities to Azure Imagine many workflows throughout the org including activities within the scope of internal or external audit Need to log compliance activities centrally to support reporting Process/workflow name Category Date Message

13 Solution overview Nintex Workflow REST Call to Function App Developed in the browser using C# Leverages Function App for processing Storage Queue for reliable delivery Cosmos DB for storage Function App Function App Storage Queue Cosmos DB Triggered with REST Call Parses request and writes to Queue Triggered by Queue message Writes to Cosmos DB

14 Demo! 15

15 Scenario 2: Retrieve GSA per diem rates

16 GSA Per Diem API Common workflow use cases are travel authorization requests and expense reports, where employees travel and incur expenses for meals and hotels The GSA publishes official Per Diems that dictate the maximum amounts that are may be expensed for hotels and meals The Per Diem amounts are updated each year Each region has its own per diems (e.g., hotels in NYC cost more than in Des Moines) Per Diems also vary by month, based on peak travel seasons Public web site: 17

17 Per Diem API REST API References: ology/government-itinitiatives/digitalstrategy/per-diem-apis/apifor-per-diem-rates Fiscal year and zip on/datastore_search?resource_id= 8ea44bc4-22ba-4386-b84c- 1494ab28964b&filters={"FiscalYea r":"2017","zip": 92131"} Fiscal year and county on/datastore_search?resource_id= 8ea44bc4-22ba-4386-b84c- 1494ab28964b&filters={"FiscalYea r":"2017","county":"worcester"}

18 Sample response (abbreviated) The Records element is nested within a bunch of stuff that can be ignored The element for each month represents the hotel Per Diem for that month The Meals element represents the Per Diem allowed for meals for the year

19 Using Visual Studio New Project>Visual C#>Cloud>Azure Functions Azure Functions maps to a Function App, which can contain 1 N individual functions Right-click the project and select publish Create new Azure Function App, then click publish

20 Function App Log into Azure Portal to review new Function App Notice it does not contain any functions yet In Visual Studio, right-click the project and click Add > New Azure Function Name the function and click Add Select function type as Http Trigger and click OK

21 Function App Republish from VS2017 and notice your functional app now contains the new function

22 GSA Per Diem wrapper Accept Zipcode and Tripdate in JSON as input (in body of request) Validate inputs Format REST call to GSA API Format JSON response with GSA Per Diem amounts (hotel and meals) 23

23 JSON formatting Input Output 24

24 Classes for GSA Per Diem JSON

25 Deserialize Input JSON Incoming JSON

26 Call to GSA REST API

27 Output JSON/HTTP response JSON response

28 Configure HTTP Methods

29 Configure API definition

30 Nintex Workflow Cloud

31 Nintex Workflow Cloud

32 Configure GSA Per Diem action in NWC

33 Next steps

34 Additional use cases Integrating with additional LOB systems

35 Q&A

36 From the xchange mobile app, select Survey from the sessions that you attend Complete the short evaluation Click Submit

37