Kansalliskirjastolla on Axiellin kanssa solmittu sopimus heidän tarjoamistaan palveluista yleisille kirjastoille. Sopimus mahdollistaa, että kirjastot saavat sopimuksen mukaisia maksuja vastaan käyttöönsä:

  • Axiell Web Services -ohjelmiston (AWS)
  • ohjelmistoihin liittyvän dokumentaation
  • haravointirajapinnan rajoittamattomana käyttöönsä osana AWS -ohjelmistoa

Axiell on luopunut Auroran osalta 2016 erillisestä rajapintapalvelimesta. Rajapinnat toteutetaan Auroran osalta suoraan tuotantojärjestelmään AWS -rajapinnan kautta.

Sisällysluettelo

Auroran Finna2-rajapinta

Axiell tarjoaa perustoiminnallisuuksien lisäksi maksullisena lisäpalveluna ns. Finna2-rajapinnan. Rajapinnan avulla saadaan Finnaan näkymään seuraavat toiminnot:

  1. Lainaushistoria ja lainaushistorian päälle asettaminen
  2. Viestiasetusten vaihtaminen ajurin kautta (muistutukset)
  3. Teoslistat
    1. Lainatuimmat
    2. Varatuimmat
    3. Uusimmat
    4. Viimeksi palautetut

Rajapinnan käyttöönottamiseksi ole yhteydessä ensin Axiellin asiakaspalveluun. Kun sopimus lisärajapinnan käyttöönotosta on tehty, ole yhteydessä Finnan palvelupisteeseen toimintojen käyttöönottamiseksi.

Lisää tietoa teoslistojen hyödyntämisestä löydät täältä: Muut asetukset: Kirjastojärjestelmän teoslistat

Seutuvaraus

  • Aurora: palvelupiste asettaa seutuvarauksen ajurin tiedoston kautta.
  • Micromarc: palvelupiste asettaa seutuvarauksen ajurin tiedoston kautta

Maksurajapinnat

Maksurajapinnat mahdollistavat käyttäjälle esimerkiksi myöhästymismaksujen maksun Finna-verkkopalvelun kautta. Maksurajapinnat on tällä hetkellä toteutettu sekä Aurora että Micromarc-järjestelmistä.

Jos haluatte ottaa maksurajapinnan käyttöön, olkaa yhteydessä Finnan palvelupisteeseen.

Aurora-ajurin asetukset

Seuraavat asetukset koskevat vain Aurora-järjestelmiä.

Huom! Ota yhteys finna-postiin asetusten muokkaamiseksi keskitetysti. Paikallisesti tehtävät muutokset näkyisivät vain kyseisessä näkymässä.

Varaukset

(Holds)

AsetusTyyppiOletusKuvaus
defaultRequiredDatepäivät, kuukaudet, vuodet2 vuottaVarauksen tekohetkestä eteenpäin laskettava päivämäärä varauksen oletusvoimassaoloajalle.
enableItemHoldsKyllä/EiKylläSallitaanko varausten tekeminen.
extraHoldFieldslistapickUpLocation

Lista kentistä, jotka varauslomakkeella näytetään. Mahdolliset arvot ovat:

  • comments, sallii varausta koskevat kommentit
  • startDate, sallii varauksen aloituspäivän muuttamisen
  • requiredByDate,  sallii voimassaoloajan vaihtamisen
  • pickUpLocation, sallii noutopaikan vaihtamisen
  • acceptTerms, näyttää varauksen ehdot. Katso kohta acceptTerms[*,fi,sv,en-gb]
excludeOrganisationsFromNormalHoldPickUplistatyhjäPoistaa halutut organisaatiot kuntavarauksen noutopaikkalistasta. Esimerkiksi "1:3" poistaa organisaatiot ID:llä 1 ja 3.
excludeLocationsFromNormalHoldPickUplistatyhjä

Poistaa halutut sijainnit kuntavarauksen noutopaikkalistasta. Esimerkiksi "1.001:7.115" poistaa sijainnit tunnuksilla 1.001 ja 7.115.

  • Numero ennen pistettä on organisaation ID. Pisteen jälkeen tulee sijainnin ID.
excludeOrganisationsFromRegionalHoldPickUplistatyhjäPoistaa halutut organisaatiot seutuvarauksen noutopaikkalistasta. Esimerkiksi "1:3" poistaa organisaatiot ID:llä 1 ja 3.
excludeLocationsFromRegionalHoldPickUplistatyhjä

Poistaa halutut sijainnit seutuvarauksen noutopaikkalistasta. Esimerkiksi "1.001:7.115" poistaa sijainnit tunnuksilla 1.001 ja 7.115.

  • Numero ennen pistettä on organisaation ID. Pisteen jälkeen tulee sijainnin ID.
defaultRequestGrouptekstityhjä

Määrittää varauksen tyypin perusarvon .

  • Tyhjä teksti tarkoittaa kuntavarausta
  • user-selected tarkoittaa, että käyttäjän täytyy valita varauksen tyyppi
  • regional tarkoittaa seutuvarausta
regionalHoldKyllä/EiEiSallitaanko seutuvaraukset.
helpText[*]tekstityhjäLomakkeella näytettävä oletus-ohjeteksti. Voi sisältää html-koodia. Huolehdittava html-koodauksesta.
helpText[fi]tekstityhjäSuomenkielisellä lomakkeella näytettävä ohjeteksti. Voi sisältää html-koodia. Huolehdittava html-koodauksesta.
helpText[sv]tekstityhjäRuotsinkielisellä lomakkeella näytettävä ohjeteksti. Voi sisältää html-koodia. Huolehdittava html-koodauksesta.
helpText[en-gb]tekstityhjäEnglanninkielisellä lomakkeella näytettävä ohjeteksti. Voi sisältää html-koodia. Huolehdittava html-koodauksesta.
updateHelpText[*]tekstityhjäMuokkauslomakkeella näytettävä oletus-ohjeteksti. Voi sisältää html-koodia. Huolehdittava html-koodauksesta.
updateHelpText[fi]tekstityhjäSuomenkielisellä muokkauslomakkeella näytettävä ohjeteksti. Voi sisältää html-koodia. Huolehdittava html-koodauksesta.
updateHelpText[sv]tekstityhjäRuotsinkielisellä muokkauslomakkeella näytettävä ohjeteksti. Voi sisältää html-koodia. Huolehdittava html-koodauksesta.
updateHelpText[en-gb]tekstityhjäEnglanninkielisellä muokkauslomakkeella näytettävä ohjeteksti. Voi sisältää html-koodia. Huolehdittava html-koodauksesta.
acceptTermsTexttekstityhjäLomakkeella optionaalisesti näytettävän ehtojen hyväksyntäkentän teksti. Voi sisältää html-koodia.
acceptTermsText[fi]tekstityhjäSuomenkielisellä lomakkeella optionaalisesti näytettävän ehtojen hyväksyntäkentän teksti. Voi sisältää html-koodia.
acceptTermsText[sv]tekstityhjäRuotsinkielisellä lomakkeella optionaalisesti näytettävän ehtojen hyväksyntäkentän teksti. Voi sisältää html-koodia.
acceptTermsText[en-gb]tekstityhjäEnglanninkielisellä lomakkeella optionaalisesti näytettävän ehtojen hyväksyntäkentän teksti. Voi sisältää html-koodia.
singleReservationQueueKyllä/EiEiNäytä yksinkertainen varausjono.
updateFieldslistapickUpLocation:frozen:frozenThrough:requiredByDate

Kentät, joiden arvoja pystytään päivittämään varauksissa. Tämä ei ole mahdollista, jos kohde on matkalla tai noudettavissa.

  • pickUpLocation, sallii noutopaikan vaihtamisen
  • frozen, sallii jäädyttämisen
  • frozenThrough, sallii jäädyttämisen ajankohdan vaihtamisen
  • requiredByDate, sallii voimassaoloajan vaihtamisen

Lainat

(Loans)

AsetusTyyppiOletusKuvaus
renewalLimitnumero-Lainojen uusimisten maksimimäärä. Jos määritelty, näytetään uusimiskerrat muodossa uusittu / maksimi kun laina on uusittu ainakin kerran. Jos ei ole määritelty, näytetään jäljelläolevat uusimiskerrat. Kumpaakaan tietoa ei näytetä, jos lainalla on pysyvä esto uusimiselle.

Saatavuustiedot

(Holdings)

AsetusTyyppiOletusKuvaus
holdingsOrganisationOrderlistatyhjäNäyttää saatavuustiedot organisaatioiden mukaan listassa annetussa järjestyksessä. Esimerkiksi: "1:2:3".
holdingsBranchOrderlistatyhjäNäyttää sijaintien saatavuustiedot sijaintien mukaan listassa annetussa järjestyksessä. Esimerkiksi: "001:095:100:110:115:120"
display_title_hold_in_resultsKyllä/EiKylläNäytetäänkö varauslinkki hakutuloslistassa

Salasanan vaihto

(changePassword)

AsetusTyyppiOletusKuvaus
minLengthnumero4PIN-koodin vaadittu minimipituus
maxLengthnumero4PIN-koodin vaadittu maksimipituus

Osoitetietojen päivittäminen

(updateAddress)

AsetusTyyppiOletusKuvaus
methodtekstidatabase

Valitse tapa, millä yhteystiedot päivitetään.

  • database, lomake tallennetaan Finnan tietokantaan ja niitä pystyy lukemaan hallintaliittymässä.
  • driver, vain jos on olemassa patronaurora. Vaihdetaan suoraan rajapinnan kautta
  • url, ulkoinen linkki tietojen vaihtamista varten
fields[]taulukkofields[] = Address:address1
fields[] = Zip:zip
fields[] = City:city
fields[] = Country:country
fields[] = Phone:phone
fields[] = Email:email
fields[] = Additional info:info

Valitse kentät, mitä yhteystietoja voidaan päivittää.

  • Address:address1, osoite, pakollinen driver vaihtoehdolla.
  • Zip:zip, postinumero, pakollinen driver vaihtoehdolla.
  • City:city, kaupunki, pakollinen driver vaihtoehdolla.
  • Country:country, maa.
  • Phone:phone, puhelinnumero.
  • Email:email, sähköpostiosoite.
  • Additional info:info, lisätietoja.
urltekstityhjäLinkki osoitetietojen vaihtamista varten ulkoiselle sivulle. Yleinen.
url[fi]tekstityhjäLinkki osoitetietojen vaihtamista varten ulkoiselle sivulle. Suomenkielinen.
url[sv]tekstityhjäLinkki osoitetietojen vaihtamista varten ulkoiselle sivulle. Ruotsinkielinen.
url[en-gb]tekstityhjäLinkki osoitetietojen vaihtamista varten ulkoiselle sivulle. Englanninkielinen.

Palautteen asetus

(Feedback)

AsetusTyyppiOletusKuvaus
domaintekstityhjäNäkymän subdomain ilman www. alkua, jotta pystytään tallentamaan lomakkeet oikealle instituutiolle tietokantaan.

Päivitä sähköposti

(updateEmail) (Finna2)

AsetusTyyppiOletusKuvaus
methodtekstidriver

Tapa, jolla sähköposti päivitetään.

  • driver, päivitetään suoraan järjestelmään.
encodeEmailPlusSignKyllä/EiKylläEstää sen, ettei plussamerkit muutu välilyönneiksi tallennuksessa.

Päivitä puhelinnumero

(updatePhone) (Finna2)

AsetusTyyppiOletusKuvaus
methodtekstityhjä

Tapa, jolla puhelinnumero päivitetään.

  • driver, päivitetään suoraan järjestelmään.

Päivitä ilmoitukset

(updateMessagingSettings)

AsetusTyyppiOletusKuvaus
methodtekstityhjä

Tapa, jolla ilmoitusasetukset päivitetään.

  • driver, päivitetään suoraan järjestelmään.  (Finna2)
  • database, lomake tallennetaan Finnan tietokantaan ja niitä pystyy lukemaan hallintaliittymässä.

Ilmoitusasetusten rajaus

(messagingFilters)

AsetusTyyppiOletusKuvaus
pickUpNoticelistatyhjä

Poistaa tavat, joilla ilmoitus kun varaus on noudettavissa, lähetetään.

  • email, poistaa sähköpostin valinnan.
  • snailMail, poistaa kirjeen valinnan.
  • sms, poistaa tekstiviestin valinnan.
overDueNoticelistatyhjä

Poistaa tavat, joilla ilmoitus kun laina on myöhässä, lähetetään.

  • email, poistaa sähköpostin valinnan.
  • snailMail, poistaa kirjeen valinnan.
  • sms, poistaa tekstiviestin valinnan.
dueDateAlertlistatyhjä

Poistaa tavat, joilla ilmoitus kun laina on loppumassa, lähetetään.

  • email, poistaa sähköpostin valinnan.
  • ilsDefined, poistaa tyhjän valinnan.
  • sms, poistaa tekstiviestin valinnan.

Lainahistorian asetukset

(getMyTransactionHistory) (Finna2)

AsetusTyyppiOletusKuvaus
max_resultsnumerotyhjäKuinka monta lainaa haetaan lainahistoriasta.
default_sorttekstiCHECK_OUT_DATE DESCENDING

Lainahistorian vakiojärjestys.

sort['CHECK_OUT_DATE DESCENDING']tekstisort_checkout_date_descKäännösavain mitä Finnassa käytetään vastaavassa lajittelussa.
sort['CHECK_OUT_DATE ASCENDING']tekstisort_checkout_date_ascKäännösavain mitä Finnassa käytetään vastaavassa lajittelussa.
sort['CHECK_IN_DATE DESCENDING']tekstisort_return_date_descKäännösavain mitä Finnassa käytetään vastaavassa lajittelussa.
sort['CHECK_IN_DATE ASCENDING']tekstisort_return_date_ascKäännösavain mitä Finnassa käytetään vastaavassa lajittelussa.
sort['AUTHOR ASCENDING']tekstisort_authorKäännösavain mitä Finnassa käytetään vastaavassa lajittelussa.
sort['TITLE ASCENDING']tekstisort_titleKäännösavain mitä Finnassa käytetään vastaavassa lajittelussa.

Lainahistorian kytkeminen

(updateTransactionHistoryState) (Finna2)

AsetusTyyppiOletusKuvaus
methodtekstidriver

Tapa millä lainahistoriaa voidaan asettaa.

  • driver, asetetaan suoraan järjestelmässä.
options[1]tekstiloan_history_forever

Lainahistorian asetus, että lainahistoria on aina päällä.

options[0]tekstiloan_history_never

Lainahistorian asetus, että lainahistoria on aina poissa päältä.

Verkkomaksamisen asetukset

(onlinePayment)

AsetusTyyppiOletusKuvaus
enabledKyllä/EiKylläOnko verkkomaksaminen sallittu.
transactionFeenumerotyhjä

Verkkomaksamisesta lisämaksu. Lisämaksun määrä ilmoitetaan sentteinä. Esimerkiksi: 50.

minimumFeenumero65Pienin summa, minkä voi maksaa. Summa ilmoitetaan sentteinä.
errorEmailtekstityhjäSähköpostiosoite mihin lähetetään ilmoitus, jos maksua ei onnistuttu rekisteröimään.
transactionMaxDurationnumero15Verkkomaksun maksimiaika minuutteina.
currencytekstiEURMäärittää mitä valuuttaa käytetään.
nonPayable[]regexnonPayable[] = '/^Lasku - Lasku\b/'
nonPayable[] = '/^Muu maksu/'		Määrittää mitä maksuja ei voi verkossa maksaa. Voi olla regex tai kokonainen lause.
exactBalanceRequiredKyllä/EiEiMäärittää voiko summia, mitkä ovat pienempiä kuin vaadittu summa, maksaa.

Teoslistojen välimuistiasetukset

(titleListCacheSettings)(Finna2)

AsetusTyyppiOletusKuvaus
settings[new]numero15Kuinka kauan uusimmat teoslista on välimuistissa Finnassa, ennenkuin tehdään uusi pyyntö. Numero tarkoittaa minuutteja.
settings[lastreturned]numero15Kuinka kauan viimeksi palautetut teoslista on välimuistissa Finnassa, ennenkuin tehdään uusi pyyntö. Numero tarkoittaa minuutteja.
settings[mostborrowed]numero480Kuinka kauan lainatuimmat teoslista on välimuistissa Finnassa, ennenkuin tehdään uusi pyyntö. Numero tarkoittaa minuutteja.
settings[mostrequested]numero240Kuinka kauan varatuimmat teoslista on välimuistissa Finnassa, ennenkuin tehdään uusi pyyntö. Numero tarkoittaa minuutteja.
  • No labels