RSS integracija

Čemu služi RSS integracija

RSS integracija omogućava ScreenSoftu da preuzme strukturirani sadržaj iz podešenog RSS kanala, pripremi njegove medije i distribuira promjene definicije uređajima povezanim s tim kanalom.

Kako radi sinhronizacija

1. Server se povezuje sa svakim podešenim RSS kanalom, preuzima njegovu definiciju i sprema lokalnu kopiju radi poređenja.
2. Novi medijski fajlovi se preuzimaju, po potrebi konvertuju i pripremaju. Nekorišteni mediji i stavke se uklanjaju.
3. Ako se trenutna definicija razlikuje od prethodne, ažurirana definicija šalje se svakom uređaju povezanom s kanalom.
4. Uređaji preuzimaju pripremljene medije sa servera i koriste ažuriranu definiciju.

Kako ScreenSoft otkriva promjene stavki

• Novi guid u novoj definiciji koji nije postojao u staroj → nova stavka; njeni mediji se preuzimaju i pripremaju.
• Prethodni guid nedostaje u novoj definiciji → uklonjena stavka; njeni mediji se uklanjaju.
• guid postoji u obje definicije, ali se changeDate razlikuje → promijenjena stavka; stari mediji se uklanjaju, a novi preuzimaju i pripremaju.

Glavna svojstva

• guid – jedinstveni ID stavke; nikada ga ne mijenjajte, obično koristite ID zapisa iz baze podataka.
• title – obavezni naslov; ne smije biti prazan i može koristiti HTML formatiranje.
• description – opis stavke; opcionalno HTML formatiranje.
• category – naziv kategorije stavke; ako u cijelom kanalu postoji samo jedna kategorija, birač kategorije skriven je u pregledu.
• link – adresa web-stranice; u pregledu se prikazuje kao QR kod za mobilni uređaj.
• pubDate – datum/vrijeme kreiranja stavke.
• endDate – posljednji dan vidljivosti; nakon tog vremena stavka na uređaju postaje nevidljiva.
• changeDate – vrijeme posljednje promjene; stavka se kešira prema guid i ponovo preuzima kada se promijeni.
• content, image – alternativni zapis s istim značenjem kao media:content.
• media:content – slika koja predstavlja stavku; URL i vrsta su obavezni.
• media:group – spremnik za jedan ili više medijskih zapisa vrsta IMAGE, VIDEO, DOCUMENT, HTML ili TEXT.

XML primjer

<?xml version="1.0"?>
<rss version="2.0" xmlns:media="http://search.yahoo.com/mrss/">
    <channel>
        <item>
            <guid>661e4533afef0661e4533afef4</guid>
            <title>20% discount</title>
            <description>Grocery from local distributors</description>
            <category/>
            <pubDate>2024-04-16 00:00:00</pubDate>
            <endDate>2024-05-21 00:00:00</endDate>
            <changeDate>2024-04-15 16:00:01</changeDate>
            <link>https://.../661e4533afef0661e4533afef4/</link>
            <media:content url="https://.../6533afef4.jpg" type="image/jpeg"/>
            <media:group>
                <media:content url="https://.../JHR0906799.pdf" name="Document name" type="application/pdf"/>
                <media:content description="Long information text ..." type="text/plain"/>
                <media:content type="text/html"><![CDATA[<h1>Title</h1><p>HTML formatted text</p>]]></media:content>
            </media:group>
        </item>
    </channel>
</rss>

Parametri stavke

Stavke medijske grupe

Slika, dokument, video: element media:content je obavezan; url i type su obavezni atributi; atribut name nije obavezan.

HTML: media:content sadrži tekst / HTML i koristi obavezni tip text/html.

Tekst: media:content koristi obavezni tip text/plain i obavezni atribut description.

Podržani tipovi sadržaja