Prettylib-tuoteratkaisut - Wiki

RSS/ATOM syötteet

Owned by Pauli Porkka (Unlicensed)
Oct 17, 2018
2 min read

PrettyLibServer tukee PrettyLib-tietokannan hakujen yhteydessä RSS/ATOM syötteitä.

Varsinainen tuettu protokolla on ATOM, jota tukevat kaikki yleisimmin käytetyt nykyaikaiset syötteidenlukuohjelmistot sekä palvelut.

Vaikka virallisesti RSS ja ATOM eivät ole sama standardi, niin lukuohjelmien yleisen monipuolisuuden takia käyttäjälle on aivan sama onko kyseessä RSS vai ATOM. Käyttäjät tunnistavat kuitenkin yleisimmin nimityksen RSS.

Käyttöönotto

Päivitettäessä uusimpiin versioihin, asentuu ATOM-komponentti automaattisesti.

ATOM-komponentille annetaan myös oletusarvoisesti oikeudet käsitellä PrettyLib-tietokantaa samoilla oikeuksilla kuin normaali PrettyLib-hakukomponenttikin.

Mikäli syötteen luku antaa virheen, että komponentti ei ole käytössä tai komponentti on otettu jossain vaiheessa pois päältä, saadaan komponentti aktivoitua seuraavasti.

  1. Tarkista ensin onko ATOM-komponentti päällä. Tämän saa aikaiseksi seuraavasti:
    1. Käynnistä asetusohjelma "Server Settings"
    2. Valitse välilehti "Components"
    3. Valitse rasti kohdasta "ATOM".
    4. Valitse "Save"
    5. Valitse "Restart" sitä kysyttäessä
  2. Tarkista onko ATOM-komponentilla pääsy tietokantaan. Tämän saa aikaiseksi seuraavasti:
    1. Käynnistä asetusohjelma "Search Settings for PrettyLib 4"
    2. Valitse välilehti "Global"
    3. Valitse oikea tietokanta "Databases" listasta
    4. Valitse painike "Edit"
    5. Valitse rasti kohtaan "Allow ATOM component to access the database"
    6. Valitse "Ok"
    7. Valitse "Save"
    8. Valitse "Restart" sitä kysyttäessä.

Käyttö

Syötteitä voidaan käyttää käytännössä kahdella tavalla.

Tapa 1

Luodaan kiinteitä hakulinkkejä, jotka osoittavat ATOM-syötteeseen. Tälläinen voisi olla esimerkiksi kirjaston sivulla oleva kiinteä RSS-linkki uutuusluetteloon ATOM-muodossa. ATOM-komponentti tukee samoja hakuparametrejä kuin PrettyLibin hakukomponenttikin. Tällöin kiinteän linkin luominen itse on suhteellisen helppoa.

Linkin pystyy yleensä kopioimaan tehtäessä hakua hakulomakkeelta. Hakutuloksen valmistuttua osoiterivillä on yleensä pitkä parametrijono, joka on kopioitavissa. Mikäli selaimen osoiterivillä ei näy juurikaan muuta kuin palvelimen osoite, on todennäköistä, että hakulomake käyttää hieman erilaista tapaa lähettää hakuparametrit palvelimelle. Ota yhteyttä asiakaspalveluumme tämän vaihtamiseksi.

Ohessa esimerkki PrettyLibin uutuusluettelolinkistä ja vastaavasta ATOM-komponentin linkistä.

PrettyLib:

https://prettylib2.erikoiskirjastot.fi/lib4/src?pbformtype=01004&profileset=fin&database=1&catdays=60&max=50


ATOM:

https://prettylib2.erikoiskirjastot.fi/libatom/src?pbformtype=01004&profileset=fin&database=1&catdays=60&max=50


Tapa 2

Annetaan PrettyLib-hakukomponentin luoda itse RSS-linkki automaattisesti jokaisesta hausta. Tämä lienee hyödyllinen lähinnä käytettäessä syötettä eräänlaisena uutuusvahtina.

Tämä edellyttää asetuksesta tuen päälle laittamista. Tämä toiminto ei ole vielä tuettu.

Käytön estäminen

Mikäli halutaan estää ATOM-komponentin käyttö, voidaan se tehdä kahdella eri tasolla.

  1. Estämällä koko ATOM-komponentin käynnistyminen ja näin estäen sen pääsy PrettyLib-tietokantaan (mihin tahansa PrettyLib-kantaan). Tämän saa aikaiseksi seuraavasti:
    1. Käynnistä asetusohjelma "Server Settings"
    2. Valitsemalla välilehti "Components"
    3. Poista rasti kohdasta "ATOM".
    4. Valitse "Save"
    5. Valitse "Restart" sitä kysyttäessä
  2. Estämällä ATOM-komponentin pääsy johonkin tiettyyn tietokantaan. Tämän saa aikaiseksi seuraavasti:
    1. Käynnistä asetusohjelma "Search Settings for PrettyLib 4"
    2. Valitse välilehti "Global"
    3. Valitse oikea tietokanta "Databases" listasta
    4. Valitse painike "Edit"
    5. Poista rasti kohdasta "Allow ATOM component to access the database"
    6. Valitse "Ok"
    7. Valitse "Save"
    8. Valitse "Restart" sitä kysyttäessä.

Prettylib-tuotetuki