Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Her er en liste over nogle typiske spørgsmål og svar vedrørende NSI´s fælles testmiljøer.

Table of Contents

Kom godt i gang

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

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:

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

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.

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

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

...

Kategori

Opgave/spørgsmål

Beskrivelse

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. 

Du skal blot Det er ganske enkelt, idet du blot skal 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

...

Kategori

Opgave/spørgsmål

Beskrivelse

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:

https://www.nspop.dk/display/web/NSP+Service%3A+FMK+adgang

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

Kategori

Opgave/spørgsmål

Beskrivelse

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.

 

   
    Fwd: Sekretærer i Test
    
    Christian Ernstsen
    to:
    Denmark nspsupport
    20-11-2013 07:36