Page History
...
Sisällysluettelo
Table of Contents |
---|
Yleiset asetukset ja koodien kielikäännökset
(General)
Asetus | Tyyppi | Oletus | Kuvaus |
---|---|---|---|
translationPrefix | teksti | Finna-toimisto asettaa | Koodien kielikäännöksille käytettävä etuliite |
Käännösavaimet
Käännösavaimessa (PREFIX) tarkoittaa yllämainitun translationPrefix-asetuksen arvoa.
Käännettävä tieto | Käännösavain | Kuvaus | Oletusarvo | Esimerkki |
---|---|---|---|---|
Sijainti (saatavuustiedot) | (PREFIX)(KOODI) | (KOODI) on location code Almassa | Locationin external name | abo_alma_max |
Noutopaikat varauksille | (PREFIX)pickup_location_(KOODI) | (KOODI) on location code Almassa | Locationin external name | abo_alma_pickup_location_max |
Kotiosoitteeseen toimitus noutopaikkana | (PREFIX)pickup_location_home_address | Näytetään, jos kotiosoitteeseen toimitus on sallittu | "Toimitus kotiosoitteeseen" | abo_alma_pickup_location_home_address |
Työosoitteeseen toimitus noutopaikkana | (PREFIX)pickup_location_work_address | Näytetään, jos työosoitteeseen toimitus on sallittu | "Toimitus työosoitteeseen" | abo_alma_pickup_location_work_address |
Kirjautumisasetukset
(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 eduPersonPrincipalName ja/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 Lähetä muutoksen tekemiseksi tarvittavat tiedot ovatseuraavat tiedot Finnan palveluosoitteeseen [email protected]:
- IdP, jota sääntö koskee (esim. https://testidp.funet.fi/idp/shibboleth)
- Shibboleth-attribuuttiattribuutit, jonka joiden perusteella mappaus tehdään (esim. eduPersonPrincipalName tai ja mail). Tarvittaessa voidaan määritellä useita attribuutteja, joita Finna kokeilee järjestyksessä toimivan löytämiseksi.
- Mitä Alma-instanssia sääntö koskee
...
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ä (tällä hetkellä eli 4.5.2021 tosin Finnassa oletusasetuksena on ettei järjestetä). Kotiosoitteen koodi on $$HOME, ja työpaikan $$WORK. Huom! Käytä aina lainausmerkkejä. Esim:pickUpLocationOrder = "MAIN:SUB:$$WORK:$$HOME" |
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ä oletus-ohjeteksti. Voi sisältää html-koodia. Huolehdittava html-koodauksesta. |
helpText[fi] | teksti | tyhjä | Suomenkielisellä lomakkeella näytettävä ohjeteksti. Voi sisältää html-koodia. Huolehdittava html-koodauksesta. |
helpText[sv] | teksti | tyhjä | Ruotsinkielisellä lomakkeella näytettävä ohjeteksti. Voi sisältää html-koodia. Huolehdittava html-koodauksesta. |
helpText[en-gb] | teksti | tyhjä | Englanninkielisellä lomakkeella näytettävä ohjeteksti. Voi sisältää html-koodia. Huolehdittava html-koodauksesta. |
updateHelpText[*] | teksti | tyhjä | Muokkauslomakkeella näytettävä oletus-ohjeteksti. Voi sisältää html-koodia. Huolehdittava html-koodauksesta. |
updateHelpText[fi] | teksti | tyhjä | Suomenkielisellä muokkauslomakkeella näytettävä ohjeteksti. Voi sisältää html-koodia. Huolehdittava html-koodauksesta. |
updateHelpText[sv] | teksti | tyhjä | Ruotsinkielisellä muokkauslomakkeella näytettävä ohjeteksti. Voi sisältää html-koodia. Huolehdittava html-koodauksesta. |
updateHelpText[en-gb] | teksti | tyhjä | Englanninkielisellä muokkauslomakkeella näytettävä ohjeteksti. Voi sisältää html-koodia. Huolehdittava html-koodauksesta. |
acceptTermsText | teksti | tyhjä | Lomakkeella optionaalisesti näytettävän ehtojen hyväksyntäkentän teksti. Voi sisältää html-koodia. Huolehdittava html-koodauksesta. |
acceptTermsText[fi] | teksti | tyhjä | Suomenkielisellä lomakkeella optionaalisesti näytettävän ehtojen hyväksyntäkentän teksti. Voi sisältää html-koodia. Huolehdittava html-koodauksesta. |
acceptTermsText[sv] | teksti | tyhjä | Ruotsinkielisellä lomakkeella optionaalisesti näytettävän ehtojen hyväksyntäkentän teksti. Voi sisältää html-koodia. Huolehdittava html-koodauksesta. |
acceptTermsText[en-gb] | teksti | tyhjä | Englanninkielisellä lomakkeella optionaalisesti näytettävän ehtojen hyväksyntäkentän teksti. Voi sisältää html-koodia. Huolehdittava html-koodauksesta. |
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" |
|
...
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 |
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ä |
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ä. |
locationTypeItemStatus[] | array | Käytettävissä 13.6.2023 alkaen. Mappaukset location typestä niteen tilaan. Jokainen mapattu arvo on kaksiosainen, kaksoispisteellä erotettu. Ensimmäinen osa määrittelee näytettävän tilan (käännettävissä status_ -etuliitteellä) ja jälkimmäinen kolmiasentoisen tilan, jonka perusteella näytetään saatavuuden väri ja kuvake (available, unavailable, uncertain). Mapattu arvo ylittää muut niteen saatavuustiedot. Esimerkki, josssa UNAVAIL-tyyppisen sijainnin niteille näytetään tilana "Staff Use" ja kuvakkeena/värinä keltainen "epävarma":
|
Info |
---|
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:// |
Info |
---|
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:
...
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
...
- multi-campus -instituutioissa: <Alma delivery domain>/view/uresolver/<institution_code>/openurl-<campus code>
- muuten: <Alma delivery domain>/view/uresolver/<institution_code>/openurl
Info |
---|
ProxyTee mahdolliset 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. |
Asiakkaaksi ilmoittautuminen
(registerPatron)
Katso erillinen ohjesivu.
Omien tietojen muutospyyntö
...
Asetus | Tyyppi | Oletus | Kuvaus |
---|---|---|---|
fields | array | address1,address2,zip,city,country
| 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) |
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. | |
selectFines | Kyllä/Ei | Ei | Voiko käyttäjä valita maksettavat maksut (käytettävissä Finnan versiosta 2.89.0 eli 18.3.2023 alkaen) |
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. |