Integrazione RSS

Riferimento tecnico

Come funziona la sincronizzazione

1. Il server recupera il feed RSS configurato e confronta gli identificatori degli elementi e changeDate values with the stored records.
2. Vengono elaborati gli elementi nuovi e modificati. Il server ne scarica i contenuti multimediali e li invia al servizio file per l'archiviazione e l'eventuale conversione; elementi e contenuti multimediali inutilizzati vengono rimossi.
3. Il server comunica al portale il rilevamento di una modifica. Il portale predispone quindi l'invio dei dati aggiornati ai dispositivi che utilizzano il canale.
4. Ogni dispositivo salva i dati ricevuti e scarica separatamente gli allegati necessari. La ricezione di una definizione non conferma di per sé il completamento di tutti i download multimediali.

Consulti Configurazione dell'applicazione RSS per l'intervallo di controllo del feed e l'assegnazione delle applicazioni. Gli aggiornamenti non sono immediati: preparazione dei contenuti multimediali e connessione dei dispositivi influiscono sulla consegna.

La sincronizzazione qui descritta presuppone un feed con almeno un elemento valido. Non consideri lo svuotamento del feed un modo garantito per interrompere la visualizzazione dei suoi contenuti.

Come il sistema rileva le modifiche degli elementi

• A guid in the new definition that was not in the old one → new item; its media are downloaded and prepared.
• Un precedente guid missing from the new definition → removed item; its media are removed.
• Il guid exists in both but changeDate differs → changed item; old media are removed and new media downloaded and prepared.

Quando modifica titolo, descrizione, collegamento o allegato, mantenga il guid and change changeDate. Questo vale anche quando sostituisce un file mantenendo lo stesso URL. Il solo riordinamento degli elementi potrebbe non avviare l'invio di una nuova definizione; aggiorni anche changeDate to have the change delivered.

Proprietà principali

• guid: Un identificatore univoco e stabile dell'elemento, come l'ID di un record nel database. Lo mantenga quando modifica il contenuto.
• title: Un titolo obbligatorio e non vuoto. Sono accettati tag HTML, ma l'elenco e l'intestazione dei dettagli mostrano testo semplice.
• description: La descrizione dell'elemento. Può contenere HTML; la visualizzazione formattata dipende dalle impostazioni dell'applicazione RSS.
• category: Un nome di categoria utilizzato per il filtro. Il selettore delle categorie compare quando il canale ha almeno una categoria non vuota.
• link: L'URL assoluto di una pagina web correlata. Un collegamento che inizia con http viene mostrato anche come codice QR nei dettagli dell'elemento per l'utilizzo su un dispositivo mobile.
• pubDate: Data e ora di creazione dell'elemento. Non ne pianificano la pubblicazione: una data futura non impedisce la visualizzazione dell'elemento.
• endDate: Data e ora di fine validità dell'elemento. L'impostazione di questo campo non garantisce la rimozione immediata dalla visualizzazione in base all'orologio del dispositivo, soprattutto se questo è offline. Non vi faccia affidamento come unico meccanismo per contenuti che devono smettere di apparire a un'ora esatta.
• changeDate: Data e ora dell'ultima modifica del contenuto. Il sistema le confronta insieme a guid; utilizzi un valore diverso a ogni aggiornamento.
• media:content: L'immagine rappresentativa dell'elemento, al di fuori del gruppo di allegati. Fornisca gli attributi url e type.
• content, image: Il parser accetta anche questi nomi di tag con gli stessi attributi multimediali. Il tag image funge da alternativa quando l'URL multimediale principale non è stato impostato. Utilizzi preferibilmente media:content; questo alias non supporta strutture image/url annidate arbitrarie.
• media:group: Il gruppo di allegati dell'elemento: immagini, video, documenti e contenuti HTML incorporati.

Formati di data e ora

Utilizzi un valore come 2026-10-17 08:30:00. The parser also accepts T or t between the date and time, a date such as 17.10.2026, and RSS dates such as Sat, 17 Oct 2026 08:30:00 +0200.

I valori vengono gestiti come date e ore locali. Lo scostamento UTC fornito non viene usato per convertirli in UTC: utilizzi quindi in modo coerente un unico fuso orario concordato. Il parser verificato non supporta timestamp ISO 8601 terminanti in Z.

Esempio 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>Ultime offerte</title>
            <description>Informazioni sulle nostre offerte attuali</description>
            <category>Notizie</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="Dettagli dell’offerta" type="application/pdf"/>
                <media:content type="text/html"><![CDATA[<h1>Dettagli</h1><p>Ulteriori informazioni su questa offerta.</p>]]></media:content>
            </media:group>
        </item>
    </channel>
</rss>

Gli indirizzi example.org sono segnaposto. Li sostituisca con URL reali accessibili al server RSS. L'esempio base omette endDate affinché l'elemento di esempio non scada automaticamente.

Parametri degli elementi

La tabella definisce il formato richiesto per l'integrazione. La tolleranza del parser verso campi mancanti non sostituisce dati compilati correttamente. Fornisca e aggiorni changeDate when updating an existing item.

Voci del gruppo multimediale

Immagine, documento o video: aggiunga un media:content element to the group and provide its url and type attributes. The optional name attribute supplies an attachment label.

HTML o testo semplice: utilizzi media:content type="text/html" and place the content directly inside the element, for example as an HTML fragment in CDATA. A simple paragraph is sufficient for plain text. Displaying an HTML attachment does not provide a full web application; this specification does not guarantee JavaScript execution.

Limitazione degli allegati testuali: autonomo text/plain attachments are not processed correctly by the verified implementation. Use the text/html form shown above for a text attachment.

Tipi di contenuto supportati

Questi sono i formati di allegato in ingresso che il sistema archivia o prepara per la visualizzazione, in base al tipo. La riuscita dell'elaborazione dipende anche dal contenuto effettivo e dalla codifica del file; il solo tipo MIME corretto non conferma che la conversione sia terminata.