Huom! Ota yhteys finna-postiin asetusten muokkaamiseksi keskitetysti. Paikallisesti tehtävät muutokset näkyisivät vain kyseisessä näkymässä.
Sisällysluettelo
Kirjautumisasetukset
(Catalog)
| Asetus | Tyyppi | Oletus | Kuvaus |
|---|---|---|---|
| loginMethod | Valinta | Kirjautumistapa (email tai password) |
Jos Shibboleth-kirjautumisessa saatavan käyttäjän tunnisteen (eduPersonPrincipalId tai sähköpostiosoite) perusteella halutaan luoda käyttäjälle automaattisesti kirjastokortti, tarvitaan muutos config.ini:n Shibboleth-sektioon idp_to_ils_map-asetukseen. Tämäkin muutos tehdään keskitetysti. Muutoksen tekemiseksi tarvittavat tiedot ovat:
- IdP, jota sääntö koskee (esim. https://testidp.funet.fi/idp/shibboleth)
- Shibboleth-attribuutti, jonka perusteella mappaus tehdään (esim. eduPersonPrincipalName tai mail)
- Mitä Alma-instanssia sääntö koskee
Varaukset
(Holds)
| Asetus | Tyyppi | Oletus | Kuvaus |
|---|---|---|---|
| defaultRequiredDate | päivät, kuukaudet, vuodet | 1 kuukausi | Varauksen tekohetkestä eteenpäin laskettava päivämäärä varauksen oletusvoimassaoloajalle |
| defaultPickUpLocation | Määrittelemätön, tyhjä tai location id | Määrittelemätön | Jos määrittelemätön, käyttäjän on aina valittava noutopiste itse. Jos tyhjä, oletuksena ensimmäinen noutopiste. Muuten oletuksena annettu noutopiste. |
| pickUpLocationOrder | id-lista | aakkosjärjestys | Noutopisteiden järjestys valintakentässä. Noutopisteet, joita tässä ei listata, näytetään aakkosjärjestyksessä. |
| extraHoldFields | lista | requiredByDate: | Lista kentistä, jotka varauslomakkeella näytetään. Mahdolliset arvot ovat comments, requiredByDate, pickUpLocation ja acceptTerms. |
| helpText | teksti | tyhjä | Lomakkeella näytettävä ohjeteksti. Voi sisältää html-koodia. |
| helpText[fi] | teksti | tyhjä | Suomenkielisellä lomakkeella näytettävä ohjeteksti. Voi sisältää html-koodia. |
| helpText[sv] | teksti | tyhjä | Ruotsinkielisellä lomakkeella näytettävä ohjeteksti. Voi sisältää html-koodia. |
| helpText[en-gb] | teksti | tyhjä | Englanninkielisellä lomakkeella näytettävä ohjeteksti. Voi sisältää html-koodia. |
| acceptTermsText | teksti | tyhjä | Lomakkeella optionaalisesti näytettävän ehtojen hyväksyntäkentän teksti. Voi sisältää html-koodia. |
| acceptTermsText[fi] | teksti | tyhjä | Suomenkielisellä lomakkeella optionaalisesti näytettävän ehtojen hyväksyntäkentän teksti. Voi sisältää html-koodia. |
| acceptTermsText[sv] | teksti | tyhjä | Ruotsinkielisellä lomakkeella optionaalisesti näytettävän ehtojen hyväksyntäkentän teksti. Voi sisältää html-koodia. |
| acceptTermsText[en-gb] | teksti | tyhjä | Englanninkielisellä lomakkeella optionaalisesti näytettävän ehtojen hyväksyntäkentän teksti. Voi sisältää html-koodia. |
| pickupLocationRules[] | lista | määrittelemätön | Varausten noutopisteiden rajaussäännöt. Kenttää voi toistaa. Säännöt käsitellään järjestyksessä alusta loppuun tai kunnes osuvassa säännössä on pysäytysehto (match=stop). Jokainen sääntö sisältää yhden tai useampia kenttiä ja niiden arvoja. Kentät ja niiden käyttö on kuvattu allaolevassa erillisessä taulukossa. |
Varausten noutopaikat
Almassa ei tällä hetkellä (11/2019) ole rajapintaa, jolla voisi pyytää varausta tehtäessä kelvolliset noutopaikat, joten Finnaan on lisätty pickupLocationRules-säännöstö (ks. ylläoleva taulukko), jolla voi luoda säännöt sille, mitkä noutopaikat käyttäjälle näytetään. Alma osaa kyllä olla hyväksymättä varausta, jos noutopaikka ei ole kelvollinen, mutta hyvän käyttökokemuksen tarjoamiseksi olisi hyödyllistä rajata noutopaikat ainakin yleisimmissä tapauksissa kelvollisiin vaihtoehtoihin.
Säännöissä on käytettävissä seuraavat kentät. Kentät erotetaan toisistaan kaksoispisteellä. Lista-muotoisissa kentissä arvot erotetaan toisistaan pilkulla. Jos arvo sisältää kaksoispisteitä tai pilkkuja, sen ympärille laitetaan heittomerkit.
| Kenttä | Mahdolliset arvot | Kuvaus |
|---|---|---|
| lib | library code | Kirjaston koodi (tarvitaan, jos location codet menevät päällekkäin eri kirjastoissa) |
| loc | location code (lista) | Niteen sijainnit |
| avail | location code (lista) | Sijainnit, joissa on niteitä saatavissa |
| unavail | location code (lista) | Sijainnit, jossa yksikään nide ei ole saatavissa |
| group | user group code (lista) | Asiakasryhmät |
| level | copy (=nide) tai title (=teos) | Onko kyseessä nide- vai teosvaraus |
| match | stop | Lopettaa sääntöjen käsittelyn, jos tämä sääntö osuu varauksen tietoihin |
| pickup | library code (lista) | Säännön sallimat noutopisteet |
| home | true | Kotiosoitteeseen toimitus sallittu (jos kotiosoite löytyy käyttäjän tiedoista) |
| work | true | Työosoitteeseen toimitus sallittu (jos työosoite löytyy käyttäjän tiedoista) |
Esimerkkejä
| Sääntö | Kuvaus |
|---|---|
| loc=MAIN:pickup=MAINLIB | Jos niteitä on paikassa MAIN, niin noutopaikaksi käy MAINLIB |
| loc=MAIN:group=STAFF:pickup=MAINLIB:work=true | Jos niteitä on paikassa MAIN ja käyttäjä kuuluu ryhmään STAFF, niin noutopaikaksi käy MAINLIB tai työosoite |
Saatavuustiedot
(Holdings)
| Asetus | Tyyppi | Oletus | Kuvaus |
|---|---|---|---|
| digitalDeliveryUrl | teksti | Jos digital delivery on käytössä, sen osoite. Muoto: "https://SOMETHING.alma.exlibrisgroup.com/view/delivery/INSTITUTION/%%id%%" | |
| inventoryTypes | lista | physical:electronic | Mitkä tyypit näytetään saatavuustiedoissa. Mahdolliset arvot ovat physical, electronic ja digital |
| itemLimit | numero | 100 | Saatavuustiedoissa yhdellä sivulla näytettävien niteiden maksimimäärä |
Huom! Jotta linkit elektronisen aineiston saatavuustiedoissa toimisivat oikein, on Almassa määriteltävä asetus publishing_base_url. Muuten Alma palauttaa linkit muodossa "publishing_base_url undefined?u.ignore_date_coverage=true&rft.mms_id=991...".
Alman ohje: Note: $$u will be created based on a Customer Parameter in the "Customer Parameters" mapping table (module: general): publishing_base_url.
Elektronisen aineiston linkkien ohjaus mahdolliseen EZProxyyn tapahtuu Almassa, eli Alma ilmoittaa omien asetustensa perusteella Finnalle osoitteen, jossa on proxyn osoite edessä. Lisätietoa Alman ohjeissa.
OpenURL-linkitys
Mikäli halutaan käyttää SFX:n sijaan Alman OpenURL-linkityspalvelua, tulee muutokset tehdä näkymän local/config/vufind/config.ini-tiedostoon (tätä ohjetta kirjoitettaessa ei Finnan hallintaliittymässä voi valita Almaa OpenURL-resolveriksi). Korvaa mahdollinen olemassaoleva OpenURL-sektio tai lisää uusi:
[OpenURL] url = "https://<jotain>.alma.exlibrisgroup.com/view/uresolver/<instituutio>/openurl" resolver = "alma"
Esimerkit toimivista url:ista:
https://uoasl.alma.exlibrisgroup.com/view/uresolver/358SUOASL_INST/openurl
https://fin-aau.alma.exlibrisgroup.com/view/uresolver/358FIN_AAU/openurl-aa-campus
Ex Libriksen dokumentaation mukaan osoitteen muoto on:
- multi-campus -instituutioissa: <Alma delivery domain>/view/uresolver/<institution_code>/openurl-<campus code>
- muuten: <Alma delivery domain>/view/uresolver/<institution_code>/openurl
Proxy-asetukset eli mahdollinen ohjaus EZProxyyn tehdään Alman puolella Alman asetuksia käyttäen. Linkitys menee aina Alman kautta, ja Alma lisää tarvittaessa proxyn osoitteen kohdeosoitteen eteen. Lisätietoa Alman ohjeissa.
Omien tietojen muutospyyntö
(updateProfile)
| Asetus | Tyyppi | Oletus | Kuvaus |
|---|---|---|---|
| fields | array | address1,address2,zip,city,country,email,phone,self_service_pin | Yhteystietojen muutoslomakkeella näytettävät kentät |
Verkkomaksaminen
(OnlinePayment)
Ks. ohje verkkomaksamisen käyttöönotosta.
| Asetus | Tyyppi | Oletus | Kuvaus |
|---|---|---|---|
| enabled | Kyllä/Ei | Ei | Voiko käyttäjä maksaa verkkomaksuja. |
| transactionFee | numero | Palvelumaksu (senteissä). | |
| minimumFee | numero | Pienin maksettavissa oleva summa (senteissä). | |
| nonPayable[] | array | LOSTITEMREPLACEMENTFEE | Maksutyypit, joita ei voi maksaa verkossa. |
| errorEmail | teksti | Sähköpostiosoite, johon lähetetään ilmoitus epäonnistuneista maksuista. | |
| transactionMaxDuration | numero | Kuinka monta minuuttia odotetaan, että käyttäjä palaa maksupalvelusta takaisin Finnaan. | |
| currency | teksti | Valuutta. | |
Seuraavat maksupalvelun asetukset sijoitetaan tiedostoon datasources.ini | |||
| onlinePayment['handler'] | teksti | Maksupalvelu (Paytrail tai CPU). | |
| onlinePayment['url'] | teksti | Osoite. | |
| onlinePayment['merchantId'] | teksti | Kauppiastunnus. | |
| onlinePayment['secret'] | teksti | Salasana. |
