Az RSS 2.0 és Atom 1.0 feedek szerkezeti követelményei
A webes hírcsatornák megbízható működésének alapja a pontos XML-szerkezet. Az RSS 2.0 és az Atom 1.0 formátumok eltérő sémákat és kötelező elemeket határoznak meg, amelyeket a syndication kliensek szigorúan ellenőriznek.
Az RSS 2.0 dokumentumoknak pontosan egy közvetlen <channel> elemet kell tartalmazniuk. Ha ettől eltérő struktúra szerepel a fájlban, az eszköz az alábbi hibaüzenetet adja vissza: "Az RSS pontosan egy közvetlen <channel> elemet tartalmazhat; talált elemek: ‹count›." Az RSS-csatornákban az egyes tételek (item) esetében kötelező a cím vagy a leírás megadása, azaz a title-or-description szabály érvényesítése. Ezenkívül az elemző beolvassa a GUID, a hivatkozás (link) és a közzétételi dátum (publication date) értékét is.
Az Atom 1.0 ezzel szemben egy modernebb, szigorúbb szabvány, amelynél a feed szintjén és a bejegyzéseknél (entry) is kötelező az egyedi azonosító (ID), a cím (title) és az utolsó frissítés időpontja (updated). Az Atom-bejegyzések feldolgozásakor az ellenőrző vizsgálja a szerzők öröklődését (author inheritance), az alternatív hivatkozásokat (alternate links), valamint a tartalomra és az összefoglalóra (content or summary) vonatkozó szabályokat.
Gyakori hibák és figyelmeztetések a feedek XML-szerkezetében
A feedek előállítása során számos olyan hiba léphet fel, amely megakadályozza a kliensek általi feldolgozást. Az XML-szintaxis hibái esetén a "Javítsa ki a hibás XML-t, majd ellenőrizze újra." üzenet jelenik meg. Ha a dokumentum DOCTYPE-deklarációt tartalmaz, a biztonság és a szabványosság érdekében a "A feed ellenőrzése előtt távolítsa el a DOCTYPE-deklarációt." hibaüzenet lép életbe.
A nem támogatott formátumok vagy verziók kiszűrésére az eszköz az alábbi szabályokat alkalmazza:
- Ha a dokumentum nem felel meg a fő formátumoknak: "Használjon <rss> elemet tartalmazó RSS 2.0 vagy <feed> elemet tartalmazó Atom 1.0 dokumentumot."
- Ha a verzió nem megfelelő: "Az ellenőrző ezt támogatja:
‹format›‹expected›; észlelt verzió:‹actual›." - Ha egy kötelező mező hiányzik: "Adja hozzá a kötelező
‹field›mezőt." - Ha egy egyedi mezőből több szerepel: "Pontosan egy
‹field›maradjon; talált elemek:‹count›."
A bejegyzések egyedi azonosítóinak ismétlődése szintén gyakori hiba. Ha egy ID már korábban is szerepelt a dokumentumban, az eszköz jelzi: "Ez az ID megismétli a(z) ‹first›. sorban először látott értéket."
Hivatkozások, URI-k és az xml:base szerepe az Atom feedekben
A feedekben található hivatkozásoknak érvényes URL- vagy URI-referenciáknak kell lenniük. Ha a hivatkozás nem értelmezhető, a "Javítsa ezt: ‹field›; a hivatkozás nem dolgozható fel URL- vagy URI-referenciaként." hibaüzenet jelenik meg.
Az Atom 1.0 szabvány különösen szigorú az azonosítók és hivatkozások terén. Az Atom ID-k esetében kötelező az abszolút IRI használata: "A(z) ‹field› mezőhöz abszolút IRI-t használjon; a relatív azonosítók nem érvényes Atom ID-k."
A relatív hivatkozások feloldása az Atom feedekben az xml:base attribútum segítségével történik. Ha egy hivatkozás relatív, és nem határozható meg hozzá érvényes alap-URI, az ellenőrző hibát jelez: "A(z) ‹field› mezőhöz abszolút címet használjon; csak a használható xml:base értékkel rendelkező Atom-hivatkozások lehetnek relatívak."
Fontos megjegyezni, hogy az ellenőrző kizárólag a hivatkozások szintaxisát és feloldhatóságát vizsgálja a dokumentumon belül. Az URL-eket nem nyitja meg, így a távoli szerverek elérhetőségét, az esetleges átirányításokat, a biztonsági tanúsítványokat vagy a céloldalak tényleges tartalmát nem ellenőrzi.
Szerzői adatok és tartalomkezelési szabályok
Mindkét formátum megköveteli a szerzői információk pontos feltüntetését, de eltérő módon. Ha az Atom feedből hiányoznak a szerző adatai, az alábbi hibák léphetnek fel:
- "Adjon <author> elemet a feedhez, vagy közvetlen <author> elemet minden bejegyzéshez."
- "Adjon <author> elemet ehhez a bejegyzéshez, annak <source> eleméhez vagy a feedhez."
Az Atom-bejegyzések tartalmának (content) és összefoglalójának (summary) kezelésére szintén szigorú szabályok vonatkoznak. Ha egy bejegyzés külső erőforrásra hivatkozik a src attribútummal, a beágyazott elemek nem szerepelhetnek mellette: "Ha a <content> src értéket használ, távolítsa el a beágyazott szöveget és a gyermekelemeket." Továbbá, ha a tartalom külső vagy nem olvasható szövegként, kötelező az összefoglaló megadása: "Adjon hozzá <summary> elemet, ha az Atom-tartalom külső vagy szövegként nem olvasható." Ha az Atom-bejegyzés nem tartalmaz beágyazott tartalmat, alternatív hivatkozást kell biztosítani: "Adjon hozzá alternatív <link> elemet, ha az Atom-bejegyzésben nincs beágyazott <content>."
Dátumformátumok és korlátozások
A feedekben szereplő dátumoknak meg kell felelniük a vonatkozó specifikációknak (az RSS 2.0 esetében az RFC 822, az Atom 1.0 esetében az RFC 3339 szabványnak). Érvénytelen vagy hibásan formázott dátum észlelésekor a "Használjon valós dátumot a feed által megkövetelt formátumban." figyelmeztetés jelenik meg.
Az ellenőrző eszköz teljesítménybeli és kezelhetőségi okokból bizonyos korlátokat alkalmaz:
- A bemeneti mezőbe legfeljebb 500 000 karakter hosszúságú XML-szöveg illeszthető be. Ha a bevitt adat ezt meghaladja, a "Az eszköz ellenőrzésenként legfeljebb
‹max›karaktert fogad el." hibaüzenet jelenik meg. - Ha a feldolgozás túllépi az időkeretet, a rendszer a "Az ellenőrzés túl sokáig tartott. Próbáljon kisebb feedet." üzenettel leáll.
- Amennyiben a folyamat egyéb okból megszakad: "Az ellenőrzés nem fejezhető be."
- A megjelenített eredmények maximális száma is korlátozott: a felület legfeljebb 200 problémát és 100 bejegyzést mutat meg egyszerre. Ha a feed ennél többet tartalmaz, a rendszer jelzi a csonkolást ("Az összesen
‹total›problémából az első‹shown›látható.", illetve "Az összesen‹total›bejegyzésből az első‹shown›látható.").
Adatkezelés és adatvédelem
A feed ellenőrzése a böngészőjében történik. A BroBroGo semmit nem tölt fel és nem ment el. A beillesztett XML-tartalom feldolgozása, elemzése és a hibák keresése teljes egészében a helyi kliensoldali környezetben fut le, így a feed adatai nem kerülnek továbbításra külső szerverekre.
Gyakran Ismételt Kérdések
Mely feedformátumokat támogatja az ellenőrző?
Az aktuális RSS 2.0 és Atom 1.0 dokumentumokat ellenőrzi. A régebbi RSS, RDF/RSS 1.0 és Atom 0.3 feedeket felismeri, de nem ellenőrzi őket nem megfelelő szabályokkal.
Megnyitja vagy teszteli a feed hivatkozásait?
Feldolgozza a hivatkozásokat tartalmazó mezőket, és az xml:base segítségével feloldja a relatív Atom-hivatkozásokat. Az URL-eket nem nyitja meg, ezért nem vizsgálja az elérhetőséget, az átirányításokat, a tanúsítványokat vagy a cél tartalmát.
Mely bejegyzésmezőket ellenőrzi?
Az RSS item esetén ellenőrzi a cím vagy leírás meglétét, és beolvassa a GUID, a hivatkozás és a közzétételi dátum értékét. Az Atom entry esetén ellenőrzi az ID, a cím, az updated, az author öröklése, az alternatív hivatkozások és a content vagy summary szabályait.
Mit jelent a szerkezeti ellenőrzés korlátja?
A jelentés csak a szerkezetet és az általános formátumszabályokat ellenőrzi. Nem igazolja, hogy a tartalom pontos, biztonságos, minden olvasó elfogadja vagy közzétételre kész.