Archive

Archive for the ‘Visual Studio’ Category

SharePoint 2013 : Présentation et développement d’une « App Part »

janvier 9, 2013 1 commentaire

Nous allons voir dans cet article ce qu’est une « App Part », et comment les développer avec Visual Studio 2012.

Présentation

Une App Part permet d’afficher la UX de votre App directement dans le site courant (dit « host web »).

A noter que l’App Part utilise une IFrame pour afficher le contenu de votre App directement dans le site.

De la même manière qu’une webpart, une App part contient une ToolPart qui vous permet de définir des propriétés personnalisées.

Vous pouvez consulter  :

Prérequis

1. Avoir créé un site permettant le debug de votre App; référez-vous à cet article en cas de problèmes.

Pour faire simple, créez une collection de sites basée sur le template « Developer Site », site dont vous utiliserez l’URL à l’étape 2 de la procédure ci-dessous.

2. Avoir configuré votre environnement pour les Apps (voir cet article).

Exemple

L’exemple ci-dessous présente le développement d’une App Part affichant sur sa page d’accueil la valeur de sa propriété custom (nommée « TexteAAfficher »).

Développement

Sans surprise, c’est votre outil préféré que vous allez utiliser pour développer votre App Part : Visual Studio 2012 .

Vous pouvez consulter les articles suivants le concernant :

1. Créez un nouveau projet avec comme template « App for SharePoint 2013 ».

0

2. Saisissez le nom de votre projet, le site utilisé pour debugger et le mode d’hébergement de votre App (ici « SharePoint-hosted »).

1

3. Le projet est créé.

2

4. Ajoutez au projet un nouvel élément, de type « Client Web Part (Host Web) ».

3

5. Définissez la page utilisée par votre « Client Web Part » : soit celle créée par défaut dans le projet (Default.aspx), soit une nouvelle – C’est cette seconde option que je choisis ici.

3

6. La page est bien créée dans le module « Pages »

4

7. Et la page est bien référencée dans le fichier « Elements.xml ». Jusque là tout va bien.

5

8. Ouvrez ensuite le fichier « Elements.xml » de la Client Web part.

Voici le fichier après modification, que j’ai découpé en 3 parties :

  • Partie 1 : Nom, titre, description et dimensions (qui ne peuvent être modifiées via l’interface),
  • Partie 2 : Ajout dans la partie « src » du paramètre « TexteAAfficher »,
  • Partie 3 : Ajout de la ligne définissant une propriété custom, nommée « texteAAfficher ».

9

Notez que la propriété de l’App Part est passée en QueryString à sa page d’accueil.

9. Modifiez la page d’accueil « MaPageCustom.aspx » pour lui faire afficher la valeur du paramètre : vous pouvez utiliser le code javascript décrit dans cet article Technet  et l’adapter à votre besoin.

10. Y’a plus qu’à : F5 pour lancer le déploiement de l’App, et vous vous retrouvez sur la page d’accueil de l’App (default.aspx).

15

Ne confondez pas la page de l’App (Default.aspx) avec la page d’accueil de votre App Part (MaPageCustom.aspx).

11. Cliquez sur le lien en haut à gauche pour revenir à la page d’accueil.

On aperçoit notre App listée en bas de page, dans la partie « Apps in Testing ».

10

12. Sur une page (ici la page d’accueil), cliquez sur « Page/Edit/Insert/App Part », sélectionnez votre App Part (ici « Mon App Part de Demo »), et cliquez sur « Add ».

11

13. L’App Part affiche bien ce qu’on lui demande : son paramètre « TexteAAfficher », dont la valeur par défaut (définie à l’étape 8 – partie 3) est bien affichée.

12

14. Cliquez sur « Edit Web part ».

1315. On retrouve bien notre bloc « Propriétés persos » définie à l’étape 8 – partie 3, et la propriété custom.

Modifiez la valeur de la propriété, validez le toolpart.

14

16. Et au final :

8

Conclusion

Au delà de cet exemple trivial, cet article vous permet (je l’espère !) d’envisager les formisables choses que vous allez pouvoir faire avec les App Parts 🙂

Publicités

Visual Studio 2012 : Sideloading of apps is not enabled on this site

Symptômes

Sous Visual Studio 2012, au lancement du debug (et donc du déploiement d’une App), le message suivant apparaît :

18

Résolution

Cette fonctionnalité de « Sideloading » est liée à la feature « Developer » :

16

2 possibilités s’offrent à vous :

  • Utiliser un template de site « Developer Site », sur lequel la feature est activée de base

18

  • Utiliser un autre template de site, et dans ce cas il vous faudra activer la feature via PowerShell (elle est hidden)

19

Et au besoin ensuite, sélectionnez votre projet dans Visual Studio, F4, et modifiez l’URL du site utilisé pour le debug.

17

SharePoint 2013 : Problème d’accès à une App déployée via Visual Studio 2012

Symptôme

Au lancement d’une App déployée via Visual Studio, lors du clic sur celle-ci :

Vous vous voyez demander 3 fois vos credentials, pour finalement aboutir sur une ereur 401.

Résolution

Suivre la procédure de cette KB pour modifier le paramètre « DisableLoopBackCheck » du serveur – Vous l’avez peut-être déjà rencontré pour des problématiques de crawling.

Sur une environnement de développement, on peut se permettre de désactiver globalement : vous pouvez faire cette modification via PowerShell, lancez la commande :

New-ItemProperty HKLM:\System\CurrentControlSet\Control\Lsa -Name « DisableLoopbackCheck » -value « 1 » -PropertyType dword

Attention : Cette modification impacte la sécurité de votre serveur et ne doit donc pas être effectuée sur un environnement de production; lisez ce très bon article sur le sujet pour plus d’informations.

 

Installer Visual Studio 2012 (Windows 8)

Ce post va décrire la procédure d’installation de Visual Studio 2012 RC (téléchargement) dans un environnement Windows 8 Release Preview (téléchargement).

Si vous savez cliquer 5 fois d’affilée çà devrait être suffisant pour cette installation 🙂

Vous pouvez par ailleurs consulter ce post qui décrit un problème pouvant être rencontré à l’installation et cet autre post qui explique comment installer les templates de projet pour SharePoint 2013.

1. Lancez l’installeur; cliquez sur « Next »

2. Choisissez les éléments à installer et cliquez sur « Install ».

3. L’installation débute.

4. L’installation s’achève, cliquez sur « LAUNCH ».

5. Sélectionnez vos settings pour l’environnement, le type d’aide à installer (minimal ou ici Advanced), et cliquez sur « Start Visual Studio » pour … démarrer VS, et oui.

6. Une fois vos settings chargés, vous accédez à votre environnement de dév. préféré.

7. Je reviens sur l’option « Advanced… » précédemment sélectionnée; elle vous permet de choisir quelle documentation installer.

Par défaut 3 catégories de doc° sont sélectionnées.

8. Une fois cliqué sur « Update », les packages se téléchargent et s’installent.

Catégories :Visual Studio Étiquettes : ,

Visual Studio 2012 : Installer les templates de projet pour SharePoint 2013

août 23, 2012 2 commentaires

Lorsque Visual Studio 2012 est installé, vous trouvez de base uniquement des templates pour SharePoint 2010.

Afin de pouvoir utiliser les templates de projet pour SharePoint 2013 il a vous falloir installer les « Microsoft Office Developer Tools for Visual Studio 2012″, disponible directement à cette adresse ou en vous rendant sur la page de téléchargement suivante et en allant dans la section « Tools ».

1. Lancez l’installeur

2. Cliquez sur « Install »

3. Vous acceptez les termes de licence, après avoir tout téléchargé et lu, bien sûr […] .

4. Un charmant message s’affiche (alors que j’ai installé VS2012 Ultimate), on en prend bonne note et « OK ».

5. Les téléchargements et l’installation débutent.

6. L’installation s’achève, cliquez sur « Finish ».

7. Vous pouvez installer d’autre packages si vous le souhaitez, sinon cliquez sur « exit ».

8. Lancez VS : les templates de projet pour SharePoint 2013 sont désormais utilisables.

Visual Studio 2012 : Setup blocked – .net framework 4.5

 Symptômes
Au lancement de l’installation de Visual Studio, le message suivant apparaît : « The .net framework installed on this machine does not meet the minimum required version ».

Si vous tentez d’installer le framework, un message vous avertit qu’il est déjà installé.

Résolution

Changer de version de Visual Studio !

J’ai finalement pu installer Visual Studio 2012 RC (téléchargement) sur Windows 8 Release Preview (téléchargement).

Pour information, la version de Visual Studio m’ayant posé problème est celle-ci.