Procédure pas à pas : création d’une colonne de site, d’un type de contenu et d’une liste pour SharePoint

  • Article

Les procédures suivantes montrent comment créer des colonnes de site SharePoint personnalisées (ou champs) ainsi qu’un type de contenu qui utilise les colonnes de site. Vous verrez également comment créer une liste qui utilise le nouveau type de contenu.

Cette procédure pas à pas comprend les tâches suivantes :

Prérequis

Vous devez disposer des éléments suivants pour exécuter cette procédure pas à pas :

  • Éditions prises en charge de Windows et SharePoint.

  • Visual Studio 2019

Créer des colonnes de site personnalisées

Cet exemple crée une liste pour la gestion des patients dans un hôpital. Tout d’abord, vous devez créer un projet SharePoint dans Visual Studio et y ajouter des colonnes de site, comme suit.

Pour créer le projet

  1. Dans le menu Fichier de Visual Studio, choisissez Nouveau>Projet.

  2. Dans la boîte de dialogue Créer un projet, sélectionnez le Projet vide SharePoint pour la version particulière de SharePoint que vous avez installée. Par exemple, si vous avez installé SharePoint 2016, sélectionnez le modèle SharePoint 2016 - Projet vide.

    Notes

    Vous pouvez également rechercher des modèles en tapant SharePoint dans la zone de texte Rechercher en haut de la boîte de dialogue Créer un projet. Vous pouvez également filtrer la liste des modèles afin d’afficher uniquement les modèles pour Office et SharePoint en sélectionnant « Office » dans la liste déroulante Type de projet. Pour plus d’informations, consultez Créer un nouveau projet dans Visual Studio.

  3. Remplacez le nom du projet par Clinique, puis choisissez le bouton Créer.

  4. Dans la boîte de dialogue Spécifier le site et le niveau de sécurité pour le débogage, entrez l’URL du site SharePoint local auquel vous souhaitez ajouter le nouvel élément de champ personnalisé, ou utilisez l’emplacement par défaut (http://<SystemName>/).

  5. Dans la section Quel est le niveau de confiance pour cette solution SharePoint?, utilisez la valeur par défaut Déployer comme une solution bac à sable.

    Pour plus d’informations sur les solutions bac à sable et de batterie de serveurs, consultez Considérations sur les solutions bac à sable (sandbox).

  6. Cliquez sur le bouton Terminer. À présent, le projet s’affiche dans l'Explorateur de solutions.

Pour ajouter des colonnes de site

  1. Ajoutez une nouvelle colonne de site. Pour ce faire, dans l’Explorateur de solutions, cliquez avec le bouton droit sur le projet Clinique, puis choisissez Ajouter>Nouvel élément.

  2. Dans la boîte de dialogue Ajouter un nouvel élément, choisissez Colonne de site, remplacez le nom par PatientName, puis choisissez le bouton Ajouter.

  3. Dans le fichier Elements.xml de la colonne de site, conservez le paramètre Type comme Texte, puis remplacez le paramètre Groupe par Colonnes de site de la clinique. Lorsque vous avez terminé, le fichier Elements.xml de la colonne de site devrait ressembler à l’exemple suivant.

    <Field
     ID="{f9ba60d1-5631-41fb-b016-a38cf48eef63}"
     Name="PatientName"
     DisplayName="Patient Name"
     Type="Text"
     Required="FALSE"
     Group="Clinic Site Columns">
</Field>

    Conseil

    Visual Studio ajoute automatiquement un espace dans le DisplayName pour vous si vous utilisez la casse mixte dans le nom de la colonne de site. Il est recommandé de ne pas utiliser d’espaces dans le nom de colonne de site, car cela peut entraîner des problèmes lorsque vous essayez de déployer la solution sur SharePoint.

  4. À l’aide de la même procédure, ajoutez deux colonnes de site supplémentaires au projet : PatientID (Type = « Integer ») et DoctorName (Type = « Text »). Définissez leur valeur Groupe sur Colonnes de site de la clinique.

Créer un type de contenu personnalisé

Ensuite, créez un type de contenu, basé sur le type de contenu Contacts, qui inclut les colonnes de site que vous avez créées dans la procédure précédente. En basant un type de contenu sur un type de contenu existant, vous pouvez gagner du temps, car le type de contenu de base fournit plusieurs colonnes de site à utiliser dans le nouveau type de contenu.

Pour créer un type de contenu personnalisé

  1. Ajoutez un type de contenu au projet. Pour ce faire, dans l’Explorateur de solutions, choisissez le nœud de projet

  2. Dans la barre de menus, choisissez Projet>Ajouter un nouvel élément.

  3. Sous Visual C# ou Visual Basic, développez le nœud SharePoint, puis sélectionnez le nœud 2010.

  4. Dans le volet Modèles, choisissez le modèle Type de contenu, remplacez le nom par Informations patient, puis choisissez le bouton Ajouter.

    L'Assistant Personnalisation de SharePoint s’ouvre.

  5. Dans la liste De quel type de contenu de base ce type de contenu doit-il hériter, choisissez Contact comme type de contenu sur lequel baser le nouveau type de contenu, puis le bouton Terminer.

    Cela vous permet d’accéder à d’autres colonnes de site potentiellement utiles dans le type de contenu Contact, en plus des colonnes de site que vous avez définies précédemment.

  6. Une fois le concepteur de type de contenu affiché, sous l’onglet Colonnes, ajoutez les trois colonnes de site que vous avez définies précédemment : Nom du patient, ID du patient et Nom du médecin. Pour ajouter ces colonnes, choisissez la première zone de liste de la liste des colonnes du site sous Nom d’affichage, puis choisissez chaque colonne de site dans la liste, une à la fois.

    Conseil

    Pour choisir les colonnes de site plus rapidement, filtrez la liste en entrant les premières lettres du nom de la colonne.

  7. En plus des trois colonnes de site personnalisées, ajoutez la colonne de site Commentaires à partir de la liste des colonnes de site.

  8. Cochez la case Obligatoire pour les colonnes de site Nom du patient et ID de patient pour les rendre obligatoires.

  9. Sous l’onglet Type de contenu, vérifiez que le nom du type de contenu est Informations patient, puis remplacez la description par Carte d’informations sur le patient.

  10. Remplacez Nom du groupe par Types de contenu de la clinique et laissez les autres paramètres à leurs valeurs par défaut.

  11. Dans la barre de menus, choisissez Fichier>Enregistrer tout, puis fermez le concepteur de type de contenu.

Créer une liste

Maintenant, créez une liste qui utilise le nouveau type de contenu et les colonnes de site.

Pour créer une liste

  1. Ajoutez une liste au projet. Pour ce faire, dans l’Explorateur de solutions, choisissez le nœud de projet

  2. Dans la barre de menus, choisissez Projet>Ajouter un nouvel élément.

  3. Sous Visual C# ou Visual Basic, développez le nœud SharePoint.

  4. Dans le volet Modèles, choisissez le modèle Liste, changez son nom en Patients, puis cliquez sur le bouton Ajouter.

  5. Conservez le paramètre Personnaliser la liste en fonction de sur Par défaut (liste personnalisée), puis choisissez le bouton Terminer.

  6. Dans le Concepteur de listes, choisissez le bouton Types de contenu pour afficher la boîte de dialogue Paramètres de type de contenu.

  7. Choisissez la nouvelle ligne, choisissez le type de contenu Informations patient dans la liste des types de contenu, puis choisissez le bouton OK.

    Cela ajoute toutes les colonnes de site du type de contenu Informations patient dans la liste.

  8. Supprimez toutes les colonnes de site de la liste, à l’exception des éléments suivants :

    • Patient ID

    • Nom du patient

    • Téléphone personnel

    • Courrier électronique

    • Nom du médecin

    • Commentaires

  9. Sous Nom d’affichage de la colonne, choisissez une ligne vide, ajoutez une colonne de liste personnalisée et nommez-la Hôpital. Laissez son type de données sur Ligne de texte unique.

    La colonne de liste personnalisée s’applique uniquement à cette liste. Lorsque vous ajoutez une colonne de liste personnalisée à une liste, un nouveau type de contenu de liste, y compris toutes les colonnes ajoutées à la liste, est créé et défini comme liste par défaut.

    Conseil

    Si vous choisissez une colonne dans la liste des colonnes de site, une colonne de site existante est utilisée. Toutefois, si vous entrez une valeur de nom de colonne sans choisir de colonnes dans la liste, une colonne de liste personnalisée est créée, même si une colonne portant le même nom existe déjà dans la liste.

    Si vous le souhaitez, au lieu de définir le type de données de la colonne de liste personnalisée sur Ligne de texte unique, vous pouvez définir le type de données de cette colonne sur Recherche, et ses valeurs seront récupérées à partir d’une table ou d’une autre liste. Pour plus d’informations sur les colonnes de recherche, consultez Relations de liste dans SharePoint 2010 et Recherches et relations de liste.

  10. En regard des zones ID du patient et Nom du patient, activez la case à cocher Obligatoire.

  11. Sous l’onglet Vues, choisissez une ligne vide pour créer une vue. Entrez Détails du patient dans une ligne vide sous la colonne Nom de la vue.

    Sous l’onglet Vues, vous pouvez spécifier les colonnes que vous souhaitez afficher dans la liste SharePoint.

  12. Choisissez la nouvelle ligne Détails du patient, puis le bouton Définir par défaut.

    La nouvelle vue est désormais celle par défaut de la liste.

  13. Ajoutez les colonnes suivantes à la liste Colonnes sélectionnées dans l’ordre suivant :

    • Patient ID

    • Nom du patient

    • Téléphone personnel

    • Courrier électronique

    • Nom du médecin

    • Hôpital

    • Commentaires

  14. Dans la liste Propriétés, choisissez la propriété Tri et regroupement, puis choisissez le bouton de points de suspension Ellipsis Icon pour afficher la boîte de dialogue Tri et regroupement.

  15. Dans la liste Nom de la colonne, choisissez Nom du patient, assurez-vous que la colonne Tri est définie sur Croissant, puis choisissez le bouton OK.

Test de l’application

Maintenant que les colonnes de site personnalisées, le type de contenu et la liste sont prêts, déployez-les sur SharePoint et exécutez l’application pour les tester.

Pour tester l'application

  1. Dans la barre de menus, sélectionnez Fichier>Enregistrer tout.

  2. Appuyez sur la touche F5 pour exécuter l’application.

    L’application est compilée, puis ses fonctionnalités sont déployées sur SharePoint et activées.

  3. Dans la barre de navigation rapide, choisissez le lien Patients pour afficher la liste Patients.

    Les noms de colonnes de la liste doivent correspondre à ceux que vous avez entrés sous l’onglet Vues dans Visual Studio.

  4. Choisissez le lien Ajouter un nouvel élément pour créer une carte d’informations sur les patients.

  5. Entrez des informations dans les champs, puis choisissez le bouton Enregistrer.

    Le nouvel enregistrement apparaît dans la liste.

Contenu connexe