...

Terminologi

...

Arkitektur

Systemet Organdonorregister-servicen består af registerservicen, der håndterer kald til systemet, funktionalitet og databaseadgang. Der understøttes adgang gennem DGWS eller IDWSen webservice, som andre systemer kan benytte til at oprette, opdatere, slette og aflæse seneste registrering fra.

<iframe src="https://archi.nspop.dk/NSP/570928ca/views/id-198d99a1-fbb0-4f0a-8e05-e2e0e880c919.html" name="test" height="580" width="800">You need a Frames Capable browser to view this content.</iframe>   

* Hver kasse i ovenstående diagram har en kort forklaring, som kommer frem i et nyt browservindue, når der klikkes på kassen.

Som illustreret på figuren herunder tilgår brugerne servicen indirekte via Sundhed.dk, patientjournalsystemer, lægepraksissystemer osv. Herudover foretager Dokumentdelingsservicen (DDS) opslag via FSK. Opslaget via FSK returnerer alene information om, hvorvidt der findes data for en person eller ej. Der understøttes adgang gennem DGWS eller IDWS.

Gliffy Diagram
displayName ODR-Arkitektur v7 name ODR-Arkitektur v7 pagePin 2

...

Der henvises til hhv. Den Gode Webservice og OIO Identity-based Web Services v1.0.1a for yderligere information.

Integrationer

CPR-subscriber

...

Oplysningen om døde personer stammer fra stamdata. Cpr-subscriber gør det muligt for ODR-servicen at lave opslag i stamdata til brug i dette slettejob.

MinLog

Alle opslag og ændringer af oplysninger i registret registreres i MinLog2 med . Med undtagelse af borgerens egen tilgang og ændring af datasystem bruger.

Ved manglende adgang til MinLog-servicen vil servicekaldet fejle.

ODR anvender MinLog Producer biblioteket til at registrere i Minlog2.

CprExists

NAS

Alle ændringer (oprettelser, opdateringer og sletning) af Stamkort afstedkommer adviseringer til NAS.

Ved manglende adgang til NAS-servicen vil servicekaldet fejle.

Beskedformat

Der anvendes følgende topic (som kan konfigureres): http://sundhedsdatastyrelsen.dk/OrganDonation/2022/05/05:OrganDonationUpdated.

Indholdet i notifikationen består af et OrganDonorUpdated-objekt, med følgende attributter:

• type: Type for beskeddefinitionen
• date: Dato for Hvornår ændringen er sket
• version: Versionsnummer for beskeddefinitionen.

<ns3:Notify xmlns:ns3="http://docs.oasis-open.org/wsn/b-2" xmlns:ns2="http://www.w3.org/2005/08/addressing" xmlns:ns6="http://nsi.dk/advis/v10" xmlns:ns8="http://sundhedsdatastyrelsen.dk/organdonor/2022/08/01/" xmlns="">
     <ns3:NotificationMessage>
          <ns3:Topic Dialect="http://docs.oasis-open.org/wsn/t-1/TopicExpression/Simple">http://sundhedsdatastyrelsen.dk/OrganDonation/2022/05/05:OrganDonationUpdated</ns3:Topic>
          <ns3:Message>
               <ns6:NotifyContent id="0501792275" idType="http://nsi.dk/advis/v10/CPR">
                    <ns8:OrgandonorUpdated>
                         <type value="http://sundhedsdatastyrelsen.dk/MessageDefinition/PDC-notification"/>
                         <date value="2022-08-01"/> 
                         <version value="1"/>
                    </ns8:OrgandonorUpdated>
               </ns6:NotifyContent>
          </ns3:Message>
     </ns3:NotificationMessage>
</ns3:Notify>

PersonInformation

Der findes pt 2 implementationer af kald til PersonInformation. Den oprindelige CprExist og den senere PersonInformation.

CprExist

Gennem kald til PersonInformation Gennem kald til CprExists Service foretages validering af CPR nummer.  CPR CPR valideringen kan køre i følgende tre modes:

• OFF: Der foretages ikke yderligere verifikation af CPRnummeret udover simpel validering af længde. CPRExists PersonInformation kaldes ikke
• WARNING: CPRExists PersonInformation service kaldes. Hvis denne service svarer, at CPR nummeret ikke findes, eller er inaktivt, så audit logges denne information.
• REJECT: CPRExists PersonInformation service kaldes. Svaret fra denne er en hård validering dvs. kaldet til ODR fejler, hvis CPRExist PersonInformation service ikke kender CPR nummeret eller det er inaktivt.

PersonInformation Service benyttes ligeledes til validering af alder. Denne validering foretages altid.

PersonInformation

Gennem kald til denne foretages opslag efter personer, som er døde og som er flyttet ud af landet. Dette anvende af slettejobbet. Ligeledes anvendes den til at få en liste af Personer, der snart fyldes 18 år. Dette anvendes af notifikations jobbet sådan, at de kan få et brev omkring organ donation.

Digital Post

Gennem kald til Digital Post Adapter foretages forsendelse af notifikationer om organ donation til borgere. For nuværende drejer det sig om borgere som snart bliver 18.

Design

Gliffy Diagram
displayName ODR-Design v3 name ODR-Design v3 pagePin

...

10

I guide til udviklere findes der et diagram, som kan hjælpe med at forstå den konkrete implementation af forretningslogikken til notifikationsjobbet herunder status opdateringen.

Datamodel

Forretningsservice

Da det kun er borgeren selv der har adgang til at oprette og ændre i vedkommendes organdonorregistrering, kan datamodellen for servicen realiseres relativt simpelt, idet at det ikke er nødvendigt at lagre information omkring hvem der har oprettet / opdateret data.

<iframe src="https://archi.nspop.dk/NSP/570928ca/views/a8998bfe-c235-4089-9971-9fee199ff7f5.html" name="test" height="240" width="800">You need a Frames Capable browser to view this content.</iframe>   

* Hver kasse i ovenstående diagram har en kort forklaring, som kommer frem i et nyt browservindue, når der klikkes på kassen.

Alle registreringer indeholder oplysninger om en gyldighedsperiode, som angiver hvorvidt registreringen stadig betragtes som gyldig eller ej.

...

v2_person_simplified er et view der anvendes til at slå op i cpr-stamdata (cpr-registry)

Operations

Afsendelse af notifikationer gør brug af 2 database tabeller, for at kunne holde styr på, hvilken dag, der er håndteret samt, hvilke personer, der har fået tilsendt post på dagen. De detaljerede schema for disse er:

NotificationDate

NotificationPerson

Baggrundsjob 

Slettejob m.m

ODR servicen indeholder to baggrundsjobs der kan henholdsvis slette registreringer for afdøde personer og ugyldiggøre registreringer for udrejste personer. 

Registreringerne for en afdød slettes 60 dage (kan konfigureres) efter personen er afgået ved døden. Registreringerne bliver slettet fra databasen og data kan således ikke genskabes igen.

Registreringerne for en person der er udrejst opdateres (ValidTo angives) så registreringen ikke længere er gyldig. Hvis personen vender tilbage til Danmark igen, så skal der laves en ny registrering af organdonation.

Jobbet for OrganDonorDeceased består af følgende operationer:

Jobbet for OrganDonorEmigrated består af følgende operationer:

Notikationer

ODR servicen et baggrundsjob der kan sende notifikationer omkring organ donation til udvalgte borgere:

• borgere der snart fylder 18 år

Jobbet fremfinder de relevante personer og kalder digital post client med cpr og relevant brev template.  Se iøvrigt se figur i guide til udviklere for detaljer omkring den konkrete logik.

Jobbet for OrganDonorNotification består af operationerne listet nedenfor. Hver operation kører som en transaktion, sådan at databasen forbliver konsistent uagtet at der opstår en fejl.