Release Notes Arena 3.0
OM RELEASE NOTES AXIELL ARENA 3.0 Detta dokument kommer att uppdateras oregelbundet och ofta, och vi rekommenderar därför att du varje gång du vill läsa dem kontrollerar om det kommit en senare version. Version A 2015-05-15 Version B 2015-06-09 Version C 2015-07-03 Version D 2015-07-06 Version E 2015-09-02 lagt till förtydligande i punkt 4.4. Lagt till punkt 9.2.1 Version F 2015-09-28 ändrat formulering i punkt 4.4 Version G 2015-11-01 tagit bort punkt om Artikeladministration samt om Samlingar. Lagt till info om lagring av CSS i punkt 9. Version H 2016-02-16 lagt till punkter i avsnitt 2 samt 4. Version I 2016-05-19 lagt till ii
innehåll INNEHÅLL 1 INFRASTRUKTUR 5 2 I SAMBAND MED UPPGRADERINGEN 6 2.1 UPPDATERINGSINDEXERING UNDER UPPGRADERINGSPERIODEN 6 2.2 LÄNKAR 6 2.3 ARBETE MED ARENA-ARTIKLAR UNDER UPPGRADERINGSPERIODEN 6 2.4 EGNA MEDIETYPSIKONER 6 2.5 GOOGLE MAPS 6 2.6 LIFERAY-TIPS 6 2.7 HTTPS I GOOGLE ANALYTICS 6 3 PRESTANDA 7 3.1 INSTÄLLNINGAR AV CACHE 7 4 AUTOMATISKT SKAPADE ANVÄNDARE 8 4.1 SKÄRMNAMN 8 4.2 E-POSTADRESS 8 4.3 NYHETSSERVICE 9 4.4 GLÖMT LÖSENORD 9 4.5 BEGRÄNSNINGAR FÖR AUTOMATISKT SKAPADE ANVÄNDARE 9 4.6 MINA UPPGIFTER 9 4.7 BEFINTLIGA ARENA-ANVÄNDARE 9 5 MINA LÅN 10 5.1 SORTERINGSALTERNATIV 10 5.2 OMLÅNSPROCESSEN 10 5.3 MINA LÅN BUGGRÄTTNINGAR/FÖRBÄTTRINGAR 10 6 RELEVANS 12 6.1 BOOST VID INDEXERING 12 6.2 BOOST I TRÄFFLISTA 12 7 NY LIFERAY-ROLL 13 8 FÖRBÄTTRINGAR OCH BUGGFIXAR 14 9 STYLING 16 9.1 LIFERAY 6.2 CSS-ÄNDRINGAR 17 9.1.1 MARKUP OCH CSS-PREFIX 17 9.1.2 BOOTSTRAP 18 9.2 TEMAN 19 9.2.1 NYTT FÄRGSCHEMA 19 9.2.2 NYA INSTÄLLNINGAR 19 9.3 ARENA 3.0 CSS-ÄNDRINGAR 19 9.3.1 PORTLETKONFIGURATION 19 9.3.2 INSTÄLLNINGAR 20 9.3.3 OMLÅN 20 10 WEBBLÄSARE 21 iii
Fel! Använd fliken Start om du vill tillämpa Heading 1 för texten som ska visas här. 4
infrastruktur 1 INFRASTRUKTUR Sökmotorn Solr uppgraderad till 4.7 Liferay uppgraderat till 6.2 SSL (kryptering) implementeras i samband med uppgraderingen 5
I samband med uppgraderingen 2 I SAMBAND MED UPPGRADERINGEN 2.1 UPPDATERINGSINDEXERING UNDER UPPGRADERINGSPERIODEN Uppdateringsindexeringen kommer inte att fungera under uppgraderingsperioden, men kommer snabbt ikapp efter att 3.0 släpps publikt. 2.2 LÄNKAR Under uppgraderingsperioden fungerar inte alla länkar som de ska. Du kan t ex komma till fel katalogpost om du klickar på en titel i en lista. Detta löses i samband med att 3.0 släpps publikt då vi kör skript som uppdaterar alla länkar till rätt syntax. 2.3 ARBETE MED ARENA-ARTIKLAR UNDER UPPGRADERINGSPERIODEN Om du arbetar med att ändra i befintliga arena-artiklar, eller lägger in nya artiklar under uppgraderingsperioden ska du tänka på att eventuella interna länkar du lägger in måste fungera med både http och https. Dessa skapas motsvarande så här: a href="//bibliotek.kommun.se (alltså utan http:) När version 3.0 är publikt tillgänglig ska interna länkar alltid skapas med https:// 2.4 EGNA MEDIETYPSIKONER Om du lagt in egna medietypsikoner kommer dessa inte att fungera i version 3.0 förrän versionen blir publikt tillgänglig 2.5 GOOGLE MAPS Se över om du har lagt in inbäddade kartbilder från Google maps och ändra i förekommande fall länkarna till https 2.6 LIFERAY-TIPS Det är en stor uppgradering av Liferay. Läs manualen och snabbguiden för att lära dig det nya gränssnittet. 2.7 HTTPS I GOOGLE ANALYTICS Eftersom uppgraderingen samtidigt innebär övergång till https ska du i samband med go live ändra länken till er Arena i Google Analytics Viktigt Innan den uppgraderade versionen blir publikt tillgänglig kommer Arena under en period om cirka 40 minuter varken att vara tillgänglig i version 2.7.2 eller 3.0. Detta beräknas ske ca kl 09:30 6
Prestanda 3 PRESTANDA I Arena version 3.0 har möjligheterna för cachning och asynkron laddning utökats, vilket påverkar prestanda positivt. Ny cachningsmöjlighet förbättrar prestanda i dynamiska listor. De enheter och avdelningar som visas i inställningarna i utökad sökning cachas numera i 24 timmar. Det innebär att ändringar i bibliotekssystemet av vad som ska visas, eller namnändringar, inte slår igenom i Utökad sökning förrän efter 24 timmar. Länkarna för att ladda ner e-media laddas nu asynkront. Visning av tillgänglighet i sökresultat och dynamiska listor laddas nu asynkront, och likaså reservationsknappen i träfflistan. Lokala översättningar cachas så länge de inte ändras. 3.1 INSTÄLLNINGAR AV CACHE Inställningar för cachning har införts i följande portletar: Dynamiska listor (0 sek default) Artiklar: sökresultat (0 sek default) Topplistor (0 sek default) Admin: Om Arena (60 min hårdkodning) I dessa portletar kan du ange hur länge de ska cachas i inställningen Cacha i antal sekunder. Cachen gäller per session. OBS: Om du är inloggad i Liferay cachas inte sökresultat. 7
automatiskt skapade användare 4 AUTOMATISKT SKAPADE ANVÄNDARE Ny funktionalitet har införts som innebär att en låntagare genom att logga in med lånekort/personnummer och PIN-kod automatiskt får tillgång till alla funktioner i Arena. I samband med inloggningen skapas en användare automatiskt utan att låntagaren behöver göra någonting extra. Låntagaren kan därmed spara sökningar och få nyhetsservice, spara minneslista, betygsätta etc. Det går följaktligen inte att logga med ett automatiskt skapat användarnamn och lösenord, eftersom det automatiskt skapade användarnamnet inte visas i gränssnittet. Denna nya funktionalitet är valfri och aktiveras av kundsupport efter begäran. Om den inte aktiveras fungerar det som tidigare. Det går inte att ha båda möjligheterna tillgängliga att låntagarna ska kunna välja mellan att själv skapa en Arena-användare eller att få en automatiskt skapad. Funktionaliteten aktiveras i samband med att 3.0 släpps publikt. 4.1 SKÄRMNAMN När en låntagare, vars användare skapats automatiskt, vill göra någonting som innebär att hen inte kan vara anonym, kommer Arena att fråga efter ett skärmnamn samt att användarvillkoren ska godkännas. Skärmnamnet är inte känsligt för gemener/versaler. De funktioner som kräver skärmnamn är recensioner, forum och samlingar (tilläggsfunktion). 4.2 E-POSTADRESS E-postadressen för den automatiskt skapade användaren är den aktiva e-postadress som finns i bibliotekssystemet. När användaren sparar en sökning och vill få nyhetsservice via e-post kommer Arena att kontrollera om hen vill använda den befintliga adressen, eventuellt ändra den, eller lägga till en om det inte finns någon. Denna kontroll görs varje gång användaren sparar en sökning och vill få nyhetsservice för den. Denna e-postadress knyts då till användaren. I Arena finns det därmed två e-postadresser som från början är identiska. Det finns en e-postadress för låntagaruppgifterna och en för Arenauppgifterna. Det innebär att om hen i efterhand ändrar e-postadress i sina låntagaruppgifter ändras den inte i Arena eller vice versa. OBS: Efter detta kommer de två adresserna att existera separerade, dvs om e- postadressen ändras i bibliotekssystemet ändras den inte i Arena och vice versa. 8
automatiskt skapade användare 4.3 NYHETSSERVICE Varje gång en användare sparar en sökning och vill få meddelande om nya titlar/artiklar via e- post visas en dialogruta med frågan om hen vill använda den befintliga e-postadressen, eller om hen vill ändra den. 4.4 GLÖMT LÖSENORD Tillagt i version B Funktionen Glömt lösenord kan alltså endast användas för Arena-användare och har ingen funktion för automatiskt skapade användare som ju endast kan logga in med lånekortsnummer/personnummer och PIN-kod. I samband med uppgraderingen skapar Axiell en sida som förklarar skillnaden mellan lösenord och PIN-kod. Sidan får url:en glomt-losenord. Vi kör även ett skript som lägger in länken till en länk till denna sida i login-portletarna i de Arenainstallationer som ska använda sig av automatiskt skapade arena-användare. 4.5 BEGRÄNSNINGAR FÖR AUTOMATISKT SKAPADE ANVÄNDARE Detta kan en automatiskt skapad användare inte göra: Logga in med användarnamn/lösenord Använda användaren på mer än ett bibliotek Passar inte för multi agency-miljöer. 4.6 MINA UPPGIFTER Innehållet på sidan Mina uppgifter har ändrats uppgifterna från bibliotekssystemet visas överst och information om användaren nederst. 4.7 BEFINTLIGA ARENA-ANVÄNDARE När funktionaliteten för att skapa användare automatiskt slås på kommer de befintliga Arenaanvändarna att fungera precis som förut. De kan alltså logga in med användarnamn/lösenord, koppla samma användarnamn till flera olika bibliotek och använda Arenas alla funktioner precis som tidigare. I samband med uppgraderingen skapas skärmnamn utifrån de befintliga användarnamnen. 9
mina lån 5 MINA LÅN Mina lån och omlån har helt gjorts om. Både utseende och funktionalitet har ändrats. Listan är nu komprimerad och omlån genomförs direkt utan det extra steg som tidigare medfört problem för en del låntagare. OBS: Alla eventuella egna textändringar i Mina lån kommer att försvinna i uppgraderingen 5.1 SORTERINGSALTERNATIV Du kan sortera listan på: Upphov Enhet Återlämningsdatum (förvalt) Status Titel Listan visas alltid i stigande ordning 5.2 OMLÅNSPROCESSEN Efter att du klickat på knappen Låna om får du direkt ett kvitto på skärmen Om du lånar om flera medier samtidigt visas de som inte gick att låna om överst på skärmen. 5.3 MINA LÅN BUGGRÄTTNINGAR/FÖRBÄTTRINGAR Buggen som innebar att information om omlånet försvann när listan sorterades om har rättats Buggen som innebar att ett fel kunde uppstå vid dubbelklick har rättats 10
mina lån Det finns nu separata texter för medier för nedladdning respektive strömning 11
Relevans 6 RELEVANS Algoritmen för relevansranking vid sökträffar har ändrats. Titel rankas numera högre än upphov Ettords-titlar rankas högre än andra titlar Nya titlar kan rankas högre (om utgivningsår boostas) 6.1 BOOST VID INDEXERING När en post indexeras boostas katalogpostfälten med olika värden, vilket påverkar relevansen. Detta gäller endast vid fritextsökning. Värdena: upphov=6 ämne=2 huvudtitel=20 Ju högre värde desto mer relevant anses fältet. Förutom att värdena har ändrats har även tekniken undergått förändring. Nu används sökmotorn Solrs inbyggda verktyg för boosting till skillnad från tidigare. Detta innebär att indexen nu är betydligt mindre till omfånget. 6.2 BOOST I TRÄFFLISTA Precis som tidigare går det att boosta värdena för föredraget språk, medietyp samt bibliotek (endast multiagency). I version 3,0 kan man även boosta utgivningsår att ranka nya titlar högre. Förvalt värde är 0 (dvs ingen boost). Värden som redan eventuellt finns i Arenas inställningar i portleten Sökresultat kommer inte att förändras i uppgraderingen, men kan behöva korrigeras. OBS katalogposter bestående av få ord och metadata rankas högre enligt relevansalgoritmen. 12
ny liferay-roll 7 NY LIFERAY-ROLL I samband med uppgraderingen kommer alla Liferay-.användare med rollen Administrator att istället tilldelas rollen Arena Administrator. Det har ingen praktisk betydelse utan användare med denna roll kommer att ha tillgång till alla nödvändiga funktioner precis som tidigare. Rollen Administrator används fortsättningsvis endast av Axiell. 13
förbättringar och buggfixar 8 FÖRBÄTTRINGAR OCH BUGGFIXAR Inloggning Ett fält för Glömt lösenord har lagts till I inställningarna i login-portleten. Om fältet har ett innehåll visas länken Glömt lösenord. Om fältet är tomt visas inte länken. För att länken ska visas gör så här: Skapa en sida med information om att För många misslyckade inloggningsförsök ger samma felmeddelande oavsett om felet uppstår i Arena eller i bibliotekssystemet. Skaffa lånekort Om giltighetstiden är 0 för lånekort som skapas via Skaffa lånekort stängs nu formuläret och ett meddelande visas. Detsamma gäller om personnumret är fel eller om låntagaren redan är registrerad. ehub Nu skickas externt låntagar-id till ehub istället för lånekortsuppgifter av integritetsskäl. Nu visas meddelanden från ehub vid länkarna för nedladdning. Detta kan påverka styling. Sökning/Utökad sökning Utökad sökning: fälten kommer nu i omvänd ordning sökfälten överst och filtret underst. Utökad sökning: Fältet Av söker på både författare och medarbetare. Fältet Titel söker på både titel och huvudtitel. Tecknen? and * är sökoperatorer och sökningen får inte träff på dem som rena tecken. Nu går det att vänstertrunkera. Sökresultat Om låntagaren väljer en annan sorteringsordning än den förvalda behålls den även efter att man gjort en ny sökning. Om fältet Sökfråga är tomt i Dynamisk lista används parametern ($externalquery) Nya default-inställningar för mervärden i Sökresultat och Dynamisk lista är omslags, betyg och sammanslagna titlar. Katalogpost Nu kommer man till rätt medietyp när man byter flik i katalogpostvyn i Arenor som innehåller flera bibliotek (multi agency) Formulär Nu har e-postadresser för mottagare lagts till i portletarna Inköpsförslag och Fjärrlåneansökan. Det innebär att portletarna kan användas på flera ställen i Arena, konfigurerade att skickas till olika bibliotek. 14
förbättringar och buggfixar Bildspel. Tidigare fanns en bugg som innebar att det gick att länka externa bilder till bildspelet. Liferay har nu rättat detta vilket innebär att om du länkar in externa bilder måste du ladda ner dem till dokumentbiblioteket och länka dit istället Säkerhet Skyddet mot fientliga angrepp bestående av massanrop mot server har utökats. 15
Styling 9 STYLING CSS-filer som Axiell utvecklat lagras numera på Axiells egna servrar alltså även när det gäller specialanpassningar för ett visst biblioteks Arena. Bibliotek som utvecklar sina egna CSS-filer ska fortsätta lagra dem i dokumentbiblioteket precis som tidigare, och ansvarar själva helt för filernas funktionalitet och påverkan på Arena. OBS! Lägg ALDRIG CSS-kod direkt i Grafiskt utseende i en portlet, utan lägg koden i CSS-filerna istället och anropa dem med en klass som du lägger in i Grafiskt utseende i den aktuella portleten. Om felaktig kod läggs direkt i portleten kan det äventyra Arenas funktionalitet till exempel så att det inte ens går att anropa sajten, 16
Styling 9.1 LIFERAY 6.2 CSS-ÄNDRINGAR Liferay 6.2 innebär förändring av den interna CSS:en. De baserar nu sin CSS på ett front-end framework med namnet Twitter Bootstrap. Versionen är Bootstrap 2.3.2 - http://getbootstrap.com/2.3.2/base-css.html. Detta betyder bland annat att vissa CSS-klasser har ersatts med motsvarigheter i Bootstrap, och att man använder Bootstrap-ikoner istället för egna ikoner. Kontrollpanelen har förbättrats och ser annorlunda ut. Liferay har även ändrat sin markup, vilket innebär påverkan på Arenas lokala styling. 9.1.1 MARKUP OCH CSS-PREFIX Liferay har lagt till CSS-klassen aui i html-taggen, för att påverka komponenterna med Bootstrapstyling. Exempel:.aui-fieldset { //styling } skrivs nu om så här:.aui.fieldset { //styling } Eftersom html-taggen är den översta i hierarkin överskrider den alla taggar under den. Konsekvensen är att om denna html-kod se ut så här före uppgraderingen body { background-color: red; } skriver Liferays aui.css för taggen body över det efter uppgraderingen eftersom css:en då blir.aui body { background-color: white; } Detta innebär i praktiken att den befintliga CSS:en inte alls fungerar. För att hantera det måste prefixet.aui läggas till före all styling. Dessutom ska klassnamnet.bwd läggas till för att säkerställa att det är den specifika egna stylingen som ska gälla. Bootstrap-styling hanterar framförallt formelement och liknande komponenter. OBS: Tänk på att det kan finnas CSS-kod placerad direkt i specifika portletar. Denna kod behöver hanteras på varje ställe och kan inte påverkas via den generella CSS:en 17
Styling 9.1.2 BOOTSTRAP ICONS Med Bootstrap följer ikonbiblioteket Glyphicons,. Det finns 140 ikoner i mörkgrått (förval) och vitt För att länka till någon av ikonerna använd motsvarande kod: <i class= icon-search ></i> Läs mer här: http://liferay.github.io/alloy-bootstrap/base-css.html#icons http://nickpiesco.github.io/alloy-ui-font-awesome-cheatsheet/ Rutnät (Grid) Bootstrap använder ett rutnät (grid) bestående av 12 kolumner för layoutmallarna. Det innebär att kolumnerna I varje rad alltid totalt ska bli 12. Exempel på layout med två kolumner: <div class="row"> <div class="span4">...</div> <div class="span8">...</div> </div> 4 + 8 = 12, vilket utgör 12 kolumner och en hel rad. Liferays gamla rutnät använde procent istället för denna beräkning. De tidigare layoutmallarna konverteras I uppgraderingen, men det gr fortfarande att göra på det gamla sättet eftersom den tidigare klasserna aui-wxx - finns kvar. Kom bara ihåg att ange prefixen.aui och/eller.bwd Läs mer här: http://getbootstrap.com/2.3.2/scaffolding.html#gridsystem 18
Styling 9.2 TEMAN 9.2.1 NYTT FÄRGSCHEMA Temat Arena Modern har fått ett nytt färgschema Variation. 9.2.2 NYA INSTÄLLNINGAR Arenas teman har fått nya inställningsmöjligheter. Inställningarna består av fält och checkboxar för att aktivera dem. Compatibility mode content Internet Explorer har en inställning för att ange vilken version som ska användas för att rendera webbsidor. Meta viewport content Fältet meta viewport tag instruerar webbläsaren i hur sidans dimensioner och skalning ska hanteras och är nödvändig vid responsive design. Om inte rätt värde finns här behandlar webbläsaren sajten som om den vore på desktop. Förvalt värde är initial-scale=1.0, width=device-width External favicon Du kan nu länka till en extern favicon, som används för bokmärken och I adressfältet I webbläsaren. Det finns även en möjlighet att länka till en apple-touch-icon för Apple. Ange sökvägen och markera kryssrutan för att aktivera funktionen. Tänk på att rensa cachen I webbläsaren om du byter ikon. Custom head and custom body bottom Dessa textfält kan användas för att lägga till kod (javascript, meta tags, CSS etc) som påverkar hela Arena. Det finns en liknande funktion i Liferay, där du kan lägga till kod antingen för hela sajten eller för specificerade sidor. 9.3 ARENA 3.0 CSS-ÄNDRINGAR 9.3.1 PORTLETKONFIGURATION CSS-klasser som tillkommit för portletinställningarnas knappar:.arena-portletconfig-submit.arena-portletconfig-reset.arena-textarea-submit.arena-translation-submit Det var tidigare arena-input-submit, vilket innebar att de ärvde specifik portlet-styling. 19
Styling 9.3.2 INSTÄLLNINGAR Portletinställningarna öppnas nu i tre kolumner i maximerad vy inställningar, egna texter och texter upptill/nedtill. 9.3.3 OMLÅN Mina lån och omlån har som nämnts ovan helt gjorts om. Alla element har fått egna css-klasser för att underlätta styling. Det finns nu så manga klasser att det inte är meningsfullt att ange dem i detta dokument, utan använd istället Firebug eller liknande hjälpmedel för att se vilka det är. Ett exempel om en viss titel inte kan lånas om får hela tabellraden CSS-klassen arena-renewalfalse, medan en titel som kan lånas om får klassen arena-renewal-true. Detta innebär att raderna kan stylas helt efter egna önskemål. Det finns också några element som har lagts till för att underlätta styling för mindre skärmar på så sätt att till exempel ledtexter kan döljas. Till exempel har tabellcellen för omlån följande markup: <td class="arena-renewal-date"> </td> <span class="hideme">due date:</span> <span class="arena-renewal-date-value">24/02/15</span> Ett mycket enkelt exempel på hur detta kan se ut istället för att fungera på mobiltelefon: @media only screen and (max-width: 768px) { }.arena-renewal-date.hideme { display: block; } Eftersom funktionen är helt omgjord måste eventuell tilläggsfunktionalitet i form av kortlista läggas in på nytt. Om du hade funktionen i version 2.7.2 och saknar den efter uppgraderingen kontakta Erika Aurell via mejl: ea@axiell.com 20
webbläsare 10 WEBBLÄSARE Testade och supporterade versioner: Internet Explorer 8, 9 och 10 Chrome, senaste versionen Firefox, senaste versionen Tänk på att version 8 av IE dock inte stöder vissa nya standarder som CSS3, som kan användas för att skapa skuggor och rundade hörn. Även om Internet Explorer har version 8 eller senare kan den vara inställd på så kallat kompatibilitetsläge, vilket gör att den beter sig som om den vore en tidigare version. Du kan kontrollera det genom att trycka på F12 och se till att Webbläsarläget är samma version som själva webbläsaren och att Dokumentläget är Standarder. Internet Explorer version 9 och framåt stöder standarder betydligt bättre än äldre versioner av IE. Internet Explorer 11 Liferay stöder inte IE11 fullt ut, vilket innebär detsamma för Arena. Liferays bildgalleri fungerar inte i IE11. Det finns en bugg I IE version 11.0.15 som har konsekvenser i Arena på olika ställen. I version 11.0.17 är denna bugg rättad. Vi rekommenderar därför alltid att du uppgraderar IE till den senaste versionen. Vi har vid några ytterst sällsynta tillfällen sett att det går att logga ut från Arena och komma tillbaka till innehållet på sidorna under /protected igen. Därför rekommenderar vi inte IE 11 för publika datorer. Kommentarer Webbläsarversioner som släpps efter en stor Arena-version är därmed inte testade och stöd för dessa kan därmed inte garanteras. Webbläsarversioner som stöddes i en tidigare Arena-version, och som har nått sin produktcykels slut testas inte längre och stöd för dessa äldre webbläsare garanteras inte. Kompatibilitets- och Quirks-läge stöds inte. (Detta är tekniker som innebär att webbläsaren emulerar en äldre version). Eventuella anpassningar av styling och javascript efter patch/uppgradering ingår normalt inte i underhållsavtalet. Välkommen att kontakta oss om du känner dig osäker på förutsättningarna för ditt bibliotek. 21