RSS integrácia

Technická dokumentácia

Ako synchronizácia funguje

1. Server načíta nakonfigurovaný RSS zdroj a porovná identifikátory položiek a hodnoty changeDate s uloženými údajmi.
2. Nové a zmenené položky sa spracujú. Server stiahne ich médiá a odovzdá ich súborovej službe na uloženie a prípadnú konverziu; nepoužívané položky a médiá priebežne odstraňuje.
3. O rozpoznanej zmene server informuje portál, ktorý zabezpečí odoslanie aktualizovaných údajov zariadeniam používajúcim daný kanál.
4. Zariadenie uloží prijaté údaje a samostatne sťahuje potrebné prílohy. Prijatie definície samo osebe nepotvrdzuje dokončenie sťahovania všetkých médií.

Interval kontroly zdroja a priradenie RSS aplikácie opisuje návod Konfigurácia RSS aplikácie. Aktualizácia nie je okamžitá; závisí aj od prípravy médií a pripojenia zariadenia.

Opísaná synchronizácia predpokladá zdroj s aspoň jednou platnou položkou. Úplné vyprázdnenie kanála nepovažujte za zaručený spôsob ukončenia zobrazovania obsahu.

Ako systém 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.

Pri zmene názvu, popisu, odkazu alebo príloh zachovajte guid a zmeňte changeDate. Rovnaké pravidlo platí pri nahradení súboru na nezmenenej URL. Samotná zmena poradia položiek nemusí vyvolať odoslanie novej definície; na doručenie zmeny použite aj changeDate.

Význam hlavných vlastností

• guid: Jedinečný a stabilný identifikátor položky, napríklad ID záznamu v databáze. Zachovajte ho aj pri úprave obsahu.
• title: Povinný neprázdny názov. Môže obsahovať značky HTML; v zozname a nadpise detailu sa zobrazuje ako obyčajný text.
• description: Popis položky. Môže obsahovať HTML; jeho formátované zobrazenie závisí od nastavenia RSS aplikácie.
• category: Názov kategórie na filtrovanie. Výber kategórie sa zobrazí, ak kanál obsahuje aspoň jednu neprázdnu kategóriu.
• link: Absolútna adresa súvisiacej webovej stránky. Odkaz začínajúci na http sa v detaile zobrazuje aj ako QR kód pre mobilné zariadenie.
• pubDate: Dátum a čas vytvorenia položky. Nejde o nastavenie odloženého zobrazenia; budúci dátum sám osebe zobrazenie nezablokuje.
• endDate: Dátum a čas konca platnosti. Samotné vyplnenie tohto poľa nezaručuje okamžité skrytie položky podľa času zariadenia, najmä pri výpadku pripojenia. Nepoužívajte ho ako jediný mechanizmus pre obsah, ktorý sa musí prestať zobrazovať v presne určenom čase.
• changeDate: Dátum a čas poslednej zmeny obsahu. Systém ho porovnáva spolu s guid; pri každej obsahovej zmene použite odlišnú hodnotu.
• media:content: Reprezentatívny obrázok položky mimo skupiny príloh. Použite atribúty url a type.
• content, image: Parser prijíma aj tieto názvy tagov s rovnakými mediálnymi atribútmi. Tag image je náhradou, ak ešte nie je nastavená URL hlavného média. Odporúčaný zápis je media:content; nejde o podporu ľubovoľnej vnorenej štruktúry image/url.
• media:group: Skupina príloh položky: obrázky, videá, dokumenty a vložený obsah HTML.

Zápis dátumu a času

Používajte napríklad 2026-10-17 08:30:00. Podporované je aj oddelenie dátumu a času znakom T alebo t, dátum v tvare 17.10.2026 a zápis RSS, napríklad Sat, 17 Oct 2026 08:30:00 +0200.

Hodnoty sa spracúvajú ako miestny dátum a čas. Uvedený časový posun sa neprepočítava do UTC, preto používajte jednotné dohodnuté časové pásmo. Zápis ISO 8601 končiaci znakom Z nie je v overenom parseri podporovaný.

XML príklad

<?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>Novinky v ponuke</title>
            <description>Informácie o aktuálnej ponuke</description>
            <category>Novinky</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="Podrobnosti ponuky" type="application/pdf"/>
                <media:content type="text/html"><![CDATA[<h1>Podrobnosti</h1><p>Ďalšie informácie o ponuke.</p>]]></media:content>
            </media:group>
        </item>
    </channel>
</rss>

Adresy na doméne example.org sú iba ukážkové; nahraďte ich skutočnými adresami dostupnými RSS serveru. Základný príklad neobsahuje endDate, aby ukážková položka automaticky neexspirovala.

Parametre položky

Tabuľka uvádza požadovaný formát integrácie. Tolerancia chýbajúcich údajov v parseri nenahrádza ich správne vyplnenie. changeDate treba vyplniť a zmeniť pri aktualizácii existujúcej položky.

Položky mediálnej skupiny

Obrázok, dokument alebo video: do skupiny vložte element media:content s atribútmi url a type. Voliteľný atribút name pomenuje prílohu.

HTML alebo obyčajný text: použite media:content type="text/html" a obsah vložte priamo do elementu, napríklad ako fragment HTML v CDATA. Na obyčajný text stačí jednoduchý odsek. Zobrazenie prílohy HTML nie je plnohodnotná webová aplikácia a táto špecifikácia negarantuje spúšťanie JavaScriptu.

Obmedzenie textových príloh: samostatné prílohy text/plain nie sú v overenej implementácii správne spracúvané. Na textovú prílohu použite vyššie uvedený zápis text/html.

Podporované typy obsahu

Ide o vstupné formáty príloh, ktoré systém podľa typu ukladá alebo pripravuje na zobrazenie. Úspešné spracovanie konkrétneho súboru závisí aj od jeho obsahu a použitého kódovania; samotná zhoda typu MIME nepotvrdzuje dokončenie konverzie.