Versions Compared

Key

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

...

Behandlingstestamenteregistret (BTR) er én applikation men udadtil to services, der håndterer data for henholdsvis  behandlingstestamenteregistreringer og livstestamenteregistreringer. Begge services har operationer til opdatering (registrering og/eller ændring) og udstilling af borgerens oplysninger i disse registre. Servicerne beskrives i det følgende, som forudsætter kendskab til HL7 CDA og webservices.

Ændringslog

...

Version

...

Dato

...

Ændring

...

Ansvarlig

...

1.0.1

...

2018-08-09

...

Initialt dokument

...

Trifork

...

Tilføjet data-elementet noForcedTreatmentIfIncapable

Fjernet elementet relativeAcceptanceRequired og indført acceptanceNeeded for alle 4 Behandlingstestamente-spørgsmål

Opdateret request/response XML-eksempler

...

TreatmentWillWithOnlyForcedTreatment endpoint tilføjet. 
Indeholder kun noForcedTreatmentIfIncapable

...

 

Opretter et behandlingstestamente og sletter livstestamente for en bestemt cpr.


...

HL7 CDA

Modellen der anvendes til at repræsentere livs- og behandlingstestamentedata er HL7 CDA (se evt. http://www.hl7.org/implement/standards/product_brief.cfm?product_id=7 ), som er en XML-baseret standard til repræsentation af kliniske data. HL7 CDA er et begrebsapparat, som kan repræsentere en enorm mængde af forskelligartede data, hvoraf kun en lille delmængde anvendes i servicen. Det anbefales derfor at studere eksemplerne der refereres her på siden frem for modellen der defineres af HL7 CDA, da de giver et mere præcist billede af hvilke data der kræves og returneres af de forskellige operationer. CDA-terminologien gør, at man kan kvalificere de forskellige begreber gennem attributter (f.eks. at et id er et CPR nummer ved at angive assigningAuthorityName="CPR"), og derfor valideres der i servicen, at disse attributter anvendes korrekt, så der ikke er tvivl om hvordan data skal fortolkes. Dvs. i praksis sker der en strengere validering end WSDL og XSDer dikterer.

...

Notificeringer i NAS

I forbindelse med skriveoperationer i BTR (oprettelse, opdateringer og sletninger) sker der en notificering via NAS få sekunder efter ændringen er gemt. Se evt. NAS2 - Anvenderguide.

De enkelte notificeringer indholder ikke detaljer vedr. oprettelse, redigering eller sletning af borgerens  behandlingstestamentdata of livstestamentdata , men udelukkende oplysninger om det cprnummer, for hvilket opdateringen har fundet sted. Det er efterfølgende op til anvenderen at hente det opdaterede stamkort ud via snitfladerne.

Følgende er et eksempel på en opdateringsnotificering til behandlingstestamente:

...

Borgere anvender services gennem en IDWS­-snitflade og har adgang til alle operationer. Der understøttes ikke fuldmagter. Der understøttes ikke fuldmagter.

Hvis en borger forsøger at oprette et behandlingstestamente, og der samtidigt allerede eksisterer et livstestamente for denne borger, fejler kaldet. Anvendere skal derfor først slette livstestamentet for borgeren, og dernæst oprette behandlingstestamentet. Dette kan også gøres ved hjælp af UpgradeToTreatmentWill-serviceoperationen.


Snitfladerne skal kaldes skal kaldes gennem NSP'ens DCC endpoint (afkoblingskomponenten).

...

Element

Beskrivelse

Type

Optionel

noLifeProlongingIfDying

Behandlingstestamente tilkendegivelse

TreatmentWillValueType*1

Nej

noLifeProlongingIfSeverelyDegraded

Behandlingstestamente tilkendegivelse

TreatmentWillValueType

Nej

noLifeProlongingIfSeverePainBehandlingstestamente tilkendegivelseTreatmentWillValueTypeNej
noForcedTreatmentIfIncapableBehandlingstestamente tilkendegivelseTreatmentWillValueTypeNej

TreatmentWillV2

Den generelle struktur der anvendes på create- og update-requests, samt på get-responses, ser ud som følger:

noLifeProlongingIfSeverePain

Element

Beskrivelse

Type

Optionel

noLifeProlongingIfDying

Behandlingstestamente tilkendegivelse

TreatmentWillValueTypeWithoutAcceptanceNeeded

Nej

noLifeProlongingIfSeverelyDegraded

Behandlingstestamente tilkendegivelse

TreatmentWillValueTypeWithAcceptanceNeeded

Nej

noLifeProlongingIfSeverePainBehandlingstestamente tilkendegivelseTreatmentWillValueTypeWithAcceptanceNeededNej
noForcedTreatmentIfIncapableBehandlingstestamente tilkendegivelseTreatmentWillValueTypeWithAcceptanceNeededNej

TreatmentWillWithOnlyForcedTreatment

Den generelle struktur der anvendes på create- og update-requests, samt på get-responses, ser ud som følger:

Element

Beskrivelse

Type

Optionel

noForcedTreatmentIfIncapableBehandlingstestamente tilkendegivelse
TreatmentWillValueType
TreatmentWillValueTypeWithAcceptanceNeededNej
noForcedTreatmentIfIncapableBehandlingstestamente tilkendegivelseTreatmentWillValueTypeNej

TreatmentWillV2

Den generelle struktur der anvendes på create- og update-requests, samt på get-responses, ser ud som følger:

...

Element

...

Beskrivelse

...

Type

...

Optionel

...

noLifeProlongingIfDying

...

Behandlingstestamente tilkendegivelse

...

TreatmentWillValueTypeWithoutAcceptanceNeeded

...

Nej

...

noLifeProlongingIfSeverelyDegraded

...

Behandlingstestamente tilkendegivelse

...

TreatmentWillValueTypeWithAcceptanceNeeded

...

Nej

...

TreatmentWillWithOnlyForcedTreatment

Den generelle struktur der anvendes på create- og update-requests, samt på get-responses, ser ud som følger:

...

Element

...

Beskrivelse

...

Type

...

Optionel

...

TreatmentWillValueType/TreatmentWillValueTypeWithAcceptanceNeeded

Elementets er en standard boolean, hvis indhold kan være "true" eller "false".

Elementet har en optionel attribut, acceptanceNeeded, som er en enumeration, der kan indeholde én af følgende strenge:

  • relativeAcceptanceRequired
  • guardianAcceptanceRequired
  • trustedAgentAcceptanceRequired

Hvis denne attribut udelades, angiver dette, at der ikke er angivet nogen værdi for denne data. Bemærk, at attributten kun må angives såfremt elementets indhold er "true"; denne validering foregår i servicen og kan ikke ses ud fra XML Schema'et.

*1: det er fra version 1.1.1 ikke længer tilladt at angive acceptanceNeeded for noLifeProlongingIfDying i den oprindelige snitflade (TreatmentWill). Der vil blive returneret med en soap fejl, hvis det sker. 

TreatmentWillValueTypeWithoutAcceptanceNeeded

Elementets er en standard boolean, hvis indhold kan være "true" eller "false".

Tilstande i servicen

Migrering af livstestamente til behandlingstestamente

Det er kun muligt for en borger at have enten ét livstestamente eller ét behandlingstestamente, eller ingen af delene. Det forventes at Livstestamenteregistret lukkes for oprettelser og opdateringer d. 1. januar 2019, og derefter vil kun udstilling og sletning af data være muligt.

...


TreatmentWillValueType/TreatmentWillValueTypeWithAcceptanceNeeded

Elementets er en standard boolean, hvis indhold kan være "true" eller "false".

Elementet har en optionel attribut, acceptanceNeeded, som er en enumeration, der kan indeholde én af følgende strenge:

  • relativeAcceptanceRequired
  • guardianAcceptanceRequired
  • trustedAgentAcceptanceRequired

Hvis denne attribut udelades, angiver dette, at der ikke er angivet nogen værdi for denne data. Bemærk, at attributten kun må angives såfremt elementets indhold er "true"; denne validering foregår i servicen og kan ikke ses ud fra XML Schema'et.

*1: det er fra version 1.1.1 ikke længer tilladt at angive acceptanceNeeded for noLifeProlongingIfDying i den oprindelige snitflade (TreatmentWill). Der vil blive returneret med en soap fejl, hvis det sker. 

TreatmentWillValueTypeWithoutAcceptanceNeeded

Elementets er en standard boolean, hvis indhold kan være "true" eller "false".

Ændringslog

Version

Dato

Ændring

Ansvarlig

1.0.1

2018-08-09

Initialt dokument

Trifork

-2018-08-10Tilføjelser til snitfladebeskrivelseTrifork
1.0.22018-08-31Ny releaseTrifork
1.0.32018-09-06Endpoints ændret fra /ltr-btr til /btrTrifork
1.0.62018-10-15

Tilføjet data-elementet noForcedTreatmentIfIncapable

Fjernet elementet relativeAcceptanceRequired og indført acceptanceNeeded for alle 4 Behandlingstestamente-spørgsmål

Opdateret request/response XML-eksempler

Trifork
1.1.02020-03-24TreatmentWillV2 med noLifeProlongingIfDying uden angivelse af yderligere acceptKvalitetsIT
1.1.12020-03-30TreatmentWill validerer ingen yderligere accept angives på noLifeProlongingIfDyingKvalitetsIT
1.1.22022-10-10
TreatmentWillWithOnlyForcedTreatment endpoint tilføjet. 
Indeholder kun noForcedTreatmentIfIncapable
KvalitetsIT
1.1.32022-11-03

UpgradeToTreatmentWill endpoint tilføjet. 

Opretter et behandlingstestamente og sletter livstestamente for en bestemt cpr.

KvalitetsIT