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)
...
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. Lähetä muutoksen tekemiseksi seuraavat 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 |
|---|
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. |
Asiakkaaksi ilmoittautuminen
(registerPatron)
Katso erillinen ohjesivu.
Omien tietojen muutospyyntö
...
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. |
