Affichage des champs personnalisés dans des composants WebPart de requête de contenu dans Office SharePoint Server 2007

Résumé : Découvrez comment afficher des champs personnalisés dans le composant WebPart de requête de contenu en définissant la propriété personnalisée CommonViewFields et en modifiant la transformation XSLT par défaut pour le rendu des éléments.

Procédure Office Visual

Concerne : système Microsoft Office 2007, Microsoft Office SharePoint Server 2007, Microsoft Office SharePoint Designer 2007

Joel Krist, Akona Systems (en anglais)

Septembre 2007

Vue d’ensemble

Vous pouvez utiliser le composant WebPart de requête de contenu pour créer des vues personnalisées dynamiques des données recherchées dans de nombreuses sources et présenter ces données à un seul endroit. Vous pouvez afficher des champs personnalisés avec le composant WebPart de requête de contenu en définissant des propriétés personnalisées et en modifiant la transformation XSLT par défaut. Cet article décrit la procédure d'affichage des champs personnalisés dans le composant WebPart de requête de contenu en modifiant la propriété CommonViewFields et la transformation XSLT par défaut utilisée par le composant WebPart de requête de contenu pour formater le rendu des éléments.

Le voir Afficher des champs personnalisés dans les composants WebPart Requête de contenu

Lire la vidéo

Durée : 14:33 | Taille : 31,242 Ko | Type : fichier WMV

Codez | Lisez | Explorez

Codez

Cet article utilise une bibliothèque de documents appelée Rapports d'état du projet pour décrire comment afficher des champs personnalisés avec le composant WebPart de requête de contenu. La bibliothèque de documents Rapports d'état du projet utilise un type de contenu de site personnalisé appelé Rapport d'état du projet, qui se trouve dans le groupe de types de contenu Rapports d'état du projet. Ce type de contenu contient les colonnes du site figurant dans le Tableau 1.

Tableau 1. Colonnes du site Rapports d'état de projet

Colonne Type de données

Nom du projet

Texte

Propriétaire du projet

Texte

État du projet

Texte

Résumé du statut du projet

Texte

Les sections ci-dessous indiquent comment personnalisés le composant WebPart de requête de contenu pour afficher des champs personnalisés. Le processus inclut sept étapes :

  1. Ajout du composant WebPart de requête de contenu à une page Web sur un site Office SharePoint Server 2007

  2. Configuration du composant WebPart de requête de contenu à utiliser avec la bibliothèque de documents Rapports d'état de projet et le type de contenu Rapport d'état.

  3. Exportation du composant WebPart de requête de contenu vers un fichier .webpart

  4. Modification du fichier .webpart exporté et définition de la propriété personnalisée CommonViewFields du composant WebPart de requête de contenu sur les champs personnalisés du type de contenu Rapports d'état de projet.

  5. Modification de la transformation XSLT par défaut, utilisée par le composant WebPart de requête de contenu pour afficher les champs personnalisés du type de contenu Rapports d'état de projet.

  6. Importation du fichier .webpart modifié dans une page Web sur un site Office SharePoint Server 2007

  7. Configuration du composant WebPart importé pour utiliser le nouveau style XSL

Ajout d'un composant WebPart de requête de contenu dans une page Web

Notes

Le composant WebPart de requête de contenu est disponible dans Office SharePoint Server 2007. Il n'est pas disponible avec Windows SharePoint Services 3.0.

Pour ajouter une instance de composant WebPart de requête de contenu dans une page Web

  1. Dans une page Web d'un site SharePoint, cliquez sur Actions du site, puis cliquez sur Modifier la page. La page passe en mode de modification.

  2. Dans une zone de composant WebPart, cliquez sur Ajouter un composant WebPart.

    Figure 1. Ajout d'un composant WebPart à une zone de composant WebPart

    Ajouter un composant WebPart à une zone de composant WebPart

  3. Dans la boîte de dialogue Ajouter des composants WebPart, activez la case à cocher Composant WebPart de requête de contenu. Cliquez sur Ajouter pour ajouter le composant WebPart à la zone Composant WebPart sélectionnée.

    Figure 2. Boîte de dialogue Ajouter des composants WebPart

    Boîte de dialogue Ajouter des composants WebPart

Configuration du composant WebPart de requête de contenu

Cette procédure indique comment configurer le composant WebPart de requête de contenu.

Pour modifier les propriétés du composant WebPart de requête de contenu afin d'afficher le contenu à partir de la bibliothèque de documents Rapports d'état de projet

  1. Dans le composant WebPart de requête de contenu, cliquez sur Modifier, puis sur Modifier le composant WebPart partagé.

    Figure 3. Modification d'un composant WebPart partagé

    Modifier un composant WebPart partagé

    Le composant Outils de requête de contenu affiche les catégories des propriétés du composant WebPart.

    Figure 4. Composant Outils de requête de contenu

    Composant Outils de requête de contenu

  2. Développez la catégorie Requête. Dans la section Source, cliquez sur Afficher les éléments de la liste suivante.

    Figure 5. Définition de la propriété source

    Définir la propriété source

  3. Cliquez sur Parcourir. Dans la boîte de dialogue Sélectionner une liste ou une bibliothèque, cliquez sur la bibliothèque de documents Rapports d'état de projet, puis cliquez sur OK.

    Figure 6. Boîte de dialogue Sélectionner une liste ou une bibliothèque

    Boîte de dialogue Sélectionner une liste ou une bibliothèque

  4. Procédez comme suit :

    1. Dans la section Type de liste, de la zone Afficher les éléments de ce type de liste, cliquez sur Bibliothèque de documents.

    2. Dans la section Type de contenu, de la zone Afficher les éléments de ce groupe de type de contenu, cliquez sur Rapports d'état de projet. Dans la zone Afficher les éléments de ce type de contenu, cliquez sur Rapport d'état de projet.

    Figure 7. Définition des propriétés de type de liste et de type de contenu

    Définir les propriétés de type de liste et de type de contenu

    Dans la section Filtres supplémentaires, définissez Afficher les éléments quand sur Statut du projet est égal à À surveiller Ou Statut du projet est égal à Peut-être à surveiller Et <pas de filtre> (Figure 8).

    Figure 8. Définition des filtres

    Définir les filtres

  5. Développez la section Présentation. Dans la zone Grouper les éléments par, cliquez sur Statut du projet, puis sur Afficher les groupes par ordre décroissant.

    Figure 9. Définition de la propriété de regroupement

    Définir la propriété de regroupement

  6. Développez la section Apparence. Dans la zone Titre, tapez Projets à surveiller comme titre du composant WebPart.

    Figure 10. Définition de la propriété de titre

    Définir la propriété de titre

  7. Cliquez sur OK dans le composant Outils pour enregistrer les modifications apportées aux propriétés des composants WebPart.

    Le composant WebPart de requête de contenu affiche les documents figurant actuellement dans la bibliothèque de documents Rapports d'état de projet, dont l'état est À surveiller ou Peut-être à surveiller et regroupe les éléments en fonction de leur état.

    Figure 11. Affichage de tous les documents

    Afficher tous les documents

Exportation du composant WebPart de requête de contenu

Le composant WebPart de requête de contenu expose de nombreuses propriétés, que vous pouvez personnaliser, mais elles ne sont pas toutes disponibles dans le composant Outils de requête de contenu. Pour modifier les propriétés personnalisées d'une instance existante du composant WebPart de requête de contenu, exportez le composant WebPart dans un fichier .webpart, puis modifiez le fichier .webpart.

Pour exporter une instance existante du composant WebPart de requête de contenu

  1. Dans le composant WebPart, cliquez sur modifier, puis sur Exporter.

    Figure 12. Exportation d'un composant WebPart

    Exporter un composant WebPart

  2. Dans la boîte de dialogue Téléchargement de fichier, cliquez sur Enregistrer. Dans la boîte de dialogue Enregistrer sous, tapez un nom et un emplacement pour le fichier .webpart. Cliquez sur Enregistrer dans la boîte de dialogue Enregistrer sous pour enregistrer le fichier.

Modifcation du fichier .webpart exporté

Le fichier .webpart exporté est un fichier texte qui contient du code XML décrivant les propriétés du composant WebPart. Vous pouvez le modifier dans un éditeur de texte ou en utilisant un éditeur XML, comme Microsoft Office SharePoint Designer 2007 ou Microsoft Visual Studio. Lorsque vous modifiez les propriétés personnalisées dans le fichier .webpart, n'oubliez pas les points suivants :

  • Vous devez spécifier les noms de colonne utilisés par leur nom interne. Le nom interne d'une colonne ne peut pas être identique au nom affiché dans l'interface utilisateur Office SharePoint Server. Par exemple, si un nom de colonne contient des espaces, chaque espace est encodé sous la forme _x0020_ dans le nom interne. Vous pouvez découvrir le nom interne d'une colonne en affichant le paramètre de chaîne de requête dans une page Colonne du site ou en affichant le code du composant WebPart de requête de contenu après avoir effectué un filtrage sur la colonne. Pour afficher le nom de colonne dans le code du composant WebPart, définissez le composant WebPart de manière à filtrer sur la colonne, exportez le composant WebPart, puis affichez le nom de la colonne tel qu'il apparaît dans les propriétés du filtre.

  • Le code ALL XML dans une balise <property/> doit être placé dans un bloc <![CDATA[ ]]>.

  • N'incluez pas d'espaces supplémentaires entre les balises dans le code XML.

Vous pouvez afficher des champs personnalisés avec le composant WebPart de requête de contenu. Cet article décrit la procédure de modification des propriétés dans le fichier .webpart du composant WebPart afin que le composant WebPart affiche les colonnes personnalisées du type de contenu Rapport d'état du projet.

Pour modifier les propriétés dans le fichier .webpart du composant WebPart de requête de contenu afin d'afficher les colonnes personnalisées du type de contenu Rapport d'état du projet

  1. Définissez la valeur de la propriété CommonViewFields. Le composant WebPart de requête de contenu ne renvoie pas automatiquement tous les champs de tous les éléments. Vous pouvez utiliser la propriété CommonViewFields pour rechercher des champs spécifiques pour lequel afficher le rendu. Recherchez la propriété CommonViewFields dans le fichier .webpart, puis modifiez-le pour qu'il se présente de la manière suivante.

    <property name="CommonViewFields" type="string">
    Nom_x0020_du_x0020_projet, Text;Propri_x00e9_taire_x0020_du_x0020_projet, Text;R_x00e9_sum_x00e9__x0020_du_x0020_statut_x0020_du_x0020_projet, Text
    </property>
    

    Ce code recherche les colonnes Nom du projet, Propriétaire du projet et Résumé du statut du projet, pour que les données dans les colonnes puissent être rendues. Chaque nom de colonne interne est spécifié, suivi de son type de données. Les paires nom/type sont séparées par des points-virgules.

  2. Enregistrez le fichier .webpart modifié.

Modification de la transformation XSLT par défaut

Vous pouvez spécifier le groupe Composant WebPart de requête de contenu et les styles d'élément dans la section Styles de la catégorie Présentation du composant Outils de requête de contenu.

Figure 13. Propriétés de style

Propriétés de style

Le composant WebPart de requête de contenu utilise le fichier XSLT ItemStyle qui se trouve dans la bibliothèque de styles de la collection de sites pour le rendu des éléments. En modifiant le fichier XSLT ItemStyle, vous pouvez ajouter un style d'élément personnalisé pour permettre au composant WebPart de requête de contenu d'afficher le rendu des champs personnalisés du type de contenu Rapport d'état du projet.

Pour modifier le fichier XSLT ItemStyle avec Office SharePoint Designer 2007

  1. Démarrez Office SharePoint Designer 2007.

  2. Dans le menu Fichier, cliquez sur Ouvrir le site.

  3. Dans la boîte de dialogue Ouvrir le site, tapez l'URL du site Office SharePoint Server, puis cliquez sur Ouvrir.

  4. Dans le menu Affichage du site SharePoint, cliquez sur Liste des dossiers, développez Style Library (Bibliothèque de styles), puis développez XSL Style Sheets.

    Figure 14. Nœud Feuilles de style XSL

    Nœud Feuilles de style XSL

  5. Recherchez le fichier ItemStyle.xsl et double-cliquez dessus pour l'ouvrir. SharePoint Designer indique le fichier est sous contrôle de source et vous demande si vous souhaitez l'archiver. Cliquez sur Oui.

  6. Accédez à la fin du fichier ItemStyle.xsl et insérez le code ci-dessous entre les balises </xsl:template> et </xsl:stylesheet>.

    <xsl:template name="CustomStyle" match="Row[@Style='CustomStyle']"
    mode="itemstyle">
      <xsl:variable name="SafeImageUrl">
        <xsl:call-template name="OuterTemplate.GetSafeStaticUrl">
          <xsl:with-param name="UrlColumnName" select="'ImageUrl'"/>
        </xsl:call-template>
      </xsl:variable>
      <xsl:variable name="SafeLinkUrl">
        <xsl:call-template name="OuterTemplate.GetSafeLink">
          <xsl:with-param name="UrlColumnName" select="'LinkUrl'"/>
        </xsl:call-template>
      </xsl:variable>
      <xsl:variable name="DisplayTitle">
        <xsl:call-template name="OuterTemplate.GetTitle">
          <xsl:with-param name="Title" select="@Title"/>
          <xsl:with-param name="UrlColumnName" select="'LinkUrl'"/>
        </xsl:call-template>
      </xsl:variable>
      <xsl:variable name="LinkTarget">
        <xsl:if test="@OpenInNewWindow = 'True'" >_blank</xsl:if>
      </xsl:variable>
      <div id="linkitem" class="item">
        <xsl:if test="string-length($SafeImageUrl) != 0">
          <div class="image-area-left">
            <a href="{$SafeLinkUrl}" target="{$LinkTarget}">
              <img class="image-fixed-width"
                src="{$SafeImageUrl}" alt="{@ImageUrlAltText}" />
            </a>
          </div>
        </xsl:if>
        <div class="link-item">
          <div class="description">
            Project Name:
            <xsl:value-of select="@Nom_x005F_x0020_du_x005F_x0020_projet" />
            <br></br>
            Project Owner:
            <xsl:value-of select="@Propriétaire_x005F_x0020_du_x005F_x0020_projet" />
            <br></br>
            Project Status Summary:
            <xsl:value-of
              select="@Résumé_x005F_x0020_du_x005F_x0020_statut_x005F_x0020_du_x005F_x0020_projet" />
          </div>           
          <xsl:call-template
            name="OuterTemplate.CallPresenceStatusIconTemplate"/>
            <a href="{$SafeLinkUrl}" target="{$LinkTarget}"
              title="{@LinkToolTip}">
              <xsl:value-of select="$DisplayTitle"/>
            </a>
        </div>
      </div>
    </xsl:template>
    

    Ce code définit un style appelé CustomStyle qui affiche les colonnes Nom du projet, Propriétaire du projet et Résumé du statut du projet, et un lien vers le document de l'élément. Notez que les noms de colonne Rapport d'état de projet ne sont pas encodés comme dans le fichier .webpart pour la propriété personnalisée CommonViewFields du composant WebPart de requête de contenu. Cette différence est liée au fait que certains caractères sont encodés lorsqu'ils sont transmis sous forme de code XML dans le code XSL pour le rendu. Pour savoir exactement les noms de champ à envoyer dans le code XSL, vous devez insérer le code ci-dessous dans le fichier ItemStyle.xsl. Ce code affiche le rendu des noms de champ. Une fois que les noms de champ appropriés sont déterminés, vous pouvez supprimer ce code du fichier XSL. Pour découvrir les noms de fichier à utiliser dans le fichier XSL, ajoutez le code ci-dessous au code XSL affiché précédemment, sous forme de premier élément dans le nouveau style personnalisé.

    <xsl:template name="CustomStyle" match="Row[@Style='CustomStyle']"
    mode="itemstyle">
      <xsl:for-each select="@*">
        P:<xsl:value-of select="name()" />
      </xsl:for-each>
    …
    
  7. Archivez le fichier ItemStyle.xsl modifié et publiez-le dans SharePoint Designer.

Importation du fichier .webpart modifié

Cette procédure indique comment importer le composant WebPart de requête de contenu personnalisé.

Pour importer le composant WebPart de requête de contenu personnalisé dans une page du site SharePoint

  1. Cliquez sur Actions du site, puis sur Modifier la page.

  2. Dans la barre d'outils de modification de la page, dans le menu Page, pointez sur Ajouter des composants WebPart, puis cliquez sur Importer.

    Figure 15. Importation d'un composant WebPart

    Importer un composant WebPart

  3. Dans le volet Ajouter des composants WebPart, cliquez sur Parcourir. Dans la boîte de dialogue Sélectionner un fichier, accédez au dossier qui contient le fichier .webpart modifié précédemment, cliquez sur le fichier, puis cliquez sur Ouvrir.

    Figure 16. Ajout de composants WebPart

    Ajouter des composants WebPart

  4. Dans le volet Ajouter des composants WebPart, cliquez sur Télécharger.

  5. Une fois que le composant WebPart est transféré, dans le volet Ajouter des composants WebPart, sélectionnez la zone Composant WebPart à laquelle ajouter le composant WebPart, puis cliquez sur Importer. Le composant WebPart de requête de contenu personnalisé est ajouté à la zone Composant WebPart sélectionnée.

Configuration du composant WebPart importé pour utiliser le nouveau style XSL

À ce stade, le composant WebPart se présente comme précédemment : il affiche les documents figurant actuellement dans la biblitohèque de documents Rapports d'état de projet, dont l'état est À surveiller ou Peut-être à surveiller, et regroupe les éléments en fonction de leur état.

Pour définir le composant WebPart pour qu'il utilise la nouvelle transformation XSLT

  1. Si la page Web n'est pas encore en mode de modification, cliquez sur Actions du site, puis sur Modifier la page.

  2. Dans le composant WebPart de requête de contenu, cliquez sur modifier, puis sur Modifier le composant WebPart partagé.

  3. Dans le composant Outils de requête de contenu, développez la catégorie Présentation, dans la section Styles, zone Style d'élément, cliquez sur CustomStyle.

    Figure 17. Sélection d'un style d’élément personnalisé

    Sélectionner un style d’élément personnalisé

  4. Dans le volet Composant WebPart, cliquez sur OK pour appliquer la modification.

    Le composant WebPart de requête de contenu utilise la transformation XSLT personnalisée pour afficher le rendu des champs personnalisés de type de contenu Rapport d'état de projet.

    Figure 18. Rendu personnalisé

    Rendu personnalisé

Lisez

Vous pouvez utiliser le composant WebPart de requête de contenu pour afficher un ensemble d'éléments dynamique basé sur une requête. Le composant WebPart de requête de contenu permet de définir des options de présentation qui déterminent la manière dont les éléments sont affichés sur la page terminée. Les éléments affichés par le composant WebPart de requête de contenu reflètent le dernier ensemble d'éléments extrait par la requête que la Visionneuse de pages est autorisée à afficher. La requête est exécutée chaque fois que la page contenant le composant WebPart de requête de contenu est affichée. Si un nouveau contenu est ajouté et qu'il répond aux critères de la requête, le composant WebPart de requête de contenu l'affiche automatiquement. Par défaut, le composant WebPart de requête de contenu ne renvoie pas tous les champs des éléments renvoyés dans une requête. Cet article de formation vidéo indique comment afficher des champs personnalisés dans le composant WebPart de requête de contenu en définissant la propriété personnalisée CommonViewFields et en modifiant la transformation XSLT par défaut utilisée pour afficher le rendu des éléments. La procédure inclut les étapes suivantes :

  1. Ajout du composant WebPart de requête de contenu à une page Web sur un site Office SharePoint Server 2007

  2. Configuration du composant WebPart de requête de contenu à utiliser avec la bibliothèque de documents Rapports d'état de projet et le type de contenu Rapport d'état.

  3. Exportation du composant WebPart de requête de contenu vers un fichier .webpart

  4. Modification du fichier .webpart exporté et définition de la propriété personnalisée CommonViewFields du composant WebPart de requête de contenu sur les champs personnalisés du type de contenu Rapport d'état du projet.

  5. Modification de la transformation XSLT par défaut, utilisée par le composant WebPart de requête de contenu pour afficher les champs personnalisés du type de contenu Rapport d'état de projet.

  6. Importation du fichier .webpart modifié dans une page Web sur un site Office SharePoint Server 2007

  7. Configuration du composant WebPart importé pour utiliser le nouveau style XSL

Explorez