Huom! Ota yhteys finna-postiin asetusten muokkaamiseksi keskitetysti. Paikallisesti tehtävät muutokset näkyisivät vain kyseisessä näkymässä. |
(Catalog)
Asetus | Tyyppi | Oletus | Kuvaus |
---|---|---|---|
loginMethod | Valinta | Kirjautumistapa (email tai password) | |
groupFees | true/false | false | Ryhmitelläänkö asiakkaan maksut tyypin, tilan, nimekkeen ja viivakoodin mukaan. Hyödyllinen ainakin niissä tapauksissa, joissa Alma luo päivittäin erillisen myöhästymismaksun. |
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. Lähetä muutoksen tekemiseksi seuraavat tiedot Finnan palveluosoitteeseen [email protected]:
(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. |
enableItemHolds | true,false tai "description" | "description" |
|
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. Arvoissa loc, avail, unavail ja group voi käyttää säännöllisiä lausekkeita (esim. loc=S.* kelpuuttaa kaikki S-alkuiset sijainnit).
Arvon voi kääntää negatiiviseksi lisäämällä sen eteen huutomerkin. Positiivisia ja negatiivisia sääntöjä ei voi sekoittaa, vaan silloin negatiiviset voittavat aina.
Kenttä | Mahdolliset arvot | Kuvaus |
---|---|---|
lib | library code | Kirjaston koodi (voidaan käyttää yksinään tai loc-kentän kanssa, jos location codet menevät päällekkäin eri kirjastoissa) |
availlib | library code | Kirjaston koodi kirjastossa, jossa niteitä on saatavissa (voidaan käyttää yksinään tai availloc-kentän kanssa, jos location codet menevät päällekkäin eri kirjastoissa) |
unavaillib | library code | Kirjaston koodi kirjastossa, jossa yksikään nide ei ole saatavissa (voidaan käyttää yksinään tai unavailloc-kentän kanssa, 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 |
policy | item policy code (lista) | Niteen policy code |
availpolicy | item policy code (lista) | Niteen policy code sijainnissa, jossa on niteitä saatavissa |
unavailpolicy | item policy code (lista) | Niteen policy code sijainnissa, 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/false | Onko kotiosoitteeseen toimitus sallittu (jos kotiosoite löytyy käyttäjän tiedoista) |
work | true/false | Onko työosoitteeseen toimitus sallittu (jos työosoite löytyy käyttäjän tiedoista) |
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 |
loc=R.*:pickup=RAUMA | Jos paikka alkaa R:llä, noutopaikaksi käy RAUMA |
lib=Boktornet:unavail=biologi,biolsaml,biovet:pickup=Boktornet | Jos Boktornet-kirjaston locationeissa biologi, biolsaml tai biovet on niteitä mutta ei yhtään paikalla, käy noutopaikaksi Boktornet |
lib=Boktornet:loc=gadolin:pickup=Boktornet | Jos Boktornet-kirjaston locationissa gadolin on niteitä (riippumatta siitä, ovat paikalla vai eivät), käy noutopaikaksi Boktornet |
policy=arkiv-28:work=false | Jos item policy on arkiv-28, ei toimitustyöosoitteeseen ole sallittu |
group=staff:policy=!archive:loc=economy,social:work=true | Jos asiakasryhmä on staff, niteen policy EI ole archive ja niteen location on economy tai social, on työosoitteeseen toimitus sallittu |
(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ä |
holdingsLocationOrder | lista | tyhjä | Oletuksena saatavuustiedot näytetään aakkosjärjestyksellä. Tällä asetuksella voi listata location codet halutussa järjestyksessä, tai määritellä yksittäisille location codeille järjestysnumero niiden tiputtamiseksi viimeisiksi. Listalla mainitsemattomat locationit saavat järjestysnumeron 999. Esimerkkejä:
|
sortByEnumChron | Kyllä/Ei | Kyllä | Järjestetäänkö niteet locationin sisällä numerointitiedon mukaisesti. |
hiddenProcessTypes[] | array | hiddenProcessTypes[ISSUE] = 'ACQ' | Fyysisen aineistotyypin process typet, jotka piilotetaan saatavuustietonäytöllä. Aineistotyypin paikalla voi olla myös *, jolloin sääntö koskee kaikkia aineistotyyppejä. |
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...". Varmista, että osoite alkaa https:// |
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. |
Alman voi määrittää linkityspalveluksi Finnan hallintaliittymässä. Osoite on yleensä muotoa https://<jotain>.alma.exlibrisgroup.com/view/uresolver/<instituutio>/openurl
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:
Tee mahdolliset proxy-asetukset eli ohjaus EZProxyyn Alman puolella Alman asetuksia käyttäen. Linkitys menee aina Alman kautta, ja Alma lisää tarvittaessa proxyn osoitteen kohdeosoitteen eteen. Lisätietoa Alman ohjeissa. |
(updateProfile)
Asetus | Tyyppi | Oletus | Kuvaus |
---|---|---|---|
fields | array |
| Yhteystietojen muutoslomakkeella näytettävät kentät. Kukin osoite sisältää seuraavat kentät:
|
disabledFields | lista | tyhjä | Yhteystietojen muutoslomakkeelta piilotettavat kentät (ylläpidon helpottamiseksi, jotta fields-asetuksia ei tarvitse toistaa kokonaan) |
(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. |