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 |
1/8-2018 | 1.2.1 | Understøttelse af Skift Stilling og Skift Sikringsgruppekode |
14/11-2018 | 1.2.2 | Understøttelse af Skift Læge og Skift Adresse |
04/12-2018 | 1.2.4 | Understøttlese af Skift Personnummer, vis brugernavn på aktuel bruger, fejlrettelser |
05/12-2018 | 1.2.5 | Understøttelse af Marker som Afød, fejlrettelser |
12/03-2019 | 1.2.9 | Understøttelse af Tilknyt værge, Skift navn, Privatmarker adresse, Fratag autorisation, fejlrettelser |
22/05-2019 | 1.2.11 | Understøttelse af uddannelseskoder for Behandlerfarmaceut og Osteopat |
08/01-2021 | 1.3.0 | SDS-3824 - Containerization af DTG |
16/03-2021 | 1.3.1 | SDS-3870 - DTG skal levere data til den nye Yderindlæser |
10/08-2023 | 1.4.1 | Understøttelse af AutorisationImporter v.4 format |
10/08-2023 | 1.4.2 | Tilknytning af forældre begrænser ikke længere på køn |
13/11-2023 | SDS-4344 - DTG understøttelse af "DNHF" data | |
31/01-2024 | 1.6.0 | Ny funktionalitet:
Fejlrettelser:
|
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. Adgang fås ved henvendelse via NSPOP.dk Brugeroprettelse. 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ælger 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. Man kan markere en autorisation som gyldig/ugyldig. Det afspejles i autorisation v.4, som beskrives her. 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. En person kan tilknyttes et apotek igen, hvis de forrige tilknytningers gyldighedsperioder alle er udløbet. 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. Tidligere versioner af DTG begrænsede valg af forældre, så et "Mor"-personnummer skulle matche en kendt person, som var kvinde (og tilsvarende for "Far"-personnummer og en mand). 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. Skift stillingPå denne side kan man skifte en persons stilling. Skift sikringsgruppePå denne side kan man skifte sikringsgruppe for en person. Hvis man vælger sikringsgruppekode 1 kan man også angive et ydernummer til egen læge. Hvis man ikke angiver et ydernummer vælges der et tilfældigt. Skift lægePå denne side kan man skifte en persons læge. Det gøres ved at indtaste et ydernummer. Hvis personen ikke allerede er i sikringsgruppe 1 vil et skift af læge også betyde at personen får skiftet sikringsgruppe til gruppe 1. Skift adressePå denne side kan man skifte en persons adresse. Man kan indtaste postnummer, postdistrikt, kommunekode, vejkode, husnummer, og vejnavn. Hvis man lader felter stå blanke vil DTG generere tilfældige værdier. Skift personnnummerPå denne side kan man skifte en person personnummer. Det gøres ved at indtaste et personnummer. På detaljesiden for den person, som har fået skiftet personnummer, vil nu findes et link til den nye person, der er skiftet til. Marker som afdødPå denne side kan man markere en person som afdød. Handlingen er permanent og kan ikke fortrydes. Personen, der er blevet markeret som afdød, kan ikke redigeres efterfølgende. Tilknytte en værge til en personPå denne side kan man tilknytte en værge til en person. Man kan vælge mellem tre forskellige typer af relation:
Hvis man lader typen eller felter stå blanke vil DTG generere tilfældige værdier. Skift navnPå denne side kan man skifte navn for en person. Man kan indtaste fornavn, mellemnavn, og efternavn. Hvis man lader felter stå blanke vil DTG generere tilfældige værdier. Privat- og særligmarker adressePå denne side kan man vælge om personen skal have markeret sin adresse som privat eller særlig beskyttet Man kan enten vælge at privat- eller særligmarkere adressen eller, hvis den allerede er markeret, kan man fjerne markeringen igen. Fratag autorisationPå denne side kan man fratage en tildelt autorisation. Man vælger i listen en autorisationkode og kan fratage personen denne. Personen kan få tildelt samme autorisationskode igen på siden Opret ny autorisation. Opret henvisningPå denne side kan man tilføje en henvisning. Reference, startdato og slutdato udfyldes altid, og hvis de efterlades tomme gælder:
Hvis de andre felter efterlades tomme bliver "" sendt videre. Dog er eventID's default 5. Opret ydelsePå denne side kan man tilføje en ydelse. Reference, ydernummer, startdato og slutdato udfyldes altid, og hvis de efterlades tomme gælder:
Referencen skal have en længde på 16, og ydernummeret skal have en længde på 6 Oprette fuldmagtshaverPå denne side kan man tilføje en fuldmagtshaver. CPR-nummer på fuldmagtshaveren og de ønskede fuldmagter skrives ned i tekstboksene, hvis de er tomme, tolkes det som, at der ingen fuldmagtshaver er. 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:
Et eksempel på en person med en given fødselsdag (opret.json):
Et eksemple på en person med et givent personnummer (opret.json) - erstat 'xxxx' med noget fornuftigt:
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:
Kendte fejlDer er i øjeblikket følgende kendte udeståender. Eventuel workaround er beskrevet i sagerne: |