Systemadministration DDElibra Webservices 9.8.44 Axiell Bibliotek A/S 2010-11-25 Copyright 2010
2 1 Indholdsfortegnelse 1 Indholdsfortegnelse... 2 2 Introduktion... 3 3 DDElibra Web Services ændringer... 3 3.1 Encoding af danske bogstaver ifm. reservering... 3 3.2 Tidsskriftsoplysninger i loan og reservation... 3 3.3 Login via NemLogin... 3 3.4 Ændringer styret af trimmeværdien UAcr arena-version... 4 3.4.1 getavailability udvidet... 4 3.4.2 debttype udvidet... 4 3.4.3 addreservation returkoder ændret... 5 3.4.4 showreservationbutton i getcataloguerecorddetail... 5
3 2 Introduktion Følgende beskriver væsentlige ændringer fra DDElibra Web Services vs. 9.8.36 til vs. 9.8.44. Se også de opdaterede udgaver af AlmaMessage.doc og AlmaMessage.xsd. 3 DDElibra Web Services ændringer 3.1 Encoding af danske bogstaver ifm. reservering Når der sendes en AddReservation til serveren, kan url'en indeholde danske eller andre nationale tegn, f.eks. æ, ø eller å. Før 9.8.44 skulle url'en derfor url-encodes, men ikke utf-8 encodes. I 9.8.44 eller senere versioner, skal url'en både utf-8 encodes og url-encodes. Eksempel på tidsskriftsangivelse: 06373674ZXNr. 33#tillægZXZX2006ZXZX Ovenstående tidsskriftsangivelse url-encoded (før 9.8.44): 06373674ZXNr.%2033%23till%E6gZXZX2006ZXZX Ovenstående tidsskriftsangivelse både utf-8 og url-encoded (fra og med 9.8.44): 06373674ZXNr.%2033%23till%C3%A6gZXZX2006ZXZX 3.2 Tidsskriftsoplysninger i loan og reservation Der er tilføjet note-elementer til loan- og reservation-elementerne. note-elementet vil indeholde år, volume og nummer ifm. tidsskriftseksemplarer. 3.3 Login via NemLogin Hvis brugergrænsefladen giver mulighed for at låneren kan autentificeres via en ekstern service, f.eks. Nemlogin, er der mulighed for at tilgå alle DDElibra Web Services som anvender pinkode, uden at lånerens pinkode skal være kendt. I så fald skal klient-applikationen i stedet sende en specifik kode i pincode, som dermed indikerer at låneren allerede er autentificeret. Denne kode skal angives i flg. trimmeværdi: Eksempel Nøgle Spr Ejer Indhold SScr alma-secret-pincode *** dde #secret534%kfd" Den angivne pinkode må maks. være 20 tegn. Hvis indhold er tomt, kan der kun logges ind med lånerens egen pinkode.
4 Bemærk: det er afgørende for sikkerheden at brugergrænsefladen ikke giver mulighed for at indtaste eller sende pinkoden, som den er angivet i SScr alma-secret-pincode. 3.4 Ændringer styret af trimmeværdien UAcr arena-version Følgende trimmeværdi styrer, at visse ændringer i DDElibra Web Services først træder i kraft, når indhold ændres til en nyere version. Eksempel Nøgle Spr Ejer Indhold UAcr arena-version *** ******** 1.2 Standard har indtil 9.8.44 været 1.2. Hvis indhold ændres til 1.5.4, træder følgende ændringerne beskrevet i de følgende afsnit i kraft. 3.4.1 getavailability udvidet Servicen getavailability har tidligere returneret værdierne yes/no i isavailable. Det vil den stadigvæk gøre, hvis trimmeværdien ændres til 1.5.4, men der vil derudover blive returneret en udvidet status for materialet i availabilityinformation. Følgende status-værdier kan blive returneret fra DDElibra: availabilityinformation isavailable Beskrivelse periodical yes materialet er et tidsskrift quarantined no biblioteket har materialet, men det er karensbelagt referenceonly yes biblioteket har materialet, men det er ikke til udlån availableforloan yes materialet kan udlånes checkedout no alle tilgængelige eksemplarer er udlånt inacquisition no materialet haves ikke, men er bestilt internetaccessible yes elektronisk ressource noholding no biblioteket har ikke materialet Samme værdier vil blive returneret ifm. getcataloguerecorddetail servicen i statusattributten i holding elementet. Dog kan værdierne periodical og internetaccessible ikke optræde her. 3.4.2 debttype udvidet Attributten debttype kan antage flere værdier. Den samlede liste over værdier som anvendes i DDElibra er: overduefeeinvoicedebt overduefeedebt loanfeedebt Erstatning Gebyr for for sen aflevering. Anvendes også ifm. regninger, hvor erstatningsbeløbet er blevet slettet. Udlån
5 reservationpickupfeedebt reservationfeedebt deletereservationfeedebt illfeedebt smsreservationfeedebt smsreminderfeedebt smsrecall1feedebt smsrecall2feedebt smsrecall3feedebt smsrecall4feedebt smsrecall5feedebt emailreminderfeedebt otherfeedebt Afhentet reservering Reservering Slettet opfyldt reservering Fjernlån Sms, afhentet reservering Sms, påmindelse Sms, 1. hjemkaldelse Sms, 2. hjemkaldelse Sms, 3. hjemkaldelse Sms, 4. hjemkaldelse Sms, 5. hjemkaldelse E-mail, påmindelse Andet 3.4.3 addreservation returkoder ændret addreservation vil nu altid returnere "ok" i status-elemenetet. Det betyder at status for om en reservering er blevet oprettet eller ej, skal ses i reservationstatus, hvor value kan antage værdierne reservationok (reservering er blevet oprettet) eller reservationnotok (reservering er ikke blevet oprettet). En mere specifik angivelse af fejlen i tilfælde af reservationnotok ses i key. 3.4.4 showreservationbutton i getcataloguerecorddetail Elementet detailcataloguerecord i getcataloguerecorddetailresponse indeholder attributten showreservationbutton. Den har tidligere haft værdien "no" ifm. tidsskrifter, men vil nu få værdien "yes", hvis der er tilgængelige tidsskriftseksemplarer.