RSS integrácia

Na čo RSS integrácia slúži

RSS integrácia umožňuje ScreenSoftu načítať štruktúrovaný obsah z nakonfigurovaného RSS kanálu, pripraviť jeho médiá a distribuovať zmeny do zariadení priradených ku kanálu.

Ako synchronizácia funguje

1. Server sa pripojí k nakonfigurovanému RSS kanálu a načíta jeho definíciu. Definícia sa uloží lokálne pre porovnanie.
2. Nové médiá sa stiahnu, podľa potreby prevedú a pripravia. Nepoužívané médiá a položky sa odstránia.
3. Ak sa nová definícia líši od predchádzajúcej, aktualizovaná definícia sa odošle všetkým zariadeniam priradeným ku kanálu.
4. Zariadenia stiahnu pripravené médiá zo servera a použijú aktualizovanú definíciu.

Ako ScreenSoft pozná zmenu položky

• Nový guid, ktorý v predchádzajúcej definícii nebol → nová položka; jej médiá sa stiahnu a pripravia.
• guid z predchádzajúcej definície v novej definícii chýba → položka je odstránená a jej médiá sa odstránia.
• guid existuje v oboch definíciách, ale changeDate sa líši → položka je zmenená; staré médiá sa odstránia a nové sa stiahnu a pripravia.

Význam hlavných vlastností

• guid – jedinečné ID položky; nemá sa meniť a zvyčajne zodpovedá ID záznamu v databáze.
• title – povinný názov položky; nesmie byť prázdny a môže obsahovať HTML formátovanie.
• description – popis položky; môže obsahovať HTML.
• category – názov kategórie. Ak je v celom kanáli iba jedna kategória, výber kategórie sa v náhľade nezobrazuje.
• link – adresa webovej stránky; v náhľade sa zobrazuje ako QR kód pre mobilné zariadenie.
• pubDate – dátum a čas vytvorenia položky.
• endDate – posledný deň viditeľnosti; ak je aktuálny čas zariadenia neskorší, položka sa skryje.
• changeDate – dátum poslednej zmeny. Položka zostáva uložená vo vyrovnávacej pamäti podľa guid; pri zmene sa načíta znova.
• content, image – alternatívny zápis s rovnakým významom ako media:content.
• media:content – reprezentatívny obrázok položky; vyžaduje URL a typ.
• media:group – kontajner pre jedno alebo viac médií typu IMAGE, VIDEO, DOCUMENT, HTML alebo TEXT.

XML príklad

<?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>

Parametre položky

Položky mediálnej skupiny

Obrázok, dokument, video: media:content je povinný; url a type sú povinné atribúty; name je voliteľný.

HTML: media:content obsahuje Text / HTML a používa povinný typ text/html.

Text: media:content používa povinný typ text/plain a povinný atribút description.

Podporované typy obsahu