SharePoint 2013 – REST, JSON and SharePoint Designer Jaap Mollema SharePoint 2013 – REST, JSON and SharePoint Designer

Jaap Mollema SharePoint Consultant Microsoft Services Jaap Jaap Mollema SharePoint Consultant Microsoft Services Jaap.Mollema@microsoft.com http://nl.linkedin.com/in/jaapmollema/

Vandaag Acties & Workflow Interop REST Endpoints SPC2012 - Developer 3/31/2017 Vandaag Acties & Workflow Interop REST Endpoints REST in SharePoint Designer Workflows Verder dan een site Theorie: SharePoint 2013 en Workflow Management Integratie SP2013 en SP2010 Theorie: REST Theorie: SharePoint 2013 Designer Demo: SharePoint 2013 Designer – high level Uitleg: De case Demo: © 2012 Microsoft Corporation. All rights reserved. Microsoft, Windows, and other product names are or may be registered trademarks and/or trademarks in the U.S. and/or other countries. The information herein is for informational purposes only and represents the current view of Microsoft Corporation as of the date of this presentation. Because Microsoft must respond to changing market conditions, it should not be interpreted to be a commitment on the part of Microsoft, and Microsoft cannot guarantee the accuracy of any information provided after the date of this presentation. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

Acties beschikbaar in 2013 To much text? Action Description Assign a Task Assigns a single workflow task to a user or group. Start a Task Process Initiates execution of a task process. Go to This Stage Specifies the next stage in a workflow to which flow control should be handed. Call HTTP Web Service Functions as a method call to a Representational State Transfer (REST) endpoint. Start a List Workflow Starts a list-scoped workflow. Start a Site Workflow Starts a site-scoped workflow. Build DynamicValue Creates a new variable of type DynamicValue. Get Property from DynamicValue Retrieves a property value from a specified variable of type DynamicValue. Count Items in DynamicValue Returns the number of rows in a variable of type DynamicValue. Trim String Removes all leading and trailing white-space characters from the current string. Find Substring in String Returns 1-based index of the first occurrence of one or more characters, or the first occurrence of a string, within a string. Replace Substring in String Returns a new string in which all occurrences of a specified character or string are replaced with another specified character or string. Translate Document Functions as a wrapper around the HTTP activity that calls the synchronous translation API. You must configure a Machine Translation Service Application for the SharePoint site on which you run the workflow. Set Workflow Status Updates workflow status as specified in message string. Create a Project from Current Item [Microsoft Project] Creates a Project Server project based on the current item. Set the current project stage status to this value [Microsoft Project] Sets the two status fields within the current stage of the project. Set the status field in the idea list item to this value [Microsoft Project] Updates the status field of the original SharePoint list item. Wait for Project Event [Microsoft Project] Pauses the current instance of the workflow to await a specified Project event: Project checked in, Project committed, Project submitted. Set this field in the project to this value [Microsoft Project] Sets the value for the enterprise custom field for a specified project. To much text?

Acties niet beschikbaar in 2013 Action Description Add List Item Permissions This action is initially displayed in workflow steps as Add these permissions to item in list. Assign a Form to a Group This action is initially displayed in a workflow step as Assign a custom form to these users. It enables you to create a custom task form with customized fields. Assign a To-do Item This action is initially displayed in a workflow step as Assign to-do to these users Capture a version of the Document Set It locks the version of the document set that has the version of documents —major or minor— that you specify in the action. Collect Data from a User Use this action to assign a task to the participant, prompting them to provide the needed information in a custom task form, and then click the Complete Task button on the task form. Copy List Item Use this action to copy a list item to another list. Declare Record Use this action to identify a document as a record and apply the record restrictions settings you may have defined in the Record Declaration Settings page on your SharePoint site. Inherit List Item Parent Permissions If your item has unique permissions, you can use this action to make the item inherit the parent permissions from the list. Lookup Manager of a User Use this action to look up a user's manager. The output value is then stored in a variable. Remove List Item Permissions It removes permissions from an item for specific users. Replace List Item Permissions It replaces an item's current permissions with the new permissions that you specify in the action. Send Document Set to Repository allows you to move or copy the document set to a document repository. Set Content Approval Status Use this action to set content approval of a document to Approved, Rejected, or Pending. Set Content Approval Status for the Document Set Use this action to set content approval of a document set to Approved, Rejected, or Pending. Set Workflow Status Use this action to set the status of the workflow Start Approval Process It starts an approval action on a document to specific users. Start Custom Task Process The Start Custom Task Process action is an approval process template that you can use if the above approval actions do not meet your needs. Start Document Set Approval Process It starts an approval action on a document set to specific users. Start Feedback Process Use this action to assign task items for feedback to users in a specific order—serial or parallel. Undeclare Record There’s more

Workflow Interop

Workflow Interop

Workflow Interop

REST

REST Site - _api/web/ Lijsten of bibliotheken _api/web/lists/ _api/web/lists/getByTitle(‘[LIST NAME’) _api/web/lists/guid’[GUID ID]’) Search _api/search/query (retrieve results) _api/search/postquery (POST, no URI length restricitions) _api/search/suggest (query suggestions) User Profiles _api/SP.UserProfiles.PeopleManager

REST DESC!!!

REST

REST

SharePoint Designer

REST In SharePoint Designer: GET (ophalen resultaten) SPC2012 - Developer 3/31/2017 REST In SharePoint Designer: GET (ophalen resultaten) POST (wegschrijven resultaten) & MERGE als onderdeel in de header PUT (vervangen data) DELETE (verwijderen data) © 2012 Microsoft Corporation. All rights reserved. Microsoft, Windows, and other product names are or may be registered trademarks and/or trademarks in the U.S. and/or other countries. The information herein is for informational purposes only and represents the current view of Microsoft Corporation as of the date of this presentation. Because Microsoft must respond to changing market conditions, it should not be interpreted to be a commitment on the part of Microsoft, and Microsoft cannot guarantee the accuracy of any information provided after the date of this presentation. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

Case Offerte reviewers Afhankelijk van offertebedrag moeten bepaalde personen het document goedkeuren. SharePoint Library: Proposals SharePoint Lijst: Routing Table

Call Stap 1: Ophalen Lijst: /_api/web/lists/GetByTitle('Routing%20Table')/items Stap 2: Beperken tot bedragen lager dan het offerte bedrag /_api/web/lists/GetByTitle('Routing%20Table')/items?$filter=(Amount lt '5000') Stap 3: Hoogste bedrag bovenaan /_api/web/lists/GetByTitle('Routing%20Table')/items?$orderby=Amount desc&$filter=(Amount lt '5000')

Headers Nodig: Niet nodig Method: GET Request: _api/web/lists/GetByTitle('Routing%20Table')/ items?$orderby=Amount desc&$filter=(Amount lt '5000') Accept: application/json;odata=verbose Content-Type: application/json;odata=verbose Niet nodig Authorization

Wegschrijven data

List Type List Item Entity Type Full Name _api/web/lists/getbytitle('Resources')?$select=ListItemEntityTypeFullName

Headers Nodig: Niet nodig Method: POST Request: _api/web/lists/GetByTitle(‘Update Feed')/ items Accept: application/json;odata=verbose Content-Type: application/json;odata=verbose __metadata Niet nodig Authorization

Wegschrijven data in andere site

App Permissions Locatie van de workflow: Locatie van de lijst _layouts/15/appprincipals.aspx?Scope=Web Workflow: i:0i.t|ms.sp.ext|8208be62-6ae6-4ccc-894c-14d8d9b9fbeb@37153b50-af42-4e1a-97e5-da30ae7efa80  Locatie van de lijst _layouts/15/oauthauthorize.aspx?client_id=8208be62-6ae6-4ccc-894c-14d8d9b9fbeb&response_type=code&scope=Search.QueryAsUserIgnoreAppPrincipal Read of Write of Manage of Full Controll Web.Read Site.Read List.Read

Tips

Tips Begin altijd binnen de context van een (sub)site (web) Maak gebruik van een TEMP lijst voor JSON response Test call in je browser Bewaar je workflow als template en enable hem op verschillende subsites middels solutions

Links How to: Complete basic operations using SharePoint 2013 REST endpoints: http://msdn.microsoft.com/en-us/library/jj164022.aspx Search REST API: http://blogs.msdn.com/b/nadeemis/archive/2012/08/24/sharepoint-2013-search-rest-api.aspx Get Started with the SharePoint 2013 REST Service: http://msdn.microsoft.com/en-us/library/fp142380.aspx Programming using the SharePoint 2013 REST service: http://msdn.microsoft.com/en-us/library/fp142385.aspx Understanding the SharePoint REST API: http://msdn.microsoft.com/en-us/magazine/dn198245.aspx