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" |
|
...
(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. |