Développement d'applications basées sur la recherche (API REST)

Transcription

1 Développement d'applications basées sur la recherche (API REST) Samuel Levesque Architecte organique SharePoint 23 mai 2015

2 SÉBASTIEN SAMUEL Levesque LEVERT a Développeur.Net depuis 2006 Développeur SharePoint depuis 2010 Formateur.Net à la formation continue du Cégep de Ste-Foy Développeur SharePoint depuis 2007 Formateur SharePoint chez Technologia Conférencier SharePoint depuis 2010 Formateur SharePoint depuis 2011 Gala d excellence SharePoint - Meilleure solution Ville de Québec - Refonte de l intranet municipal Contact Contact : [email protected] : [email protected] Blog : SharePointerie.com

3

4 Agenda L interface REST de SharePoint 2013 Développement d applications basées sur la recherche JavaScript + JQuery SharePoint hosted app

5

6 Qu est-ce que c est? REST = Representational State Transfer REST protocole Style d architecture utilisé pour le développement de service web

7 REST vs SOAP

8 Slide avec photo

9 Vue de haut niveau de l architecture REST SharePoint

10 URL de point de terminaison du service REST de l API SP]/[Nom de l opération]?[paramètre] sharepoint saturday

11

12 Vue d'ensemble des sujets Processus global Prérequis Utilisation de librairies tierces Intégrer le plugin Utilisation de l API de recherche Construire une requête Exécuter la requête Afficher les résultats

13 Processus global Construire une requête REST Gérer les autorisations et l authentification Exécuter la requête Afficher les résultats

14 Prérequis Avoir SharePoint 2013 sur site (On-Premise) ou SharePoint 2013 Online (O365) Avoir configuré votre service de recherche ainsi que la recherche de personnes Avoir une référence aux librairies tierces suivantes : jquery, jquery.ui et jquery.ui.autocomplete

15 Utilisation de librairies tierces Le choix des librairies tierces a une incidence afin que la solution fonctionne dans SharePoint Online (O365) ET pour une installation sur site (On-Premise) Telerik vs Jquery AutoComplete Certaines librairies s intègrent plus facilement que d autres Telerik ne permet pas de s alimenter directement de l API REST de recherche SharePoint Jquery AutoComplete prend facilement le résultat d une requête AJAX en format JSON

16 Intégrer le plugin AutoComplete

17 Utilisation de l API de recherche REST Le service REST de recherche prend en charge à la fois les requêtes : POST /_api/search/postquery GET /_api/search/query Quand utiliser le POST? Excède la restriction de longueur du URL avec une demande GET Type complexe à spécifier dans une requête

18 Utilisation de l API de recherche REST Paramètre QueryText : Chaîne qui contient le texte de la requête de recherche. Paramètre SourceId : GUID de la source de résultat à utiliser pour l exécution de la requête de recherche. Paramètre SelectProperties : Chaîne qui contient une liste de propriétés séparées par des virgule. Paramètre SortList : La liste des propriétés pour spécifier le tri des résultats.

19 Construire la requête REST Requête : samuel &SourceId = B09A EA-4AF9-81EF-EDFAB16C4E31 Le GUID à spécifier dans le paramètre SourceId pour obtenir uniquement les résultats de personnes est le même pour toutes les installations.

20 Construire la requête REST On peut tester cette requête en l exécutant directement dans le fureteur (résultat sous une forme XML) :

21 Exécuter la requête REST

22 Afficher les résultats simplifiés appendto: $('#menu-container') }).data("uiautocomplete")._renderitem = function(ul, item) { return $("<li>").append('<a>' + item.fields.preferredname + '</a>' ).appendto(ul); }; }); Résultats simplifiés :

23 Afficher les résultats détaillés var haspicture = item.fields.pictureurl; var currentitem; if(haspicture){ currentitem = '<a><img src="' + item.fields.pictureurl + '"/>' + item.fields.preferredname + ' - ' + item.fields.jobtitle + '</a>' } else{ currentitem = '<a><img src="/_layouts/images/o14_person_placeholder_96.png"/>' + item.fields.preferredname + ' - ' + item.fields.jobtitle + '</a>' } return $("<li>").append(currentitem).appendto(ul); Résultats détaillés :

24

25 Que faire si la propriété que je veux utiliser n est pas retourné?

26 Outil de débogage (Gratuit)

27 Conclusion Réalisation très rapide JQueryUI est gratuit Supporté On-Premise et dans SharePoint Online (O365) Pas de déploiement de solutions de ferme Facilement modifiable et pourrait être amélioré pour ajouter toute autres propriétés que vous jugeriez pertinente (Ex : Département, intérêts, etc ).

28

29

30 Bronze Web Or Argent Merci à nos commanditaires!

31 SharePint! Ce soir à 18h Le Trèfle, 3971 Rue Ontario E

32 Références Search REST API Vue d'ensemble de l'api REST SharePoint Search (MSDN) Calling SharePoint search using REST (e.g. from JavaScript or an app) Retrieving values of Managed Properties in SharePoint 2013 Search REST API