Indhold

Komponenter

Dette dokument dækker følgende komponenter på NSP:

• Din Digitale Tandlægevælger (DDTV)

Komponenten dækker 3 services som følger

• Type: IDWS SOAP Webservice

• Filnavn: ddtv-citizen-service.war 

• Url: <serverurl>/ddtv-citizen-service/2025/05/01

• Status-url: <serverurl>/ddtv-citizen-service/status

• Alarm-url: <serverurl>/ddtv-citizen-service/alarm
• DKS-config: <serverurl>/ddtv-citizen-service/dksconfig

• Type: DGWS SOAP Webservice

• Filnavn: ddtv-dentist-service.war

• Url: <serverurl>/ddtv-dentist-service/2025/05/01

• Status-url: <serverurl>/ddtv-dentist-service/status

• Alarm-url: <serverurl>/ddtv-dentist-service/alarm
• DKS-config: <serverurl>/ddtv-dentist-service/dksconfig

• Type: Webservlet
• Filnavn: ddtv-batch-service.war
• Url: <serverurl>/ddtv-batch-service

• Status-url: <serverurl>/ddtv-batch-service/status

• Alarm-url: <serverurl>/ddtv-batch-service/alarm

Konfiguration

Servicekonfiguration

Grundlæggende konfiguration af alle services foregår ved redigering i filen application.properties. For den enkelte service placeres filen i følgende WildFly modul:

/pack/wildfly8/modules/dk/nsp/ddtv/main/

Moduldefinition, som kan anvendes for alle services, findes i kildekoden under:

/etc/wildfly/modules/dk/nsp/ddtv/main/module.xml

I application.properties for DDTV-Citizen servicen kan følgende properties defineres:

I application.properties for DDTV-Dentist servicen kan følgende properties defineres:

I application.properties for DDTV-Batch servicen kan følgende properties defineres:

log4j konfiguration

Log4j konfiguration for alle services findes i samme bibliotek som servicekonfigurationen

Se yderligere opsætning i installationsvejledningen.

Whitelisting

Der foretages whitelisting ved check mod databasen. En ny whitelisting kan tilføjes med følgende SQL insert:

INSERT INTO WHITELIST (cvr, comment)
VALUES ('some-cvr-here', 'some-reason-for-whitelisting-here');

Overvågning

Alle DDTV services udstiller en overvågningsside, som findes i listen af komponenter.

Fortolkning af overvågningsside

Overvågningssiderne returnerer enten:

• HTTP 200, hvis servicen i øjeblikket kører fint.
• HTTP 500, hvis der er opstået en fejl der kræver indgriben.

Audit-logning

Hvert servicekald medfører en ny indgang i auditloggen, som kan være udfyldt med følgende komponenter, afhængig af konteksten:

{
    "time": "2025-09-19T09:04:46.985764854Z",
    "category": "dk.sds.nsp.audit.log",
    "audit": {
        "timestamp": "2025-09-19T11:04:44.736968533+02:00",
        "components": [{
                "component": "DDTV",
                "contexts": [{
                        "context": "applyForNewDentist",
                        "information": [{
                                "key": "patient-id",
                                "type": "RPI",
                                "value": "1811804807"
                            }, {
                                "key": "patient-id-source",
                                "type": "RPI",
                                "value": "OID:1.2.208.176.1.6.1.1"
                            }, {
                                "key": "actor-role",
                                "type": "NPI",
                                "value": "CITIZEN"
                            }, {
                                "key": "actor-id",
                                "type": "NPI",
                                "value": "1811804807"
                            }, {
                                "key": "actor-id-source",
                                "type": "NPI",
                                "value": "CPR"
                            }
                        ]
                    }
                ]
            }
        ]
    },
    "access": {
        "code": 200,
        "duration": 2247,
        "httpHeaders": {
            "Content-Type": "text/xml;charset=UTF-8",
            "SOAPAction": "http://sundhedsdatastyrelsen.dk/ddtv/2025/05/01/#ddtvApplyForNewDentist"
        },
        "httpHost": "localhost",
        "idCardAttributes": {
            "X509Subject": "CN=NSP Test Service Consumer,SERIALNUMBER=UI:DK-O:G:8d3fa047-c77e-47e4-bdd2-e91488610ce6,O=Sundhedsdatastyrelsen,2.5.4.97=NTRDK-33257872,C=DK",
            "dk:gov:saml:attribute:AssuranceLevel": "3",
            "dk:gov:saml:attribute:CprNumberIdentifier": "1811804807",
            "dk:gov:saml:attribute:SpecVer": "DK-SAML-2.0"
        },
        "method": "POST",
        "path": "/ddtv-citizen-service/2025/05/01/",
        "query": "",
        "port": 8080,
        "protocol": "http",
        "reqSize": 12564,
        "resSize": 6493,
        "soapHeaders": {
            "Audience": "https://fsk",
            "Issuer": "TEST1-NSP-STS",
            "NameID": "dk:gov:saml:attribute:CprNumberIdentifier:1811804807",
            "w3Action": "http://sundhedsdatastyrelsen.dk/ddtv/2025/05/01/#ddtvApplyForNewDentist",
            "w3MessageID": "ae528b36-4715-470b-a603-bc4b150a028b"
        },
        "threadId": "default task-1",
        "time": "2025-09-19T11:04:44.736899022+02:00",
        "stats": {
            "handlerDuration": 42,
            "RequestContentDuration": 3,
            "ResponseContentDuration": 0,
            "SecurityProtocolRequestDuration": 17,
            "SecurityProtocolResponseDuration": 20,
            "bufferAllocated": false,
            "usedBuffers": 2,
            "activeBuffersInPool": 2,
            "idleBuffersInPool": 0
        },
        "reqUUID": "f6567a23-dc35-46f2-8ad9-01314fa47750"
    }
}

Baggrundsjobs

Overvågning af baggrundsjobs

Der findes et status og et alarm-endpoint for hver baggrundsjob. De har følgende url'er:

• <serverurl>/batch-service/status
• <serverurl>/batch-service/alarm

De to status-endpoints kan svare følgende

• • Http-kode 200 og Database: OK 
  • Http-kode 500 og Database: Unavailable

De to alarm-endpoints er som udgangspunkt tomme og returnerer 200, men kan give en alarm-besked og status 500, hvis jobbet er i problemer.

Job til identifikation af borgere, der fylder 22 år

Jobbet startes via et HTTP GET kald til <serverurl>/batch-service/scan-citizens-job/start

Jobbet foretager et kald til PersonInformation, som returnerer borgere med den relevante fødselsdato. For hver identificeret borger oprettes en record bor borgeen i databasen med status NO_DENTIST (hvis ikke der allerede findes data for borgeren) samt dpStatus READY,som signalerer klar til afsendelse af digital post.

Job til afsendelse af digital post

Jobbet startes via et HTTP GET kald til <serverurl>/batch-service/digital-post-job/start

Jobbet fremsøger records fra i databasen med dpStatus  = READY. Der afsendes forskellige digital post breve afhængigt af status:

Digital Post sendes i praksis via NSP-komponenten Digital Post Adapter

Job til påmindelse af borger

Jobbet startes via et HTTP GET kald til <serverurl>/batch-service/remind-citizens-job/start

Jobbet fremsøger records fra i databasen, hvor følgende gælder

• Status = NO_DENTIST (der er ikke valgt tandlæge)
• dpStatus  = SENT (der er sendt digital post)
• Der er sendt digital post eller reminder for et stykke tid siden (konfigurerbart)
• Maksimalt antal reminders endnu ikke er sendt.
• Reminders er ikke fravalgt

For disse sendes ny Digital Post i form af et påmindelsesbrev. Digital Post sendes i praksis via NSP-komponenten Digital Post Adapter.

Job til afsendelse af EDI-beskeder

Jobbet startes via et HTTP GET kald til <serverurl>/batch-service/edi-job/start

Jobbet fremsøger records fra i databasen, hvor følgende gælder

• Status = DENTIST_CHOSEN (der er valgt tandlæge)
• Der er ikke en nyere record for samme borger
• ddtvMayContactDentist er true (det er ikke fravalgt at kontakte tandlægen)

For disse sendes en EDI-besked om, at en borger har valgt en specifik tandlæge. I kaldet indgår en RequestID, som genereres i forbindelse med at EDI-beskeden sendes, og lagres i databasen. Når der senere bekræftes eller afvises via DGWS-servicen til tandlæger, vi denne RequestID blive anvendt til at slå op hvem borgeren var.

EDI-beskeder sendes i praksis via EDI-portalen med en snitflade til formålet udviklet af Nasure.

Job til afsendelse af "se bort fra tidligere EDI"-beskeder

Jobbet startes via et HTTP GET kald til <serverurl>/batch-service/ignore-previous-edi-job/start

Jobbet fremsøger records fra EDIStatus-tabellen databasen. For hver afgøres om en af følgende gælder. 

• Der er ikke nogle data for borgeren (opt out)
• Det er længere samme tandlæge, der er valgt (borgeren har valgt om i mellemtiden)

For disse sendes en EDI-besked om, at en borger har valgt om, og at der skal ses bort fra tidligere EDI. I kaldet indgår den RequestID, som blev sendt i forbindelse med den oprindelige EDI-besked.

EDI-beskeder sendes i praksis via EDI-portalen med en snitflade til formålet udviklet af Nasure.

Job til sletning af data for afdøde borgere, samt borgere, der aldrig svarede

Oprydningsjobbet startes via et HTTP GET kald til <serverurl>/batch-service/cleanup-job/start

Jobbet kaldes for at påbegynde en oprydning af følgende:

• Data for afdøde borgere. Alle registrerede data slettes 1 år efter borgeren personerne er afgået ved døden (konfigurerbart)
• Data for borgere, der har fået tilsendt Digital Post, men stadig ikke har reageret efter 2 år (konfigurerbart)