RSS Reader Vue d'ensemble
RSS Reader transforme un nombre quelconque de flux en une seule liste d'éléments. Cet article explique aux éditeurs et aux administrateurs les mécanismes qui se cachent derrière cette liste : ce qu'est une source et quels formats de flux fonctionnent, comment les éléments de plusieurs flux sont fusionnés et triés, à quelle fréquence ils sont actualisés et comment le cache du navigateur fait apparaître le composant WebPart instantanément. Les paramètres eux-mêmes se trouvent dans les groupes Flux d’actualités et Comportement du volet de propriétés ; les étapes de configuration sont décrites dans KB10367. Comment ajouter et configurer le composant WebPart RSS Reader.
Sources
Une source est un flux doté de trois attributs, modifiés dans le volet Sources du groupe Flux d’actualités :
| Champ | Signification |
|---|---|
| URL | L'adresse du flux — le document XML, et non le site web. Obligatoire. |
| Afficher le nom | Le nom de la source tel que les lecteurs le voient : sur son onglet dans la rangée des sources et dans le regroupement By source. Obligatoire. |
| Ordre | La position de la source parmi les autres (1, 2, 3…). Détermine l'ordre des onglets et des groupes dans l'ordre de tri By source. |
Il n'y a pas de limite au nombre de sources, mais chaque source est téléchargée à chaque chargement et à chaque actualisation ; une liste d'une douzaine de flux très actifs met donc plus de temps à apparaître et produit plus d'éléments que la limite Éléments affichés ne peut en afficher. Trois à six sources par composant WebPart constituent une plage pratique ; répartissez les ensembles plus importants sur plusieurs composants WebPart ou plusieurs pages.
Les adresses des sources sont stockées dans les propriétés du composant WebPart, à l'intérieur de la page. Dans Microsoft Teams, l'application personnelle utilise le jeu de sources enregistré par l'administrateur avec Enregistrer les paramètres ; un onglet de canal possède son propre jeu.
Formats de flux et éléments pris en charge
Les flux sont téléchargés et analysés par le service de flux Vitextra, qui renvoie les éléments sous une forme normalisée (voir Comment les flux sont chargés ci-dessous). Le service gère les formats de syndication courants — RSS et Atom — et lit les extensions que les éditeurs utilisent pour enrichir leurs éléments :
| Donnée d'un élément | D'où elle provient |
|---|---|
| Titre et lien | Le titre et le lien de l'élément RSS ou Atom |
| Description | La description ou le résumé de l'élément, débarrassé de son balisage HTML |
| Date de publication | La date de publication de l'élément ; les éléments sans date valide sont affichés sans date |
| Image | Media RSS media:content ou media:thumbnail, pochette iTunes, ou la première image dans le HTML de la description (les images de suivi d'un pixel sont ignorées) |
| Auteur | Dublin Core dc:creator, l'élément auteur du flux, ou Media RSS media:credit — dans cet ordre |
| Catégories | Les éléments de catégorie de l'élément |
Un flux qui ne propose aucune de ces extensions fonctionne quand même : le composant WebPart affiche le titre, la description et la date.
Comment les flux sont chargés
Un script exécuté dans le navigateur ne peut pas télécharger un flux depuis un autre site web, sauf si ce site autorise les requêtes cross-origin, ce que les éditeurs de flux ne font presque jamais. RSS Reader envoie donc la liste des adresses des sources au service de flux Vitextra, qui télécharge les flux depuis Internet, les analyse et renvoie les canaux et les éléments au navigateur. Le navigateur de l'utilisateur ne se connecte jamais aux serveurs des éditeurs pour le flux lui-même — uniquement pour les images des éléments, qui sont chargées directement depuis l'éditeur.
Deux conséquences pour les administrateurs :
- un flux doit être accessible depuis Internet : un flux hébergé sur un serveur intranet ou derrière un VPN ne peut pas être affiché ;
- les navigateurs des utilisateurs doivent avoir accès à
vitextra.com; la requête contient les adresses des sources et les mêmes identifiants techniques que la vérification de licence de tout composant WebPart Vitextra (voir KB10374. Confidentialité et sécurité dans RSS Reader : comment les flux sont chargés et ce qui est envoyé).
Sources qui ne peuvent pas être chargées
Si l'une des sources ne peut pas être téléchargée ou analysée — l'adresse est erronée, le serveur est hors service, le document est une page web plutôt qu'un flux, le XML est corrompu —, le service de flux la marque comme indisponible et renvoie les autres. Le composant WebPart, dans ce cas :
- laisse la source indisponible en dehors de la liste fusionnée,
- masque son onglet dans la rangée des sources,
- n'affiche aucune erreur — les autres flux sont affichés normalement.
La source réapparaît automatiquement au chargement suivant lorsque le flux est de nouveau disponible. Comme l'omission est silencieuse, un éditeur qui a mal saisi une adresse ne verra aucun avertissement ; le seul signe est un onglet manquant. Ouvrez l'adresse dans un navigateur pour la vérifier : un flux fonctionnel affiche du XML (ou une page de flux mise en forme), une adresse erronée affiche un site web ou une erreur. Si toutes les sources échouent, le composant WebPart affiche Aucun élément trouvé. ; si le service de flux lui-même ne peut pas être joint, il affiche Désolé, nous avons rencontré un problème. Veuillez actualiser la page, puis réessayer. — voir KB10373. Pourquoi mon flux RSS ne se charge-t-il pas ? Dépannage de RSS Reader.
Fusion et tri
Les éléments de toutes les sources sont fusionnés en une seule liste, puis triés selon l'option Sort order (ordre de tri) du groupe Comportement :
| Ordre de tri | Résultat |
|---|---|
| Newest first (par défaut) | Tous les éléments de toutes les sources par date de publication, les plus récents en haut |
| Oldest first | La même liste inversée — les plus anciens d'abord, pour les chronologies et les archives |
| By source | Les éléments regroupés par source selon l'Ordre des sources ; du plus récent au plus ancien au sein de chaque groupe |
Avec Newest first, une source très active peut évincer les autres de la liste : si un flux publie vingt éléments par jour et un autre deux par semaine, le haut de la liste est occupé par le flux actif. Trois façons de garder l'équilibre : utiliser By source, augmenter Éléments affichés, ou activer le commutateur Filtres pour que les lecteurs puissent sélectionner la source discrète sur son onglet.
Les dates sont comparées en tant que véritables horodatages. Les éléments dont le flux ne fournit aucune date de publication valide sont traités comme les plus anciens : ils arrivent en dernier avec Newest first et en premier avec Oldest first, et le composant WebPart n'affiche aucune date pour eux.
Les sélections du lecteur — un onglet de source, des balises de catégorie, le texte de recherche — sont appliquées après le tri, et la limite Éléments affichés est appliquée en dernier ; le composant WebPart affiche donc les N premiers éléments de la liste filtrée et triée.
Actualisation automatique
Lorsque Actualiser automatiquement est activé, le composant WebPart recharge les flux toutes les Fréquence d'actualisation minutes (1–7) tant que la page est ouverte. L'actualisation est silencieuse : les espaces réservés de chargement ne sont pas affichés, la liste est remplacée sur place, et l'onglet de source, les puces de catégorie et le texte de recherche actuels du lecteur sont conservés. Si une actualisation échoue — le réseau est hors service, le service de flux est indisponible —, le composant WebPart continue d'afficher les éléments qu'il possède déjà et réessaie à l'intervalle suivant.
Désactivez l'actualisation automatique pour les pages que les gens ouvrent brièvement, et activez-la pour les pages qui restent ouvertes longtemps : un panneau d'actualités sur un écran dans le hall d'accueil, un tableau de bord qu'une équipe d'exploitation garde ouvert toute la journée. L'intervalle s'applique par composant WebPart ; deux RSS Reader sur une même page s'actualisent indépendamment.
📝 Remarque
Chaque actualisation est une requête au service de flux, et le service télécharge chaque source pour y répondre. Un intervalle d'une minute sur une page qu'une centaine de personnes gardent ouverte représente six mille requêtes de flux par heure. N'utilisez l'intervalle le plus court que là où la fraîcheur en vaut la peine, et trois à cinq minutes ailleurs.
Le cache du navigateur
Après chaque chargement réussi, le composant WebPart stocke les éléments reçus dans le stockage de session du navigateur, indexés par le jeu d'adresses des sources. Lorsque la même page est rouverte dans la même session d'onglet du navigateur, le composant WebPart affiche les éléments en cache immédiatement et en demande de nouveaux en arrière-plan ; la liste est mise à jour dès leur arrivée. Le cache est utilisé pendant 30 minutes au plus, après quoi les éléments sont chargés normalement.
Ce que cela signifie en pratique :
- la première visite d'une page dans une session de navigateur affiche des espaces réservés pendant une seconde ou deux ; les visites suivantes affichent le contenu immédiatement ;
- le cache appartient à la session de l'onglet du navigateur et disparaît à la fermeture de l'onglet — rien n'est conservé sur l'appareil au-delà ;
- un changement des sources invalide le cache, car la clé est construite à partir des adresses ;
- si une actualisation échoue, les éléments en cache restent à l'écran et le message d'erreur n'est affiché que lorsqu'il n'y a absolument rien à afficher.
Le cache contient les éléments de flux tels qu'ils ont été reçus du service de flux — titres, descriptions, liens, adresses des images — et aucune donnée personnelle. Sur un ordinateur partagé, il est effacé avec les autres données de site de la session du navigateur.
