RSS integrace

Technická dokumentace

Jak synchronizace funguje

1. Server načte nakonfigurovaný RSS zdroj a porovná identifikátory položek a hodnoty changeDate s uloženými údaji.
2. Nové a změněné položky se zpracují. Server stáhne jejich média a předá je souborové službě k uložení a případné konverzi; nepoužívané položky a média uklízí.
3. O rozpoznané změně server informuje portál, který zajistí odeslání aktualizovaných údajů zařízením používajícím daný kanál.
4. Zařízení uloží přijaté údaje a samostatně stahuje potřebné přílohy. Přijetí definice samo o sobě nepotvrzuje dokončení stahování všech médií.

Interval kontroly zdroje a přiřazení RSS aplikace popisuje návod Konfigurace RSS aplikace. Aktualizace není okamžitá; závisí také na přípravě médií a připojení zařízení.

Popsaná synchronizace předpokládá zdroj s alespoň jednou platnou položkou. Úplné vyprázdnění kanálu nepovažujte za zaručený způsob ukončení zobrazování obsahu.

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

Při změně názvu, popisu, odkazu nebo příloh zachovejte guid a změňte changeDate. Stejné pravidlo platí při nahrazení souboru na nezměněné URL. Samotná změna pořadí položek nemusí vyvolat odeslání nové definice; pro doručení změny použijte také changeDate.

Význam hlavních vlastností

• guid: Jedinečný a stabilní identifikátor položky, například ID záznamu v databázi. Zachovejte jej i při úpravě obsahu.
• title: Povinný neprázdný název. Může obsahovat HTML značky; v seznamu a nadpisu detailu se zobrazuje jako prostý text.
• description: Popis položky. Může obsahovat HTML; jeho formátované zobrazení závisí na nastavení RSS aplikace.
• category: Název kategorie pro filtrování. Výběr kategorie se zobrazí, pokud kanál obsahuje alespoň jednu neprázdnou kategorii.
• link: Absolutní adresa související webové stránky. Odkaz začínající na http se v detailu zobrazuje také jako QR kód pro mobilní zařízení.
• pubDate: Datum a čas vytvoření položky. Nejde o nastavení odloženého zobrazení; budoucí datum samo o sobě zobrazení nezablokuje.
• endDate: Datum a čas konce platnosti. Samotné vyplnění tohoto pole nezaručuje okamžité skrytí položky podle času zařízení, zejména při výpadku připojení. Nepoužívejte je jako jediný mechanismus pro obsah, který se musí přestat zobrazovat v přesně určený čas.
• changeDate: Datum a čas poslední změny obsahu. Systém jej porovnává společně s guid; při každé obsahové změně použijte odlišnou hodnotu.
• media:content: Reprezentativní obrázek položky mimo skupinu příloh. Použijte atributy url a type.
• content, image: Parser přijímá také tyto názvy tagů se stejnými mediálními atributy. Tag image je náhradou, pokud ještě není nastavena URL hlavního média. Doporučený zápis je media:content; nejde o podporu libovolné vnořené struktury image/url.
• media:group: Skupina příloh položky: obrázky, videa, dokumenty a vložený obsah HTML.

Zápis data a času

Používejte například 2026-10-17 08:30:00. Podporováno je také oddělení data a času znakem T nebo t, datum ve tvaru 17.10.2026 a RSS zápis, například Sat, 17 Oct 2026 08:30:00 +0200.

Hodnoty se zpracovávají jako místní datum a čas. Uvedený časový posun se nepřepočítává do UTC, proto používejte jednotnou dohodnutou časovou zónu. Zápis ISO 8601 končící znakem Z není v ověřeném parseru podporován.

XML pří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 nabídce</title>
            <description>Informace o aktuální nabídce</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 nabídky" type="application/pdf"/>
                <media:content type="text/html"><![CDATA[<h1>Podrobnosti</h1><p>Další informace o nabídce.</p>]]></media:content>
            </media:group>
        </item>
    </channel>
</rss>

Adresy na doméně example.org jsou pouze ukázkové; nahraďte je skutečnými adresami dostupnými RSS serveru. Základní příklad neobsahuje endDate, aby ukázková položka automaticky neexpirovala.

Parametry položky

Tabulka uvádí požadovaný formát integrace. Tolerance chybějících údajů v parseru nenahrazuje jejich správné vyplnění. changeDate je nutné vyplnit a změnit při aktualizaci existující položky.

Položky skupiny médií

Obrázek, dokument nebo video: do skupiny vložte element media:content s atributy url a type. Volitelný atribut name pojmenuje přílohu.

HTML nebo běžný text: použijte media:content type="text/html" a obsah vložte přímo do elementu, například jako fragment HTML v CDATA. Pro běžný text stačí jednoduchý odstavec. Zobrazení HTML přílohy není plnohodnotná webová aplikace a tato specifikace negarantuje spouštění JavaScriptu.

Omezení textových příloh: samostatné přílohy text/plain nejsou v ověřené implementaci správně zpracovávány. Pro textovou přílohu použijte výše uvedený zápis text/html.

Podporované typy obsahu

Jde o vstupní formáty příloh, které systém podle typu ukládá nebo připravuje ke zobrazení. Úspěšné zpracování konkrétního souboru závisí i na jeho obsahu a použitém kódování; samotná shoda MIME typu není potvrzením dokončené konverze.