Procédure : afficher des champs personnalisés dans un composant WebPart Requête de contenu

Un composant WebPart Requête de contenu affiche une vue dynamique d'un contenu sur une page de votre site Microsoft Office SharePoint Server 2007. Le composant WebPart exécute une requête qui peut porter sur les listes et les sites de votre collection de sites, puis présente les résultats de cette requête dans la page. Vous pouvez, par exemple, utiliser ce composant WebPart pour afficher les cinq articles les plus récemment publiés dans votre site Web, quel que soit l'emplacement où ils sont stockés.

La principale caractéristique de ce composant WebPart sont les éléments suivants : Requête et Présentation. Le premier permet de déterminer le contenu à afficher et le second de déterminer le style et la présentation du contenu. Vous pouvez également associer des règles afin de n'afficher dans le composant WebPart que les éléments correspondant à un certain ensemble de règles.

Dans le volet d'outils, vous pouvez procéder comme suit :

• Sélectionner l'étendue de la requête. Vous pouvez configurer le composant WebPart pour rechercher des éléments dans l'ensemble de la collection de sites, à partir d'un site spécifique de la collection de sites, ou à partir d'une liste en particulier.

• Sélectionner le type de liste à partir de laquelle effectuer la recherche.

• Spécifier les types de contenus que le composant WebPart doit afficher.

• Sélectionner des filtres supplémentaires pour contrôler le contenu que le composant WebPart doit afficher. Par exemple, il est possible d'utiliser un filtre pour afficher uniquement les pages Article créées par un utilisateur en particulier.

• Sélectionner les options de tri et de groupement pour déterminer l'ordre dans lequel les éléments apparaissent.

• Sélectionner les options de type pour contrôler la façon dont le composant WebPart présente les éléments et groupe les en-têtes.

Par défaut, la feuille de style XSL qui contrôle la présentation du composant WebPart Requête de contenu rend les colonnes Title, Description, ImageUrl et LinkUrl (si présentes) des éléments que la requête renvoie. Le composant WebPart rend les colonnes ImageUrl et LinkUrl sous forme d'image et de lien hypertexte, respectivement. Le composant WebPart Requête de contenu utilise les feuilles de style XLS pour rendre ces colonnes par défaut.

Si vous souhaitez faire des recherches dans des types de contenus personnalisés et générer des colonnes spécifiques à partir de ces types de contenus dans le composant WebPart, vous devez effectuer des personnalisations dans le fichier .webpart.

Cette rubrique explique comment inclure des colonnes supplémentaires dans la requête du composant WebPart et comment demander au composant WebPart, au moyen d'un programme, de renommer les colonnes et d'utiliser les noms attendus par la transformation XSLT par défaut, puis de rendre les colonnes en utilisant les styles de la transformation XSLT par défaut.

Pour comprendre les étapes qui permettent d'effectuer cette personnalisation, envisagez le scénario suivant. Imaginez que vous disposiez du type de contenu Articles de la Base de connaissances avec les colonnes suivantes :

• KB Title (Titre de la base) (Texte)

• Product (Produit) (Texte)

• Version (Texte)

• Status (État) (Choix)

Vous souhaitez associer une bibliothèque de documents intitulée Articles de la Base de connaissances avec le type de contenu qui contient les articles de la Base de connaissances. Vous voulez ensuite afficher le contenu des articles de cette base dans un composant WebPart Requête de contenu dans votre page d'accueil, afficher la colonne Titre en tant que champ Titre et enfin, afficher la colonne Produit en tant que champ Description dans le composant WebPart. Pour cela, suivez les étapes ci-dessous.

Afficher des champs personnalisés dans un composant WebPart Requête de contenu

1. Ajoutez un composant WebPart Requête de contenu dans une page.

   • Dans la section Requête, définissez la Source de façon à afficher les éléments de la bibliothèque de documents Articles de la Base de connaissances (liste). Définissez le type de liste et le type de contenu en conséquence.

   • Dans la section Présentation, choisissez Titre et description pour le style de l'élément.

2. Modifiez les propriétés du fichier du composant WebPart pour afficher les champs personnalisés. Pour accéder au fichier .webpart correspondant, dans le menu Edition du composant WebPart, cliquez sur Exporter.

   • Office SharePoint Server 2007 génère un fichier .webpart contenant l'ensemble complet des propriétés disponibles pour ce composant WebPart. Le fichier .webpart est un fichier XML que vous pouvez modifier en utilisant un éditeur de texte.

3. Dans le fichier .webpart, localisez la propriété CommonViewFields. Utilisez cette propriété pour spécifier les champs supplémentaires que vous souhaitez afficher dans le composant WebPart. Ajoutez les noms internes des colonnes et le type.

   <property name="CommonViewFields" type="string">KB_x0020_Title,Text;Product,Text;</property>
   

   Notes

   Vous ne pouvez pas utiliser les noms complets de vos colonnes dans cette propriété. Vous pouvez rechercher les noms des colonnes internes en activant les propriétés de la colonne dans la liste ou dans la bibliothèque de documents. Cliquez avec le bouton droit sur la colonne et choisissez Propriétés. Le nom interne d'une colonne apparaît dans la propriété Address (URL) après 'Field='. Dans le scénario Articles de la Base de connaissances, les colonnes sont : Knowledge Base Article et Product et leurs noms internes KB_x0020_Title et Product, respectivement.

4. Mappez ces noms de colonnes internes au titre et à la description présents dans les transformations XSLT. Pour cela, modifiez la propriété DataColumnRenames.

   <property name="DataColumnRenames" type="string">KB_x0020_Title,Title;Product,Description</property>
   

   Notes

   Les transformations XSLT par défaut peuvent générer les quatre champs suivants : Title, Description, LinkUrl et ImageUrl. Dans votre propriété DataColumnRenames, vérifiez que les noms que vous spécifiez correspondent aux noms dans les transformations XSLT. C'est-à-dire, Title, Description, LinkUrl et ImageUrl.

5. Enregistrez localement le fichier .webpart.

6. Dans la page Web, supprimez le composant WebPart Requête de contenu que vous avez ajouté à l'étape 1.

7. Importez le fichier .webpart et ajoutez le composant WebPart dans votre page. Pour importer le fichier .webpart, cliquez sur Page, sur Ajouter des composants WebPart, puis cliquez sur Importer. Recherchez le fichier .webpart et cliquez sur Télécharger.

8. Faites glisser le composant WebPart vers la zone appropriée de la page. Il doit afficher le Titre de la Base de connaissances et le nom du produit.

Si vous souhaitez que la colonne État ou Version apparaisse en plus du titre de la Base de connaissances et du nom du produit, modifiez la transformation XSLT et ajoutez le rendu pour les colonnes supplémentaires.

Voir aussi

Autres ressources

Procédure : personnaliser XSL pour le composant WebPart Requête de contenu
Procédure : personnaliser le format RSS pour le composant WebPart Requête de contenu
Procédure : personnaliser le composant WebPart Requête de contenu à l'aide des propriétés personnalisées
Tâches courantes de personnalisation des pages et des sites