Placer son argent ou développer son activité

S’initier à SPservices (jQuery / JavaScript) dans SharePoint

Ce tutoriel se limite à une initiation à SPservices dans SharePoint. SPServices est une bibliothèque qui s’appuie sur JQuery et simplifie l’appel aux services Web de SharePoint.

Pour exécuter avec succès cette initiation à SPservices, vous devez suivre au préalable le tutoriel dédié à JQuery, et qui est expliqué dans l’article S’initier à JQuery (JavaScript) dans SharePoint.

Télécharger la bibliothèque SPservices

Avant de débuter cette initiation à SPservices, téléchargez la dernière version de SPServices.

Stockez le fichier zip sur votre ordinateur, décompressez-le et renommez le fichier jQuery.SPServices-2013.01.js en jQuery.SPServices.js. Dans les environnements complexes, il peut être intéressant d’identifier chaque version de SPservices. Dans notre cas, il est plus simple d’avoir une seule référence dans votre collection de sites SharePoint.

Pour pouvoir utiliser le fichier jQuery.js, il est nécessaire de le téléverser (« uploader ») dans la bibliothèque Scripts, créée dans le tutoriel dédié à JQuery.

Allez dans la bibliothèque Scripts puis cliquez sur le bouton Ajouter un document.

Cliquez ensuite sur Parcourir et « uploader » jQuery.SPServices.js dans la bibliothèque.

Initiation à SPservices
Bibliotheque jQuery et SPServices

Vérifier le bon fonctionnement de SPservices

Avant toute chose, il est important de vérifier que SPservices est valide et fonctionne bien dans votre environnement. Il est supposé que vous avez déjà vérifié que JQuery fonctionne parfaitement bien.

Avec le Bloc-notes (notepad.exe), créez un petit fichier VerifierSPservices.js avec le texte suivant:

<script type="text/javascript" src="/Scripts/jquery.js"></script>
 <script type="text/javascript" src="/Scripts/jquery.SPServices.js"></script>
 <script type="text/javascript">
 $(document).ready(function() {
 alert($().SPServices.SPGetCurrentSite());
 });
 </script>

Seules les lignes nouvelles par rapport à VerifierJQuery.js seront présentées.

La seconde ligne sert à référencer l’appel à SPServices. Vous devez donc modifier votre fichier pour que la première instruction src pointe bien vers l’emplacement du fichier jQuery.js hébergé dans la bibliothèque Scripts.

Le code exécuté est:

alert($().SPServices.SPGetCurrentSite());

Si tout va bien, ce code affiche un message avec l’URL complète de votre site.

Enregistrez vos modifications faites dans le fichier VerifierSPservices.js.

Uploadez aussi votre fichier VerifierSPservices.js dans la bibliothèque Scripts.

Initiation à SPservices

Une fois le fichier VerifierSPservices.js uploadé, faites un clic-droit dessus puis Copier le raccourci. Dans un instant, vous aurez besoin de coller le chemin.

Par ailleurs, pour tester le bon fonctionnement du script, vous allez utiliser la page Test, créée dans le tutoriel jQuery. Si vous n’avez plus de page Test, consultez le tutoriel pour en créer une.

Notamment, ouvrez un nouvel onglet dans votre navigateur puis allez sur la page d’accueil de votre site puis cliquez sur Actions du site puis Afficher tout le contenu du site.

Ensuite, cliquez sur la bibliothèque Pages du site.

Puis, dans le volet de gauche, cliquez sur le lien Test. Si un message jQuery s’affiche, fermez-le.

Et cliquez sur Actions du site puis Modifier la page.

Composant webpart editeur de contenu
Composant webpart editeur de contenu

Avec la souris, survolez le composant Editeur de contenu pour faire apparaître son menu d’édition:

Ensuite, cliquez sur Modifier le composant Webpart: sur la droite de l’écran, les paramètres de l’Editeur de contenu s’affiche. Si un message jQuery s’affiche, fermez-le.

Ensuite, sous Lien du contenu, coller le contenu du presse-papier. Normalement, il contient l’emplacement du fichier VerifierSPservices.js.

Ensuite, cliquez sur le bouton OK.

Puis, vous devez voir une fenêtre qui s’affiche en indiquant l’URL du site.

Enregistrez votre page: le message s’affiche à nouveau.

Commentaires

Laisser un commentaire

Votre adresse e-mail ne sera pas publiée. Les champs obligatoires sont indiqués avec *