Versions Compared

Key

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

...

Nedenstående diagram viser et overblik over de steps som der skal gennemgås, før det er muligt at få adgang til Nationalt eCPR via FMK. Vurder derfor inden opstart, hvilke behov jeres organisation har for adgang, og hvad der er behov for at kunne se og følge. Tallet angivet i parentes henviser til links, hvor der kan findes yderligere information om emnet. 

(1) Adgangsrettigheder:

(2) MitID erhverv:

...

(9) Webservice:

Aftaler

Der skal laves 2 forskellige aftaler med SDS for at kunne bruge Nationalt eCPR i produktion:

  1. En sundhedsdatanetaftale og tilsvarende tilslutning
    1. Det har alle regioner i forvejen, men det skal sikres, at det integrerende system har sikker adgang til SDN.
  2. En NSP serviceaftale
    1. Sådan en har alle regioner i forvejen.

Det er en god idé at få aftaleprocesserne igangsat som noget af det første, så I ikke senere bliver bremset af manglende aftaler.

DGWS adgangsbillet

Hvis din bruger eller dit system ikke allerede har et gyldigt ID-kort, skal der rekvireres et sådant hos NSP’ens STS-service. Der er i skrivende stund (okt. 2023) kun krav om ”Den Gode Web Service” niveau 3 (system IDKort), men hvis servicen (i step 3) kaldes med et person IDKort (DGWS niveau4) virker det naturligvis også.

Det bliver for omstændeligt at beskrive i detaljer, hvordan du rekvirerer et ID-Kort (og du har sikkert også gjort det i andre sammenhænge), men du kan læse mere om det her:

Hvis det er et System-IDkort, du vil skabe, skal du bruge: /sts/services/NewSecurityTokenService, og i dit request skal du medsende et autentifikationsbevis baseret på et ”systemcertifikat”. Læs evt. mere om dem på MitID Erhverv - Certifikater.

STS’en skal betragtes som endnu en DGWS service på NSP, så her skal der også whitelistes. Testmulighederne i de efterfølgende steps gælder også for STS’en, så her er der god hjælp/inspiration at hente. 

Brug afNationalt eCPR

Snitfladen i Nationalt eCPR følger ”Den Gode Web Service”, hvor adgangsbilletten indlejres i headeren og parametre mv. kommunikeres i body. Hvis I koder i Java eller .NET er der god hjælp at hente i ”SOSI bibliotekerne”:

Test og Testmiljøerne på NSP

Der er gode muligheder for at teste din (færdige) løsning mod NSP’ens testmiljøer. Du finder yderligere information om testmiljøerne her:

Hvis I ikke allerede har adgang, kan I ansøge om adgang her: Bestillingsark for adgang til testmiljø der skal udfyldes og indsendes til SDS´s Nationale Servicedesk.

Liste over miljøer

Nationalt eCPR-Service er tilgængelig i følgende miljøer

Test1

http://test1-cnsp.ekstern-test.nspop.dk:8080/decoupling/ecpr2/

Test2

http://test2-cnsp.ekstern-test.nspop.dk:8080/decoupling/ecpr2/

Prodtest

http://prodtest-cnsp.ekstern-test.nspop.dk:8080/decoupling/ecpr2/

Udd

http://uddannelse-cnsp.ekstern-test.nspop.dk:8080/decoupling/ecpr2/

Stage og Prod

Endpoints til stage og prod miljøer fås efter aftale ved henvendelse til NSP Supporten.

eCPR - Forretningsregler

Excerpt Include
eCPR - Forretningsregler
eCPR - Forretningsregler

WSDL

Der findes en række services i Nationalt eCPR, som er defineret gennem to WSDLer:

  • ECPR2Service: De basale service til opslag og opdatering af data

  • ECPR2MasterDataService: Utility service til OID-opslag

De konkrete WSDLer findes i ecpr2-wsdl.zip under /wsdl.

Status
subtletrue
colourYellow
titleas is
Nationalt eCPR driftes pt på FMK platformen, og wsdl filerne kan derfor hentes der.

Status
subtletrue
titleto be
Når Nationalt eCPR flyttes til NSP platformen fjernes ECPRMasterDataService, hvorefter Utility service til OID service også findes gennem ECPR2Service. Herefter kan WSDL'erne findes på to forskellige endpoints, både med og uden security headers:

  • Med security header:{\[miljøurl\}\ecpr2\wsdl\dgws_service.wsdl
  • Uden security header: {\[miljøurl\}\ecpr2\wsdl\dgws_service_no_security_header.wsdl

eCPR - Snitfladebeskrivelse

...

XML skemaer for indhold i adviseringer:ecpr2 ECPR2Advis-advis-collection-dist.zip

Status
subtletrue
colourYellow
titleAS is
 Nationalt eCPR driftes pt på FMK platformen, og xml filerne kan derfor hentes der.

...

Der adviseres ved to typer handlinger:

Ændring af personregistreringActionBeskrivelse
Opdatering af personUpdated

For alle ændringer der foretages på en personregistrering efter den er oprettet. 

  • Ændring/opdatering af en eksisterende værdi
  • Tilføjelse af nye dataelementer
  • Inaktivering af gamle dataelementer
  • Flet af to personregistreringer (opdaterer begge de oprindelige personregistreringer)

Adviseringen indeholder ikke information om hvordan og med hvad personregistreringen er blevet ændret. 
Blot information om at den er blevet ændret.

Sletning af personDeletedFuldstændig fjernelse af en personregistrering - vil kun forekomme i test.

Ændringer af personregistreringer

...

1.02023-11-30Indhold publiceretSDS
1.12023-12-04

Tilføjet:

  • afsnittet adviseringer
  • underafsnit til Kom-godt-igang.
  • liste over miljøer
  • afsnit om wsdl
SDS
1.22023-12-05

Tilrettet hvordan wsdl'erne tilgåes efter flytning til NSP

Trifork