Intégration RSS

Référence technique

Fonctionnement de la synchronisation

1. Le serveur récupère le flux RSS configuré et compare les identifiants des éléments et les valeurs de changeDate aux enregistrements stockés.
2. Les éléments nouveaux et modifiés sont traités. Le serveur télécharge leurs médias et les transmet au service de fichiers pour stockage et conversion éventuelle ; les éléments et médias inutilisés sont nettoyés.
3. Le serveur informe le portail d’une modification détectée. Le portail organise ensuite la transmission des données actualisées aux appareils utilisant ce canal.
4. Chaque appareil enregistre les données reçues et télécharge séparément les pièces jointes nécessaires. La réception d’une définition ne confirme pas, à elle seule, la fin de tous les téléchargements de médias.

Consultez Configuration d’une application RSS pour l’intervalle de vérification du flux et l’attribution de l’application. Les mises à jour ne sont pas immédiates : la préparation des médias et la connexion des appareils affectent aussi la transmission.

La synchronisation décrite suppose un flux contenant au moins un élément valide. Ne comptez pas sur le vidage du flux comme moyen garanti d’arrêter l’affichage de ses contenus.

Détection des modifications d’éléments

• Un guid dans la nouvelle définition mais absent de l’ancienne → nouvel élément ; ses médias sont téléchargés et préparés.
• Un ancien guid absent de la nouvelle définition → élément supprimé ; ses médias sont retirés.
• Le guid existe dans les deux, mais changeDate diffère → élément modifié ; les anciens médias sont retirés et les nouveaux téléchargés et préparés.

Lorsque vous modifiez un titre, une description, un lien ou une pièce jointe, conservez la valeur de guid et modifiez changeDate. Cela s’applique aussi au remplacement d’un fichier à URL inchangée. Réordonner les éléments ne déclenche pas forcément l’envoi d’une nouvelle définition ; mettez aussi à jour changeDate pour transmettre la modification.

Propriétés principales

• guid: Un identifiant unique et stable de l’élément, comme l’ID d’un enregistrement de base de données. Conservez-le lors des modifications.
• title: Un titre obligatoire et non vide. Les balises HTML sont acceptées, mais la liste et le titre détaillé affichent du texte brut.
• description: La description de l’élément. Elle peut contenir du HTML ; l’affichage formaté dépend des paramètres de l’application RSS.
• category: Un nom de catégorie utilisé pour filtrer. Le sélecteur apparaît si le canal contient au moins une catégorie non vide.
• link: L’URL absolue d’une page associée. Un lien commençant par http apparaît aussi sous forme de QR code dans les détails pour un usage mobile.
• pubDate: La date et l’heure de création. Elles ne programment pas sa publication : une date future n’empêche pas son affichage.
• endDate: La date et l’heure de fin de validité. Ce champ ne garantit pas une disparition immédiate selon l’horloge de l’appareil, surtout hors connexion. Ne vous fiez pas à lui seul pour des contenus devant disparaître à une heure exacte.
• changeDate: La date et l’heure de la dernière modification. Le système les compare avec guid ; utilisez une valeur différente à chaque mise à jour.
• media:content: L’image représentative de l’élément, hors du groupe de pièces jointes. Fournissez les attributs url et type.
• content, image: Le parseur accepte aussi ces noms de balises avec les mêmes attributs média. La balise image sert de repli si l’URL média principale n’est pas définie. Privilégiez media:content ; cet alias ne prend pas en charge les structures image/url imbriquées arbitraires.
• media:group: Le groupe de pièces jointes de l’élément : images, vidéos, documents et contenu HTML intégré.

Formats de date et d’heure

Utilisez une valeur comme 2026-10-17 08:30:00. Le parseur accepte aussi T ou t entre la date et l’heure, une date comme 17.10.2026, et des dates RSS comme Sat, 17 Oct 2026 08:30:00 +0200.

Les valeurs sont traitées comme des dates et heures locales. Le décalage UTC fourni ne sert pas à les convertir en UTC ; utilisez donc systématiquement un fuseau convenu. Le parseur vérifié ne prend pas en charge les horodatages ISO 8601 se terminant par Z.

Exemple XML

<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:media="http://search.yahoo.com/mrss/">
    <channel>
        <item>
            <guid>offer-001</guid>
            <title>Dernières offres</title>
            <description>Informations sur nos offres actuelles</description>
            <category>Actualités</category>
            <pubDate>2026-10-17 08:00:00</pubDate>
            <changeDate>2026-10-17 08:30:00</changeDate>
            <link>https://example.org/offers/offer-001/</link>
            <media:content url="https://example.org/media/offer-001.jpg" type="image/jpeg"/>
            <media:group>
                <media:content url="https://example.org/media/offer-001.pdf" name="Détails de l’offre" type="application/pdf"/>
                <media:content type="text/html"><![CDATA[<h1>Détails</h1><p>Plus d’informations sur cette offre.</p>]]></media:content>
            </media:group>
        </item>
    </channel>
</rss>

Les adresses example.org sont des espaces réservés. Remplacez-les par des URL réelles accessibles au serveur RSS. L’exemple de base omet endDate pour que l’élément n’expire pas automatiquement.

Paramètres des éléments

Le tableau définit le format d’intégration requis. La tolérance du parseur aux champs absents ne remplace pas des données correctement renseignées. Fournissez et modifiez changeDate lors de la mise à jour d’un élément existant.

Éléments du groupe de médias

Image, document ou vidéo : ajoutez un élément media:content au groupe et fournissez ses attributs url et type. L’attribut facultatif name fournit le libellé de la pièce jointe.

HTML ou texte brut : utilisez media:content type="text/html" et placez le contenu directement dans l’élément, par exemple comme fragment HTML dans CDATA. Un simple paragraphe suffit pour du texte brut. Afficher une pièce jointe HTML ne fournit pas une application web complète ; cette spécification ne garantit pas l’exécution de JavaScript.

Limitation des pièces jointes texte : les pièces jointes autonomes text/plain ne sont pas correctement traitées par l’implémentation vérifiée. Pour une pièce jointe texte, utilisez la forme text/html présentée ci-dessus.

Types de contenus pris en charge

Il s’agit des formats d’entrée de pièces jointes que le système stocke ou prépare pour l’affichage selon leur type. La réussite dépend aussi du contenu réel et de l’encodage des fichiers ; un type MIME correspondant ne confirme pas à lui seul la fin de la conversion.