Page History
...
Behandlingstestamenteregistret (BTR) er én applikation men udadtil to services, der håndterer data for henholdsvis livstestamenteregistreringer og behandlingstestamenteregistreringer. Begge services har operationer til registrering 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 |
- | 2018-08-10 | Tilføjelser til snitfladebeskrivelse | Trifork |
1.0.2 | 2018-08-31 | Ny release | Trifork |
1.0.3 | 2018-09-06 | Endpoints ændret fra /ltr-btr til /btr | Trifork |
1.0.6 | 2018-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.0 | 2020-03-24 | TreatmentWillV2 med noLifeProlongingIfDying uden angivelse af yderligere accept | KvalitetsIT |
1.1.1 | 2020-03-30 | TreatmentWill validerer ingen yderligere accept angives på noLifeProlongingIfDying | KvalitetsIT |
1.1.2 | 2022-10-10 | TreatmentWillWithOnlyForcedTreatment endpoint tilføjet. | KvalitetsIT |
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. Se evt. NAS 2.0 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:
...
WSDL Behandlingstestamenteregistret
Operation | Beskrivelse | DGWS | IDWS |
---|---|---|---|
CreateTreatmentWill_2018_05_01 | Opret en behandlingstestamenteregistrering for en specifik borger | Nej | Ja |
UpdateTreatmentWill_2018_05_01 | Opdatér en borgers behandlingstestamenteregistrering | Nej | Ja |
DeleteTreatmentWill_2018_05_01 | Slet en borgers behandlingstestamenteregistrering | Nej | Ja |
GetTreatmentWill_2018_05_01 | Hent en behandlingstestamenteregistrering for en specifik borger | Ja | Ja |
HasTreatmentWill_2018_05_01 | Hent om en specifik borger har en behandlingstestamenteregistrering | Ja | Ja |
WSDL Behandlingstestamenteregistret version 2
Operation | Beskrivelse | DGWS | IDWS |
---|---|---|---|
CreateTreatmentWill_2020_03_16 | Opret en behandlingstestamenteregistrering for en specifik borger | Nej | Ja |
UpdateTreatmentWill_2020_03_16 | Opdatér en borgers behandlingstestamenteregistrering | Nej | Ja |
DeleteTreatmentWill_2020_03_16 | Slet en borgers behandlingstestamenteregistrering | Nej | Ja |
GetTreatmentWill_2020_03_16 | Hent en behandlingstestamenteregistrering for en specifik borger | Ja | Ja |
GetTreatmentWillWithOnlyForcedTreatment | Hent en behandlingstestamenteregistrering for en specifik borger. Indeholder kun forced treatment. | Ja | Nej |
HasTreatmentWill_2020_03_16 | Hent om en specifik borger har en behandlingstestamenteregistrering | Ja | Ja |
Serviceoperationer Livstestamenteregistret
...
Element | Beskrivelse | Type |
---|---|---|
realmCode | Krævet pr. standard, fast værdi | |
typeId | Krævet pr. standard, fast værdi | |
templateId | Krævet pr. standard, fast værdi | |
id | Krævet pr. standard, fast værdi | |
code | Krævet pr. standard, fast værdi | |
title | Krævet pr. standard, fast værdi | |
effectiveTime | Krævet pr. standard, fast værdi | |
ConfidentialityCode | Krævet pr. standard, fast værdi | |
languageCode | Krævet pr. standard, fast værdi | |
versionNumber | Versionsnummer for en registrering | |
recordTarget.patient Role.id | Borgerens CPR-nr i "extension"-attribut | |
author.time | Dato/tid. Format: yyyyMMddHHmmssZ, fx. 20171024143445+0200 | |
Borgerens CPR-nr i "extension"-attribut | ||
Nedenstående elementer hører alle under component.structuredBody.component.section.entry.observation | ||
code | Krævet pr. standard, fast værdi | |
value | Data for en behandlingstestamenteregistrering | TreatmentWill. Se tabel under afsnittet Typer. |
...
GetTreatmentWillWithOnlyForcedTreatment
Request-eksempel: HasTreatmentWillRequestGetTreatmentWillRequest.xml
Request-eksempel v2: HasTreatmentWillRequestGetTreatmentWillRequest_v2.xml
Element | Beskrivelse | Type | Optionel |
---|---|---|---|
id | Som attribut "extension" angives personens CPR-nummer (uden bindestreg) | varchar(30) | Nej |
Response-eksempel: HasTreatmentWillResponseGetTreatmentWillResponse.xml
Response-eksempel: HasTreatmentWillResponseGetTreatmentWillResponse_v2.xml
Element | Beskrivelse | Type |
---|---|---|
realmCode | Krævet pr. standard, fast værdi | |
typeId | Krævet pr. standard, fast værdi | |
templateId | Krævet pr. standard, fast værdi | |
id | Krævet pr. standard, fast værdi | |
code | Krævet pr. standard, fast værdi | |
title | Krævet pr. standard, fast værdi | |
effectiveTime | Krævet pr. standard, fast værdi | |
ConfidentialityCode | Krævet pr. standard, fast værdi | |
languageCode | Krævet pr. standard, fast værdi | |
versionNumber | Versionsnummer for en registrering | |
recordTarget.patient Role.id | Borgerens CPR-nr i "extension"-attribut | |
author.time | Dato/tid. Format: yyyyMMddHHmmssZ, fx. 20171024143445+0200 | |
Borgerens CPR-nr i "extension"-attribut | ||
Nedenstående elementer hører alle under component.structuredBody.component.section.entry.observation | ||
code | Krævet pr. standard, fast værdi | |
value | Data for en behandlingstestamenteregistrering. Indeholder kun noForcedTreatmentIfIncapable. | TreatmentWillWithOnlyForcedTreatment. Se tabel under afsnittet Typer. |
HasTreatmentWill
Request-eksempel: HasTreatmentWillRequest.xml
Request-eksempel: HasTreatmentWillRequest_v2.xml
Element | Beskrivelse | Type | Optionel |
---|---|---|---|
id | Som attribut "extension" angives personens CPR-nummer (uden bindestreg) | varchar(30) | Nej |
Response: HasTreatmentWillResponse.xml
Response: HasTreatmentWillResponse_v2.xml
Element | Beskrivelse | Type | ||
---|---|---|---|---|
willExists | Eksisterer | willExists | Eksisterer der en behandlingstestamenteregistrering for den pågældende person der laves en forespørgsel for. | hl7:bl |
...
Element | Beskrivelse | Type | Optionel |
---|---|---|---|
noLifeProlongingIfDying | Behandlingstestamente tilkendegivelse | TreatmentWillValueTypeWithoutAcceptanceNeeded | Nej |
noLifeProlongingIfSeverelyDegraded | Behandlingstestamente tilkendegivelse | TreatmentWillValueTypeWithAcceptanceNeeded | Nej |
noLifeProlongingIfSeverePain | Behandlingstestamente tilkendegivelse | TreatmentWillValueTypeWithAcceptanceNeeded | Nej |
noForcedTreatmentIfIncapable | 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 |
---|---|---|---|
noForcedTreatmentIfIncapable | Behandlingstestamente tilkendegivelse | TreatmentWillValueTypeWithAcceptanceNeeded | Nej |
TreatmentWillValueType/TreatmentWillValueTypeWithAcceptanceNeeded
...