Onco:V1.0Implementatiegids-MDO-verslagen - Bewerkingsoverzicht

Marc: /* identifier en document versionering */

2017-04-18T09:41:46Z

identifier en document versionering

← Oudere versie		Versie van 18 apr 2017 09:41
Regel 162:		Regel 162:
	Deze identificatie wijzigt niet als er een nieuwe versie van het verslag komt, bijvoorbeeld omdat gegevens zijn aangevuld of gecorrigeerd. Dat betreft een ''nieuwe versie'' van ''hetzelfde verslag''. Een andere identifier duidt er dus op dat het een ander MDO overleg betreft.		Deze identificatie wijzigt niet als er een nieuwe versie van het verslag komt, bijvoorbeeld omdat gegevens zijn aangevuld of gecorrigeerd. Dat betreft een ''nieuwe versie'' van ''hetzelfde verslag''. Een andere identifier duidt er dus op dat het een ander MDO overleg betreft.

	~~Wanneer er~~ een ~~nieuwe versie van hetzelfde verslag komt~~, ~~blijft~~ de ~~identifier hetzelfde~~, maar het id ~~wijzigt: iedere aangemaakte (en verstuurde~~) ~~QuestionnaireResponse krijgt~~ een ~~eigen, uniek id, ongeacht of er al een ander verslag van hetzelfde MDO overleg is verzonden~~. ~~Meta~~.~~lastUpdated~~ is een ~~gegevens waarmee~~ de ~~volgordelijkheid van versies van MDO verslagen aangegeven kan worden~~. ~~Deze~~ '~~''moet''' altijd hoger~~ zijn ~~voor latere versies. Dat betekent~~ niet ~~per se dat deze in oplopende waarden binnenkomen~~. ~~Bij berichtenverkeer~~ over Internet ~~valt niet te garanderen dat de volgorde van binnenkomende HTTP calls dezelfde is bij zender en ontvanger~~. ~~De ontvanger~~ moet ~~dus altijd kijken naar~~ de ~~waarden die in meta.lastUpdated staan~~, ~~niet naar~~ de ~~volgorde~~ van ~~binnenkomst om te bepalen wat~~ de ~~laatste versie van~~ een MDO verslag is. ~~Een inzender mag~~ een verslag ~~meerdere malen insturen~~, ~~bijvoorbeeld wanneer de HTTP connectie verbroken werd~~ en de ~~inzender~~ dus niet ~~weet of het verslag~~ is ~~aangekomen~~. ~~In dat geval wordt hetzelfde id~~, ~~dezelfde meta~~.~~lastUpdated en dezelde identifier.value gebruikt: het betreft immers~~ ''~~dezelfde~~ versie van ~~hetzelfde~~ verslag''.		Zoals boven aangeven, heeft iedere FHIR resource ook een id. Dat id moet uniek zijn voor alle MDO-verslagen. Dat gebeurt door een unieke prefix per ziekenhuis (af te spreken met IKNL) te nemen met een unieke identificatie erachter, dus b.v. 'umcu-123' of 'amphia-fh12'. Wat achter de prefix staat, mag het MDO-verslagnummer zijn, maar het is in principe vrij. (Let op: [http://hl7.org/fhir/stu3/datatypes.html#id FHIR id's] staan maar een beperkte set tekens toe.)

			Voor de communicatie wordt een [http://hl7.org/fhir/stu3/http.html#update FHIR update] gebruikt. Dat is een HTTP PUT, met als content de QuestionnaireResponse, waarbij de id wordt aangemaakt door de inzender. (Id's aangemaakt door de inzender zijn eenvoudiger wanneer het EPD wil communiceren via een message queue op een communicatieserver: dan heeft het EPD het id al direct beschikbaar, en hoeft dit niet teruggecommuniceerd te worden.) Communicatie over Internet kan mislukken. Daarom moet de inzender als de connectie verbroken wordt, de FHIR update blijven herhalen tot er een succes status is ontvangen (HTTP status 200 of 201). Een PUT is idempotent: dat wil zeggen dat deze bij herhaald uitvoeren dezelfde toestand van de server oplevert. Concreet: ook al wordt (door verbroken connecties) een MDO verslag tweemaal ingezonden, dan nog zal er maar één aangemaakt worden op de server. Als er later (door wijzigingen in het MDO verslag zelf) een gecorrigeerde versie van het verslag wordt opgestuurd, houdt deze hetzelfde id en identifier. Dat betekent wel dat het ziekenhuis moet borgen dat de laatste versie ook als laatste wordt ingezonden. Wat dus niet mag is deze volgorde:
			1. versie 1 van verslag X ingezonden met PUT, connectie verbroken
			1. versie 2 van verslag X met wijzigignen ingezonden met PUT, respons '201 Created'
			1. tweede poging versie 1 van verslag X in te zenden met PUT, respons '200 OK'
			In dit geval moet de tweede poging van versie 1 gedaan worden vóór inzenden van versie 2, of helemaal achterwege blijven.

	Een voorbeeld van de betekenis van een aantal verschillende waarden ten opzichte van de eerste rij:		Een voorbeeld van de betekenis van een aantal verschillende waarden ten opzichte van de eerste rij:
Regel 170:		Regel 176:
	\|-		\|-
	\| tstzh-99 \|\| http://www.testziekenhuis.nl/mdoverslag-identificaties \|\| 123 \|\| Vergelijk de volgende rijen met deze waarden		\| tstzh-99 \|\| http://www.testziekenhuis.nl/mdoverslag-identificaties \|\| 123 \|\| Vergelijk de volgende rijen met deze waarden
	\|-
	~~\| tstzh-1100 \|\| http://www.testziekenhuis.nl/mdoverslag-identificaties \|\| 123 \|\| Een eerdere versie van het verslag~~
	\|-
	~~\| tstzh-55 \|\| http://www.testziekenhuis.nl/mdoverslag-identificaties \|\| 123 \|\| Een latere versie van het verslag~~
	\|-		\|-
	\| tstzh-77 \|\| http://www.testziekenhuis.nl/mdoverslag-identificaties \|\| 234 \|\| Een verslag van een ander MDO overleg uit hetzelfde ziekenhuis		\| tstzh-77 \|\| http://www.testziekenhuis.nl/mdoverslag-identificaties \|\| 234 \|\| Een verslag van een ander MDO overleg uit hetzelfde ziekenhuis

Marc: /* QuestionnaireResponse */

2017-04-08T08:03:41Z

QuestionnaireResponse

← Oudere versie		Versie van 8 apr 2017 08:03
Regel 24:		Regel 24:
	<QuestionnaireResponse xmlns="http://hl7.org/fhir">		<QuestionnaireResponse xmlns="http://hl7.org/fhir">
	<id value="testzh-3141"/>		<id value="testzh-3141"/>
	~~<meta>~~
	~~<lastUpdated value="2017-03-06T13:12:11+01:00"/>~~
	~~<profile value="http://www.iknl.fhir/mdo_verslag_diagnose_20161112"/>~~
	~~</meta>~~
	<language value="nl-NL"/>		<language value="nl-NL"/>
	</syntaxhighlight>		</syntaxhighlight>
Regel 33:		Regel 29:
	Het rapport begint met identificaties en versies, en de gebruikte taal:		Het rapport begint met identificaties en versies, en de gebruikte taal:
	* Een uniek id (uniek binnen het verzonden FHIR bericht). Deze begint met een prefix die per ziekenhuis wordt afgesproken met IKNL, zodat de id's uniek zijn binnen de NKR.		* Een uniek id (uniek binnen het verzonden FHIR bericht). Deze begint met een prefix die per ziekenhuis wordt afgesproken met IKNL, zodat de id's uniek zijn binnen de NKR.
	* Versie Oncologie standaard voor deze transactie
	* Taal (altijd Nederlands)		* Taal (altijd Nederlands)
	* voor meta.lastUpdated en id, zie ook [[#identifier_en_document_versionering\|Identifier en document versionering]]

	Berichten worden door een ziekenhuis verzonden naar de NKR met een [[http://hl7.org/fhir/http.html#update \| FHIR update]]. Daarbij maakt de inzender een id aan, wat door de NRK server gebruikt wordt als uniek id voor het bericht. Met een FHIR update wordt een resource (de QuestionnaireResponse) aangemaakt als er nog geen resource met id='testzh-3141' bestaat, en wordt de oudere overschreven als deze wel bestaat. Wanneer de connectie verbroken wordt voordat de zender een HTTP response heeft gekregen, kan de resource gewoon opnieuw ingezonden worden. Dit moet herhaald worden totdat de zender een response met '200 OK' of '201 Created' gekregen heeft, wat aangeeft dat de resource is aangemaakt.		Berichten worden door een ziekenhuis verzonden naar de NKR met een [[http://hl7.org/fhir/http.html#update \| FHIR update]]. Daarbij maakt de inzender een id aan, wat door de NRK server gebruikt wordt als uniek id voor het bericht. Met een FHIR update wordt een resource (de QuestionnaireResponse) aangemaakt als er nog geen resource met id='testzh-3141' bestaat, en wordt de oudere overschreven als deze wel bestaat. Wanneer de connectie verbroken wordt voordat de zender een HTTP response heeft gekregen, kan de resource gewoon opnieuw ingezonden worden. Dit moet herhaald worden totdat de zender een response met '200 OK' of '201 Created' gekregen heeft, wat aangeeft dat de resource is aangemaakt. Zie ook [[#identifier_en_document_versionering\|Identifier en document versionering]].

	=== text ===		=== text ===

Marc: /* QuestionnaireResponse */

2017-04-08T08:02:58Z

QuestionnaireResponse

← Oudere versie		Versie van 8 apr 2017 08:02
Regel 23:		Regel 23:
	<syntaxhighlight lang="xml">		<syntaxhighlight lang="xml">
	<QuestionnaireResponse xmlns="http://hl7.org/fhir">		<QuestionnaireResponse xmlns="http://hl7.org/fhir">
	<id value="~~umcu~~-3141"/>		<id value="testzh-3141"/>
	<meta>		<meta>
	<lastUpdated value="2017-03-06T13:12:11+01:00"/>		<lastUpdated value="2017-03-06T13:12:11+01:00"/>
Regel 35:		Regel 35:
	* Versie Oncologie standaard voor deze transactie		* Versie Oncologie standaard voor deze transactie
	* Taal (altijd Nederlands)		* Taal (altijd Nederlands)
	* voor meta.lastUpdated en id, zie ook [[#~~Document_versionering_en_identifier~~\|~~Document~~ versionering ~~en identifier~~]]		* voor meta.lastUpdated en id, zie ook [[#identifier_en_document_versionering\|Identifier en document versionering]]

			Berichten worden door een ziekenhuis verzonden naar de NKR met een [[http://hl7.org/fhir/http.html#update \| FHIR update]]. Daarbij maakt de inzender een id aan, wat door de NRK server gebruikt wordt als uniek id voor het bericht. Met een FHIR update wordt een resource (de QuestionnaireResponse) aangemaakt als er nog geen resource met id='testzh-3141' bestaat, en wordt de oudere overschreven als deze wel bestaat. Wanneer de connectie verbroken wordt voordat de zender een HTTP response heeft gekregen, kan de resource gewoon opnieuw ingezonden worden. Dit moet herhaald worden totdat de zender een response met '200 OK' of '201 Created' gekregen heeft, wat aangeeft dat de resource is aangemaakt.

	=== text ===		=== text ===

Marc: /* identifier en document versionering */

2017-04-08T07:51:22Z

identifier en document versionering

← Oudere versie		Versie van 8 apr 2017 07:51
Regel 173:		Regel 173:
	! id !! identifier.system !! identifier.value !! Betekenis		! id !! identifier.system !! identifier.value !! Betekenis
	\|-		\|-
	\| ~~umcu~~-99 \|\| http://www.testziekenhuis.nl/mdoverslag-identificaties \|\| 123 \|\| Vergelijk de volgende rijen met deze waarden		\| tstzh-99 \|\| http://www.testziekenhuis.nl/mdoverslag-identificaties \|\| 123 \|\| Vergelijk de volgende rijen met deze waarden
	\|-		\|-
	\| ~~umcu~~-1100 \|\| http://www.testziekenhuis.nl/mdoverslag-identificaties \|\| 123 \|\| Een eerdere versie van het verslag		\| tstzh-1100 \|\| http://www.testziekenhuis.nl/mdoverslag-identificaties \|\| 123 \|\| Een eerdere versie van het verslag
	\|-		\|-
	\| ~~umcu~~-55 \|\| http://www.testziekenhuis.nl/mdoverslag-identificaties \|\| 123 \|\| Een latere versie van het verslag		\| tstzh-55 \|\| http://www.testziekenhuis.nl/mdoverslag-identificaties \|\| 123 \|\| Een latere versie van het verslag
	\|-		\|-
	\| ~~umcu~~-77 \|\| http://www.testziekenhuis.nl/mdoverslag-identificaties \|\| 234 \|\| Een verslag van een ander MDO overleg uit hetzelfde ziekenhuis		\| tstzh-77 \|\| http://www.testziekenhuis.nl/mdoverslag-identificaties \|\| 234 \|\| Een verslag van een ander MDO overleg uit hetzelfde ziekenhuis
	\|-		\|-
	\| ~~amphia~~-99 \|\| http://www.eeninstelling.nl/ids \|\| 123 \|\| Een verslag van een MDO overleg uit een ander ziekenhuis		\| tstinst-99 \|\| http://www.eeninstelling.nl/ids \|\| 123 \|\| Een verslag van een MDO overleg uit een ander ziekenhuis
	\|-		\|-
	\| ~~umcu~~-99 \|\| http://www.testziekenhuis.nl/mdoverslag-identificaties \|\| 123 \|\| Dezelfde versie van hetzelfde verslag		\| tstzh-99 \|\| http://www.testziekenhuis.nl/mdoverslag-identificaties \|\| 123 \|\| Dezelfde versie van hetzelfde verslag
	\|-		\|-
	\| ~~umcu~~-99 \|\| http://www.testziekenhuis.nl/mdoverslag-identificaties \|\| 345 \|\| Illegaal: een id mag niet hergebruikt worden voor een ander MDO verslag		\| tstzh-99 \|\| http://www.testziekenhuis.nl/mdoverslag-identificaties \|\| 345 \|\| Illegaal: een id mag niet hergebruikt worden voor een ander MDO verslag
	\|}		\|}

Marc: /* identifier en document versionering */

2017-04-08T07:50:19Z

identifier en document versionering

← Oudere versie		Versie van 8 apr 2017 07:50
Regel 171:		Regel 171:
	{\| class="wikitable"		{\| class="wikitable"
	\|-		\|-
	! id ~~!! meta.lastUpdated~~ !! identifier.system !! identifier.value !! Betekenis		! id !! identifier.system !! identifier.value !! Betekenis
	\|-		\|-
	\| 99 ~~\|\| 2017-03-06T13:12:11+01:00~~ \|\| http://www.testziekenhuis.nl/mdoverslag-identificaties \|\| 123 \|\| Vergelijk de volgende rijen met deze waarden		\| umcu-99 \|\| http://www.testziekenhuis.nl/mdoverslag-identificaties \|\| 123 \|\| Vergelijk de volgende rijen met deze waarden
	\|-		\|-
	\| 1100 ~~\|\| 2017-03-03T10:11:12+01:00~~ \|\| http://www.testziekenhuis.nl/mdoverslag-identificaties \|\| 123 \|\| Een eerdere versie van het verslag		\| umcu-1100 \|\| http://www.testziekenhuis.nl/mdoverslag-identificaties \|\| 123 \|\| Een eerdere versie van het verslag
	\|-		\|-
	\| 55 ~~\|\| 2017-03-06T15:16:17+01:00~~ \|\| http://www.testziekenhuis.nl/mdoverslag-identificaties \|\| 123 \|\| Een latere versie van het verslag		\| umcu-55 \|\| http://www.testziekenhuis.nl/mdoverslag-identificaties \|\| 123 \|\| Een latere versie van het verslag
	\|-		\|-
	\| 77 ~~\|\| 2017-03-06T13:12:11+01:00~~ \|\| http://www.testziekenhuis.nl/mdoverslag-identificaties \|\| 234 \|\| Een verslag van een ander MDO overleg uit hetzelfde ziekenhuis		\| umcu-77 \|\| http://www.testziekenhuis.nl/mdoverslag-identificaties \|\| 234 \|\| Een verslag van een ander MDO overleg uit hetzelfde ziekenhuis
	\|-		\|-
	\| 99 ~~\|\| 2017-03-06T13:12:11+01:00~~ \|\| http://www.eeninstelling.nl/ids \|\| 123 \|\| Een verslag van een MDO overleg uit een ander ziekenhuis		\| amphia-99 \|\| http://www.eeninstelling.nl/ids \|\| 123 \|\| Een verslag van een MDO overleg uit een ander ziekenhuis
	\|-		\|-
	\| 99 ~~\|\| 2017-03-06T13:12:11+01:00~~ \|\| http://www.testziekenhuis.nl/mdoverslag-identificaties \|\| 123 \|\| Dezelfde versie van hetzelfde verslag		\| umcu-99 \|\| http://www.testziekenhuis.nl/mdoverslag-identificaties \|\| 123 \|\| Dezelfde versie van hetzelfde verslag
	\|-		\|-
	\| ~~99 \|\| 2017-03-03T11:12:13+01:00 \|\| http://www.testziekenhuis.nl/mdoverslag-identificaties \|\| 123 \|\| Illegaal: hetzelfde id met een andere Meta.lastUpdated kan niet~~		\| umcu-99 \|\| http://www.testziekenhuis.nl/mdoverslag-identificaties \|\| 345 \|\| Illegaal: een id mag niet hergebruikt worden voor een ander MDO verslag
	\|-
	\| 99 ~~\|\| 2017-03-06T13:12:11+01:00~~ \|\| http://www.testziekenhuis.nl/mdoverslag-identificaties \|\| 345 \|\| Illegaal: een id mag niet hergebruikt worden voor een ander MDO verslag
	\|}		\|}

Marc: /* QuestionnaireResponse */

2017-04-08T07:46:55Z

QuestionnaireResponse

← Oudere versie		Versie van 8 apr 2017 07:46
Regel 23:		Regel 23:
	<syntaxhighlight lang="xml">		<syntaxhighlight lang="xml">
	<QuestionnaireResponse xmlns="http://hl7.org/fhir">		<QuestionnaireResponse xmlns="http://hl7.org/fhir">
	<id value="3141"/>		<id value="umcu-3141"/>
	<meta>		<meta>
	<lastUpdated value="2017-03-06T13:12:11+01:00"/>		<lastUpdated value="2017-03-06T13:12:11+01:00"/>
Regel 32:		Regel 32:

	Het rapport begint met identificaties en versies, en de gebruikte taal:		Het rapport begint met identificaties en versies, en de gebruikte taal:
	* Een uniek id (uniek binnen het verzonden FHIR bericht)		* Een uniek id (uniek binnen het verzonden FHIR bericht). Deze begint met een prefix die per ziekenhuis wordt afgesproken met IKNL, zodat de id's uniek zijn binnen de NKR.
	* Versie Oncologie standaard voor deze transactie		* Versie Oncologie standaard voor deze transactie
	* Taal (altijd Nederlands)		* Taal (altijd Nederlands)

Marc: /* Document versionering en identifier */

2017-03-29T15:20:17Z

Document versionering en identifier

← Oudere versie		Versie van 29 mrt 2017 15:20
Regel 149:		Regel 149:
	</syntaxhighlight>		</syntaxhighlight>

	===~~Document~~ versionering ~~en identifier~~===		===identifier en document versionering===
	Iedere QuestionnaireResponse krijgt een identificatie. Dit is een logische identificatie: dus de identificatie van een MDO-verslag, betreffende een bepaalde patiënt en op een bepaald moment gehouden door een groep zorgverleners.		Iedere QuestionnaireResponse krijgt een identificatie. Dit is een logische identificatie: dus de identificatie van een MDO-verslag, betreffende een bepaalde patiënt en op een bepaald moment gehouden door een groep zorgverleners.

Marc: /* Referenties */

2017-03-29T14:30:46Z

Referenties

← Oudere versie		Versie van 29 mrt 2017 14:30
Regel 392:		Regel 392:
	==Triggers==		==Triggers==
	==Referenties==		==Referenties==
	[http://hl7.org/fhir/datatypes.html FHIR Datatypes]		# [http://hl7.org/fhir/datatypes.html FHIR Datatypes]
	[http://hl7.org/fhir/questionnaire.html FHIR Questionnaire]		# [http://hl7.org/fhir/questionnaire.html FHIR Questionnaire]
	[http://hl7.org/fhir/questionnaireresponse.html FHIR QuestionnaireResponse]		# [http://hl7.org/fhir/questionnaireresponse.html FHIR QuestionnaireResponse]

	==Wijzigingen en beheer==		==Wijzigingen en beheer==

Marc: /* Document identificatie */

2017-03-29T14:29:30Z

Document identificatie

← Oudere versie		Versie van 29 mrt 2017 14:29
Regel 391:		Regel 391:

	==Triggers==		==Triggers==
	==~~Document identificatie~~==		==Referenties==
			[http://hl7.org/fhir/datatypes.html FHIR Datatypes]
			[http://hl7.org/fhir/questionnaire.html FHIR Questionnaire]
			[http://hl7.org/fhir/questionnaireresponse.html FHIR QuestionnaireResponse]

	==Wijzigingen en beheer==		==Wijzigingen en beheer==

Marc: /* Datatypes */

2017-03-29T14:26:48Z

Datatypes

← Oudere versie		Versie van 29 mrt 2017 14:26
Regel 389:		Regel 389:
	\|\|		\|\|
	\|}		\|}
	~~Voor details zie [http://hl7.org/fhir/datatypes.html FHIR Datatypes]~~

	==Triggers==		==Triggers==
	==Document identificatie==		==Document identificatie==
	==Wijzigingen en beheer==		==Wijzigingen en beheer==