Procédure : personnaliser le format RSS pour le composant WebPart Requête de contenu

  • Article

Après avoir personnalisé le composant WebPart Requête de contenu pour afficher les champs et le contenu de votre choix, vous pouvez configurer le composant WebPart pour qu'il émette un flux RSS de ce contenu.

Cette rubrique explique comment ajouter et personnaliser les flux RSS qui diffusent du contenu de composant WebPart Requête de contenu :

  • Activation d'un flux RSS pour un composant WebPart Requête de contenu

  • Fonctionnement d'une URL de flux RSS

  • Utilisation d'un fichier .xsl personnalisé pour les flux RSS de composant WebPart Requête de contenu

  • Résolution des problèmes de mise en cache pour un flux RSS de composant WebPart Requête de contenu

Activation d'un flux RSS pour du contenu de composant WebPart Requête de contenu

Pour activer un flux RSS qui diffuse du contenu de composant WebPart Requête de contenu, 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 savoir comment personnaliser le format RSS pour le composant WebPart Requête de contenu, il est important de comprendre les différentes parties d'une URL de flux RSS ainsi que la façon dont ils interagissent. Considérons le format d'une URL de flux RSS : http://nom_serveur/_layouts/feed.aspx?xsl=fichiers .xsl inscrits dans le fichier Web.config&web=adresse_web&page=guid&wp=guid.

L'URL de flux inclut un chemin vers le fichier Feed.aspx, généré à partir du fichier Feed.xsl qui se trouve dans le dossier _layouts du serveur Microsoft Office SharePoint Server 2007. Le fichier Feed.aspx recherche le composant WebPart Requête de contenu qui émet le flux RSS, détermine la requête exécutée par le composant WebPart et utilise le fichier Feed.xsl du dossier _layoutspour produire le code XML du flux RSS.

Les valeurs spécifiées pour chaque paramètre fournissent des informations requises par Office SharePoint Server 2007 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 Requête de contenu qui émet le flux RSS

URL relative de serveur

Page

Page contenant le composant WebPart Requête de contenu qui émet le flux RSS

GUID

Wp

ID du composant WebPart Requête de contenu

GUID

Informations des paramètres XSL supplémentaires

La conception du composant WebPart Requête de contenu facilite l'administration des flux RSS ; Office SharePoint Server 2007 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 \Inetpub\wwwroot\wss\VirtualDirectories\numéro_port\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 de key de FeedXsl1 est mappée avec la valeur 1 du paramètre xsl dans l'URL de flux RSS.

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

Pour activer un flux RSS pour un composant WebPart Requête de contenu

  1. Modifiez le composant WebPart Requête de contenu.

  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 de composant WebPart Requête de contenu

Vous pouvez utiliser un fichier .xsl personnalisé pour des flux RSS de composant WebPart Requête de contenu en procédant de l'une des façons suivantes :

  • En éditant le fichier Rss.xsl par défaut qui est inclus avec Office SharePoint Server 2007 ; ceci permet de s'assurer que tous les composants WebPart Requête de contenu 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 Requête de contenu 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 de l'ordinateur serveur où Office SharePoint Server 2007 est installé.

  • 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 Requête de contenu spécifique. Utilisez cette option si vous avez besoin de droits d'administrateur local sur le serveur Office SharePoint Server 2007 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 à émettre 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 Requête de contenu en éditant le fichier ItemXslLink.xsl associé au fichier de définition de composant WebPart (.wpd).

  3. Editez 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 émet le flux RSS pour le composant WebPart Requête de contenu en copiant le fichier ContentQueryMain.xsl et en téléchargeant la copie vers la Bibliothèque de styles.

  5. Éditez la copie du fichier ContentQueryMain.xsl et modifiez le code suivant :

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

    en :

    <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 Requête de contenu utilise la copie du fichier ContentQueryMain.xsl en éditant la propriété du composant WebPart Requête de contenu qui détermine quel fichier Main.xsl est utilisé.

    1. Recherchez le composant WebPart Requête de contenu sur une page et exportez-le.

    2. Éditez la propriété MainXslLink. Modifiez le code suivant :

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

      en :

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

    3. Enregistrez les modifications et importez le composant WebPart Requête de contenu.

Résolution des problèmes de mise en cache pour les flux RSS de composant WebPart Requête de contenu

Lors de l'utilisation de flux RSS de composant WebPart Requête de contenu, le flux RSS 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 Requête de contenu, 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 Requête de contenu 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 de composant WebPart Requête de contenu

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

  2. Éditez 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

Autres ressources

Procédure : personnaliser le composant WebPart Requête de contenu à l'aide des propriétés personnalisées
Procédure : afficher des champs personnalisés dans un composant WebPart Requête de contenu
Procédure : personnaliser le format RSS pour le composant WebPart Requête de contenu