Azure for SharePoint Developers - Workshop - Part 2: Azure Functions
Download as PPTX, PDF0 likes132 views
This document discusses Azure Functions and common use cases for using Azure Functions with SharePoint Online. It provides an overview of Azure Functions including common triggers, bindings, and runtimes. It then describes examples of using Functions with SharePoint Online for tasks like elevating permissions, running timer jobs, hiding API keys, extending site designs and scripts, and custom code in Microsoft Flow. Additional details and code samples are provided for Functions integration with SharePoint Online.
![public static void Run(byte[] image, string filename,
Stream outputBlob, TraceWriter log)
{
log.Info($"Processing image: {filename}");
var imageBuilder = ImageResizer.ImageBuilder.Current;
imageBuilder.Build(
image, outputBlob,
new ResizeSettings(640, 400, FitMode.Max, null), false);
}
{
"bindings": [
{
"name": "image",
"type": "blobTrigger",
"direction": "in",
"path": "card-input/{filename}.jpg",
"connection": "AzureWebJobsStorage"
},
{
"type": "blob",
"name": "outputBlob",
"path": "card-output/{filename}.jpg",
"connection": "AzureWebJobsStorage",
"direction": "out"
}
]
}](https://image.slidesharecdn.com/wrk403-2masteringazurefunctions-181204152603/85/Azure-for-SharePoint-Developers-Workshop-Part-2-Azure-Functions-16-320.jpg)
![var listRecipe = {
"$schema": "schema.json",
"actions": [
{
"primary_verb": "List.CreateOrOpen",
"target": "Customer Tracking",
"templateType": 100,
"verbs": [
{
"verb": "SetDescription",
"description": "List of Customers and Orders"
},
{
"verb": "AddFieldIfNotExist",
"fieldType": "Text",
"displayName": "Customer Name",
"isRequired": false,
"addToDefaultView": true
},
{
"verb": "AddFieldIfNotExist",
"fieldType": "DateTime",
"displayName": "Date of Delivery",
"isRequired": true
},
]
},
{
primary_verb: "Theme.Apply",
target: "Contoso Travel Green"
}
],
"bindata": {},
"version": 1
};
Idempotent syntax of
common site configuration
actions
Script actions can be
concatenated in single file or
multiple files can be used (and
reused)
RestRequest("/_api/Microsoft.Sharepoint.Utilities.WebTemplateExtensions.Script
Utility.CreateFormula", {info:{Title:"Contoso Travel - Legal Case Book",
Description:"Restricted site design to create a legal case book site",
ScriptGuids:["b432a1cd-7e1f-4fb1-9829-633d8MaG1C”],
Targets:["CN=GUID,OU=GUID,OU=Tenants,OU=MSOnline,DC=<value>,DC=ms
oprd,DC=msft,DC=net"], IsDefault:true, WebTemplate:"68"}});
Site Design attributes
designate display
characteristics and target
template](https://image.slidesharecdn.com/wrk403-2masteringazurefunctions-181204152603/85/Azure-for-SharePoint-Developers-Workshop-Part-2-Azure-Functions-22-320.jpg)
![var flowRecipe = {
"$schema": "schema.json",
"actions": [{
"primary_verb": "Flow.Trigger",
"target": “<<http post url>>",
"name": “contoso hr additions",
"parameters": {
"department": "HR",
"cost center": "1023"
}
}
],
"bindata": {},
"version": 1
};
SharePoint
Online
Storage
Queue
Azure Function
Microsoft Flow
Business logic will handle the message
processing. Site URL is used as a parameter to
connect to site using remote APIs. Applies
needed customization using remote
provisioning techniques, for example with PnP
remote provisioning template model.
Script configured to start
previously configured flow,
which will receive the newly
created site URL as parameter.
Flow includes a step to pass
site URL to Azure storage
queue for delegating
processing to Azure side
1 2
3
4](https://image.slidesharecdn.com/wrk403-2masteringazurefunctions-181204152603/85/Azure-for-SharePoint-Developers-Workshop-Part-2-Azure-Functions-24-320.jpg)
Azure for SharePoint Developers - Workshop - Part 2: Azure Functions
- 2. Azure Functions w/SharePoint Online Common Use Cases • Elevate permissions • Timer job • Hiding API keys • Extending Site Designs/ Scripts • Custom code in Flow
- 3. …if cloud computing was transportation
- 5. Azure Functions Process events with Serverless code. Make composing Cloud Apps insanely easy Develop Functions in C#, Node.js, F#, Python, PHP, Batch and more Easily schedule event-driven tasks across services Expose Functions as HTTP API endpoints Scale Functions based on customer demand Easily integrate with Logic Apps
- 7. 1
- 9. Functions Runtime Functions Programming Interface App Service App Hosting Plans Triggers Input Bindings Output Bindings
- 10. Functions 1.x Functions 2.x C# (script) GA GA C# (precompiled) GA GA JavaScript GA GA F# GA GA Java GA GA PowerShell Experimental Python Experimental PHP Experimental TypeScript Experimental Batch (.cnd, .bat) Experimental Bash Experimental
- 11. Trigger • Invokes the function • Always exactly 1 Input binding • Handles incoming data • Optional Output binding • Handles outgoing data • Optional
- 12. Type 1.x 2.x Trigger Input Output Blob Storage ✔ ✔ 1 ✔ ✔ ✔ Cosmos DB ✔ ✔ ✔ ✔ ✔ Event Grid ✔ ✔ ✔ Event Hubs ✔ ✔ ✔ ✔ External File 2 ✔ ✔ ✔ External Table 2 ✔ ✔ ✔ HTTP ✔ ✔ 1 ✔ ✔ Microsoft Graph Excel tables ✔ ✔ ✔ Microsoft Graph OneDrive files ✔ ✔ ✔ Type 1.x 2.x Trigger Input Output Microsoft Graph Outlook email ✔ ✔ MS Graph Events ✔ ✔ ✔ ✔ MS Graph Auth tokens ✔ ✔ Mobile Apps ✔ ✔ ✔ ✔ Notification Hubs ✔ ✔ Queue storage ✔ ✔ 1 ✔ ✔ SendGrid ✔ ✔ ✔ Service Bus ✔ ✔ ✔ ✔ Table storage ✔ ✔ 1 ✔ ✔ Timer ✔ ✔ ✔ Twilio ✔ ✔ ✔ Webhooks ✔ ✔ ✔
- 13. Function (pass a function key) Admin (pass function app’s host key) System (pass function app’s master key) Anonymous (can be used in conjunction with App Service authN) Coming soon: User – this will be token based
- 16. public static void Run(byte[] image, string filename, Stream outputBlob, TraceWriter log) { log.Info($"Processing image: {filename}"); var imageBuilder = ImageResizer.ImageBuilder.Current; imageBuilder.Build( image, outputBlob, new ResizeSettings(640, 400, FitMode.Max, null), false); } { "bindings": [ { "name": "image", "type": "blobTrigger", "direction": "in", "path": "card-input/{filename}.jpg", "connection": "AzureWebJobsStorage" }, { "type": "blob", "name": "outputBlob", "path": "card-output/{filename}.jpg", "connection": "AzureWebJobsStorage", "direction": "out" } ] }
- 17. C#
- 19. Do try this at home! http://bit.ly/AzFuncTools Want to not elevate permissions? See this great blog series by Vardhaman Deshpande http://bit.ly/AzFuncOnBehalfOf
- 20. • Light-weight API management • Change URL, manipulate request and response • Inherits the configuration of your Function App (e.g. authentication) Azure Function Proxies
- 22. var listRecipe = { "$schema": "schema.json", "actions": [ { "primary_verb": "List.CreateOrOpen", "target": "Customer Tracking", "templateType": 100, "verbs": [ { "verb": "SetDescription", "description": "List of Customers and Orders" }, { "verb": "AddFieldIfNotExist", "fieldType": "Text", "displayName": "Customer Name", "isRequired": false, "addToDefaultView": true }, { "verb": "AddFieldIfNotExist", "fieldType": "DateTime", "displayName": "Date of Delivery", "isRequired": true }, ] }, { primary_verb: "Theme.Apply", target: "Contoso Travel Green" } ], "bindata": {}, "version": 1 }; Idempotent syntax of common site configuration actions Script actions can be concatenated in single file or multiple files can be used (and reused) RestRequest("/_api/Microsoft.Sharepoint.Utilities.WebTemplateExtensions.Script Utility.CreateFormula", {info:{Title:"Contoso Travel - Legal Case Book", Description:"Restricted site design to create a legal case book site", ScriptGuids:["b432a1cd-7e1f-4fb1-9829-633d8MaG1C”], Targets:["CN=GUID,OU=GUID,OU=Tenants,OU=MSOnline,DC=<value>,DC=ms oprd,DC=msft,DC=net"], IsDefault:true, WebTemplate:"68"}}); Site Design attributes designate display characteristics and target template
- 24. var flowRecipe = { "$schema": "schema.json", "actions": [{ "primary_verb": "Flow.Trigger", "target": “<<http post url>>", "name": “contoso hr additions", "parameters": { "department": "HR", "cost center": "1023" } } ], "bindata": {}, "version": 1 }; SharePoint Online Storage Queue Azure Function Microsoft Flow Business logic will handle the message processing. Site URL is used as a parameter to connect to site using remote APIs. Applies needed customization using remote provisioning techniques, for example with PnP remote provisioning template model. Script configured to start previously configured flow, which will receive the newly created site URL as parameter. Flow includes a step to pass site URL to Azure storage queue for delegating processing to Azure side 1 2 3 4
- 28. http://bit.ly/AzFuncTools http://bit.ly/AzureSPC-FuncJS http://bit.ly/AzureSPC-FuncCS On Behalf Of Flow http://bit.ly/AzFuncOnBehalfOf http://bit.ly/AzureSPC-FuncCSOM http://bit.ly/AzureSPC-FuncSPFx http://bit.ly/AzureSPC-SiteScripts
Editor's Notes
- #2: WRK403 - What Every SharePoint Developer should know about Microsoft Azure While the SharePoint Framework is the new place to customize the SharePoint UI, it runs completely within the web browser, and does nothing to help with background processing or other server-side work, including situations where you need to elevate permissions beyond what the end user is allowed to do. Both sandboxed and farm solutions are off the table in SharePoint Online, leaving few SharePoint-based options for this kind of work. Fortunately, Microsoft Azure is well positioned to handle these situations and many more, and should be part of every SharePoint developer's tool set. This workshop will introduce Azure platform services including Azure Active Directory, web apps, logic apps, Azure Functions, and more. You will learn practical approaches to integrate these with SharePoint. Scenarios will include: • Surfacing line of business data in SharePoint via Azure web apps and functions • Elevating permission in a SharePoint web part • Using Azure functions as timer jobs and web services • Implementing workflows and business orchestration with Azure Logic Apps • Storing and querying large data sets (beyond 5,000 rows) in SQL Azure • Safely managing security and secrets in your Azure code with Managed Service Identities and Key Vault Attendees should have a working knowledge of C# development and familiarity with SharePoint Online. Don't miss this opportunity to upgrade your development skills for modern SharePoint!
- #4: 3