Releasenote ADA 3.3.3

Transkript

1 Releasenote ADA ADA er Rigsarkivets værktøj til test af arkiveringsversioner, som er udarbejdet efter reglerne i bekendtgørelse nr af 20. august 2010 om arkiveringsversioner. Den nye ADA version afløser tidligere ADA version Denne releasenote giver en kort introduktion til følgende ændringer, som vi har implementeret i ADA version I overskriftsform lyder de: Forbedret performance Dannelse og sletning af underliggende databaser (ny funktion) Genoptagelse af tidligere kørte tests (ny funktion) Nyt logsystem (forbedret stabilitet + forbedret dokumentation) Ny alternativ fejllog Ny tabelviewer, herunder: visualisering af relationer mellem tabeller (ny funktion) forbedret muligheder for SQL-forespørgler (ny funktion) Mindre ændringer i brugergrænsefladen Dokumentrelationer (udgået funktion) Nye deltests og ændringer i deltests Systemkrav På de følgende sider kan du læse om ændringerne. Rapportering af fejl i programmet vil være med til at forbedre kvaliteten af efterfølgende versioner, og I er derfor meget velkomne til at kontakte os, når I falder over fejl eller andre uhensigtsmæssigheder (ada-meldinger@sa.dk). I er naturligvis også velkomne til at komme med forslag til videreudvikling, herunder ønsker til brugergrænseflade, ny funktionalitet osv. Rigsarkivet fraskiver sig ethvert ansvar for fejl, som skulle opstå i forbindelse med anvendelsen af programmet. Bemærk: ADA kræver fulde administratorrettigheder og bør køres som administrator for at give korrekte testresultater (Højreklik på ikonet og vælg kør som administrator ) På vegne af Rigsarkivet - Phillip Tømmerholt 27. marts 2017.

2 Forbedret performance Indlæsningen af filer og test af struktur inkl. MD5 er lavet om, så der er markante forbedringer. Dokumenttesten og dokumentindextesten er blevet lavet om, og målinger vi har foretaget indikerer, at testene er blevet 3-5 gange hurtigere. Der testes stadig for det samme, så der er tale om reel performanceforbedring. Vi vil meget gerne høre om omverdenen oplever samme forbedret performance. Dannelse og sletning af underliggende databaser ADA har altid under test af en arkiveringsversion dannet en række databasefiler, som bliver brugt i selve testen af arkiveringsversionen. Således ligger data duplikeret fra arkiveringsversionen, hvilket udgør en sikkerhedsrisiko for sensitive data. Under Værktøjer er det nu mere klart for brugeren, at disse databasefiler dannes. ADA gemmer som default databasefiler under AppData, men nu er der en funktion, hvor man kan angive en sti til, hvor disse filer skal placeres. Det er samtidigt muligt at slette alle disse filer for en eller flere arkiveringsversioner via samme faneblad: Bemærk at denne funktion kun er tilgængelig inden man kører en test. Genoptagelse af tidligere test Når en test påbegyndes vil ADA tjekke om der allerede foreligger en database fra en tidligere kørsel. Brugeren vil blive spurgt om der ønskes at fortsætte eller om der skal køres en helt ny test. Hvis der tidligere er kørt en fuld test, vil alle fejlmeddelelser fra sidste kørsel blive genskabt i testloggen, og det er muligt via tabelviewer at tilgå de indlæste data. Hvis ADA er gået ned midt i en kørsel vil ADA rydde resultaterne fra den givne test og genoptage testen efter den sidste vellykkede test. Hvis ADA således er blevet afbrudt midt i tabeltesten, vil en genoptagelse rydde resultaterne fra tabeltesten og starte kørslen derfra allerede afviklede tests som lå før tabeltesten, som f.eks. strukturtesten vil blive registreret, men ikke kørt igen. NOTE. Ved genoptagelse bevares alle forudindstillede valg. Har man for eksempel fravalgt MD5-test, vil denne også være fravalgt ved genoptagelse. Det er et udviklingsønske at man fremover kan ændre indstillinger og kunne slå flere tests til, men dette er endnu ikke implementeret i ADA

3 Nyt logsystem Alle fejlmeddelelser, som ADA kan komme med, er nu bundet op på det, som vi kalder for det nye logsystem. Dette betyder, at enhver fejlmeddelelse i testloggen begynder med et element i skarp parentes, hvori et unikt id indgår. Et eksempel kunne være, hvis tableindex.xml i en arkiveringsversion ikke er validt i henhold til skema, så vil der i testloggen komme følgende fejl: [4.C.1_8] tableindex.xml er ikke validt. ( + beskrivelse af specifik parsingfejl) Det unikke løbenummer [4.C.1_8] henviser til dokumentet: Hvad udgør en ADA-test Dokumentation af hvad ADA (version 3.3.3) tester for. I omtalte dokument, som er tilgængeligt på vores hjemmeside er bekendtgørelse 1007 brudt ned i en række testområder med tilhørende deltests. Eksempelvis lyder bekendtgørelsens punkt 4.C.1: Alle indeksfile skal overholde deres tilhørende skema, jf. bilag 8.. Derfor er der en række deltests inden for testområdet 4.C.1 som tester wellformedness og validitet for de enkelte indeksfiler, hvoraf [4.C.1_8] som allerede nævnt tester for om tableindex.xml er validt. Med implementeringen af denne nye testlog er der derfor en større overensstemmelse mellem fejlmeddelelse og hjemmel i bekendtgørelse. Fejlmeddelelser vil i testloggen være markeret med rød skrift som ovennævnte eksempel. Der vil også være fejlmeddelelser i skarp parentes, som er markeret med grå skrift. Disse er blot hints og opmærksomhedspunkter, som ikke nødvendigvis betyder, at der er fejl i pågældende arkiveringsversion. Se eksempelvis: [6.C_9] Der findes 5 egenproducerede forespørgsler i arkiveringsversionen. [6.C.9] er blot en oplysning om, at der er sagsbehandlerdefinerede SQL-forespørgsler, som er navngivet med præfikset AV i tableindex.xml. Endeligt vil exceptions håndteres som en fejlmeddelelse i samme stil som de definerede deltests. Exceptions vil have klamancen [0.1] efterfulgt af en exception test omkring uventet fejl + eventuelt yderligere information: [0.1] Uventet fejl. ( + eventuel beskrivelse af fejl) Hvis man støder på denne fejl er der tale om en fejl i ADA, og ikke nødvendigvis i arkiveringsversionen. Fejl som disse eller andre uhensigtsmæssigheder kan meldes til ada-meldinger@sa.dk.

4 Ny alternativ fejllog Trykker man på Progress log, så får man en anden præsentationsform for testen: Denne præsentationsform er en direkte afspejling af det, der er defineret i Hvad udgør en ADA-test - Dokumentation af testfunktioner i ADA (version 3.3.3). I træstrukturens første niveau, kaldet Alle test er en opsamling af alle tests. Hvis man med musen trykker på Alle test vil der komme en opsamling af alle eventuelle fejl og hints i arkiveringsversionen: Der er tre kolonner: Første kolonne angiver med et lille muse-ikon om man kan se flere informationer om den pågældende fejl. Er der et museikon, kan man på rækken højreklikke med musen og få vist informationer om gældende test (se næste billeder). Anden kolonne angiver hvilken type, der er tale om. Er det et hint/info vil dette være angivet. Er der tale om en reel fejl i arkiveringsversionen, så vil denne have teksten Error og hele rækken vil være markeret rød. Det er muligt ved tryk på kolonneheader Type at sortere på fejltype. Tredje kolonne angiver testnummer og beskrivelse af testresultatet.

5 Flere informationer: Højreklik med musen på rækken med 5.E_7 og man får vist flere informationer om gældende test Trykker man på List results får en man en boks med did er for de 8 dokumenter, der indeholder private tags: Ved at trykke på kolonnen i den nye pop-up og genvejstaste CTRL-A markeres alle værdier i kolonnen. Disse kan kopieres (CTRL-C) så man kan få listen ud i eksempelvis i tekstdokument. Bemærk at denne informationsmulighed pt. kun er på ganske få tests.

6 Træstrukturen i Progress Log 1. niveau indeholder en opsamling af Alle test. 2. niveau afspejler de tre bilag i bekendtgørelsen (Bilag 4, 5 og 6) 3. niveau afspejler de testområder der er henvist til i Hvad udgør en ADA-test Dokumentation af hvad ADA (version 3.3.3) tester for. 4. niveau afspejler den enkelte deltest. På forrige billede er 3. niveau markeret. Denne hedder 4.C.2 fileindex.xml, hvilket kan ses af den blå markering i selve træstrukturen samt i øverste grå bjælke i boksen til højre. I boksen til højre og under navnet på testområdet er der en grå boks med titlen Description. Når man stiller sig på testområde, 3. niveau, så vil bekendtgørelsens bestemmelser stå under Description. I det valgte tilfælde vil de to bestemmelser under 4.C.2 være beskrevet. Stiller man sig på 4. niveau er man helt nede på den enkelte deltest. Her vil beskrivelsen af testen være at finde i Description -boksen.

7 Bemærk, at der også i Progress Log er et lampesystem, som ligner lampesystemet i statusboksen. Da der er en fejl i en opmærkning af en fils MD5-sum er denne fundet via deltesten 4.C.2_3, så er lampen for denne markeret rød. Dette arves op igennem de enkelte niveauer til 4.C.2 fileindex.xml og videre op til 4 Datastrukturer og slutteligt til 1. niveau. Lamperne kan dog ikke kun være røde og grønne som i statusboksen. Der er en del forskellige farver i spil. Trykker man på knappen med? vil der komme en forklaring på farvekoderne: Failed: Running: Unexpected result? Not run Skipped Finished Containing info Check not recognized Der er detekteret fejl i arkiveringsversionen. Testen kører stadig. [0.1] uventet fejl. Kontakt ada-meldinger@sa.dk ved disse. Tests der er fravalgt fra testens start, og som ikke skal køres. Tests der er blevet sprunget over pga. andre fejl tidligere i testen. For eksempel kan der ikke køres en nøgletest, hvis tableindex.xml ikke er wellformed. Testen er kørt, og der er ikke fundet fejl i arkiveringsversionen. Der er et hint/info fra denne test. Ikke en fejl. Dette er tests, som endnu ikke er indført i ADA, men som er formuleret i Hvad udgør en ADA-test - Dokumentation af testfunktioner i ADA (version 3.3.3).

8 Ny tabelviewer Tabelvieweren er udskiftet med en ny version, der blandt andet kan lave en visuel repræsentation af tabellerne og deres relationer: Det er muligt via menuen yderst til højre at ændre på visualisering, såsom om kolonnenavne skal med, navne på fremmednøgler og lignende. I tabelvieweren er der også ændret i visualiseringen af tabeller, og der er implementeret farvekoder i feltet, hvor man kan foretage SQL-forespørgsler: Hvis brugeren trykker på den lille trekant/pil ned (se næste billede) kommer der nu en drop down - liste, hvor det er muligt at se: 1) De 10 seneste forespørgsler, som man har foretaget. 2) De sagsbehandlerdefinerede forespørgsler, som arkivaren har formuleret skal være i arkiveringsversionen navngivet med præfikset AV 3) De forespørgsler man har gemt som favoritter. Man gemmer en forespørgsel som favorit ved at trykke på stjernen for en kørt forespørgsel.

9 Ved at trykke med musen på den enkelte forespørgsel vil resultatet af forespørgslen komme op i tabelvieweren. Mindre ændringer i brugergrænsefladen Dokumentviewer Når brugeren åbner vieweren for kontekstdokumentationen, vil denne åbnes automatisk. Tidligere måtte man via en stifinder selv finde frem til relevante arkiveringsversion og mappen contextdocumentation. Det samme gælder for dokumentvieweren, hvor startpunkt nu er det første medie for den aktuelle arkiveringsversion. Aktive drev via stifinder Finder man en arkiveringsversion via ADAs stifinder, vil aktive drev automatisk slås til. AVID-nummer Når en test af arkiveringsversion påbegyndes, så låses inputboksen, så der ikke er nogen tvivl om at testresultaterne stammer fra kørsel af pågældende arkiveringsversion. Ligeledes fremkommer AVIDnummer nu i titellinje og fremgår også i procesnavn, så man kan lukke den korrekte version via jobliste. Nedlukning af ADA Når der lukkes ned for ADA, kommer der en pop-up boks, som spørger om man er sikker. Opdater fileindex.xml Der er kommet en ny funktion til opdatering af fileindex.xml. Har man foretaget rettelser i en arkiveringsversion og vil opdatere fileindex.xml er der nu en lidt mere finkornet funktion. Man kan stadig som tidligere ved tryk på Skab ny fileindex.xml slette fileindex.xml og danne en helt ny. Denne funktion kan dog tage lang tid, hvis der er dokumenter i arkiveringsversionen. Derfor er der kommet en ny funktion: Ved tryk på Opdater fileindex.xml under fanebladet værktøjer vil ADA fileindex.xml slette alle opmærkninger, der ikke er dokumenter, og beregne og indsætte opmærkninger for de af arkiveringsversionen filer, der ikke er dokumenter. Ny Brugervejledning Under fanebladet Hjælp er der nu kommet en opdateret og mere fyldig brugervejledning til programmet. Dokumentrelationer Fanen med dokumentrelationer er fjernet, da denne kun virkede på ganske få arkiveringsversioner. Vi henviser til den nye tableviewer i stedet.

10 Nye deltest og ændringer i deltests Der er generelt ændret i måden ADA indlæser tabeller og dokumenter. Herudover er der ændret og tilpasset i en række deltests. Denne releasenote vil ikke præsentere alle detaljer for alle deltests, men vi henviser til Hvad udgør en ADA-test Dokumentation af hvad ADA (version 3.3.3) tester for, som afspejler status på hver enkelt test. Vi vil dog gerne fremhæve de nye implementerede deltests, hvor ADA i højere grad tester for om arkiveringsversioner lever op til bekendtgørelsen. Nye implementerede deltests er eksempelvis: 4.C.4_1 Der testes for, at mindst 1 af dokumentkategorierne i <documentcategory> contextdocumentationindex.xml er markeret som true for hvert dokument 4.C.6_2 Hvis arkiveringsversionen har opmærket ekstension.gml i ofn samt gml i aft testes der for, om opmærkningen i gmlxsd er udført korrekt. 4.C.6_3 Der testes for om en docid opmærket i elementet <pid> har en overordnet reference til en docid opmærket i <did> 4.C.6_4 Der testes for om alle led i indlejrede filers filer, har en endelig og afsluttende reference til en <did> 4.E_2 Der testes for, om der findes dokumentsamlingsmapper, der er tomme 4.E _10 Der testes for om nogen af dokumentsamlingsmapperne, indeholder mere end dokumentmapper 4.E_14 Der testes for, om der findes dokumentmapper, der er tomme 4.F_2 Der testes for, om der findes uvedkommende objekter i mappen Schemas, samt de 2 undermapper 4.G_1 Der testes for om der findes andre mapper eller filer i Documents, udover dokumentsamlingsmapper 4.G_11 Der testes for om nogen af dokumentsamlingsmapperne, indeholder mere end dokumentmapper 4.G_13 Der testes for om dokumenternes ID er er unikke inden for Documents. 6.C_28 Der undersøges om navne på database, tabeller, kolonner, nøgler og views er forskellige fra SQL:1999 reserverede ord. 6.A_1 Der testes for, om det angivne arkiveringsversions ID i archiveindex.xml er identisk med den aktuelle arkiveringsversion der testes. Systemkrav Programmet er testet under: Windows 7 Enterprise, Processor: Intel(R) Core (TM) i5 CPU 660@ 3.33GHz 3.47 GHz (2 kerner). Installeret hukommelse 12,0 GB. ADA kræver, at Microsoft.Net Framework 4.5 er installeret. Udover en række Open Source-moduler indeholder ADA moduler, som er underlagt licensregler, og programmet må derfor kun distribueres af Rigsarkivet. Følgende Open Source-moduler benyttes i ADA: MediaInfo fra underlagt GNU Library or Lesser General Public License (LGPL) Følgende moduler er underlagt licensregler: LeadTools Raster Image version