Building solutions with Office Graph

Waldek Mastykarz

(MVP)

Albert-Jan Schot (MVP)

Recent changes• Apps for SharePoint• Apps for Office• Azure AD apps/My apps

• SharePoint Add-ins• Office Add-ins• Web applications

It’s a preview*

Delve vs Office Graph

DelveAn application pivoting on the data in the Office GraphCurrently only web based

Office GraphBased on Search/FASTMachine Learning techniques that connects you to relevant dataAn API

Delve Web

Delve Mobile Apps

Delve, Privacy and the Office Graph• It’s Search it’s security trimmed!• Relations in the Office Graph

− Public or Private

• Trending stuff− Need at least five (5) interactions before trending

• What about a sensitive documents trending in Delve?− Prohibit Search from index the document library or site − Hide documents from delve. Managed Property called HideFromDelve.

−See: sharepointappie.nl/go/HideFromDelve

Terminology• Actor

− Source Node in the Office Graph− Represented by the DocId of the item in the search index (or ME)

• Object− Target Node in the Office Graph− Represented by the DocId of the item in the search index

• Edge− Relationship/interaction between the Actor and Object− Has a Action type, a Weight, a timestamp and a few more properties

• Action type− The type of action the Edge represents

Actor

Object

EdgeKatiej

Letter.docxviewed

Action typesTypes• Simple

−Modified, viewed

• Computed−Trending, working with

• Structural−Manager, colleagues

Privacy• Public

−Modified, colleagues

• Private−Viewed, working with

DEMO

Office Graph query options

JSOM

• AuthN not required

• KeywordQuery()

CSOM

• AuthN required

• KeywordQuery()

SDK

• AuthN required

• Office 365 API/Unified API

• .NET, Android, iOS

• Currently no support for Office Graph

REST

• AuthN: it depends

• ANY platform

• ANY kind of solution

Unified API query comparisonSharePoint Search API:GET https://contoso.sharepoint.com/_api/search/query?QueryText=’*'&Properties=‘GraphQuery:actor(me\,action\:1021)’&RankingModelId='0c77ded8-c3ef-466d-929d-905670ea1d72'&RowLimit=10&ClientType=’ContosoWebApp’

vs.

Unified API:GET https://graph.microsoft.com/beta/me/trendingAround

Office Graph and OAuth• Supported by

− SharePoint Add-ins− Office Add-ins, web applications & mobile apps

• Requires delegated permissions− SharePoint Add-ins:

Search QueryAsUserIgnoreAppPrincipal

•Missing permissions no result− Office Add-ins, web applications and mobile apps:

Office 365 SharePoint Online Run file search queries as a user

•Missing permissions 403 unauthorized error

DEMOs

Next steps

• Get familiar with developer opportunities for the Office

Graph:

dev.office.com/officegraph

• Provide feedback:

sharepointappie.nl/go/UserVoiceOfficeGraph

• More information and sample solutions:

mavention.com/office-graph

• Download Mavention Office Graph Add-ins:

sharepointappie.nl/go/OfficeGraphAddIns/

• Register for Unity Connect and see us present a custom

NextGen portal

unityconnect.com/amsterdam

Ask-me-anything

Albert-Jan Schot−SharePoint MVP−Mavention−@appieschot−sharepointappie.nl

Waldek Mastykarz

−SharePoint MVP−Mavention−@waldekm−blog.mastykarz.nl

THANK YOU