RSS integracija

Uvod i snalaženje

Tehnički zahtevi za RSS izvore, prepoznavanje izmena, polja stavki i priloge.

Kome je vodič namenjen

Ova specifikacija namenjena je programeru ili dobavljaču koji priprema RSS/XML izvor za korisnika. Korisnik prosleđuje URL gotovog izvora dobavljaču sistema, čiji administrator ga povezuje i kreira RSS aplikaciju. Pogledajte odeljak Konfiguracija RSS aplikacije za postupak podešavanja.

Pogledajte primere u biblioteci aplikacija

Čemu služi RSS integracija

RSS integracija omogućava sistemu da preuzme strukturisani sadržaj iz podešenog RSS kanala, pripremi njegove medije i distribuira izmene definicije uređajima povezanim sa tim kanalom.

Tehnička referenca

Kako funkcioniše sinhronizacija

  1. Server preuzima podešeni RSS izvor i poredi identifikatore stavki i changeDate vrednosti sa sačuvanim zapisima.
  2. Nove i izmenjene stavke se obrađuju. Server preuzima njihove medije i šalje ih servisu za datoteke radi skladištenja i eventualne potrebne konverzije; nekorišćene stavke i mediji se uklanjaju.
  3. Server obaveštava portal o otkrivenoj izmeni. Portal zatim organizuje isporuku ažuriranih podataka uređajima koji koriste taj kanal.
  4. Svaki uređaj čuva primljene podatke i zasebno preuzima potrebne priloge. Sam prijem definicije ne potvrđuje da je preuzimanje svih medija završeno.

Pogledajte odeljak Konfiguracija RSS aplikacije za interval provere izvora i dodelu aplikacije. Ažuriranja nisu trenutna: na isporuku utiču i priprema medija i povezanost uređaja.

Ovde opisana sinhronizacija pretpostavlja izvor sa najmanje jednom važećom stavkom. Ne oslanjajte se na pražnjenje izvora kao na garantovan način za prekid prikazivanja njegovog sadržaja.

Kako sistem otkriva izmene stavki

  • Vrednost guid u novoj definiciji koja nije postojala u prethodnoj → nova stavka; njeni mediji se preuzimaju i pripremaju.
  • Prethodni guid koji nedostaje u novoj definiciji → uklonjena stavka; njeni mediji se uklanjaju.
  • Vrednost guid postoji u oba skupa, ali se changeDate razlikuje → izmenjena stavka; stari mediji se uklanjaju, a novi se preuzimaju i pripremaju.

Kada menjate naslov, opis, link ili prilog, zadržite guid i promenite changeDate. To važi i pri zameni datoteke na nepromenjenom URL-u. Sama promena redosleda stavki možda neće pokrenuti isporuku nove definicije; ažurirajte i changeDate da bi izmena bila isporučena.

Glavna svojstva

  • guid: Jedinstven, stabilan identifikator stavke, kao što je ID zapisa iz baze podataka. Zadržite ga pri uređivanju sadržaja.
  • title: Obavezan naslov koji nije prazan. HTML oznake se prihvataju, ali se naslov u listi i detaljnom prikazu prikazuje kao običan tekst.
  • description: Opis stavke. Može da sadrži HTML; formatirani prikaz zavisi od podešavanja RSS aplikacije.
  • category: Naziv kategorije koja se koristi za filtriranje. Birač kategorija pojavljuje se kada kanal ima najmanje jednu kategoriju koja nije prazna.
  • link: Apsolutni URL povezane veb-stranice. Link koji počinje sa http prikazuje se i kao QR kod u detaljnom prikazu stavke za korišćenje na mobilnom uređaju.
  • pubDate: Datum i vreme kreiranja stavke. Ovo ne zakazuje njeno objavljivanje: budući datum ne sprečava prikazivanje stavke.
  • endDate: Datum i vreme završetka važenja stavke. Podešavanje ovog polja ne garantuje trenutno uklanjanje iz prikaza prema satu uređaja, naročito kada uređaj nema vezu. Za sadržaj koji mora da prestane da se prikazuje u tačno vreme nemojte se oslanjati samo na ovo polje.
  • changeDate: Datum i vreme poslednje izmene sadržaja. Sistem poredi ovu vrednost zajedno sa guid-om; pri svakom ažuriranju sadržaja koristite drugu vrednost.
  • media:content: Reprezentativna slika stavke, izvan grupe priloga. Navedite atribute url i type.
  • content, image: Parser prihvata i ove nazive oznaka sa istim atributima medija. Oznaka image služi kao rezerva kada glavni URL medija nije podešen. Kao preporučeni oblik koristite media:content; ovaj alternativni naziv ne podržava proizvoljne ugnježdene strukture image/url.
  • media:group: Grupa priloga stavke: slike, video-zapisi, dokumenti i ugrađeni HTML sadržaj.

Formati datuma i vremena

Koristite vrednost poput 2026-10-17 08:30:00. Parser prihvata i T ili t između datuma i vremena, datum poput 17.10.2026, kao i RSS datume poput Sat, 17 Oct 2026 08:30:00 +0200.

Vrednosti se obrađuju kao lokalni datumi i vremena. Navedeno odstupanje od UTC-a ne koristi se za konverziju u UTC, pa dosledno koristite jednu dogovorenu vremensku zonu. Provereni parser ne podržava ISO 8601 vremenske oznake koje se završavaju znakom Z.

XML primer

<?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>

Adrese example.org su zamenski primeri. Zamenite ih stvarnim URL-ovima dostupnim RSS serveru. Osnovni primer izostavlja endDate da uzorak stavke ne bi automatski istekao.

Parametri stavke

Tabela definiše potreban format integracije. To što parser toleriše nedostajuća polja ne zamenjuje ispravno popunjene podatke. Navedite i promenite changeDate kada ažurirate postojeću stavku.

ParametarObaveznoTipPrimer
guidDATekst / Broj548A59C5B5E
titleDATekst / HTMLSjajne vesti
descriptionNETekst / HTMLOvo su VELIKE vesti
linkNEURLhttps://...
categoryNETekstVesti
authorNETekstBill Johanson
pubDateDADatum i vreme2026-10-17 08:00:00
endDateNEDatum i vreme2026-10-18 18:00:00
changeDatePri ažuriranjuDatum i vreme2026-10-17 08:30:00
media:contentNEStavka
media:groupNEGrupa

Stavke grupe medija

Slika, dokument ili video-zapis: dodajte element media:content u grupu i navedite njegove url i type atribute. Opcioni atribut name predstavlja naziv priloga.

HTML ili običan tekst: koristite media:content type="text/html" i stavite sadržaj direktno unutar elementa, na primer kao HTML fragment u CDATA odeljku. Za običan tekst dovoljan je jednostavan pasus. Prikaz HTML priloga ne obezbeđuje punu veb-aplikaciju; ova specifikacija ne garantuje izvršavanje JavaScripta.

Ograničenje tekstualnih priloga: samostalni text/plain prilozi ne obrađuju se ispravno u proverenoj implementaciji. Za tekstualni prilog koristite text/html oblik prikazan iznad.

Podržani tipovi sadržaja

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

Ovo su ulazni formati priloga koje sistem skladišti ili priprema za prikaz, u zavisnosti od njihovog tipa. Uspešna obrada zavisi i od stvarnog sadržaja datoteke i kodiranja; samo odgovarajući MIME tip ne potvrđuje da je konverzija završena.

Niste pronašli ono što tražite?
Obratite se svom dobavljaču softvera.