Procédure : personnaliser le format RSS pour le composant WebPart Contenu par requête

  • Article

Dernière modification : lundi 19 avril 2010

S’applique à : SharePoint Server 2010

Après avoir personnalisé le composant WebPart Contenu par requête pour afficher les champs et le contenu de votre choix, vous pouvez configurer le composant WebPart de manière à ce qu’il diffuse un flux RSS (Really Simple Syndication) de ce contenu.

Cette rubrique explique comment ajouter et personnaliser des flux RSS qui diffusent du contenu Composant WebPart Contenu par requête :

  • Activation d’un flux RSS pour du contenu Composant WebPart Contenu par requête

  • Fonctionnement d'une URL de flux RSS

  • Utilisation d’un fichier .xsl personnalisé pour les flux RSS Composant WebPart Contenu par requête

  • Résolution des problèmes de mise en cache pour un flux RSS Composant WebPart Contenu par requête

Activation d’un flux RSS pour du contenu Composant WebPart Contenu par requête

Pour activer un flux RSS qui diffuse du contenu Composant WebPart Contenu par requête, modifiez le composant WebPart et activez la case à cocher Activer le flux. Après avoir activé le flux, cliquez sur l’icône de flux RSS pour obtenir un aperçu du contenu du flux dans votre navigateur.

Fonctionnement d’une URL de flux RSS

Pour personnaliser le format RSS pour le Composant WebPart Contenu par requête, il est important de comprendre les différentes parties d’une URL de flux RSS et la façon dont elles interagissent. Voici le format d’une URL de flux RSS : **http://nom_serveur/_layouts/feed.aspx?xsl=fichiersXSL inscrits dans le fichier Web.config&web=adresse_web&page=GUID&wp=**GUID

L’URL de flux comprend un chemin d’accès vers le fichier Feed.aspx, qui est généré à partir du fichier Feed.xsl dans le dossier _layouts du serveur exécutant Microsoft SharePoint Server 2010. Le fichier Feed.aspx recherche le Composant WebPart Contenu par requête qui diffuse le flux RSS, détermine la requête exécutée par le composant WebPart, puis utilise le fichier Feed.xsl dans le dossier _layoutspour produire le code XML du flux RSS.

Les valeurs spécifiées pour chaque paramètre fournissent des informations requises par SharePoint Server 2010 pour émettre un flux RSS.

Paramètre

Description

Valeurs valides

xsl

Pointeur vers la clé utilisée pour identifier le fichier Rss.xsl utilisé par le composant WebPart pour produire le flux RSS

Fichiers .xsl qui sont inscrits dans le fichier web.config

Web

Site Web contenant le Composant WebPart Contenu par requête qui diffuse le flux RSS

URL relative de serveur

Page

Page contenant le Composant WebPart Contenu par requête qui diffuse le flux RSS

GUID

Wp

ID du Composant WebPart Contenu par requête.

GUID

Informations des paramètres XSL supplémentaires

La conception du Composant WebPart Contenu par requête facilite l’administration des flux RSS ; SharePoint Server 2010 inscrit chaque fichier .xsl dans le fichier web.config. Le paramètre xsl de l’URL de flux RSS représente le fichier .xsl inscrit dans le fichier web.config qui se trouve à l’emplacement indiqué par le chemin d’accès suivant :\Inetpub\wwwroot\wss\VirtualDirectories\portnumber\wpresources. L’inscription d’un fichier .xsl dans la section <appsettings> du fichier web.config permet au fichier Feed.aspx d’utiliser ce fichier .xsl.

<appsettings>
   <add key="FeedXsl1" value="/Style Library/Xsl Style Sheets/Rss.xsl">
</appsettings>

La valeur key de FeedXsl1 est mappée à la valeur 1 du paramètre xsl dans l’URL de flux RSS.

La valeur value du chemin d’accès /Style Library/Xsl Style Sheets/Rss.xsl pointe vers le fichier Rss.xsl de la Bibliothèque de styles, incluse par défaut dans SharePoint Server 2010.

Pour activer un flux RSS pour un composant WebPart Contenu par requête

  1. Modifiez le Composant WebPart Contenu par requête.

  2. Développez la section Présentation, puis activez la case à cocher Activer le flux.

  3. Cliquez dans le flux RSS pour obtenir un aperçu dans Internet Explorer et vérifiez que le flux fonctionne comme prévu.

Utilisation d’un fichier XSL personnalisé pour des flux RSS Composant WebPart Contenu par requête

Vous pouvez utiliser un fichier .xsl personnalisé pour des flux RSS Composant WebPart Contenu par requête en procédant de l’une des façons suivantes :

  • En modifiant le fichier Rss.xsl par défaut qui est inclus avec SharePoint Server 2010 ; ceci permet de s’assurer que tous les Composants WebPart Contenu par requête utilisent le même fichier Rss.xsl mis à jour pour le rendu des flux. Vous pouvez procéder ainsi par exemple pour utiliser un fichier Rss.xsl qui utilise le schéma Atom au lieu du schéma RSS 2.0, et pour utiliser Atom pour tous les composants WebPart Contenu par requête de la collection de sites. Utilisez cette approche si vous êtes propriétaire de la collection de sites mais que vous n’êtes pas propriétaire du serveur exécutant SharePoint Server 2010.

  • En ajoutant un fichier Rss.xsl personnalisé à la Bibliothèque de styles et en l’inscrivant dans le fichier web.config. Utilisez cette approche pour générer un flux RSS personnalisé qui s’applique à un Composant WebPart Contenu par requête spécifique. Utilisez cette option si vous avez besoin de droits d’administrateur local sur le serveur SharePoint Server 2010 pour inscrire le fichier .xsl, si vous devez prendre en charge plusieurs façons de modifier votre composant WebPart ou si vous devez modifier le fichier web.config.

Pour modifier le fichier RSS.xsl par défaut

  1. Accédez à la Bibliothèque de styles.

  2. Modifiez le fichier Rss.xsl de façon à diffuser les données de flux RSS de votre choix.

  3. Enregistrez les modifications.

Pour ajouter un fichier .xsl de flux RSS personnalisé à la bibliothèque de styles et modifier des fichiers pour son utilisation

  1. Accédez à la Bibliothèque de styles.

  2. Cliquez sur Télécharger, puis téléchargez le fichier .xsl vers la Bibliothèque de styles. Vous pouvez télécharger le fichier vers le dossier qui contient le fichier Rss.xsl par défaut.

    Notes

    Si vous n’avez pas accès au fichier .xsl dans la Bibliothèque de styles, vous pouvez personnaliser le Composant WebPart Contenu par requête en modifiant le fichier ItemXslLink.xsl associé au fichier de définition de composant WebPart (.wpd).

  3. Modifiez le fichier web.config, ajoutez une nouvelle entrée <appSettings> pour le fichier que vous avez ajouté à l’étape 2, puis enregistrez les modifications.

    <appSettings>
...
   <add key="FeedXsl2" value="/Style Library/Xsl Style Sheets/Rss-custom.xsl" />
...
</appSettings>

  4. Modifiez le fichier .xsl qui diffuse le flux RSS pour le Composant WebPart Contenu par requête en copiant le fichier ContentQueryMain.xsl et en téléchargeant la copie vers la Bibliothèque de styles.

  5. Modifiez la copie du fichier ContentQueryMain.xsl et modifiez le code suivant. Supprimez ce code :

    <xsl:variable name="FeedUrl1" select="concat($SiteUrl,$FeedPageUrl,'xsl=1&amp;web=',$WebUrl,'&amp;page=',$PageId,'&amp;wp=',$WebPartId)" />

    Et remplacez-le par le code suivant :

    <xsl:variable name="FeedUrl1" select="concat($SiteUrl,$FeedPageUrl,'xsl=2&amp;web=',$WebUrl,'&amp;page=',$PageId,'&amp;wp=',$WebPartId)" />

  6. Vérifiez que votre Composant WebPart Contenu par requête utilise la copie du fichier ContentQueryMain.xsl en modifiant la propriété du Composant WebPart Contenu par requête qui détermine le fichier Main.xsl qui est utilisé :

    1. Recherchez le Composant WebPart Contenu par requête sur une page et exportez-le.

    2. Modifiez la propriété MainXslLink. Supprimez ce code :

      <property name="MainXslLink" type="string" />

      Et remplacez-le par le code suivant :

      <property name="MainXslLink" type="string">/Style Library/XSL Style Sheets/ContentQueryMain-custom.xsl</property>

    3. Enregistrez les modifications, puis importez le Composant WebPart Contenu par requête.

Résolution des problèmes de mise en cache pour les flux RSS Composant WebPart Contenu par requête

Lors de l’utilisation de flux RSS Composant WebPart Contenu par requête, le flux RSS pour le Composant WebPart Contenu par requête sur lequel vous cliquez en premier peut persister de façon inattendue, vous empêchant de vous abonner à des flux nouveaux ou mis à jour et de les afficher.

Ceci se produit parce que le cache du Composant WebPart Formulaire de données, dont hérite le Composant WebPart Contenu par requête, génère la même clé de cache que celle qui est générée pour un composant WebPart créé dynamiquement, même si la propriété xsl est différente. Le Composant WebPart Contenu par requête réutilise donc les données de flux mises en cache depuis le premier chargement de la page.

Pour résoudre les problèmes de cache pour le flux RSS Composant WebPart Contenu par requête

  1. Créez des copies des fichiers Feed.aspx à l’emplacement indiqué par le chemin Program Files\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\LAYOUTS, puis renommez-les en Feed1.aspx, Feed2.aspx, etc.

  2. Modifiez votre fichier Rss.xsl, puis modifiez le paramètre xsl pour qu’il pointe vers le numéro de flux correspondant. Par exemple, indiquez xsl=1 pour Feed1.aspx et xsl=2 pour Feed2.aspx.

Voir aussi

Tâches

Procédure : Personnaliser le composant WebPart Contenu par requête à l’aide de propriétés personnalisées

Procédure : Afficher des champs personnalisés dans un composant WebPart Contenu par requête

Procédure : personnaliser le format RSS pour le composant WebPart Contenu par requête