Versions Compared

Old Version 4

changes.mady.by.user Unknown User (jeh)

Saved on

compared with

New Version Current

changes.mady.by.user Thomas Klemmensen

Saved on

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.82019-04-12Tilføjelse af flere PermissionType værdierTrifork

...

Type

OID

Beskrivelse

Eksempel

CPR1.2.208.176.1.2CPR-nummer

<ns2:id assigningAuthorityName="CPR" extension="0501792275" root="1.2.208.176.1.2"/>

DK MedCom (member body)1.2.208.184Id på ClinicalDocument. Ikke aktual aktuel ifm. denne service (extension=NA)

<ns2:id assigningAuthorityName="MedCom" extension="NA" root="1.2.208.184"/>

Fortrolighed2.16.840.1.113883.5.25Altid N (for "Normal") ifm. denne service

<ns2:confidentialityCode code="N" codeSystem="2.16.840.1.113883.5.25"/>

Dokument type-id2.16.840.1.113883.1.3HL7-registreret RMIM (HL7 internal)

<ns2:typeId extension="POCD_HD000040" root="2.16.840.1.113883.1.3"/>

ODR code system1.2.208.184.15.1*Kodesystem

<ns2:code code="OrganDonor" displayName="OrganDonorRegistration" codeSystem="1.2.208.184.15.1"/>

...

På oidref.com kan man i øvrigt se betydningen af enkeltcifre i de fleste OID'er, fx  http://oidref.com/2.16.840.1.113883.1.3


Notificeringer i NAS

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

De enkelte notificeringer indholder ikke detaljer vedr. oprettelse, redigering eller sletning af borgerens organdonordata, 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.

Der anvendes følgende topic (som kan konfigureres): http://sundhedsdatastyrelsen.dk/OrganDonation/2022/05/05:OrganDonationUpdated.

Følgende er et eksempel på en opdateringsnotificering:

Code Block
firstline1
titleEksempel på notifikation ved skrivning fra ODR
linenumberstrue
collapsetrue
<ns3:Notify xmlns:ns3="http://docs.oasis-open.org/wsn/b-2" xmlns:ns2="http://www.w3.org/2005/08/addressing" xmlns:ns6="http://nsi.dk/advis/v10" xmlns:ns7="http://sundhedsdatastyrelsen.dk/organdonor/2022/08/01/">
     <ns3:NotificationMessage>
          <ns3:Topic Dialect="http://docs.oasis-open.org/wsn/t-1/TopicExpression/Simple">http://sundhedsdatastyrelsen.dk/OrganDonation/2022/05/05:OrganDonationUpdated</ns3:Topic>
          <ns3:Message>
               <ns6:NotifyContent id="0501792275" idType="http://nsi.dk/advis/v10/CPR">      
					<ns7:OrgandonorUpdated>
						<ns7:type>http://sundhedsdatastyrelsen.dk/MessageDefinition/Organdonor-notification</ns7:type>
						<ns7:date>2022-10-27</ns7:date>
						<ns7:version>1</ns7:version>
					</ns7:OrgandonorUpdated>
                </ns6:NotifyContent>
          </ns3:Message>
     </ns3:NotificationMessage>
</ns3:Notify>
Code Block
firstline1
titleOrganDonorUpdatedNotification
linenumberstrue
collapsetrue
<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
		   targetNamespace="http://sundhedsdatastyrelsen.dk/organdonor/2022/08/01/"
		   elementFormDefault="qualified">
	<xs:element name="OrgandonorUpdated">
		<xs:complexType>
			<xs:sequence>
				<xs:element name="type" type="xs:string"/>
				<xs:element name="date" type="xs:string"/>
				<xs:element name="version" type="xs:string"/>
			</xs:sequence>
		</xs:complexType>
	</xs:element>
</xs:schema>

Snitflade

Sundhedsfaglige anvender servicen gennem en DGWS­-snitflade, som skal kaldes med et MOCES niveau 4 medarbejdercertifikat. Via DGWS er der udelukkende adgang til at se om et registrering eksisterer, samt se detaljer om registreringen.

...

Server-URL'er for de forskellige test-miljøer kan findes på Endpoints for eksterne testmiljøer.

WSDL-filer
HTML-side med overblik
<server>/odr/wsdl
Organdonorregister DGWS
<server>/odr/wsdl/dgws
Organdonorregister IDWS*
<server>/odr/wsdl/idws
Organdonorregister IDWS*
<server>/odr/wsdl/idws/standard

*  I den nye udgave af WSDL for IDWS (standard) har vi fjernet IDWSFault fra skemaet. Dette er gjort, da hensigten hele tiden har været, at det er SOAP Fault, der skal returneres ved fejl fra IDWS servicen.


Webservice-endpoints

URL

Functionality

<server>/odr/odr
Webservice-endpoint
<server>/odr/odrAdmin

Webservice admin-endpoint (til brug for brugerflade)


WSDL

Operation


Beskrivelse


DGWSIDWS
SundhedspersonaleAdminBorger

CreateOrganDonorRegistration_2018_05_01

Opret en organdonorregistrering for en specifik borger

NejJaJa

UpdateOrganDonorRegistration_2018_05_01

Opdatér en borgers organdonorregistrering

NejJaJa

DeleteOrganDonorRegistration_2018_05_01

Slet en borgers organdonorregistrering

NejJaJa

GetOrganDonorRegistration_2018_05_01

Hent en organdonorregistrering for en specifik borger

JaJaJa

HasOrganDonorRegistration_2018_05_01

Hent om en specifik borger har en organdonorregistrering

JaJaJa

...

Sundhedspersonale vil modtage fejlkode 501 - "Adgang til CPR-nummeret ikke tilladt", hvis der gøres forsøg på at få adgang til en operation, der kræver skriveadgang såsom oprette, slette eller opdatere.


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.

CreateOrganDonorRegistration

Request-eksempel:  CreateOrganDonorRequestCreateOrganDonorRequest.xml

Element

Beskrivelse

Type

Optionel

id

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

varchar(30)

Nej

OrganDonorRegistration

Data for en organdonorregistrering. Type er OrganDonorRegistration. Se tabel under afsnittet Typer.

-

Nej

Response-eksempel (indeholder ingen data):  CreateOrganDonorResponseCreateOrganDonorResponse.xml

UpdateOrganDonorRegistration

Request-eksempel: UpdateOrganDonorRequest UpdateOrganDonorRequest.xml

Element

Beskrivelse

Type

Optionel

id

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

varchar(30)

Nej

OrganDonorRegistration

Data for en organdonorregistrering. Type er OrganDonorRegistration. Se tabel under afsnittet Typer.

-

Nej

Response-eksempel (indeholder ingen data):  UpdateOrganDonorResponseUpdateOrganDonorResponse.xml

DeleteOrganDonorRegistration

Request-eksempel:  DeleteOrganDonorRequestDeleteOrganDonorRequest.xml

Element

Beskrivelse

Type

Optionel

id

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

varchar(30)

Nej

Response-eksempel (indeholder ingen data):  DeleteOrganDonorResponseDeleteOrganDonorResponse.xml

GetOrganDonorRegistration

Request-eksempel:  GetOrganDonorRequestGetOrganDonorRequest.xml

Element

Beskrivelse

Type

Optionel

id

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

varchar(30)

Nej

Response-eksempel:  GetOrganDonorResponseGetOrganDonorResponse.xml

Element

Beskrivelse

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 int

author.time

Dato/tid. Format: yyyyMMddHHmmssZ, fx. 20171024143445+0200

author.assignedAuthor.id

Borgerens CPR-nr i extension"-attribut int

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 organdonorregistrering. Type er OrganDonorRegistration. Se tabel under afsnittet Typer.

HasOrganDonorRegistration

Request-eksempel:  HasOrganDonorRequestHasOrganDonorRequest.xml

Element

Beskrivelse

Type

Optionel

id

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

varchar(30)

Nej

Response:  HasOrganDonorResponseHasOrganDonorResponse.xml

Element

Beskrivelse

registrationExists

Eksisterer der en organdonorregistrering for den pågældende person der laves en forespørgsel for. Indeholder true eller false.

...