Versions Compared

Key

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

...

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.22021-10-12Opdateret ifm. udfasning af btr-snitflade med accept fra pårørende, værge eller fremtidsfuldmægtig for uafvendeligt døendeKvalitetsIT

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.

...

btrbtr
WSDL-filer
HTML-side med overblik
<server>/btr/wsdl
Livstestamenteregister DGWS
<server>/btr/wsdl/ltr/dgws
Livstestamenteregister IDWS
<server>/btr/wsdl/ltr/idws
Behandlingstestamenteregister DGWS v2<server>/btr/wsdl/btrV2/dgws
Behandlingstestamenteregister IDWS v2<server>/btr/wsdl/btrV2/idws


WSDL Livstestamenteregistret

Behandlingstestamenteregister v2

Operation

Beskrivelse

DGWS<server>/btr/wsdl/btrV2/dgws
Behandlingstestamenteregister IDWS v2<server>/btr/wsdl/btrV2/idws

WSDL Livstestamenteregistret

IDWS

Operation

Beskrivelse

DGWSIDWS

CreateLivingWillRequest_2018_05_01

Opret en livstestamenteregistrering for en specifik borger

NejJa

UpdateLivingWillRequest_2018_05_01

Opdatér en borgers livstestamenteregistrering

NejJa

DeleteLivingWillRequest_2018_05_01

Slet en borgers livstestamenteregistrering

NejJa

GetLivingWillRequest_2018_05_01

Hent en livstestamenteregistrering for en specifik borger

JaJa

HasLivingWillRequest_2018_05_01

Hent om en specifik borger har en livstestamenteregistrering

JaJa

WSDL Behandlingstestamenteregistret version 2

Operation

Beskrivelse

DGWSIDWS

CreateTreatmentWill_20182020_0503_0116

Opret en behandlingstestamenteregistrering for en specifik borger

NejJa

UpdateTreatmentWill_20182020_0503_0116

Opdatér en borgers behandlingstestamenteregistrering

NejJa

DeleteTreatmentWill_20182020_0503_0116

Slet en borgers behandlingstestamenteregistrering

NejJa

GetTreatmentWill_20182020_0503_0116

Hent en behandlingstestamenteregistrering for en specifik borger

JaJa

HasTreatmentWill_20182020_0503_0116

Hent om en specifik borger har en behandlingstestamenteregistrering

JaJa

WSDL Behandlingstestamenteregistret version 2

...

Operation

...

Beskrivelse

...

CreateTreatmentWill_2020_03_16

...

Opret en behandlingstestamenteregistrering for en specifik borger

...

UpdateTreatmentWill_2020_03_16

...

Opdatér en borgers behandlingstestamenteregistrering

...

DeleteTreatmentWill_2020_03_16

...

Slet en borgers behandlingstestamenteregistrering

...

GetTreatmentWill_2020_03_16

...

Hent en behandlingstestamenteregistrering for en specifik borger

...

HasTreatmentWill_2020_03_16

...

Hent om en specifik borger har en behandlingstestamenteregistrering

...

Serviceoperationer Livstestamenteregistret

Nedenfor beskrives de forskellige operationer i servicen. For hver operation gives eksempler på request/response hvis aktuelle (for simpelhedens skyld uden DGWS/IDWS headers). Eksemplerne tjener dels til formål at

Serviceoperationer Livstestamenteregistret

Nedenfor beskrives de forskellige operationer i servicen. For hver operation gives eksempler på request/response hvis aktuelle (for simpelhedens skyld uden DGWS/IDWS headers). Eksemplerne tjener dels til formål at give overblik over hvad der skal til for at bruge en operation, men demonstrerer samtidigt hvilke attributter der er krævet. Dvs. de forskellige requests angiver hvad der som minimum skal angives.

...

Der er request og response eksempler for både oprindelig version og version 2.

CreateTreatmentWill

Request-eksempel CreateTreatmentWillRequest.xml *1Request-eksempel v2: CreateTreatmentWillRequest_v2.xml

Element

Beskrivelse

Type

Optionel

id

Som attribut "extension" angives personens CPR-nummer (uden bindestreg)

varchar(30)

Nej

treatmentWill


Data for en behandlingstestamenteregistrering. Type er TreatmentWill. Se tabel under afsnittet Typer.

-

Nej

Response-eksempel (indeholder ingen data): CreateTreatmentWillResponse.xml Response-eksempel v2 (indeholder ingen data): CreateTreatmentWillResponse_v2.xml

UpdateTreatmentWill

...

Request-eksempel v2: UpdateTreatmentWillRequest_v2.xml

Element

Beskrivelse

Type

Optionel

id

Som attribut "extension" angives personens CPR-nummer (uden bindestreg)

varchar(30)

Nej

treatmentWill

Data for en behandlingstestamenteregistrering. Type er TreatmentWill. Se tabel under afsnittet Typer.

-

Nej

...

Response-eksempel v2 (indeholder ingen data): UpdateTreatmentWillResponse_v2.xml

DeleteTreatmentWill

Request-eksempel DeleteTreatmentWillRequest.xmlRequest-eksempel v2: DeleteTreatmentWillRequest_v2.xml

Element

Beskrivelse

Type

Optionel

id

Som attribut "extension" angives personens CPR-nummer (uden bindestreg)

varchar(30)

Nej

Response-eksempel (indeholder ingen data): DeleteTreatmentWillResponse.xmlResponse-eksempel v2 (indeholder ingen data): DeleteTreatmentWillResponse_v2.xml

GetTreatmentWill

Request-eksempel GetTreatmentWillRequest.xmlRequest-eksempel v2: GetTreatmentWillRequest_v2.xml

Element

Beskrivelse

Type

Optionel

id

Som attribut "extension" angives personens CPR-nummer (uden bindestreg)

varchar(30)

Nej

...

Response-eksempel: GetTreatmentWillResponse_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


author.assignedAuthor.id

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.

HasTreatmentWill

...

Request-eksempel: HasTreatmentWillRequest_v2.xml

Element

Beskrivelse

Type

Optionel

id

Som attribut "extension" angives personens CPR-nummer (uden bindestreg)

varchar(30)

Nej

...

Nej

Response: HasTreatmentWillResponse_v2.xml

...

Element

...

Beskrivelse

...

willExists

...

Eksisterer der en behandlingstestamenteregistrering for den pågældende person der laves en forespørgsel for.

...

Typer

LivingWill

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

Element

Beskrivelse

Type

Optionel

noLifeProlongingIfDying

Livstestamente tilkendegivelse

Boolean

Nej

noLifeProlongingIfSeverelyDegraded

Livstestamente tilkendegivelse

Boolean

Nej

TreatmentWill

willExists

Eksisterer der en behandlingstestamenteregistrering for den pågældende person der laves en forespørgsel for.

hl7:bl

Typer

LivingWill

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

TreatmentWillValueTypenoForcedTreatmentIfIncapableBehandlingstestamente TreatmentWillValueType

Element

Beskrivelse

Type

Optionel

noLifeProlongingIfDying

Behandlingstestamente tilkendegivelse

TreatmentWillValueType*1

Nej

noLifeProlongingIfSeverelyDegraded

Behandlingstestamente tilkendegivelse

TreatmentWillValueType

Nej

noLifeProlongingIfDying

Livstestamente tilkendegivelse

Boolean

noLifeProlongingIfSeverePainBehandlingstestamente tilkendegivelse

Nej

noLifeProlongingIfSeverelyDegraded

Livstestamente tilkendegivelse

Boolean

Nej

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

noLifeProlongingIfSeverePainBehandlingstestamente tilkendegivelseTreatmentWillValueTypeWithAcceptanceNeededNej
noForcedTreatmentIfIncapableBehandlingstestamente tilkendegivelseTreatmentWillValueTypeWithAcceptanceNeededNej

...

TreatmentWillValueTypeWithAcceptanceNeeded

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

...

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

...