Kategori

Opgave/spørgsmål

Beskrivelse

Kom godt i gang

Hvordan kommer jeg i gang med at bruge testmiljøerne?

Der er en overordnet aktivitetsliste på NSP-operatørens NSPs 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 SDS 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 Der er 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 Her er en vejledning til testcertifikater:

https://www.nspop.dk/pages/viewpage.action?pageId=8915610

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.
Start med at læse denne beskrivelse på NSPOP: https://www.nspop.dk/pages/viewpage.action?pageId=12226170

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.

For at anvende DGWS services bruger man et ID-kort, og typisk vil man skulle have det udstedt fra en STS (se single-signon i DGWS). Dertil bruger man Seal.Java eller Seal.NET, og dokumentation til Seal.Java ("The SOSI Library
Programmer's Guide") indeholder brugbare praktiske eksempler på anvendelser. Seal.NET dokumentationen er mindre omfattende, så det er en fordel at have kendskab til Seal.Java dokumentationen.

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:

• DGWS (Den Gode Webservice)
• DGWS på digitaliser.dk (indholdet er i de vedhæftede pdf-dokumenter i siden der linkes til)
• DGWS på MedCom
• DGWS med XML eksempler
• STS anvenderdokument
• SEAL
• SEAL.JAVA
• SEAL.NET
• The SOSI Library Programmer's Guide
• IDWS (Identitybased Web Services) og OIOSAML (dansk profil)
• OIOSAML på digitaliser.dk
• SOAP
• XML
• Specialistblad på nspop.dk vedr. tekniske kaldsforløb

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:

https://www.nspop.dk/display/web/Ordliste

Kom godt i gang

NSP-operatørens NSPs 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?

SDS 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:

FMK overblik på nspop.dk

Kom godt i gang

Hvordan kalder jeg FIBS? (Fødselsindberetningsservicen på NSP)

FIBS er dokumenteret på NSP -operatørens hjemmeside:

FIBS servicedokumentation

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).

For at kalde FIBS har man brug for et STS signeret ID-kort, hvilket betyder at man som FIBS testklienten

1. skaber et ID-kort
2. signerer med eget VOCES/FOCES/MOCES certifikat
3. sender til STS, som validerer og signerer ID-kort
4. bygger FIBS request og anvender det STS signerede ID-kort

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.

Hvordan kommer jeg i gang med at bruge de enkelte services i testmiljøerne?

Dokumentationen findes her:

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).

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

1. Klik ind på oversigten over komponenter på operatørens hjemmeside: https://www.nspop.dk/display/web/Inventory+-+NSP-komponenter
2. Klik på den ønskede komponent (f.eks. "advis")
3. Klik på linket i kolonnen "version"
4. På den fremkomne side er der et direkte link til den aktuelle tekniske dokumentation i fisheye

Metode 2: Brug release-oversigten

1. Klik ind på oversigten over releases på operatørens hjemmeside: https://www.nspop.dk/pages/viewpage.action?pageId=4818177
2. Vælg den seneste PIT ("Point In Time") for det miljø, du ønsker at anvende (f.eks. test eller produktion) og klik ind på den
3. Find den service, du ønsker at læse dokumentation fra, og klik på linket med versionsnummeret (f.eks. "advis v1_0_2")
4. På den "Inventory side" du kommer til er der nu et direkte link til den dokumentation, der er releaset i det valgte miljø for den valgte service/komponent.

Metode 3: Find dokumentationen direkte i fisheye

1. Klik ind på fisheye: https://fisheye.nspop.dk/browse/public/components
2. Find den ønskede service/komponent, og følg træstrukturen til folderen "latest" under "doc".

Du kan finde kort beskrivelse af forskellen mellem PEM og CPR enkeltopslag her: Registeropslag på NSP
Der henvises til yderligere anvender dokumentation for SCES i  anvenderguiden for kopiregisterservicen afsnit 5. Guiden ligger her: Anvendelse af Kopiregisterservice (SKRS) 

 Hvordan kommer jeg I gang med at bruge

National Adviseringsservice (NAS)?

Du skal anmode om at blive whitelistet til NAS til både test og produktion ved at sende en supportsag via www.nspop.dk. NSP supporten sørger for at whitelistningen foretages og giver dig besked, når det er foretaget.

Dokumentationen findes her:

 https://fisheye.nspop.dk/browse/public/components/sdm/latest/dochttps://www.nspop.dk/display/web/NAS+-+National+Adviseringsservice

HUSK:

Alle NAS entities er forbeholdt dem, der har oprettet dem. Dette er  fastholdt i owner_id, som en sammensætning af cvr og itSystemName fra   id-kortet (simpel string concatenation). Så hvis der kommer et andet CVR   nummer eller anden itSystemName, så vil requestet fejle.  

Kategori

Opgave/spørgsmål

Beskrivelse

Testdata

Hvordan får jeg flere testpatienter?

Der er en form på NSP-operatørens NSPs 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 NSPs 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 stamdata hos NSP -operatørensupport
• 2 Opret identiteter hos OCES-operatøren
• 3 Opret testcertifikater hos OCES-operatøren

1: Bestil:

Da data i testmiljøerne skal være sammenhængende, skal stamdata først bestilles hos NSP -operatørensupport:

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:

• Ydernummer angivet: Det er en privatpraktiserende læge, hvor du har bestemt hvilket ydernummer lægen skal have
• Ydernummer = ∗: Det er en privatpraktiserende læge, hvor testdatascriptet udvælger et tilfældigt ydernummer i testyderregistret for dig
• Ydernummer ikke angivet: Det er en sygehuslæge

Bemærk at ydernummeret skal eksistere i testyderregistret, hvis du angiver det eksplicit.

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):

http://digitaliser.dk/resource/2388971

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.

Kategori

Opgave/spørgsmål

Beskrivelse

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.

Hvis versionnummeret er større end 0, så findes der FMK-data på patienten.