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 :

ChampSignification
URLL'adresse du flux - le document XML, et non le site web. Obligatoire.
Nom d’affichageLe nom de la source tel que les lecteurs le voient : sur son onglet dans la rangée des sources et dans le regroupement Par source. Obligatoire.
OrdreLa position de la source parmi les autres (1, 2, 3…). Détermine l'ordre des onglets et des groupes dans l'ordre de tri Par 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émentD'où elle provient
Titre et lienLe titre et le lien de l'élément RSS ou Atom
DescriptionLa description ou le résumé de l'élément, débarrassé de son balisage HTML
Date de publicationLa date de publication de l'élément ; les éléments sans date valide sont affichés sans date
ImageMedia 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)
AuteurDublin Core dc:creator, l'élément auteur du flux, ou Media RSS media:credit - dans cet ordre
CatégoriesLes é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. 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 :

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 et qu’aucune donnée précédente ou de cache valide n’est disponible, 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 Ordre de tri du groupe Comportement :

Ordre de triRésultat
Les plus récents d’abord (par défaut)Tous les éléments de toutes les sources par date de publication, les plus récents en haut
Les plus anciens d’abordLa même liste inversée - les plus anciens d'abord, pour les chronologies et les archives
Par sourceLes éléments regroupés par source selon l'Ordre des sources ; du plus récent au plus ancien au sein de chaque groupe

Le groupe Comportement

Le groupe Comportement

Un flux très actif peut remplir toute la liste affichée et masquer les sources moins actives. Le regroupement par source ne garantit pas l’équilibre : la première source peut atteindre à elle seule la limite d’éléments. Augmentez le nombre d’éléments affichés ou activez les onglets de source pour permettre aux lecteurs d’en choisir une autre.

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 Les plus récents d’abord et en premier avec Les plus anciens d’abord, 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 selon l’intervalle de 1 à 7 minutes défini dans Fréquence d'actualisation 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 un chargement réussi, le composant enregistre les éléments dans le stockage de session du navigateur, avec le jeu d’adresses des flux comme clé. À la réouverture, un cache correspondant datant de 30 minutes au plus peut apparaître immédiatement pendant le chargement des éléments récents en arrière-plan. Les entrées plus anciennes sont ignorées, mais ne sont pas supprimées automatiquement après 30 minutes.

Ce que cela signifie en pratique :

  • sans cache valide, le composant WebPart affiche des espaces réservés jusqu’à l’arrivée des données ; la durée dépend du réseau et du service de flux ;
  • le cache utilise le stockage de session de l’onglet ; la restauration de la session du navigateur peut le restaurer, donc fermer l’onglet ne garantit pas un effacement définitif ;
  • 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.

Questions et réponses

Posez une question sur cet article et obtenez une réponse officielle de notre équipe.

Aucune question pour le moment. Posez la première !

Articles à la une

Référence des listes et des colonnes de Discussions

Référence complète des listes SharePoint que le composant WebPart Vitextra Discussions crée sur un site - Forums de discussion, Sujets de discussion, Publications de discussion, Abonnements aux discussions et la bibliothèque Ressources de discussion - avec chaque colonne Vtx : nom d'affichage, nom interne, type, index, valeur par défaut et valeurs de choix autorisées, comment les listes sont reconnues par des colonnes marqueurs, les paramètres de liste appliqués à la création, quelles colonnes le composant WebPart tient à jour et lesquelles vous pouvez modifier sans risque.

56 13 min
Affichages d’Employee Directory : liste et fiches, taille des fiches, champs des fiches et regroupement

Comment choisir entre l’affichage « Détails » (liste) et « Fiche contact » (fiches) dans les composants WebPart Vitextra Employee Directory, définir la taille et les champs des fiches, configurer les colonnes et la liste compacte, regrouper les employés par colonne, attribut personnalisé ou première lettre du nom, et afficher la zone de recherche et les totaux.

105 9 min
Comment définir les droits annuels et les jours reportés

Comment attribuer à chaque employé un droit annuel individuel et des jours reportés dans Vitextra Absence & Coverage : la liste Balances, comment une ligne est rattachée à une personne, un type et une année, comment trouver le TypeId, exemples de calcul et ce que les employés voient sur leurs cartes de solde.

92 5 min

Partager