Présentation de l environnement de développement SharePoint Atelier pratique Manuel de l atelier SPCHOL200 Création de composants Visual Web Part VB.NET
Ce document est fourni en l état. Les informations et les vues contenues dans ce document, y compris les URL et autres références de site Web Internet, sont susceptibles d être modifiées sans préavis. Vous les utilisez à vos risques. Ce document ne vous confère aucun droit sur la propriété intellectuelle contenue dans quelque produit Microsoft que ce soit. Vous pouvez copier ou utiliser ce document pour vos propres besoins de référence internes. 2010 Microsoft. Tous droits réservés.
Sommaire SPCHOL200 : CREATION DE COMPOSANTS VISUAL WEB PART... 2 Objectif de l atelier... 2 Ressources supplémentaires... 2 Mise en route... 3 Connexion à l ordinateur virtuel... 3 Emplacements... 3 Préparation de l atelier... 3 Copie des exemples de code à partir du document Word... 4 Extraits de code... 4 Tâche 1 - Créer un projet SharePoint... 5 Tâche 2 - Générer une classe de proxy LINQ-to-SharePoint pour accéder aux données de la liste... 8 Tâche 3 - Accéder aux données de liste SharePoint dans le composant Visual Web Part... 11 Tâche 4 Construire et déployer le composant Visual Web Part... 13 Exercice 2 Connexion de composants WebPart... 18 Tâche 1 - Créer un projet SharePoint vide... 19 Tâche 2 Créer l interface de connexion WebPart... 21 Tâche 3 Créer le composant WebPart fournisseur... 24 Tâche 4 Créer le composant WebPart consommateur... 27 Tâche 5 Construire et déployer les composants WebPart... 30 Tâche 6 Connecter les composants WebPart... 36 Tâche 7 Vérifier la connexion WebPart... 37 Résumé de l atelier... 39 Page 1
SPCHOL200 : Création de composants Visual Web Part Durée estimée de cet atelier : 30 minutes Visual Studio 2010 et SharePoint Foundation 2010 sont requis pour ces exercices. Ils sont installés sur l ordinateur virtuel utilisé dans cet atelier. Objectif de l atelier Les composants WebPart constituent une partie essentielle des technologies ASP.NET utilisées par SharePoint pour présenter des informations dynamiques aux utilisateurs. Les composants WebPart représentent la personnalisation la plus courante créée pour SharePoint. Un composant WebPart est un composant réutilisable qui se trouve sur une page de composants WebPart et qui peut présenter n importe quel type d informations basées sur le Web. L objectif de cet atelier est d apprendre à utiliser les améliorations disponibles dans SharePoint 2010 pour créer des composants Visual Web Part et connecter des composants WebPart en vue de leur utilisation dans le système SharePoint. Utiliser des composants WebPart existants et Linq. Connecter deux composants WebPart. Ressources supplémentaires Cet atelier comprend les ressources supplémentaires suivantes : Ce manuel de l atelier SPCHOL200_Manual_VB.docx Ce document. Code source Completed\VB\Ex1 Completed\VB\Ex2 Code source de l atelier complet en VB.NET. Ressources Resources\VB Différentes autres ressources utilisées tout au long de cet atelier. Page 2
Mise en route Connexion à l ordinateur virtuel Connectez-vous à l ordinateur virtuel à l aide des informations d utilisateur suivantes : Nom d utilisateur : Administrator Mot de passe : pass@word1 Emplacements Cet atelier pratique contient une série de ressources supplémentaires à des emplacements précis. Par défaut, il est supposé que le répertoire de base de l atelier pratique est C:\Content Packs\Packs \SharePoint 2010 Developer Labs 1.0\SUPPORTING FILES\SPCHOL200\Resources. Le dossier de travail par défaut de cet atelier est C:\SPHOLS\SPCHOL200. Préparation de l atelier Accédez au répertoire de base de l atelier pratique Supporting Files\SPCHOL200\Resources et exécutez le script PowerShell optimize.ps1 : 1. Cliquez avec le bouton droit sur optimize.ps1 et sélectionnez Exécuter avec PowerShell : Figure 1 - Exécuter le script PowerShell 2. Cette opération ouvre une fenêtre PowerShell pour exécuter le script. Cliquez sur Ouvrir si une fenêtre de sécurité s affiche. Veuillez attendre la fin de l exécution du script PowerShell et la fermeture de la fenêtre PowerShell (cela peut prendre une minute) : Page 3
Figure 2 - Fenêtre PowerShell exécutant le script Copie des exemples de code à partir du document Word La copie et le collage de code à partir de ce document Word vers Visual Studio ne sont fiables que pour les parties de code mis en forme, par exemple : Console.WriteLine("Ce code est fiable!"); Le code qui ne se trouve pas dans ces parties peut contenir des caractères Unicode ou d autres caractères invisibles qui ne sont pas du code C#/VB ou XML valide, par exemple : Console.WriteLine «Ce code n est pas fiable!!» Extraits de code Vous pouvez également utiliser des extraits de code pour insérer le code approprié dans l atelier. Pour utiliser l extrait de code requis pour cet atelier : Cliquez avec le bouton droit sur le fichier de code où vous souhaitez insérer l extrait de code. Sélectionnez Insérer un extrait : Figure 3 - Insérer un extrait de code Dans la galerie Mes extraits de code, sélectionnez les extraits de code requis. Page 4
Exercice 1 Procédure pas à pas pour composant WebPart et Linq Durée estimée de cet exercice : 10 minutes Dans cet exercice, vous développerez et déploierez un composant Visual Web Part lisant les données dans une liste et les affichant dans un contrôle DataGrid. Dans cet exercice, vous apprendrez à : 1. Créer un composant Visual Web Part. 2. Générer un code de proxy Linq. 3. Utiliser un fournisseur Linq pour lire les données dans une liste SharePoint. 4. Rendre les données à l aide du contrôle Web SPDataGrid. Tâche 1 - Créer un projet SharePoint Dans cette tâche, une solution et un projet seront créés. Le reste du travail de développement sera contenu dans l exercice 1 de cet atelier. 1. Ouvrez Visual Studio 2010 en sélectionnant successivement Menu Démarrer Tous les programmes Microsoft Visual Studio 2010 Microsoft Visual Studio 2010. 2. Dans le menu, sélectionnez Fichier Nouveau Projet. 3. Dans la boîte de dialogue Nouveau projet, choisissez Visual Basic SharePoint 2010 parmi les Modèles installés. 4. Sélectionnez Composant Visual Web Part dans les Éléments de projet. Figure 4 - Projet de composant Visual Web Part SharePoint 2010 5. Tapez SPCHOL200-Ex1 dans la zone de texte Nom 6. Entrez C:\SPHOLS\SPCHOL200\VB\Ex1 dans la zone de texte Emplacement. Page 5
7. Désactivez Créer le répertoire pour la solution. 8. Cliquez sur OK. 9. Dans l Assistant Personnalisation de SharePoint : Indiquez http://intranet.contoso.com/ comme site local. Définissez le niveau de confiance sur Déployer en tant que solution de batterie. Cliquez sur le bouton Terminer. Figure 5 - Assistant Personnalisation de SharePoint Page 6
10. Visual Studio crée le nouveau projet SPCHOL200-Ex1 et ajoute les fichiers nécessaires. Figure 6 - Projet SPCHOL200-Ex1 11. Notez que Visual Studio crée également un composant Visual Web Part nommé VisualWebPart1. Dans l Explorateur de solutions, développez VisualWebPart1 et ouvrez VisualWebPart1.webpart. Figure 7 - Composant Visual Web Part 12. Remplacez la valeur de l élément de propriété avec la valeur d attribut de nom Title par SPLinqDemoTitle et la valeur de l élément de propriété avec la valeur d attribut de nom Description par SPLinqDemoPart Description. (Voir l exemple de code ci-après.) Cela changera la propriété Title et Description du composant Visual Web Part lorsqu il sera déployé. Enregistrez le fichier. <properties> <property name="title" type="string">splinqdemotitle</property> <property name="description" type="string">splinqdemopart Description</property> </properties> Page 7
Tâche 2 - Générer une classe de proxy LINQ-to-SharePoint pour accéder aux données de la liste Dans cette tâche, vous allez utiliser le nouvel utilitaire de génération de code spmetal.exe et générer le code de proxy Linq-to-SharePoint. 1. Dans l Explorateur de solutions, cliquez avec le bouton droit sur SPCHOL200-Ex1 et sélectionnez Ouvrir le dossier dans l Explorateur Windows. 2. Maintenez enfoncée la touche MAJ et cliquez avec le bouton droit n importe où dans la fenêtre de l Explorateur et sélectionnez Ouvrir une fenêtre de commandes ici pour ouvrir la fenêtre d invite de commandes dans le répertoire du projet actuel : Figure 8 - Ouvrir une fenêtre de commandes ici 3. Tapez la commande suivante dans l invite de commandes et appuyez sur Entrée pour définir le chemin sur celui du dossier SharePoint 2010 : set path=%path%;c:\program files\common files\microsoft shared\web server extensions\14\bin 4. Tapez la commande suivante dans l invite de commandes et appuyez sur Entrée pour générer le code du proxy Linq-to-SharePoint. spmetal.exe /web:http://intranet.contoso.com /namespace:spchol200_ex1.visualwebpart1 /code:splinq.vb Remarque : vous pouvez recevoir des avertissements à propos des types de contenus de la liste Modèles de formulaires. Vous pouvez ignorer cet avertissement et continuer. 5. Fermez la fenêtre de commande et revenez à Visual Studio. Page 8
6. Dans Visual Studio, cliquez avec le bouton droit sur le projet SPCHOL200-Ex1 et sélectionnez Ajouter Élément existant. Figure 9 - Ajouter un élément existant Page 9
7. Sélectionnez SPLinq.vb dans la boîte de dialogue Ajouter un élément existant et cliquez sur Ajouter : Figure 10 - Ajouter le fichier SPLinq.vb 8. Dans l Explorateur de solutions, cliquez avec le bouton droit sur SPCHOL200-Ex1, puis sélectionnez Ajouter une référence. 9. Revenez à l onglet Parcourir et entrez C:\Program Files\Common Files\Microsoft Shared\ Web Server Extensions\14\ISAPI dans la zone de texte Nom de fichier. Appuyez sur Entrée pour changer les répertoires. Votre fenêtre Ajouter une référence doit maintenant ressembler à la figure 11. Page 10
10. Sélectionnez Microsoft.SharePoint.Linq.dll. Figure 11 - Ajouter une référence 11. Cliquez sur OK pour ajouter la référence à votre projet. Tâche 3 - Accéder aux données de liste SharePoint dans le composant Visual Web Part Dans cette tâche, vous ajoutez à votre solution du code qui permettra au composant Visual Web Part de récupérer des données de liste SharePoint. 1. Dans l Explorateur de solutions, développez VisualWebPart1 et double-cliquez sur VisualWebPart1UserControl.ascx. 2. Visual Studio ouvre le contrôle utilisateur du composant Visual Web Part. 3. Ajoutez le code suivant au contrôle utilisateur pour construire votre vue de grille. Page 11
<%@ Import Namespace="Microsoft.SharePoint.WebControls" %> <SharePoint:SPGridView id="spgridview" runat="server" AutoGenerateColumns="false"> <HeaderStyle HorizontalAlign="Left" ForeColor="Navy" Font-Bold="true" /> <Columns> <SharePoint:SPBoundField DataField="Title" HeaderText="Title"></SharePoint:SPBoundField> <SharePoint:SPBoundField DataField="JobTitle" HeaderText="JobTitle"></SharePoint:SPBoundField> <SharePoint:SPBoundField DataField="ProjectTitle" HeaderText="ProjectTitle"></SharePoint:SPBoundField> <SharePoint:SPBoundField DataField="DueDate" HeaderText="DueDate"></SharePoint:SPBoundField> </Columns> </SharePoint:SPGridView> Extraits de code : ASP.NET spchol200_ex1_spgridview 4. Le contrôle utilisateur du composant Visual Web Part doit ressembler à ceci après l ajout du code ci-dessus : Figure 12 - Contrôle utilisateur du composant Visual Web Part 5. Dans l Explorateur de solutions, cliquez avec le bouton droit sur VisualWebPart1UserControl.ascx et sélectionnez Afficher le code. 6. Ajoutez les instructions d importation suivantes au code sous-jacent : Imports Microsoft.SharePoint.Linq Imports Microsoft.SharePoint Imports System.Linq Imports SPCHOL200_Ex1.SPCHOL200_Ex1.VisualWebPart1 Extrait de code : Mes extraits de code spchol200_ex1_namespaces Page 12
7. Insérez le code suivant à l intérieur de la méthode Page_Load : Dim dc As New SPLinqDataContext(SPContext.Current.Web.Url) Dim Employees As EntityList(Of EmployeesItem) = _ dc.getlist(of EmployeesItem)("Employees") Dim empquery = From emp In Employees _ Where emp.project.duedate < DateTime.Now.AddMonths(6) _ Select emp.title, emp.jobtitle, ProjectTitle = emp.project.title, _ DueDate = emp.project.duedate.tostring() spgridview.datasource = empquery spgridview.databind() Extrait de code : Mes extraits de code spchol200_ex1_pageload Tâche 4 Construire et déployer le composant Visual Web Part 1. Dans l Explorateur de solutions, cliquez avec le bouton droit sur SPCHOL200-Ex1 et sélectionnez Déployer. Cela permet de construire le composant Visual Web Part et de le déployer sur le site SharePoint local : http://intranet.contoso.com Figure 13 - Déployer le composant Visual Web Part 2. Ouvrez Internet Explorer et naviguez jusqu au site suivant : http://intranet.contoso.com 3. Si un message sollicite votre authentification, entrez les informations suivantes. Nom d utilisateur : Administrator Mot de passe : pass@word1 Page 13
4. Cliquez sur l icône Modifier dans le menu supérieur pour ouvrir le Ruban SharePoint aux Outils d édition. Figure 14 - Icône Modifier de SharePoint Figure 15 - Ruban SharePoint - Page Édition Page 14
5. Sous l onglet Insérer du Ruban, cliquez sur Composant WebPart pour insérer un composant WebPart dans la page. Figure 16 - Ruban SharePoint - Insérer un composant WebPart 6. Sous Catégories, sélectionnez Custom. 7. Sous Composants WebPart, sélectionnez le composant SPLinqDemoTitle. Figure 17 - Sélection du composant WebPart SPlinqDemoTitle Page 15
Placez votre curseur dans la zone de la page où vous voulez faire apparaître le composant WebPart. Il doit s agir d une zone qui accepte les composants WebPart. Dans ce cas, placez votre curseur dans la zone sous le contrôle Documents partagés. Figure 18 - Zones de disposition Page 16
8. Cliquez sur Ajouter pour ajouter le composant WebPart à la page. Le composant WebPart SPLinqDemoTitle est ajouté à la zone de disposition sélectionnée, comme l illustre la figure ci-après. Figure 19 - Composant WebPart SPLinqDemoTitle ajouté à la zone de disposition Page 17
9. Cliquez sur Page, sur la flèche vers le bas du bouton Enregistrer et fermer puis sélectionnez Arrêter la modification pour enregistrer la page et cesser la modification. Cliquez sur Oui à l invite proposant d enregistrer les modifications effectuées. Figure 20 - Ruban SharePoint - Arrêter la modification 10. Fermez Internet Explorer. 11. Fermez Visual Studio 2010. Dans l exercice précédent, vous avez créé et déployé un composant Visual Web Part qui utilise LINQ to SharePoint pour collecter des données d une liste SharePoint. Exercice 2 Connexion de composants WebPart Durée estimée de cet exercice : 20 minutes Dans cet exercice, vous apprendrez à : 1. Créer deux composants WebPart SharePoint de base. 2. Configurer un composant WebPart afin qu il participe à une connexion WebPart en tant que fournisseur. 3. Configurer un composant WebPart afin qu il participe à une connexion WebPart en tant que consommateur. Page 18
Tâche 1 - Créer un projet SharePoint vide Dans cette tâche, vous allez créer un projet SharePoint vide. 1. Ouvrez Visual Studio 2010 en sélectionnant successivement le Menu Démarrer Tous les programmes Microsoft Visual Studio 2010 Microsoft Visual Studio 2010. 2. Dans le menu, sélectionnez Fichier Nouveau Projet. 3. Dans la boîte de dialogue Nouveau projet, choisissez Visual Basic SharePoint 2010 parmi les Modèles installés. 4. Sélectionnez Projet SharePoint vide dans les Éléments de projet. 5. Entrez SPCHOL200-Ex2 dans la zone de texte Nom. 6. Entrez C:\SPHOLS\SPCHOL200\VB\Ex2 dans la zone de texte Emplacement. Figure 21 - Boîte de dialogue Nouveau projet Visual Studio 7. Assurez-vous que les options Créer un répertoire pour la solution et Ajouter au contrôle de code source sont désélectionnées toutes les deux. 8. Cliquez sur OK. Page 19
9. Dans l Assistant Personnalisation de SharePoint : Indiquez http://intranet.contoso.com comme site local. Définissez le niveau de confiance sur Déployer en tant que solution de batterie. Figure 22 - Assistant Personnalisation de SharePoint 10. Cliquez sur Terminer pour terminer l Assistant. Page 20
11. Visual Studio crée le nouveau projet SPCHOL200-Ex2 et ajoute les fichiers nécessaires. Figure 23 - Projet SPCHOL200-Ex2 Tâche 2 Créer l interface de connexion WebPart Dans cette tâche, vous allez créer l interface de connexion WebPart IProject permettant l échange des informations de connexion entre un composant WebPart fournisseur et un composant WebPart consommateur. 1. Dans l Explorateur de solutions, cliquez avec le bouton droit sur SPCHOL200-Ex2, puis sélectionnez Ajouter Nouvel élément. Figure 24 - Ajouter un nouvel élément Page 21
2. Dans la boîte de dialogue Ajouter un nouvel élément, sélectionnez Éléments communs Code parmi les Modèles installés. 3. Sélectionnez Interface parmi les modèles disponibles. 4. Entrez IProject dans la zone de texte Nom et cliquez sur le bouton Ajouter. Figure 25 - Création de l interface IProject 5. Visual Studio ajoute le nouveau fichier IProject.vb au projet. 6. Dans l Explorateur de solutions, double-cliquez sur le fichier IProject.vb pour l ouvrir. Page 22
Figure 26 Interface ajoutée 7. Insérez le code suivant à l intérieur de l interface IProject : ReadOnly Property Id() As Integer ReadOnly Property Name() As String Extrait de code : Mes extraits de code spchol200_ex2_iproject 8. Le fichier IProject.vb doit ressembler à ceci une fois le bloc de code ci-dessus ajouté : Figure 27 - Iterface IProject Page 23
Tâche 3 Créer le composant WebPart fournisseur Dans cette tâche, vous allez créer un composant WebPart qui participera à une connexion WebPart en tant que fournisseur. 1. Dans l Explorateur de solutions, cliquez avec le bouton droit sur SPCHOL200-Ex2, puis sélectionnez Ajouter Nouvel élément. 2. Sélectionnez Éléments communs SharePoint 2010 parmi les Modèles installés. 3. Sélectionnez Composant WebPart parmi les modèles d élément disponibles. 4. Entrez ProviderWebPart dans la zone de texte Nom et cliquez sur Ajouter. Figure 28 - Ajout du composant WebPart fournisseur Page 24
5. Visual Studio ajoute le nouveau composant WebPart fournisseur à la solution. Figure 29 - Composant WebPart fournisseur 6. Dans l Explorateur de solutions, double-cliquez sur ProviderWebPart.vb pour ouvrir le fichier de code en arrière-plan. 7. Dans la déclaration de classe ProviderWebPart, utilisez le mot clé Implements de manière à ce que le composant WebPart fournisseur implémente IProject. Implements IProject Extrait de code : Mes extraits de code spchol200_ex2_provider_class 8. La déclaration de classe ProviderWebPart doit ressembler à ceci une fois la modification de code ci-dessus effectuée : Figure 30 Implémenter l interface IProject 9. Remplacez l implémentation des propriétés ID et Name dans la déclaration de classe ProviderWebPart. Ce bloc de code implémente l interface de connexion WebPart IProject et ajoute une variable locale au composant WebPart : Private _projectpicker As DropDownList = Nothing Page 25 ReadOnly Property IdProp() As Integer Implements IProject.Id Get Return Integer.Parse(_projectPicker.SelectedValue)
End Get End Property ReadOnly Property Name() As String Implements IProject.Name Get Return _projectpicker.selecteditem.tostring() End Get End Property Extrait de code : Mes extraits de code spchol200_ex2_provider_properties 10. La classe ProviderWebPart doit ressembler à ceci une fois la modification de code ci-dessus effectuée : Figure 31 - Interface IProject implémentée et variable DropDownList 11. Insérez le code suivant dans la méthode CreateChildControls, juste après l appel de la méthode MyBase.CreateChildControls : Try _projectpicker = New DropDownList() Using spsite As New SPSite(SPContext.Current.Web.Url) Using spweb As SPWeb = spsite.openweb() Dim projectslist As SPList = spweb.lists("projects") For Each project As SPListItem In projectslist.items Page 26
_projectpicker.items.add(new ListItem(project.Title, project.id.tostring())) Next End Using End Using _projectpicker.autopostback = True Me.Controls.Add(_projectPicker) Catch ex As Exception Me.Controls.Clear() Me.Controls.Add(New LiteralControl(ex.Message)) End Try Extrait de code : Mes extraits de code spchol200_ex2_provider_createchildcontrol 12. Insérez la propriété suivante ConnectionProvider sous la méthode CreateChildControls. Cette propriété fournit le point d interface du fournisseur de connexion pour le composant WebPart fournisseur : <ConnectionProvider("Project Name and ID")> _ Public Function NameDoesNotMatter() As IProject Return Me End Function Extrait de code : Mes extraits de code spchol200_ex2_provider_connection 13. Exécutez une génération dans Visual Studio 2010 ; pour ce faire, dans le menu Générer, sélectionnez Générer la solution. Si vous avez effectué toutes les opérations correctement, vous obtenez un message indiquant que la génération a réussi. Au cours des minutes précédentes, vous avez vu comment créer un composant WebPart fournisseur et ajouter un point d interface du fournisseur de connexion afin que le composant WebPart consommateur puisse recevoir des messages d un composant WebPart fournisseur. Tâche 4 Créer le composant WebPart consommateur Dans cette tâche, vous allez créer un composant WebPart qui participera à une connexion WebPart en tant que consommateur. 1. Dans l Explorateur de solutions, cliquez avec le bouton droit sur SPCHOL200-Ex2, puis sélectionnez Ajouter Nouvel élément. 2. Sélectionnez Éléments communs SharePoint 2010 parmi les Modèles installés. Page 27
3. Sélectionnez Composant WebPart parmi les modèles d élément disponibles. 4. Entrez ConsumerWebPart dans la zone de texte Nom et cliquez sur Ajouter. Figure 32 - Ajout du composant WebPart consommateur 5. Visual Studio ajoute le nouveau composant WebPart consommateur à la solution. Page 28
Figure 33 - composant WebPart consommateur 6. Insérez le code suivant sous la déclaration de classe ConsumerWebPart : Dim _provider As IProject = Nothing Dim _lbl As Label = Nothing Extrait de code : Mes extraits de code spchol200_ex2_consumer_variables 7. Insérez le code suivant dans la méthode CreateChildControls, juste après l appel de la méthode MyBase.CreateChildControls : Try _lbl = New Label() If _provider IsNot Nothing Then If _provider.id > 0 Then _lbl.text = _provider.name & " was selected." Else _lbl.text = "Nothing was selected." End If Else _lbl.text = "No Provider Web Part Connected." End If Me.Controls.Add(_lbl) Catch ex As Exception Me.Controls.Clear() Me.Controls.Add(New LiteralControl(ex.Message)) End Try Extrait de code : Mes extraits de code spchol200_ex2_consumer_createchildcontrol Page 29
8. Insérez la propriété suivante ConnectionConsumer sous la méthode CreateChildControls. Cette propriété fournit le point d interface du consommateur de connexion pour le composant WebPart consommateur : <ConnectionConsumer("Project Name and ID")> _ Public Sub ThisNameDoesNotMatter(ByVal providerinterface As IProject) _provider = providerinterface End Sub Extrait de code : Mes extraits de code spchol200_ex2_consumer_connection Au cours des minutes précédentes, vous avez vu comment créer un composant WebPart consommateur et créer un point d interface du consommateur de connexion afin que le composant WebPart consommateur puisse recevoir des messages d un composant WebPart fournisseur. Tâche 5 Construire et déployer les composants WebPart Dans cette tâche, vous allez construire et déployer les composants WebPart fournisseur et consommateur, ainsi que créer une page de composants WebPart pour ajouter les composants WebPart. 1. Dans l Explorateur de solutions, cliquez avec le bouton droit sur SPCHOL2-Ex2 et sélectionnez Déployer. Figure 34 - Déployer SPCHOL200-Ex2 Page 30
2. Ouvrez Internet Explorer et naviguez jusqu au site suivant : http://intranet.contoso.com 3. Si un message sollicite votre authentification, entrez les informations suivantes. Nom d utilisateur : Administrator Mot de passe : pass@word1 4. Dans le menu Actions du site, sélectionnez Autres options. Figure 35 - Actions du site - Autres options Page 31
5. Sélectionnez Page de composants dans la liste Page, puis cliquez sur Créer. Figure 36 - Créer une page de composants WebPart 6. Dans Nouvelle page de composants WebPart : Entrez spchol200-wp dans la zone de texte Nom. Choisissez Page complète, vertical en guise de modèle de mise en page. Sélectionnez Rapports personnalisés dans le menu déroulant Bibliothèque de documents. Cliquez sur le bouton Créer. Page 32
Figure 37 - Options Nouvelle page de composants WebPart 7. SharePoint crée la nouvelle page de composants WebPart et ouvre la page en mode édition. 8. Cliquez sur la zone de composant WebPart (zone bleue qui indique «Ajouter un composant WebPart»). Figure 38 - Zone de composant WebPart Page 33
9. Sélectionnez Custom dans Catégories. 10. Sélectionnez ConsumerWebPart et cliquez sur Ajouter. Figure 39 - Ajouter le composant WebPart consommateur 11. Le composant WebPart consommateur doit apparaître dans la page. Figure 40 - Composant WebPart consommateur ajouté à la page 12. Cliquez sur Ajouter un composant WebPart dans le corps principal de l écran (voir la figure 41). 13. Sélectionnez Custom dans Catégories. Page 34
14. Sélectionnez ProviderWebPart et cliquez sur Ajouter. Figure 41 - Ajouter le composant WebPart fournisseur 15. Le titre ProviderWebPart doit apparaître dans la page. Figure 42 - Composant WebPart fournisseur ajouté à la page Page 35
Tâche 6 Connecter les composants WebPart Dans cette tâche, vous allez connecter les composants WebPart fournisseur et consommateur. 1. Pointez sur le composant WebPart fournisseur de manière à faire apparaître une flèche de menu déroulant sur le côté droit de la fenêtre. Cliquez sur cette flèche pour ouvrir la liste déroulante et faites défiler celle-ci vers la bas jusqu à Connexions. Figure 43 - Bouton Modifier associé au composant WebPart fournisseur 2. Pointez sur Connexions Envoyer Nom et ID projet à ConsumerWebPart, puis cliquez sur ConsumerWebPart. Figure 44 - Menu Connexion WebPart 3. Cette opération crée une connexion WebPart avec le composant WebPart ConsumerWebPart, et le texte du composant WebPart consommateur indique désormais que l option d écriture d exemple de code supplémentaire a été sélectionnée. Page 36
Figure 45 - Connexion WebPart terminée 4. Cliquez sur Arrêter la modification dans le Ruban SharePoint. Figure 46 - Arrêter la modification Tâche 7 Vérifier la connexion WebPart Dans cette tâche, vous allez vérifier la connexion WebPart entre les composants WebPart fournisseur et consommateur ajoutés à la page de composants WebPart au cours de la tâche 6. Page 37
1. Dans le composant WebPart ProviderWebPart, sélectionnez Building more developer tools dans la liste déroulante. Figure 47 - Sélection d un projet 2. Normalement, la page doit être actualisée et le composant WebPart ConsumerWebPart doit être mis à jour avec le projet sélectionné (Building more developer tools) dans la liste déroulante ProviderWebPart. Figure 48 - Composant WebPart consommateur mis à jour Au cours des minutes précédentes, vous avez vu comment connecter deux composants WebPart et envoyer un message depuis le composant WebPart fournisseur au composant WebPart consommateur. Page 38
Résumé de l atelier Dans cet atelier, vous avez effectué les exercices suivants : créer un projet Composant Visual Web Part ; générer un code de proxy Linq-to-SharePoint ; créer une requête Linq pour récupérer des données de liste SharePoint ; créer deux composants WebPart SharePoint de base ; configurer un composant WebPart afin qu il participe à une connexion WebPart en tant que fournisseur ; configurer un composant WebPart afin qu il participe à une connexion WebPart en tant que consommateur. Dans cet atelier, vous avez appris à créer un composant Visual Web Part SharePoint à partir de zéro. Vous avez également appris à écrire une requête Linq-to-SharePoint en utilisant le nouveau mode Linq-to-SharePoint. En outre, vous avez appris à créer et à configurer des composants WebPart pour des connexions WebPart. Page 39