Créer des définitions de liste personnalisées dans SharePoint 2010

Article
09/24/2014

Bannière Démarrage rapide SharePoint
Prise en main du développement Web dans SharePoint 2010 : découvrez comment créer une définition de liste personnalisée dans SharePoint 2010, puis y attacher un récepteur d’événements.

Dernière modification : mercredi 12 janvier 2011

S’applique à : SharePoint Foundation 2010 | SharePoint Server 2010 | Visual Studio | Visual Studio 2010

Dans cet exercice, vous créez une définition de liste personnalisée dans Microsoft SharePoint 2010, puis vous créez un récepteur d’événements qui est déclenché lorsque la liste est utilisée. Pour accomplir cette tâche, vous devez effectuer les opérations suivantes :

Créer un projet de définition de liste SharePoint
Personnaliser la définition de liste SharePoint
Tester la solution

Créer un projet de définition de liste SharePoint

Dans cette tâche, vous créez un projet SharePoint 2010 de définition de liste dans Microsoft Visual Studio 2010.

Pour créer le projet SharePoint

Pour démarrer Visual Studio 2010, cliquez sur le menu Démarrer, sur Tous les programmes, sur Microsoft Visual Studio 2010, puis sur Microsoft Visual Studio 2010.
Dans le menu Fichier, pointez sur Nouveau, puis cliquez sur Projet.
Dans la boîte de dialogue Nouveau projet, dans la section Modèles installés, cliquez sur Visual C#, sur SharePoint, puis sur 2010.
Cliquez sur Définition de liste à partir des éléments de projet.
Dans la zone Nom, tapez Bugs, puis cliquez sur OK.
Dans l’Assistant Personnalisation de SharePoint, tapez le site Web local à utiliser pour cet exercice (tel que https://localhost/SampleWebSite).
Pour le niveau de confiance, sélectionnez Déployer en tant que solution de batterie, puis cliquez sur Suivant.
Dans la zone Quel est le nom complet de la définition de liste ?, tapez Bugs.
Dans la liste déroulante Quel est le type de la définition de liste ?, sélectionnez Liste personnalisée.
Activez la case à cocher Ajouter une instance de liste pour cette définition de liste, puis cliquez sur Terminer.

Personnaliser la définition de liste SharePoint

Cette tâche vous montre comment personnaliser le modèle de projet Définition de liste en modifiant le nom de la liste, le type de contenu correspondant et les champs qui apparaissent dans le nouveau formulaire, modifier le formulaire et afficher le formulaire.

Pour personnaliser la définition de liste

Dans l’Explorateur de solutions, développez ListInstance1, puis ouvrez le fichier Elements.xml.
Dans l’élément ListInstance, définissez l’attribut Title sur Bugs et l’attribut TemplateType sur 10001.
Dans l’Explorateur de solutions, avant Schema.xml, ouvrez Elements.xml.
Dans l’élément ListTemplate, définissez l’attribut Type sur 10001, puis ajoutez l’attribut DisallowContentTypes=”FALSE”.

Insérez le code XML suivant au début de l’élément Elements dans le fichier Elements.xml, comme le montre la figure 1. Ce code XML décrit le type de contenu Bug Item stocké par la liste.

<!-- Describes content types. -->
<ContentType
  ID="0x010089E3E6DB8C9B4B3FBB980447E313CE94"
  Name="Bug Item"
  Group="Custom Content Types"
  Description="Bug item content type."
  Version="0">
  <FieldRefs>
    <FieldRef ID="{fa564e0f-0c70-4ab9-b863-0177e6ddd247}" />
    <FieldRef ID="{cb55bba1-81a9-47b6-8e6c-6a7da1d25602}" />
    <FieldRef ID="{0248c82f-9136-4b3a-b802-d0b77280b3bc}" />
    <FieldRef ID="{aa4a82dd-5b32-4507-9874-4e1c7bca3279}" />
  </FieldRefs>
</ContentType>
<!--  End describes content types. -->

Insérez le code XML suivant au début de l’élément Elements dans le fichier Elements.xml, comme le montre la figure 1. Ce code XML décrit les champs utilisés par le type de contenu Bug Item.

<!-- Describes fields in bug list. -->
<Field Type="Note" DisplayName="Description" Required="FALSE" NumLines="6" RichText="FALSE" Sortable="FALSE" ID="{cb55bba1-81a9-47b6-8e6c-6a7da1d25602}" StaticName="BugDescription" Name="BugDescription" Group="Custom Columns" />
<Field Type="Text" DisplayName="Project" Required="FALSE" MaxLength="255" ID="{0248c82f-9136-4b3a-b802-d0b77280b3bc}" StaticName="BugProject" Name="BugProject" Group="Custom Columns" />
<Field Type="Text" DisplayName="Assigned To" Required="FALSE" MaxLength="255" ID="{aa4a82dd-5b32-4507-9874-4e1c7bca3279}" StaticName="BugAssignedTo" Name="BugAssignedTo" Group="Custom Columns" />
<!-- End describes fields in bug list. -->

Figure 1. Fichier Elements.xml après insertion des deux sections de code

Fichier elements.xml après insertion du code

Dans l’Explorateur de solutions, ouvrez Schema.xml.
Ajoutez l’attribut EnableContentTypes=”TRUE” à l’élément List dans le fichier Schema.xml.
Insérez le code XML suivant dans l’élément ContentTypes au sein du fichier schema.xml, comme le montre la figure 2. Ce code XML décrit le type de contenu Bug Item stocké par cette liste.
```

<ContentTypeRef ID="0x010089E3E6DB8C9B4B3FBB980447E313CE94" />

```

Insérez le code XML suivant dans l’élément Fields, comme le montre la figure 2. Ce code XML décrit les champs stockés par la liste. Ceux-ci sont directement liés aux champs dans le type de contenu que vous avez ajouté à l’étape précédente.

<!-- Start Add. -->
<Field Type="Note" DisplayName="Description" Required="FALSE" NumLines="6" RichText="FALSE" Sortable="FALSE" ID="{cb55bba1-81a9-47b6-8e6c-6a7da1d25602}" StaticName="BugDescription" Name="BugDescription" Group="Custom Columns" />
<Field Type="Text" DisplayName="Project" Required="FALSE" MaxLength="255" ID="{0248c82f-9136-4b3a-b802-d0b77280b3bc}" StaticName="BugProject" Name="BugProject" Group="Custom Columns" />
<Field Type="Text" DisplayName="Assigned To" Required="FALSE" MaxLength="255" ID="{aa4a82dd-5b32-4507-9874-4e1c7bca3279}" StaticName="BugAssignedTo" Name="BugAssignedTo" -Group="Custom Columns" />
<!-- End Add. -->

Figure 2. Schema.xml après insertion du code ContentTypeRefs et du code Fields

Schema.xml après insertion de ContentTypeRefs

Insérez le code XML suivant dans l’élément ViewFields au sein de la seconde vue, où BaseViewID="1" comme indiqué dans la figure 3. Ce code XML décrit les champs qui doivent être visibles dans cette vue particulière. BaseView 1 est défini en tant que vue par défaut. Il s’agit de la vue dans laquelle doivent apparaître les champs nouvellement créés.
```

<FieldRef Name="BugDescription"></FieldRef>
<FieldRef Name="BugProject"></FieldRef>
<FieldRef Name="BugAssignedTo"></FieldRef>

```
Figure 3. Schema.xml après insertion du code XML des champs
Dans l’Explorateur de solutions, cliquez avec le bouton droit sur le nœud Bugs puis cliquez sur Déployer.

Tester la solution

Dans cette tâche, vous testez la solution en ajoutant un bogue à la liste Bugs.

Pour ajouter un élément à la liste Bugs

Ouvrez le site Web que vous avez précédemment spécifié.
Dans la page d’accueil, dans le volet de navigation de gauche, cliquez sur la liste Bugs.
Sous l’onglet Outils de liste, cliquez sur Éléments, puis cliquez sur Bug Item dans la liste déroulante Nouvel élément comme indiqué dans la figure 4.

Figure 4. Option Bug Item dans la liste déroulante Nouvel élément

L’écran Bugs - New Item apparaît comme le montre la figure 5.

Figure 5. Boîte de dialogue New Bug
Dans l’écran Bugs - New Item, tapez Bug01 dans la zone Title.
Tapez Qui assura le suivi de ce bogue ? dans la zone Description, tapez Écriture d’articles pour les développeurs dans la zone Projet, puis cliquez sur Enregistrer.

Partager via