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.
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
- 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. - 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.
- 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.
- 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
guidaz ú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
guidhiányzik az új tartalomleírásból → eltávolított elem; a médiafájljai eltávolításra kerülnek. - Az
guidmindkettőben szerepel, de az alábbi érték:changeDateelté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éter | Kötelező | Típus | Példa |
|---|---|---|---|
guid | IGEN | Szöveg / Szám | 548A59C5B5E |
title | IGEN | Szöveg / HTML | Nagyszerű hír |
description | NEM | Szöveg / HTML | Ez NAGY hír |
link | NEM | URL | https://... |
category | NEM | Szöveg | Hírek |
author | NEM | Szöveg | Bill Johanson |
pubDate | IGEN | Dátum-idő | 2026-10-17 08:00:00 |
endDate | NEM | Dátum-idő | 2026-10-18 18:00:00 |
changeDate | Frissítéskor | Dátum-idő | 2026-10-17 08:30:00 |
media:content | NEM | Bejegyzés | |
media:group | NEM | Csoport |
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.
Kapcsolódó témák és következő lépések
← Vissza az áttekintéshez – Integrációk és tartalomkészítés
Forduljon szoftverszolgáltatójához.
