Axiell ALM Netherlands B.V.

Transcriptie

1 Release-notes

2 Axiell ALM Netherlands B.V. Copyright 2015 Axiell ALM Netherlands B.V. Alle rechten voorbehouden. Adlib is een product van Axiell ALM Netherlands B.V. De informatie in dit document kan zonder enige voorafgaande waarschuwing worden gewijzigd en houdt geen verplichting in voor Axiell ALM Netherlands B.V. Axiell aanvaardt geen aansprakelijkheid voor de volstrekte juistheid en volledigheid van de hierin opgenomen teksten. De software, zoals deze in dit document staat beschreven, wordt geleverd onder de voorwaarden van een gebruiksrechtovereenkomst. De bedoelde software mag uitsluitend volgens de voorwaarden van deze overeenkomst worden gebruikt of gekopieerd. Daar onze producten voortdurend verbeterd worden, kunnen latere versies verschillen met de producten die hierin beschreven staan. Dit document houdt geen enkele contractuele verplichting in om software te leveren, en mag niet als definitieve productbeschrijving worden beschouwd.

3 Inhoud Inleiding Nieuwe functionaliteit Prestatieverbetering voor link resolving Nieuwe sjablonen voor uitleenbriefjes Overige verbeteringen... 7

4

5 Inleiding Deze release-notes beschrijven een aantal verbeteringen in de Adlibexecutables, die zijn geïmplementeerd in Adlib 7.2 service-release 1 (build ). Deze release is vanaf half april 2015 beschikbaar voor alle klanten met een onderhoudscontract en is te downloaden vanaf de Adlib website. U kunt deze software over uw bestaande Adlib-systeem heen installeren (vanaf versie 4.4). U hoeft dus niets te deïnstalleren, maar maak vooraf wel een backup van uw databases en applicaties. Vanaf Adlib 5.0 wordt een nieuw licentiebestand gebruikt: Adlib.lic. Als u 5.0 of hoger al gebruikt, dan kunt u deze upgrade direct na installatie gebruiken; uw licentiebestand is dan al vernieuwd, staat op de juiste plek en wordt niet overschreven door de upgrade. Alleen als u deze upgrade installeert over een Adlib-versie ouder dan 5.0, dan geldt voor u het volgende: als u deze release op cd ontvangt dan vindt u daarop al het juiste licentiebestand; als u deze release hebt gedownload, dan onze helpdesk (ALM.NL.helpdesk@axiell.com) voor het benodigde wachtwoord en uw licentiebestand. Plaats dit bestand (u kunt er kopieën van maken) na installatie van de upgrade in uw Adlib \bin en \tools of \executables mappen (indien aanwezig). Het gaat erom dat het licentiebestand in dezelfde mappen staat als waarin uw Adlib.exe-bestanden staan. Hoe die mappen heten maakt niets uit. De release-notes van vorige grote releases en service-releases zijn te vinden op de Adlib website. Waarschuwing voor achterwaartse compatibiliteit Nieuwe functionaliteit in Adlib 6.6 voor SQL Server en Oracledatabases maakt dat u records die u met deze versie (of nieuwer) wijzigt niet meer kunt openen met oudere versies van Adlib (zowel adlwin.exe als wwwopac.exe). Houd hier alstublieft rekening mee als u Adlib 7.2 eerst wilt uitproberen voordat u definitief overstapt. Voor CBF-databases geldt deze beperking niet. Dit betekent dat u wwwopac.exe ook naar 7.2 moet opwaarderen (deze noodzaak geldt niet voor wwwopac.ashx). Dat kan echter gevolgen hebben voor uw webapplicatie, vanwege enkele veranderingen in het structured XML-formaat: voorheen verschenen lege velden uit veldgroepen niet in de record-xml, terwijl dat vanaf 6.6 wel het geval is. Eveneens geldt dat u de nieuwste versie van Adlib Designer nodig hebt om functionaliteit te implementeren die in deze release-notes wordt beschreven. Maar wanneer u uw applicatie in de nieuwe versie van Designer hebt aangepast, kunt u die applicatie, of delen daarvan, niet meer bewerken in een oudere versie van Adlib Designer

6 Inleiding Adlib Wanneer u uw Adlib database-structuren bewerkt via Designer 7.2 dan gelden, vanwege wijzigingen in het.inf-formaat als gevolg van de toevoeging van nieuwe interfacetalen, de volgende beperkingen: U kunt hierna uw database-structuren niet meer met een oudere versie van Designer aanpassen. U moet voortaan dus Designer 7.2 of hoger gebruiken. U kunt hierna geen gebruik meer maken van Adlib-versies (adlwin.exe en adloan.exe) ouder dan versie 7.2. U moet hierna uw wwwopac (.exe of.ashx) updaten naar versie 7.2. De update van de.ashx-versie kan op zichzelf mogelijk ook weer gevolgen hebben: o o Vanaf wwwopac.ashx worden veldnamen die gespecificeerd zijn in de adlibweb.xml-secties brieffields, detail- Fields, searchfields en authenticationconfiguration aan de eisen voor XML elementnamen gevalideerd bij de start van de applicatie. Als een veldnaam daar niet aan voldoet genereert de API een uitzondering (AdlibWebException) met details over de veldnaam, sectie en database. Als u de uitzondering tegenkomt na uw wwwopac.ashx-upgrade naar of hoger, moet u de onjuiste veldnamen in de datadictionary (.inf-bestand) en vervolgens in adlibweb.xml corrigeren. De XML elementnaamvereisten zijn als volgt: namen mogen letters, cijfers and andere tekens bevatten maar ze mogen niet beginnen met een cijfer of interpunctieteken of met de string xml. Verder mogen namen geen spaties bevatten. De Adlib API zoals gebruikt door de huidige versie van wwwopac.ashx voert een strikt beleid aangaande de definitie van veldtags: alle tags die worden gebruikt in records die u leest of schrijft via de API, moeten in de datadictionary zijn gedefinieerd. Wanneer u de nieuwe wwwopac.ashx dus voor uw website gaat gebruiken, kunt u hierdoor foutmeldingen tegenkomen, want het komt in Adlib-applicaties helaas voor dat tags alleen op het scherm gedefinieerd zijn of via importeren of adapl-procedures in records terecht zijn gekomen. Axiell ALM heeft verschillende tools in ontwikkeling (momenteel genaamd ValidateDatabase en RemoveTagsFromData) waarmee u onder andere de niet-gedefinieerde tags in uw records kunt opsporen, waarna u die alsnog in de betreffende.inf kunt (laten) definiëren om daarmee het probleem op te lossen. Vraag onze helpdesk om de status van deze tools en de bijbehorende documentatie

7 1 Nieuwe functionaliteit 1.1 Prestatieverbetering voor link resolving In Adlib is het interne mechanisme voor het verwerken van koppelingen (Eng.: link resolving) van meer dan één niveau diep aanzienlijk verbeterd, hetgeen kan leiden tot substantiële prestatieverbeteringen tijdens het openen van een record dat veel meer-danéén-niveau-diepe koppelingen naar andere (vaak dezelfde) records in bijvoorbeeld validatiedatabases bevat. Als u bijvoorbeeld een boekrecord opent dat naar veel objectrecords koppelt terwijl ook data die vanuit een tweede gekoppelde database is gekoppeld (zoals de Thesaurus of Personen en instellingen) moet worden opgehaald, dan moeten al die records worden ingelezen in het geheugen (en daarna weer verwijderd) voordat het huidige boekrecord volledig kan worden getoond met met alle waarden van de in de eerste én tweede graad gekoppelde records, zoals vervaardigers of objectnamen. Dit proces achter de schermen is veel efficiënter gemaakt, door gebruik te maken van een nieuwe run-time recordcache die tijdelijk records in het geheugen bewaart waarnaar veel wordt verwezen tijdens het recursieve link-resolvingproces. In veel gevallen (vooral waar veel tweede-niveau koppelingen niet uniek zijn, zoals dezelfde vervaardiger voor veel gekoppelde objectrecords) voorkomt dit het onnodig opnieuw inlezen van records, en daarmee het onnodig herverwerken van koppelingen, omdat die records al in het geheugen aanwezig zijn als er in dit proces eerder naar werd verwezen. 1.2 Nieuwe sjablonen voor uitleenbriefjes Vanuit Adloan Uitlening kunt u voor de lener briefjes afdrukken ter herinnering aan de door die lener geleende, geretourneerde of gereserveerde exemplaren. Tot op heden werden voor dat doel.rtfsjablonen gebruiken, één per taal en per type transactie. Vanaf Adloan worden in plaats van 42 van deze.rtf-sjablonen nog maar zes XSLT-sjablonen plus één XML-bestand met vaste teksten gebruikt, die in de Adlib \executables-submap worden meegeleverd: issue-list-all.xsl om het Totaal uitleenoverzicht te genereren. issue-list-one.xsl om het uitleenbriefje voor één of meer geselecteerde exemplaar te genereren. return-list-all.xsl om het Totaal inname-overzicht te genereren

8 Nieuwe functionaliteit Adlib return-list-one.xsl om het inneembriefje voor één of meer geselecteerde exemplaren te genereren. reservation-list-all.xsl om het Totaal reserveringsoverzicht te genereren. reservation-list-one.xsl om het reserveringsbriefje voor één of meer geselecteerde exemplaren te genereren. adloanlisttranslations.xml waarin alle benodigde vertalingen van de vaste teksten in de briefjes zijn of kunnen worden opgenomen, waaronder ook de naam van uw instelling en eventueel een contact- adres. Een adres wordt groot onder de instellingsnaam afgedrukt. U kunt alle bestanden naar wens bewerken in een tekstverwerker zoals Windows Kladblok, Notepad++ of Visual Studio, bijvoorbeeld om de vormgeving en vaste teksten aan te passen of om het logo van uw instelling toe te voegen

9 Adlib Nieuwe functionaliteit In adloanlisttranslations.xml bijvoorbeeld, vervangt u de vaste tekst ruimte_voor_instellingsnaam in taal 1 (Nederlands) door uw eigen instellingsnaam. Als u Adloan Uitlening niet altijd in het Nederlands weergeeft, moet u uw instellingsnaam ook voor die andere talen invullen: de taalcijfers worden in het XML-document zelf uitgelegd. Een adres voor informatie-aanvragen kunt u in de daaropvolgende <translation>-node invullen in plaats van placeholder_for_ _address. Als u helemaal geen adres wilt afdrukken, verwijdert u de tekst placeholder_for_ _address gewoon, maar laat wel de omringende XML <outputtext>-tags staan. En in plaats van een e- mailadres kunt u er net zo goed de URL naar uw website in opgeven. <translation name="institution name"> <outputtext language="0">placeholder_for_institution_name</outputtext> <outputtext language="1">ruimte_voor_instellingsnaam</outputtext> <outputtext language="2">espace_réservé_pour_nom_d'institution </outputtext> <outputtext language="3">platzhalter_für_institutionsname</outputtext> <outputtext language="4">placeholder_for_institution_name</outputtext> <outputtext language="5">placeholder_for_institution_name</outputtext> <outputtext language="6">placeholder_for_institution_name</outputtext> </translation> <translation name=" address"> <outputtext language="0">placeholder_for_ _address</outputtext> <outputtext language="1">placeholder_for_ _address</outputtext> <outputtext language="2">placeholder_for_ _address</outputtext> <outputtext language="3">placeholder_for_ _address</outputtext> <outputtext language="4">placeholder_for_ _address</outputtext> <outputtext language="5">placeholder_for_ _address</outputtext> <outputtext language="6">placeholder_for_ _address</outputtext> </translation> De overige vaste teksten kunt u ook aanpassen, maar maak geen wijzigingen aan alles wat tussen < en > haken staat. Als er voor een gewenste taal wel een Adlib taalcijfer bestaat terwijl er nog geen <outputtext>-regels voor zijn, dan kunt u die regels zelf toevoegen. In de.xsl-bestanden hoeft u niet per se iets te wijzigen, tenzij u de lay-out van de briefjes wilt aanpassen of een afbeelding (bijvoorbeeld het logo van uw instelling) boven aan de briefjes toegevoegd wilt zien. In het eerste geval moet u kennis van CSS en XSLT hebben: zie eventueel het document Programming XSLT stylesheets for Adlib voor een introductie. In het tweede geval hoeft u maar een enkele regel code aan te passen: 1. Plaats het gewenste afbeeldingsbestand in uw Adlib \Library loans management-submap (de map die adcirc.pbk bevat, de mapnaam kan anders zijn)

10 Nieuwe functionaliteit Adlib Zoek de volgende regel (HTML) code op: <img src="books.jpg" width="150px" heigth="250px"/> 3. Vervang books.jpg door de daadwerkelijke naam van uw afbeeldingsbestand. 4. Vul de gewenste maximale breedte en hoogte van de afbeelding in pixels in en sla de wijzigingen op. 5. Druk vanuit Adloan het betreffende briefje af om uw wijzigingen te testen. Houd wanneer u de betreffende snelmenu-optie kiest (bijv. Totaal uitleenoverzicht) eventueel de Shift-toets ingedrukt om het briefje alleen in voorbeeldweergave op het scherm te tonen en niet naar de printer te sturen. 6. Voer de bovenstaande wijzigingen uit in alle zes.xsl-bestanden als u wilt dat de wijzigingen in alle typen briefjes zichtbaar worden. De oude.rtf-sjablonen blijven gebruiken Adloan kan ook nog steeds met de oude.rtf-sjablonen blijven werken. In principe kijkt Adlib voor het afdrukken van uitleenbriefjes e.d. eerst of de nieuwe XSLT-stylesheets in de map \executables of \bin aanwezig zijn. Als die er niet zijn, wordt gecontroleerd of de oude.rtf-bestanden er zijn en zo ja, dan worden die alsnog gebruikt voor het afdrukken van de briefjes. Na een update kunt u de nieuwe stylesheets dus verplaatsen of verwijderen om Adloan weer met de.rtfsjablonen te laten werken

11 2 Overige verbeteringen In 7.2 service-release 1 is verder de volgende functionaliteit verbeterd: Ref.nr. Korte beschrijving 4338 Een geldige URL gaf een onterechte foutmelding 404 wanneer die geopend werd met de openurl ADAPL-functie Op uitleenbriefjes was het niet mogelijk om de plaatscode af te drukken omdat deze informatie niet beschikbaar was in Adloan. De fiks zorgt ervoor dat <shelfmark> in de uitgevoerde XML nu beschikbaar is en via de nieuwe XSLTstylesheets voor Adloan-briefjes kan worden afgedrukt Een linkscreen-adapl die bij een linkzoekscherm werd gebruikt, werkte niet meer, waardoor de applicatie ook stopte met werken. In dit geval was de adapl gekoppeld aan tag Br in de catalo-database Het venster Meerdere voorkeurstermen gevonden, selecteer term(en) uit lijst toonde de term en het soort term (domein), maar het domein was niet altijd juist en het was niet mogelijk om meer recorddetails weer te geven De onderstreping van gekoppelde veldwaarden in de detailweergave verdween nadat u op de knop Verberg invariante data had geklikt. De onderstreping verscheen weer nadat u tussen tabbladen had geschakeld Het wijzigen van de volgorde van veldoccurrences via Ctrl+pijltje werkte niet als er een HTML-veld in de groep zat: het HTML-veld werd niet verplaatst wanneer u Ctrl+pijltje in de niet-html-velden gebruikte, terwijl de overige occurrences wel van volgorde veranderden Wanneer u de lijstweergave opende met records uit een pointerfile, dan toonde de top van het lijstscherm altijd de opgeslagen zoekopdracht, zelfs als die niet erg informatief was (in het geval van met de hand geselecteerde pointerfiles bijvoorbeeld), in plaats van de meer bruikbare titel van de pointerfile Als u een lange lijst met reproducties had en u schoof omlaag door de lijst, dan bleef de Media Viewer aan de bovenkant van de lijst staan en verdween zo uit het zicht

12 Overige verbeteringen Adlib Wanneer u na zoeken op een thesaurus-term in Stap 4 van de Zoekassistent op de knop Alle sleutels klikte dan kon dat verschillende resultaten tot gevolg hebben, afhankelijk van welke term in dat venster was geselecteerd In een meertalige applicatie werden feedback-koppelingen niet verwerkt Wanneer in een SQL-applicatie linkstruncatie werd gebruikt, dan was het niet mogelijk om links getrunceerd op een term met daarin een spatie te zoeken Als de knop Zoek afbeelding opnieuw werd gebruikt voor een al ingevulde occurrence van het veld (Reproductie) Referentie, dan toonde de Media Viewer de afbeelding maar verving de vorig ingevulde afbeelding niet daadwerkelijk (zoals bleek wanneer u tussen tabbladen schakelde). Om een nieuwe afbeelding te kunnen koppelen moest u de al gevulde occurrence eerst leegmaken om pas daarna de nieuwe afbeelding in te voegen De Ctrl+E snelkoppeling om de procedure Wijzig standplaatsen te starten, functioneerde nog terwijl de knop in het lint op dat moment inactief was Als u een record met veel (meer dan 50) gekoppelde reproducties opende, dan duurde het erg lang voordat de Media Viewer geopend was. En terwijl dat gaande was kon u niet verder werken in Adlib Na een export met een voorgedefinieerd adapl-exportformaat, werd er geen doelbestand gecreëerd. En als het doelbestand al bestond, dan werd het wel verwijderd maar niet opnieuw geschreven De gereserveerde variabele &I was altijd 1 wanneer de adapl in een Geavanceerd zoeken-opdracht werd uitgevoerd Een gebruikersnaam die een aanhalingsteken bevatte, veroorzaakte een SQL-query syntaxisfout. De gebruikersnaam werd afgekapt Een detailscherm werd niet ververst op het moment dat aan een voorwaarde voor een bepaald voorwaardelijk veld werd voldaan Wanneer u in het venster Standplaats van objecten wijzigen een gevalideerd veld verliet nadat u daarin een nietbestaande waarde had ingevuld, dan werd het venster Vind

13 Adlib Overige verbeteringen data voor het veld niet geopend. In plaats daarvan verscheen alleen de foutmelding: Validation failed De Herstart-knop werkte niet altijd correct, afhankelijk van uw daaraan voorafgaande acties Een gekoppeld meertalig veld dat op een scherm als alleenlezen was gedefinieerd, kon nog steeds bewerkt worden Zelfs als aan de methode Publish records to TheCollection- Cloud toegangsrechten Geen waren toegekend, dan werden er nog steeds service-oproepen naar The Collection Cloud gedaan Het exporteren van afbeeldingsmetadata via het menu Bestand > Afbeeldingen, genereerde een COMErrorException Adlib Designer rapporteerde geen ADAPL compilatiewaarschuwingen zoals gedeclareerde maar ongebruikte variabelen Een scherm met toegangsrechten Geen werd toch getoond wanneer een record in bewerkingsmodus werd gezet, terwijl het niet zichtbaar was wanneer het record werd opgehaald en in weergavemodus werd getoond Na het exporteren van een geselecteerde subset van velden naar unstructured XML, bevatte het resultaat toch alle velden van het record Klikken op een interne koppeling opende het relevante gekoppelde record niet Wanneer u in een geavanceerde zoekopdracht alleen middentruncatie gebruikte dan kreeg u een verkeerd resultaat Wanneer u tijdens het slepen van een record in de hiërarchiebrowser via de optie Verplaats record de hiëarchie van enkele records wijzigde, dan genereerde Adlib een fout Niet-voorkeurstermvervanging werkte soms niet correct: er vond dan geen termvervanging plaats en een nieuw domein werd niet aan de voorkeursterm toegevoegd In -rtl modus was het Bestand-menu in Adlib bijna geheel leeg Het opslaan van een bewerkt record met veel afbeeldingen duurde extreem lang Na het gebruik van de Afdrukassistent resulteerde de laat

14 Overige verbeteringen Adlib ste stap van het proces niet in het venster Afdrukken van waaruit u een voorbeeld op het scherm kan tonen of de uitvoer daadwerkelijk kunt afdrukken. Nadat u in de Afdrukassistent op de knop Toon klikte, stopte de procedure zonder waarschuwing Een geavanceerde zoekopdracht in een specifieke dataset werd over alle datasets uitgevoerd als de optie Gebruik relaties niet was gemarkeerd Adlib liep vast wanneer u dubbelklikte op een leeg gekoppeld veld in een SQL-database, om het venster Vind data voor het veld te openen Zoeken-en-vervangen was niet beschikbaar ofschoon de toegangsrechten voor de Global update methode op Volledig waren ingesteld Bij het koppelen van een afbeelding via Wijzigen > Zoek afbeelding crashte Adlib wanneer de afbeeldingsnaam een Hebreeuws teken bevatte De media-navigatieknoppen bleven inactief, ook al waren er meerdere gekoppelde afbeeldingen Bij het koppelen van een afbeelding via Wijzigen > Zoek afbeelding in een veld met het Ingest Storage type, werden Hebreeuwse tekens uit de bestandsnaam niet correct in de XML opgeslagen Bij het koppelen van een afbeelding via Wijzigen > Zoek afbeelding werd niet het gehele afbeeldingsbestandspad naar het veld met het Ingest Storage type gekopieerd Bij het gebruik van de optie Bestand > Selecteer een bestand gebruikte Adlib soms de toegangsrechten-instellingen van de vorige gegevensbron De knop Media Viewer in het menu Beeld van het lint werkte niet In het venster Vind data voor het veld werd een gekoppeld record niet getoond wanneer de recorddata voor het meertalige veld langer was dan de sleutel in de index Er kwam geen waarschuwing wanneer een term uit de thesaurus verwijderd werd terwijl die term nog in gebruik was in een gekoppeld veld in een andere database en feedbackkoppelingen actief waren

15 Adlib Overige verbeteringen 6801 Adlib kon crashen wanneer u klikte op een Is deel van - relatie in records met veel relaties Auteurnamen uit een andere dataset konden na zoeken met de Zoekassistent in de huidige dataset in de lijstweergave worden weergegeven en vervolgens een fout 31 genereren wanneer u dubbelklikte op zo n naam Na de Geavanceerd zoeken-opdracht current_location = * reageerde Adlib niet meer De knop Opslaan als in het Media-menu van het lint werkte niet Geavanceerd zoeken op lege gekoppelde velden gaf een onjuist resultaat Het was een recordeigenaar niet toegestaan om een record te bewerken in een applicatie met gespecificeerde rechten en default toegangsrechten Geen Een imagedirectory-import importeerde geen enkel bestand uit de bronmap wanneer die map PDF-bestanden bevatte De WHEN-operator in een Geavanceerd zoeken-opdracht werkte niet of produceerde verkeerde resultaten Een gecombineerde zoekopdracht naar een bredere term in Geavanceerd zoeken was erg traag en gaf een verkeerd resultaat In het venster Geavanceerd zoeken werd een opgehaald veld met een index in de gekoppelde database hier niet weergegeven als zijnde een geïndexeerd veld Wanneer u in het venster Standplaats van objecten wijzigen een standplaats uit het venster Vind data voor het veld selecteerde, dan werd de foutmelding Invalid data found gegenereerd De WHEN-operator in een Geavanceerd zoeken-opdracht werkte niet of produceerde verkeerde resultaten Wanneer een standaardwaarde was ingesteld voor het veld record_access.owner dan konden alleen gebruikers met admin-rechten het record opslaan Het contextveld (voor de weergave van hiërarchieën als een string) bleef leeg Het was niet mogelijk om een alleen-lezenbestand in een

16 Overige verbeteringen Adlib applicatieveld te koppelen Wanneer een XML uitwisselbestand een verwijzing naar het niet-bestaande bevatte en u importeerde dat bestand in een ander programma zoals Excel, dan veroorzaakte deze XSD-verwijzing foutmeldingen "access denied". Met de fiks wordt de XSD-verwijzing niet langer in exportuitvoer opgenomen Adlib crashte nadat u in het venster Vind data voor het veld een thesaurusterm had geselecteerd die in een contextveld terecht zou komen Adlib crashte wanneer u een lange Geavanceerd zoekenopdracht zoals de volgende gebruikte: %0 = xxxx, xxxx, xxxxx Een export naar csv liet soms na de veldnamen zelf ook te exporteren Een Geavanceerd zoeken-opdracht die zowel when als contains bevatte, leverde geen resultaten op Na het forceren van een naam in een gekoppeld veld en het daarna verplaatsen van de cursor naar een ander gekoppeld veld, was de Lijst-knop in het lint inactief Een XML-import via import.exe negeerde het eerste XMLelement als het doelveld meertalig was en als andere bronvelden gemapt waren naar andere talen van hetzelfde veld Het lijstweergavetabblad Miniatuurweergaven toonde recordnummers in plaats van objectnummers Adlib crashte wanneer u de F1 contextuele Help opende vanuit het venster Vind data voor het veld Zoeken via de zoekingang Huidige standplaats barcode in Objecten in eigen beheer deed Adlib crashen