Her er en liste over nogle typiske spørgsmål og svar vedrørende NSI´s fælles testmiljøer.
Kom godt i gang
Kom godt i gang | Hvordan kommer jeg i gang med at bruge testmiljøerne? | Der er en overordnet aktivitetsliste på NSP-operatørens hjemmeside, der hjælper med at få etableret et godt udgangspunkt for både aftale, teknik og organisation (under overskriften ”Tilslutningsguide” i linket nedenfor: https://www.nspop.dk/pages/viewpage.action?pageId=8915610 Som støtte i tilslutningen er der i tilslutningsguiden placeret en ”tjekliste” som Appendiks A, hvor man kan danne sig et overblik over de væsentligste punkter i tilslutningsforløbet. Når aftalen er på plads, modtager du en mail med et endpoint til de fælles testmiljøer. De kan derudover findes her: https://www.nspop.dk/pages/viewpage.action?pageId=4839407 Der er ikke udarbejdet specifik servicedokumentation for testmiljøerne, idet målet med testmiljøerne er at være produktionslignende, og der henvises derfor til dokumentationen for produktionsmiljøet (samt fra eventuelle projekter ved test af services eller snitfladeversioner, der endnu ikke er i produktion). |
Kom godt i gang | Hvordan får jeg hul igennem til FMK? | Det er en forudsætning at der er en aftale på plads med NSI om brug af testmiljøerne. Endvidere skal der være bestilt og oprettet stamdata, og der skal være oprettet mindst ét testcertifikat for en sundhedsfaglig bruger med cpr-nummer og autorisationsID, der findes i testmiljøerne. NSP-operatøren har udarbejdet en kort vejledning, der – givet ovenstående er på plads – anviser hvordan FMK tages i brug. Vejledningen inkluderer de nødvendige endpoints til FMK i testmiljøerne: https://www.nspop.dk/display/web/NSP+Service%3A+FMK+adgang NB! I linket ovenfor er det beskrevet, at anvendelse af FMK's testmiljø Admin-konsol forudsætter et whitelistet testcertifikat. Der skal foretages en whitelisting af det CPRnummer og CVRnummer som certifikatet er oprettet med. Der sendes en webformular til National ServiceDesk, der sørger for at whitelistingen foretages. |
Kom godt i gang | Hvordan opretter jeg testcertifikater? | NSP-operatøren har en vejledning til testcertifikater: |
Kom godt i gang | Hvordan kommer jeg i gang med at bruge de enkelte services i testmiljøerne? | I aftalen med NSP-operatøren om brug af testmiljøerne angives hvilke services der ønskes adgang til. Endpoints til de specifikke services i testmiljøerne kan rekvireres hos NSP support. Der findes endvidere en oversigt over udvalgte endpoints her: https://www.nspop.dk/pages/viewpage.action?pageId=4839407 Hvis ikke I har udfyldt aftalen allerede kan den findes her: https://www.nspop.dk/pages/viewpage.action?pageId=3672761 Adgang til datasamlinger (NSP stamdata) forudsætter whitelisting. Denne kan i.f.m. test fås i samme sagsgang, ved at udfylde ovenstående anmodning. I.f.m. adgang til produktionsdata eller adgang til datasamlinger for testområdet kan anmodning rettes til NSP området gennem denne blanket: Bestillingsark for stamdataregistre |
Kom godt i gang | Jeg er helt nybegynder i sundheds-it, og jeg vil gerne vide mere om det hele - hvor starter jeg? | Der er mange begreber og standarder i spil, og det kræver tid og indsats at få det samlede overblik. Der er endvidere en række krav til sikkerhed, autentifikation, identitet og autorisation der skal opfyldes, og man har valgt så vidt muligt at anvende og profilere internationale standarder for at overholde disse krav. Brugen af NSP er bygget op over det princip, at al kommunikation er webservicebaseret (følger DGWS 1.0.1), og der anvendes digital signatur (OCES) som fundament for identitet og autentifikation af både personer og it-systemer. Det forudsættes at man har et overordnet kendskab til begreberne fra Den Gode Web Service (DGWS), samt certifikat begreber, f.eks. MOCES, VOCES og FOCES. Desuden anbefales man at bruge et af de tilbudte Seal biblioteker til henholdvsvis Java og .NET for at udstede ID-kort og kald af DGWS services. Her er en række begreber og standarder, samt links til vejledninger m.v. Generelt kan det anbefales at søge på nspop.dk efter information, samt på digitaliser.dk:
|
Kom godt i gang | Hvad betyder alle forkortelserne I bruger over det hele??? | På NSP-operatørens hjemmeside ses en oversigt over både begreber og forkortelser: |
Kom godt i gang | NSP-operatørens hjemmeside,http://www.nspop.dk, virker halvfærdig og jeg kan ikke finde svar på mine spørgsmål - hvad gør jeg forkert? | Der foregår løbende en udbygning af hjemmesiden. Hvis du har spørgsmål vedr. testmiljøerne er der et omfattende dokumentationsmateriale om testmiljøerne, sammenhængende testdata og de andre aspekter vedr. ibrugtagning og anvendelse af miljøerne. I nærværende FAQ er der linket "dybt" ind på nspop.dk og til andre kilder til information, og det anbefales kraftigt at kigge FAQ'en igennem, idet der her er opsamlet svar på de oftest stillede spørgsmål. Det anbefales endvidere at gøre brug af søgefunktionen på nspop.dk (øverste højre hjørne på alle sider). |
Kom godt i gang | Hvordan bruger jeg Dump/Restore? | NSI har releaset en visuel klient, der "pakker" det bøvlede/tekniske i Dump/Restore ind: https://svn.softwareborsen.dk/dump-restore-client/releases/ I linket ovenfor vælger du den nyeste version (pt. 1.0.1), og pakker zip-filen ud. Der er inkluderet en vejledning, "Anvenderguide til klient v10.pdf", hvori det er beskrevet relativt udførligt hvad man skal gøre for at komme i gang med testdataklienten. Eksplicit for FMK er der en række relevante informationer samlet sammen her, herunder endpointet til Dump/Restore, hvis man selv ønsker at lave en testdataklient: |
Kom godt i gang | Hvordan kalder jeg FIBS? (Fødselsindberetningsservicen på NSP) | FIBS er dokumenteret på NSP-operatørens hjemmeside: For bedre at forstå testklienten er det en fordel at have overblik over de forskellige use cases beskrevet i "How-To (Tutorials)" afsnittet i Seal.Java dokumentationen (SEAL.JAVA).
|
Kom godt i gang | Jeg skal bruge service "X" - hvor finder jeg de nødvendige tekniske og praktiske informationer? | På nspop.dk er der samlet informationer om de forskellige services, der udbydes på NSP. Brug søgefunktionen i øverste højre hjørne af nspop.dk for at finde den relevante service, hvis ikke du nemt kan klikke dig frem til den på anden vis. Bemærk: Der er stadig enkelte "huller" i dokumentationen, og det er en igangværende proces af fylde disse huller ud. |
| Kom godt igang | Hvordan kommer jeg igang med at bruge datasamlinger på NSP? | Du skal anmode om at blive whitelistet til datasamlingerne - se evt. under Hvordan kommer jeg i gang med at bruge de enkelte services i testmiljøerne? Dokumentationen findes her: https://fisheye.nspop.dk/browse/public/components/sdm/release-3.5.3/doc I dokumentationen findes der en guide til anvendere. Her kan du også søge efter seneste version samt se kode på Inventory - sdm-v_3_5_3, (indeholder alle registerservices). |
| Kom godt i gang | Dokumentationen er alt for overordnet, hvor finder jeg noget mere anvendelig dokumentation? | NSP operatørens hjemmeside er opdelt i flere sektioner, og meget af den tekniske dokumentation (med xml-eksempler, endpoints, WSDL, XDS-filer m.m.) ligger i et separat område kaldet "Fisheye", der ikke er linket til fra den overordnede dokumentation, men i stedet skal findes for konkrete releases. På den måde sikres det, at man har fat i den dokumentation, der er gældende for den version af servicen, der er aktuel i det miljø, man udvikler til. Der er mindst tre forskellige måder at fremsøge den tekniske dokumentation - men kun én udgave af dokumentationen, så valget af metode er temperamentsafhængigt, resultatet bliver det samme. Metode 1: Brug komponent-oversigten
Metode 2: Brug release-oversigten
Metode 3: Find dokumentationen direkte i fisheye
|
Testdata
Testdata | Hvordan får jeg flere testpatienter? | Der er en form på NSP-operatørens hjemmeside, hvor man kan bestille testpatienter (klik på den grønne knap med teksten "Oprettelse af Test Stamdata"): https://www.nspop.dk/display/resources/Oprettelse+af+Test+Stamdata Bemærk at denne service ikke koster noget at anvende. Bemærk endvidere at formatet for bestillingen er dokumenteret i svaret til næste spørgsmål, herunder angivelse af om testpatienter skal oprettes med kliniske data i de tilhørende nationale services (pt. FMK). |
Testdata | Hvor meget kan jeg bestemme over testdata, f.eks. navne på patienter og den slags? | På NSP-operatørens hjemmeside ses en oversigt over de parametre, der kan angives: https://www.nspop.dk/display/web/Testdata#Testdata-BestillingafTestborgerogTestautorisationer På sigt er det intentionen at udvide mængden af felter, du som dataejer kan angive i en bestilling. |
Testdata | Hvordan får jeg oprettet testklinikere, f.eks. læger og sygeplejersker? | Opgaven består af følgende trin, der er beskrevet i detaljer længere nede:
1: Bestil: Da data i testmiljøerne skal være sammenhængende, skal stamdata først bestilles hos NSP-operatøren: https://www.nspop.dk/display/resources/Oprettelse+af+Test+Stamdata Bemærk at klinikere også skal oprettes som borgere, så det matcher den virkelige verden, hvor en kliniker også findes i CPR-registret.
2 og 3: Opret identititer og testcertifikater Klinikeres adgang til testmiljøerne er (som i produktionsmiljøet) betinget af brugen af digital signatur, og der skal derfor også oprettes testcertifikater for klinikerne. Dette gøres i OCES-operatørens testmiljø, og der er udarbejdet en vejledning til hvordan man gør (nederst på siden der linkes til nedenfor, ## overskrift ”Testcertifikater”): https://www.nspop.dk/pages/viewpage.action?pageId=8915610 Bemærk at oplysningerne, der angives i testcertifikaterne, bør stemme overens med data i testmiljøerne. Bemærk endvidere, at det er muligt at scripte sig ud af opgaven hvis der skal oprettes store mængder testcertifikater, idet den form, der anvendes til oprettelse af identiteter i OCES-operatørens testmiljø, blot er en helt almindelig POST-form. NB! Der er formatteringsregler for autorisationsnumre hvilket har betydning for dit valg af test-autorisationer, idet den eneste gyldige vokal der kan anvendes i autorisationsnumre er "Y". Ud over dette, må autorisationsnumre kun indeholde konsonanter og tal. |
Testdata | Hvordan opretter jeg en sygehuslæge eller en privatpraktiserende læge? | Der er ikke en eksplicit måde at angive dette på, idet denne information er afledt. I praksis styres ”typen” af læge ved om der angives et ydernummer i bestillingen. Der er tre muligheder:
Bemærk at ydernummeret skal eksistere i testyderregistret, hvis du angiver det eksplicit.
|
| Testdata | Hvordan opretter jeg et ydernummer? | Der kan ikke oprettes konkrete ydernumre. |
Testdata | Hvem har "ejerskab" på SOR/SKS koder - hvordan ved jeg hvilke koder jeg kan bruge uden at genere andre? | Testmiljøerne anvender produktionsdata for SKS- og SOR-registrene, så du kan referere til "rigtige" SKS- og SOR-koder. Der er pt. ikke planer om at indføre "testdata ejerskab" for disse registre, så du har frie hænder til at pege på de koder, du mener tjener dit formål bedst. |
Testdata | Hvordan får jeg fat i patienter af forskellig ”type”, f.eks. diabetespatienter, kronikere, cancer, osv.? | Som en del af konceptet omkring sammenhængende testdata genereres der automatisk data, der dels hænger pænt sammen, dels har klinisk meningsgivende data i f.eks. FMK. Ønskes der (kliniske) testdata til specifikke formål, er det op til anvenderne selv at opbygge ”gode” testdatasæt, f.eks. gennem brug af egne testinstallationer (EPJ, EOJ, LSP, osv). Det er intentionen med testmiljøerne, at man som anvender af miljøet vidensdeler internt, og orienterer andre anvendere om ”gode” patienter man har udarbejdet, og som andre kan kopiere til eget brug (gennem Dump/Restore snitfladen). |
Testdata | I de ”gamle” testmiljøer hed vores testklinikere ”XX Læge 1”, ”XX Læge 2”, osv, men i de nye hedder de noget mere almindeligt – hvorfor? | Testdatascriptet tager nogle få parametre som input, og data derudover genereres automatisk. Fornavn, efternavn, vejnavn m.v. hentes fra en opslagstabel, hvor der er et antal af hver type ("Kasper", "Michael", "Abdul", "Leif", osv osv), og scriptet udvælger tilfældigt fra denne tabel, så der opstår testdata, der ser "pæne" ud. I den nuværende version af scriptet er det kun muligt at konfigurere få parametre - på længere sigt håber vi på at udvide det, så man får mere indflydelse og kan konstruere målrettede testdata, f.eks. borgere hvor der indgår specialtegn (danske bogstaver, umlaut, osv) i deres navne, postnummer, osv osv. Konfigurationsparametrene er dokumenteret her: https://www.nspop.dk/display/web/Testdata#Testdata-BestillingafTestborgerogTestautorisationer |
Testdata | Hvilke autorisationstyper kan jeg vælge imellem når jeg opretter testklinikere? | Den komplette liste (“klassifikation”) kan hentes på sst.dk som en xml-fil: http://autregwebservice.sst.dk/autregservice.asmx/GetAllProfessionGroups Listen over autorisationstyper, som FMK forholder sig til, kan ses i snitfladebeskrivelsen for FMK. Her er et link til dokumentationen for FMK version 1.2.6 (se side 19 for FMK's egen beskrivelse af roller og rettigheder): |
Testdata | Hvordan finder jeg ud af hvad mine testborgere og testklinikere hedder i testmiljøerne? (fornavn, efternavn m.v.) | Disse informationer er tilgængelige gennem SDM (stamdatamodulet) på NSP, samt CPR-enkeltopslagsservicen. Hvis I ikke benytter nogle af disse services i jeres systemer er det pt. nødvendigt at kontakte den nationale servicedesk med en forespørgsel. Husk i givet fald at angive hvilke testcpr-numre, I ønsker at få udtrukket navneinformationer på. Når testdata oprettes via den Nationale Servicedesk, returneres også navneoplysninger for de testborgere der oprettes. |
Brugere
Brugere | Hvordan giver jeg mine brugere adgang til FMK-online i testmiljøerne? | Som i produktionsmiljøet er adgangen til FMK-online baseret på dels digital signatur (M-OCES og test M-OCES), dels på sundhedsfaglig autorisation. Det er derfor nødvendigt at oprette testcertifikater til dine brugere. Testcertifikaterne skal baseres på testCPR-numre, der matcher hvad I har af sammenhængende testdata (herunder at der for de valgte testCPR-numre skal findes autorisationsID'er i testautorisationsregistret). Læs mere om hvordan man får testdata og testcertifikater i de øvrige spørgsmål. Bemærk: Det er ikke nødvendigt at etablere egne testmiljøer for at give adgang til FMK-online, dertil kræves alene testcertifikater, der passer ind i de sammenhængende testdata som beskrevet ovenfor. |
Brugere | Hvordan giver jeg mine brugere adgang til testmiljøerne? | Først og fremmest skal du have formalia på plads omkring brug af testmiljøerne, og du skal have testpatienter og testklinikere. Dette er beskrevet i svaret til spørgsmålet med ordlyden "Hvordan kommer jeg i gang med at bruge testmiljøerne?" samt en række af de øvrige "Kom godt i gang" spørgsmål. Dernæst skal du have dit eget testmiljø, der kobler op mod det af de fælles testmiljøer, der passer bedst til dit konkrete formål med dit eget testmiljø. Dine brugere skal have adgang til dit eget testmiljø - hvordan det gøres afhænger af dit setup, og hvordan dine brugere er placeret geografisk og netværksmæssigt. Hvis du er LPS-leverandør eller lignende har dine kunder nok ikke realistiske testLRA-muligheder, og du kan overveje at hjælpe dem på vej ved at oprette testcertifikater til dem. Bemærk i øvrigt, at adgang til FMK-online sker i en browser og derfor i praksis alene kræver et passende testcertifikat. Se spørgsmålet med ordlyden "Hvordan giver jeg mine brugere adgang til FMK-online i testmiljøerne?" for yderligere information om dette. |
Testbrugere og certifikater
Testbrugere og certifikater | Hvordan får jeg en lægesekretær eller tilsvarende bruger uden autorisation, som arbejder på vegne af en autoriseret sundhedsfaglig? | Testmiljøerne og produktionsmiljøet er også her identiske i håndteringen af brugere. En person uden sundhedsfaglig autorisation skal eksistere i testcpr-registret, og skal vælges blandt ens "egne" testborgere. Du skal blot oprette et medarbejdercertifikat for vedkommende, og efterfølgende sørge for at angive i kaldet til FMK hvilken rolle der ønskes, og evt. hvem, der arbejdes på vegne af. Eneste krav er standardkravet om at personen (samt "på-vegne-af personen") skal eksistere i testmiljøet (CPR-registret), og at det skal være et CPR-nummer, der er "ejet" af jer i testmiljøerne. Håndtering af sekretærer og andre personer uden sundhedsfaglig autorisation er beskrevet i FMK snitfladebeskrivelsen (kan findes her: http://digitaliser.dk/group/1597792/resources/type/150025). Søg evt. efter ordet "medhjælp" for at finde de relevante afsnit. Bemærk at "på vegne af" også styres af bemyndigelsesregistret, så man har gennem brug af bemyndigelsesservicen yderligere muligheder for at teste disse emner. |
Testbrugere og certifikater | Hvilke uddannelseskoder kan jeg anvende, når jeg bestiller testklinikere? | I testmiljøerne kan der benyttes samme sæt af uddannelseskoder som i produktionsmiljøet. I beskrivelsen af autorisationsregistret (SDM) på NSP er der en liste af gyldige koder med tilhørende navn (afsnit 8, "feltbeskrivelser"): https://www.nspop.dk/display/web/Udstilling+af+Autorisationsregisteret Koderne er også angivet under afsnittet om bestilling af testdata https://www.nspop.dk/display/web/Testdata |
FMK
FMK | Hvor finder jeg de gældende WSDL'er for de forskellige FMK snitfladeversioner? | På digitaliser.dk - her er der både WSDL og dokumentation for de forskellige snitfladeversioner. |
FMK | Hvordan finder jeg en patient i FMK, hvor der ingen data er på patienten (jeg vil gerne teste at mit it-system kan håndtere "tomme" patienter)? | Du kan i bestillingen af sammenhængende testdata angive for en patient, om der skal oprettes kliniske data. Hvis du fravælger dette, har patienten et "tomt" medicinkort. Efterfølgende kan du kontrollere om kortet fortsat er tomt ved at se på versionsnummeret. Hvis dette er 0 og der ikke returneres løse recepter i svaret på GetMedicineCard , så er der ingen data på patienten. |
| FMK Produktion | Hvordan bliver vi certificeret til FMK produktion? | Der findes en beskrivelse af hvordan en certificering til FMK produktion foregår her:NSP Service: FMK adgang |
Endpoints
Endpoints | Hvor finder jeg endpoints til FMK's testmiljøer? | FMK har sin egen service-side på nspop.dk, og her er der sammen med megen anden nyttig information også endpoints til testmiljøerne: |
Endpoints | Hvor finder jeg endpoints til SOSI-GW og SOSI-DCC? | Sosi-gw på test2 miljøet kan findes her (erstat miljønavn for at ramme et af de andre testmiljøer): http://test2.ekstern-test.nspop.dk:8080/sosigw/ Dokumentationen (https://svn.nspop.dk/public/components/sosi-gw/latest/doc/) beskriver hvordan snitflade skal tilgås. Det bør desuden bemærkes at DCC (afkoblings-komponenten) normalt bruges i sammenhæng med sosi-gw. Denne sikre også at det er den korrekte bagvedliggende service (f.eks. FMK) , der forespørges. DCC kan findes her: http://test2.ekstern-test.nspop.dk:8080/decoupling/ Dokumentation for denne findes her: https://svn.nspop.dk/public/components/sosi-dcc/latest/doc/ |
Endpoints | Hvor finder jeg endpoints til de forskellige operationer på adviseringsservicen? | Her er endpoints til TEST2, adgang i de øvrige miljøer på samme URL, blot erstat test1 med det relevante miljønavn (test2, prodtest, udd). Bemærk at man skal whitelistes hos NSP-operatøren for at få adgang til de enkelte services, det gælder også i testmiljøerne. http://test2.ekstern-test.nspop.dk:8080/idlist/service http://test2.ekstern-test.nspop.dk:8080/pullpoint/service http://test2.ekstern-test.nspop.dk:8080/pullpointfactory/service http://test2.ekstern-test.nspop.dk:8080/subscriptionmanager/service |
Fejlretning
Fejlretning | Vi har en fejl i produktion med en patient med så komplekse data, at vi ikke kan genskabe fejlsituationen i testmiljøet – kan vi få en kopi af produktionsdata for den patient? | Desværre er dette ikke muligt indenfor rammerne af hvad datatilsynet tillader. |
| Fejlretning | Vi er blevet bekendt med, at problemerne med at tilgå de 4 testmiljøer er brug af gamle IG certifikater, som valideres op mod et gammelt IG-miljø.
| Vi må derfor betegne miljøet som driftsustabilt. Derfor bedes du checke gl. certifikater efter nedenstående information: Sådan kan du se forskel på certifikater til PP hhv. IG miljøet: For PP miljøet indeholder certifikatet: Issuer: TRUST2408 Systemtest VIII CA, TRUST2408 For IG miljøer indeholder certifikatet: Issuer: TRUST2408 Systemtest X CA
Hvis der er tale om et IG certifikat, bedes det hurtigst belejligt udskiftet med et PP testcertifikat hos Nets/DanID. |