Changelog
Dato | Version | Ændring |
---|---|---|
31/12-2016 | 1.0.0 | Initiel release af Dynamisk Testdata Generator |
03/03-2017 | 1.0.1 | Web interface tilføjet |
23/03-2017 | 1.0.2 | Environment tilføjet til generator. Webservice-modul opdateret til at gøre brug af json-1.0.4 i stedet for json-1.0.3. |
19/5-2017 | 1.0.2 | Udvidet dokumentation af web klient. Ingen ny release, kun dokumentationsopdatering |
17/7-2017 | 1.1.0 | "Tilknyt apotek", "Tilknyt forælder" og "Udsted særligt sundhedskort" events tilføjet |
8/9-2017 | 1.1.1 | Nyt søgefelt tilføjet med mulighed for at fremsøge personer tilhørende andre |
17/1-2018 | 1.2.0 | Understøttelse af begrænset ordinationsret |
IndledningDynamisk Testdata Generator kan anvendes på to forskellige måder. Først og fremmest er der en web-klient, hvor en anvender kan logge ind og oprette personer samt tilknytte autorisationer og ydere hertil. Ud over dette er det muligt for en anvender selv at kalde den HTTP POST baserede web-snitflade, som klienten gør brug af, for på den måde at arbejde med testdata direkte i egne systemer og scripts. RegistreNår man opretter en person eller et andet event gennem enten klienten eller web-snitfladen, så oprettes data ikke direkte i Stamdata Registrene på NSP. Dette skyldes at Stamdata på NSP kommer ind via et antal importere som asynkront modtager data fra forskellige kilder. DTG er udviklet til at simulere denne opførsel for at sikre bedst mulig datakvalitet og sammenlignlighed med produktionsregistre. Derfor kan der gå op til 24 timer inden f.eks. en autorisation bliver tilgængelig i de tilsvarende Stamdata Registre på NSP. Denne anvenderguide indeholder ikke detaljer omkring felter og datastrukturer i stamdata-registrene på NSP, det forventes derfor at læseren kender til de forskellige fagområder som det er muligt at oprette testdata til. KlientWeb klienten er udviklet med fokus på et brugervenligt og selvforklarende design. Klienten understøttes derfor af flere forskellige browsere, og samtidig er der foretaget flere heuristiske usability tests, der sikrer en klient, der er let forståelig og brugervenlig. Klienten kan tilgåes via nspop.dk hvor den offentlige adresse også kan findes. Klienten er generelt set lavet således at en bruger ikke er tvunget til at angive nogle af de mulige input, hvis et felt er tomt så finder DTG selv på noget realistisk data at anvende. Gennem klienten er det muligt at foretage sig følgende handlinger:
OversigtKlienten starter på oversigtssiden hvor det er muligt at se alle de personer som tilhører den aktuelle bruger. Herfra kan man oprette nye personer, filtrere i ens data samt vælge en enkelt person (klikke på rækken) for at se detaljer omkring denne. Ny personPå denne side kan man vælge at angive nogle af de værdier en person skal have, hvis et felt ikke udfyldes så vælger DTG selv nogle realistiske data. Da CPR nummer, fødselsdato og køn skal hænge sammen gælder følgende regler:
Det ydernummer der angives ved oprettelse af en ny person angiver personens alment praktiserende læge ifm. sygesikring. Hvis der ikke angives et nummer vælges der et tilfældigt. Den nye persons far og mor vælges tilfældigt blandt den aktive brugers eksisterende data. Hvis der ikke kan findes en passende person til rollen angives der i stedet et tilfældigt navn og fødselsdato. Vis personPå denne side kan man se yderligere detaljer omkring den valgte person samt tilføje nye events for personen. I bunden af siden kan man se en oversigt over de events som tidligere er blevet tilføjet. Hvis der trykkes på "Fraskriv ejerskab" flyttes personen væk fra den aktive bruger og over i en pulje af baggrundsdata. Dvs. personen findes stadig på NSP, men den tilhører ikke længere den aktive bruger og man kan ikke længere se eller opdatere data for den. I denne version kan man ikke se forældre/barn relationer, men dette forventes i en kommende version. Tildel AutorisationPå denne side kan man tildele en autorisation og tilknytte den autoriserede person til en yder. Hvis man ikke udfylder autorisationskode eller uddannelseskode så vælge DTG tilfældige værdier i stedet. Hvis man ikke angiver et ydernummer så laves der ingen tilknytning til en yder. Hvis man vælger et ydernummer som ikke findes i forvejen så oprettes der en yder med det angivne nummer i yderregisteret. Tilknyt apotekPå denne side kan man gøre en person til en apoteker ved at tilknytte et apoteksnummer til vedkomne. Hvis apoteket med det angivne apoteksnummer ikke allerede findes, oprettes det af systemet. Hvis man vælger et apoteksnummer der allerede findes kan man ikke udfylde de resterende felter da disse værdier derfor allerede er fastlagte. Flere personer kan godt være knyttet til det samme apoteksnummer og ligeledes kan en person godt være tilknyttet flere apoteksnumre. Tilknyt forælderPå denne side kan man knytte en forælder til det valgte barn. Man kan ligeledes vælge om der også skal tilknyttes forældermyndighed. Begge personer skal være ejet af den aktive bruger, man kan ikke tilknytte en forælder der ikke tilhører en selv. Typen 'anden' bruges hvis der ikke er tale om biologiske forældre og kræver at forældremyndighed er valgt. Den tilknyttede forælder skal være minimum 18 år ældre end den valgte person. Det er kun de to nyeste forældremyndigheder der er aktive i det genererede testdata, ligeledes er det den nyeste mor og far relation der er aktive. Udsted særligt sundhedskortPå denne side kan man udstede et særligt sundhedskort. Personer med et særligt sundhedskort er også nogle gange omtalt som grænsegængere. Hvis man vælger at personen har bopæl i udlandet bør man angive sikringsgruppe 7, da denne gruppe netop dækker over dette. Hvis man udsteder to særlige sundhedskort til en person er det den nyeste af dem der bliver det aktive i registeret Begræns ordinationsretPå denne side er det muligt at angive begrænsninger til ordinationsretten på en given autorisation. Såfremt den valgte person har minimum en autorisation er det muligt at vælge begræns ordinationsret eventet. Fra dropdownlisten vælges en autorisation og efterfølgende udfyldes de ønskede begrænsninger i autorisationsfraskrivelse, delvisindskrænkning, autorisationsfratagelse etc. Der skal udfyldes valide ATC koder og * kan anvendes som wildcard. ATC koderne skal adskilles med mellemrum. Klienten giver løbende feedback på validiteten af de ATC koder man indtaster. Der kan angives fra 1. til 5. niveau af ATC koder, så det er ikke en nødvendighed at angive alle 7 karakterer. ScriptDe endpoints som klienten bruger til at oprette personer og events med er ligeledes tilgængelige for anvendere således at de f.eks. kan udvikle egne integrationer eller blot simple scripts til oprettelse af ny testdata. NSP offentliggør kildekode for DTG projektet og her kan man under "modules/webservice/src/main/resources" finde Swagger filen swagger.yml som beskriver input og output til de forskellige endpoints. EksemplerFølgende er et eksempel på hvordan man får oprettet en enkelt person, tildelt en autorisation og listet sine data. Under "modules/webservice/src/test/curl" kan man finde yderligere eksempler. OpretAntag at filen opret.json indeholder følgende:
Hvis vi så udfører følgende kommando:
Får vi følgende tilbage:
AutorisationAntag at filen autorisation.json indeholder følgende:
Hvis vi så udfører følgende kommando:
Får vi følgende tilbage:
ListAntag at filen list.json indeholder følgende:
Hvis vi så udfører følgende kommando:
Får vi følgende tilbage:
|