Indledning
Denne side skitserer de forventede snitflader (metoder) som udstilles på den kommende NSP ddtv-service. Den endelige snitfladebeskrivelse vil blive offentliggjort sammen med servicen på NSP Test-miljøerne som en del af leverancebeskrivelsen hørende til servicen.
Siden indledes med at definere nogle datatyper, som bruges af flere metoder nedenfor.
Fælles datatyper
PersonID Element
Element | Beskrivelse | Type | Obligatorisk |
|---|---|---|---|
id | Angiver borgerens ID (CPR-nummer uden bindestreg). | string | Ja |
classification | Typen af ID. Gyldige værder er: 'CPR' | string | Ja |
Bemærk, person-id'et er type-klassificeret, så der i fremtiden kan understøttes flere person-id typer, f.eks. eCPR, EU person id, etc.
DentistID Element
Element | Beskrivelse | Type | Obligatorisk |
|---|---|---|---|
id | Angiver tandlægeklinikkens ID i den valgte klassifikation. | string | Ja |
classification | Typen af ID. Gyldige værder er: 'SOR' | string | Ja |
Bemærk, id'et er type-klassificeret, så der i fremtiden kan understøttes flere id typer.
ddtvDentistContact Element
Element | Beskrivelse | Type | Obligatorisk |
|---|---|---|---|
time | Tidspunkt for afsendelse af besked | DateTime | Ja |
type | 0: Anmodning om optagelse 1: Påmindelse 2: Ignorer tidligere henvendelser | int | Ja |
ddtvStatus Element
Element | Beskrivelse | Type | Obligatorisk |
|---|---|---|---|
exists | Borgeren findes i databasen. | bool | Ja |
dentistChosen | Borgeren har valgt tandlæge. Sættes til 'None', hvis borgeren ikke har valgt tandlæge. | DentistID / None | Ja, men kan være None |
dentistMayBeContacted | Den valgte tandlæge må kontaktes af DDTV | bool | Ja (default Ja) |
reminderList | Borgeren er blevet påmindet om at vælge tandlæge | Liste af ddtvReminder elementer | Ja, men skal være None eller tom liste, hvis der endnu ikke er sendt påmindelse. |
dentistContactedList | Tidspunkter og typer af beskeder til den valgte tandlæge | Liste af ddtvDentistContact elementer | Ja, men skal være None eller tom liste, hvis tandlægen ikke er blevet kontaktet. |
noMoreReminders | Borgeren ønsker ikke flere påmindelser, eller maksimalt antal reminders afsendt. | bool | Ja, default: False |
OptOut | Borgeren ønsker ikke at bruge ddtv | bool | Ja, default: False |
Metoder
ddtvCheckStatus(...)
Returnerer statusinformation for en borgers tandlægevalg.
Input:
| Element/Parameter | Type | Beskrivelse | evt. note |
|---|---|---|---|
| personID | PersonID | CPR nummer på den der ønskes status for | I normaltilfældet vil personID være lig ID'et i IDWS Identititokenet, hvor der efterspørges status for personen selv. Hvis den kaldende person gør brug af fuldmagt eller forældremyndighed, vil personID være på hhv. fuldmagtsgiver eller barnet. Elementet er type-klassificeret, så der på sigt kan understøttes andre person-id typer (se datatypebeskrivelsen ovenfor) |
Output:
| Element | Type | Beskrivelse | evt. note |
|---|---|---|---|
| status | ddtvStatus | Status for Borgerens ddtv forløb |