RSS integrace

K čemu RSS integrace slouží

RSS integrace umožňuje ScreenSoftu načítat strukturovaný obsah z nakonfigurovaného RSS kanálu, připravit jeho média a distribuovat změny do zařízení přiřazených ke kanálu.

Jak synchronizace funguje

1. Server se připojí ke nakonfigurovanému RSS kanálu a načte jeho definici. Definice se uloží lokálně pro porovnání.
2. Nová média se stáhnou, podle potřeby převedou a připraví. Nepoužívaná média a položky se odstraní.
3. Pokud se nová definice liší od předchozí, aktualizovaná definice se odešle všem zařízením přiřazeným ke kanálu.
4. Zařízení stáhnou připravená média ze serveru a použijí aktualizovanou definici.

Jak ScreenSoft pozná změnu položky

• Nový guid, který v předchozí definici nebyl → nová položka; její média se stáhnou a připraví.
• guid z předchozí definice v nové chybí → položka je odstraněna a její média se odstraní.
• guid existuje v obou definicích, ale changeDate se liší → položka je změněna; stará média se odstraní a nová se stáhnou a připraví.

Význam hlavních vlastností

• guid – jedinečné ID položky; nemá se měnit a obvykle odpovídá ID záznamu v databázi.
• title – povinný název položky; nesmí být prázdný a může obsahovat HTML formátování.
• description – popis položky; může obsahovat HTML.
• category – název kategorie. Pokud je v celém kanálu jen jedna kategorie, výběr kategorie se v náhledu nezobrazuje.
• link – adresa webové stránky; v náhledu se zobrazuje jako QR kód pro mobilní zařízení.
• pubDate – datum a čas vytvoření položky.
• endDate – poslední den viditelnosti; pokud je aktuální čas zařízení pozdější, položka se skryje.
• changeDate – datum poslední změny. Položka zůstává cacheovaná podle guid; při změně se načte znovu.
• media:content – reprezentativní obrázek položky; vyžaduje URL a typ.
• media:group – kontejner pro jedno nebo více médií typu IMAGE, VIDEO, DOCUMENT, HTML nebo TEXT.

XML example

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

Item parameters

Media group entries

Image, Document, Video: media:content is required; url and type are required attributes; name is optional.

HTML: media:content contains Text / HTML and uses required type text/html.

Text: media:content uses required type text/plain and required description.

Supported content types