RSS-integráció

Bevezetés és tájékozódás

RSS-hírcsatornák műszaki követelményei, változásérzékelés, elemmezők és mellékletek.

Kinek szól az útmutató

Ez a specifikáció az ügyfél számára RSS/XML-hírcsatornát előkészítő fejlesztőnek vagy szállítónak szól. Az ügyfél átadja a kész hírcsatorna URL-címét a rendszer szolgáltatójának, akinek adminisztrátora csatlakoztatja azt, és létrehozza az RSS-alkalmazást. A beállítás menetét az RSS-alkalmazás konfigurálása útmutató ismerteti.

Példák megtekintése az alkalmazáskönyvtárban

Mire szolgál az RSS-integráció

Az RSS-integráció lehetővé teszi, hogy a rendszer strukturált tartalmat kérjen le egy beállított RSS-csatornából, előkészítse annak médiafájljait, és a csatornához rendelt eszközökre eljuttassa a tartalomleírás változásait.

Műszaki referencia

A szinkronizálás működése

  1. A kiszolgáló lekéri a beállított RSS-hírcsatornát, majd az elemek azonosítóit és changeDate értékeit összehasonlítja a tárolt rekordokkal.
  2. Az új és módosított elemek feldolgozásra kerülnek. A kiszolgáló letölti a médiafájljaikat, és elküldi őket a fájlszolgáltatásnak tárolásra és szükség szerinti konvertálásra; a már nem használt elemeket és médiafájlokat eltávolítja.
  3. A kiszolgáló értesíti a portált az észlelt változásról. A portál ezután eljuttatja a frissített adatokat a csatornát használó eszközökre.
  4. Minden eszköz elmenti a fogadott adatokat, és külön tölti le a szükséges mellékleteket. A tartalomleírás fogadása önmagában nem igazolja az összes médiafájl letöltésének befejezését.

A hírcsatorna ellenőrzési időközéről és az alkalmazás hozzárendeléséről az RSS-alkalmazás konfigurálása útmutatóban olvashat. A frissítés nem azonnali: a médiafájlok előkészítése és az eszköz kapcsolata is befolyásolja a kézbesítést.

Az itt leírt szinkronizálás legalább egy érvényes elemet tartalmazó hírcsatornát feltételez. Ne tekintse a hírcsatorna kiürítését a megjelenítés biztos leállítási módjának.

Az elemek változásainak észlelése

  • A guid az új tartalomleírásban szerepel, a régiben viszont nem → új elem; a médiafájljai letöltődnek és előkészítésre kerülnek.
  • Egy korábbi guid hiányzik az új tartalomleírásból → eltávolított elem; a médiafájljai eltávolításra kerülnek.
  • Az guid mindkettőben szerepel, de az alábbi érték: changeDate eltér → módosított elem; a régi médiafájlok eltávolításra kerülnek, az újak letöltődnek és előkészülnek.

Cím, leírás, hivatkozás vagy melléklet módosításakor őrizze meg ezt: guid és változtassa meg ezt: changeDate. Ez akkor is érvényes, ha egy változatlan URL-címen lévő fájlt cserél le. Az elemek puszta átrendezése nem feltétlenül indítja el az új tartalomleírás kézbesítését; frissítse ezt is: changeDate a változás eljuttatásához.

Fő tulajdonságok

  • guid: Az elem egyedi, állandó azonosítója, például egy adatbázisrekord azonosítója. Tartalomszerkesztéskor őrizze meg.
  • title: Kötelező, nem üres cím. HTML-címkék megadhatók, de a lista és a részletek fejléce egyszerű szöveget jelenít meg.
  • description: Az elem leírása. Tartalmazhat HTML-t; a formázott megjelenítés az RSS-alkalmazás beállításaitól függ.
  • category: Szűréshez használt kategórianév. A kategóriaválasztó akkor jelenik meg, ha a csatorna legalább egy nem üres kategóriát tartalmaz.
  • link: Kapcsolódó weboldal abszolút URL-címe. A http kezdetű hivatkozás az elem részleteiben QR-kódként is megjelenik, mobiltelefonos használathoz.
  • pubDate: Az elem létrehozásának dátuma és ideje. Ez nem ütemezi a megjelenést: egy jövőbeli dátum nem akadályozza meg az elem megjelenítését.
  • endDate: Az elem érvényességének záródátuma és -ideje. A mező beállítása nem garantálja az azonnali eltűnést az eszköz órája alapján, különösen kapcsolat nélküli eszköz esetén. Pontosan meghatározott időpontban leállítandó tartalomnál ne támaszkodjon kizárólag erre.
  • changeDate: Az utolsó tartalommódosítás dátuma és ideje. A rendszer a guid értékével együtt hasonlítja össze; minden tartalomfrissítéshez eltérő értéket adjon meg.
  • media:content: Az elem reprezentatív képe a mellékletcsoporton kívül. Adja meg a url és type attribútumokat.
  • content, image: Az értelmező ugyanezekkel a médiaattribútumokkal ezeket a címkeneveket is elfogadja. Az image címke tartalékmegoldás, ha a fő média-URL nincs megadva. Elsődlegesen a media:content alakot használja; ez az alternatíva nem támogat tetszőleges egymásba ágyazott image/url szerkezeteket.
  • media:group: Az elem mellékletcsoportja: képek, videók, dokumentumok és beágyazott HTML-tartalom.

Dátum- és időformátumok

Használjon ilyen értéket: 2026-10-17 08:30:00. Az értelmező a dátum és idő között T vagy t jelet is elfogad, illetve ilyen dátumot: 17.10.2026és ilyen RSS-dátumokat: Sat, 17 Oct 2026 08:30:00 +0200.

Az értékeket helyi dátumként és időként kezeli a rendszer. A megadott UTC-eltolást nem használja UTC-re váltáshoz, ezért következetesen ugyanazt az egyeztetett időzónát használja. A Z végződésű ISO 8601 időbélyegeket az ellenőrzött értelmező nem támogatja.

XML-példa

<?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>Latest offers</title>
            <description>Information about our current offers</description>
            <category>News</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="Offer details" type="application/pdf"/>
                <media:content type="text/html"><![CDATA[<h1>Details</h1><p>More information about this offer.</p>]]></media:content>
            </media:group>
        </item>
    </channel>
</rss>

Az example.org címek helykitöltők. Cserélje le őket az RSS-kiszolgáló számára elérhető valódi URL-címekre. Az alapvető példa nem tartalmaz endDate mezőt, hogy a mintaelem ne járjon le automatikusan.

Elemparaméterek

A táblázat a kötelező integrációs formátumot határozza meg. Az értelmező hiányzó mezőkkel szembeni megengedő viselkedése nem helyettesíti a helyesen kitöltött adatokat. Meglévő elem frissítésekor adja meg és módosítsa ezt: changeDate .

ParaméterKötelezőTípusPélda
guidIGENSzöveg / Szám548A59C5B5E
titleIGENSzöveg / HTMLNagyszerű hír
descriptionNEMSzöveg / HTMLEz NAGY hír
linkNEMURLhttps://...
categoryNEMSzövegHírek
authorNEMSzövegBill Johanson
pubDateIGENDátum-idő2026-10-17 08:00:00
endDateNEMDátum-idő2026-10-18 18:00:00
changeDateFrissítéskorDátum-idő2026-10-17 08:30:00
media:contentNEMBejegyzés
media:groupNEMCsoport

A médiacsoport elemei

Kép, dokumentum vagy videó: adjon a csoporthoz egy ilyen elemet: media:content és adja meg a következő attribútumait: url és type . Az opcionális name attribútum a melléklet megnevezését adja meg.

HTML vagy egyszerű szöveg: használja ezt: media:content type="text/html" és a tartalmat közvetlenül az elembe helyezze, például HTML-részletként CDATA-ban. Egyszerű szöveghez egy bekezdés is elegendő. Egy HTML-melléklet megjelenítése nem biztosít teljes webalkalmazást; ez a specifikáció nem garantál JavaScript-végrehajtást.

A szöveges mellékletek korlátozása: az önálló text/plain mellékleteket az ellenőrzött megvalósítás nem dolgozza fel helyesen. Szöveges melléklethez a fent bemutatott text/html alakot használja.

Támogatott tartalomtípusok

image/webp image/jpeg image/png video/mp4 video/x-msvideo video/webm video/quicktime video/x-m4v video/mpeg application/pdf application/rtf application/msword application/vnd.openxmlformats-officedocument.wordprocessingml.document application/vnd.ms-excel application/vnd.openxmlformats-officedocument.spreadsheetml.sheet application/vnd.ms-powerpoint application/vnd.openxmlformats-officedocument.presentationml.presentation application/vnd.oasis.opendocument.text application/vnd.oasis.opendocument.presentation application/vnd.oasis.opendocument.spreadsheet text/html

Ezek olyan bemeneti mellékletformátumok, amelyeket a rendszer típusuktól függően tárol vagy megjelenítésre előkészít. A sikeres feldolgozás a fájl tényleges tartalmától és kódolásától is függ; a megfelelő MIME-típus önmagában nem igazolja a konvertálás befejezését.

Nem találta meg, amit keresett?
Forduljon szoftverszolgáltatójához.