Versie van 6 sep 2019 14:54

{{#customtitle: Transactie Opleveren potentiële contraindicaties (conversie MP-6.12 conditieslijst naar MedMij datamodel)}}

Naar Mapping architectuur

1 Inleiding

Deze pagina beschrijft hoe een MP ICA (Medicatieproces Intoleranties Contraindicaties en Allergieën) versie 6.12 'opleveren potentiële contraindicaties' response te converteren naar de transactie: 'Beschikbaarstellen ICAvertaling' uit de informatiestandaard 'Contraindicaties en overgevoeligheden' (CIO).

Een ICA versie 6.12 'opleveren potentiële contraindicaties' converteert zich in het datamodel van de informatiestandaard 'Contraindicaties en overgevoeligheden' naar de zibs AllergieIntolerantie en Alert (en de daarbij behorende zibs probleem, zorgverlener, zorgaanbieder, contactpersoon en patiënt).

Aangezien deze conversie plaatsvindt tussen verschillende versies van standaarden zijn er een aantal zaken waarmee rekening gehouden moet worden:

niet alle CIO-functionaliteit is beschikbaar in MP ICA 6.12 en andersom:
de informatie uit MP ICA 6.12 past niet altijd naadloos op het CIO-datamodel.

Deze twee aspecten zijn hieronder verder uitgewerkt.

1.1 Missende CIO functionaliteit bij converteren vanaf ICA 6.12

Sommige elementen uit de zib basiselementen (zibroot) kunnen niet worden gevuld vanuit MP ICA 6.12. Dat wordt echter niet gezien als een omissie, omdat die basiscomponenten ontworpen zijn voor alle zibs en voor een specifieke zib niet alle elementen van toepassing zullen zijn.

Onderstaande tabel toont de overige elementen die niet (goed) gevuld kunnen worden vanuit 6.12.

#	Informatie / Functionaliteit	Omschrijving
1	Type overgevoeligheid	In 6.12 zijn er alleen overgevoeligheden voor medicatie, overige overgevoeligheden zijn geen onderdeel van de 6.12 informatiestandaard. De zib kent bijvoorbeeld ook overgevoeligheden voor voeding, omgeving, stof/product of 'anders'.
2	Reactie	In 6.12 bestaat geen informatie over reactie, deze bestaat wel in de zib. De datum/tijd laatste reactie is er ook niet in 6.12.
3	Ernst	In 6.12 bestaat geen informatie over ernst, deze bestaat wel in de zib.

1.2 Informatie in ICA 6.12 die niet past op het CIO datamodel

#	Informatie / Functionaliteit	Omschrijving
1	6.12 Condition/text	6.12 kent een text element dat een voor mensen leesbare presentatie van de conditie is én meer informatie mag bevatten. Het is onduidelijk hoe deze te mappen.
2	informant	ZIB BasisElementen heeft nu exact 1 informant. FHIR kent 0..1 informant. De 6.12 condition kan er - in theorie - 0..* bevatten. Aangemeld bij het bestaande ZIB issue 737. In de CIO-transactie is gekozen voor 0..1 informant.
3	toelichting	in 6.12 is er nog informatie over tijdstip vastleggen van de toelichting en een aparte auteur voor de toelichting. Deze kan alleen in vrije tekst meegezonden worden als onderdeel van de toelichting zelf naar de zib.
4	(on)zekerheid	in 6.12 bestaat de zogenaamde 'uncertaintyCode', die overigens op vaste waarde 'N' (geen uitspraak over onzekerheid) gezet wordt. Deze ontbreekt in de zib en kan daarom niet gemapt worden. Omdat dit een vaste waarde is in 6.12 levert dit geen verlies van informatie op.
5	ontkenning	in 6.12 is het niet de bedoeling om de ontkenning van een conditie (er is géén allergie voor antibiotica) uit te wisselen. Technisch is het echter wel mogelijk (met een @negationInd), ontvangers moeten daarom negatieve conditities negeren. De mapping mapt om deze reden alleen positieve condities. Echter hierover is nog discussie en daarvoor is een issue aangemeld: CIO-2.

2 Conversie specificaties (mappings)

Specificaties voor de ICA 6.12 potentiële contra-indicaties vindt u via de informatiestandaard medicatieveiligheid op de Nictiz website.

Specificaties voor het MedMij 1.1 datamodel vindt u via de MedMij wiki voor AllergieIntolerantie.

2.1 AllergieIntolerantie

MP-6.12 Potentiële contraindicaties			Conversie beschrijving (mapping)	CIO dataset (beschikbaarstellen icavertaling
Type	Concept	Card		Type	Concept	#	Card
	/REPC_IN000024NL/ControlActProcess/subject/Condition[code = ('DINT', 'DALG', 'DNAINT')][not(@negationInd = 'true')]	0..*	Bij allergie/intolerantie kunnen alleen overgevoeligheden die aanwezig zijn worden gemapt. De overige condities (met code 'DX') kunnen niet worden gemapt op AllergieIntolerantie. In 6.12 zijn er alleen overgevoeligheden voor medicatie, overige overgevoeligheden zijn geen onderdeel van de 6.12 informatiestandaard. In 6.12 is het niet toegestaan om condities te ontkennen, als dit tóch gebeurt worden deze condities niet gemapt.		AllergieIntolerantie	1	0 .. *
	-	-	-		ZIBRoot	54	1 .. 1
	id	1..1	-		Identificatienummer	55	1 .. 1
	informant	0..*	ZIB BasisElementen heeft nu exact 1 informant. FHIR kent 0..1 informant. De 6.12 condition kan er echter 0..* bevatten. Aangemeld bij het bestaande [https://bits.nictiz.nl/browse/ZIB-737 ZIB issue 737]		Informatiebron	56	0 .. 1
	patient	0..1	-		PatientAlsBron	57	0 .. 1
	subject/patient	1..1	de referentie naar de patiënt die deze allergie/intolerantie heeft (en dus opgenomen is in Condition/subject)		Patient	58	1 .. 1
	exists(assignedPerson)	0..1	deze groep is van toepassing voor iedere informant/assignedPerson		Zorgverlener	59	0 .. 1
	assignedPerson	0..1	hierin zit de zib zorgverlener		Zorgverlener	60	1 .. 1
	exists(responsibleParty)	0..1	deze groep is van toepassing voor iedere informant/responsibleParty		BetrokkeneAlsBron	61	0 .. 1
	responsibleParty	0..1	hierin zit de zib contactpersoon		Contactpersoon	62	1 .. 1
	author	1..1	-		Auteur	63	0 .. 1
	patient	0..1	-		PatientAlsAuteur	64	0 .. 1
	subject/patient	1..1	de referentie naar de patiënt die deze allergie/intolerantie heeft (en dus opgenomen is in Condition/subject)		Patient	65	0 .. 1
	exists(assignedPerson)	0..1	deze groep is van toepassing voor iedere informant/assignedPerson		ZorgverlenerAlsAuteur	66	0 .. 1
	assignedPerson	0..1	hierin zit de zib zorgverlener		Zorgverlener	67	0 .. 1
	-	-	Deze bestaat niet in 6.12		BetrokkeneAlsAuteur	68	0 .. 1
	-	-	-		Contactpersoon	69	0 .. 1
	subject	1..1	-		Onderwerp	70	1 .. 1
	-	-	-		Patient	71	1 .. 1
	patient	1..1			Patient	72	0 .. 1
	author/time	0..1	-		DatumTijd	75	0 .. 1
	causativeAgent/(administerableMaterialKind OR administerableMedicationKind)	0..1	In 6.12 is dit één van de volgende Stofnaamcode (SNK) OID 2.16.840.1.113883.2.4.4.1.750 Stofnaamcode i.c.m. toedieningsweg (SSK) OID 2.16.840.1.113883.2.4.4.1.725 Ongewenste groep OID 2.16.840.1.113883.2.4.4.1.902.122 Handelsproduct (HPK) 2.16.840.1.113883.2.4.4.7		VeroorzakendeStof	2	1 .. 1
	exists(causativeAgent)	1..1	Alleen gebruiken als er een causativeAgent bestaat. Vaste waarde: Medicijn (Propensity to adverse reactions to drug, 419511003, SNOMED CT)		AllergieCategorie	3	0 .. 1
	statusCode	0..1	-		AllergieStatus	4	0 .. 1
	effectiveTime/low	0..1	-		BeginDatumTijd	5	0 .. 1
	-	-	Ernst van de observatie mag niet gebruikt worden in 6.12		MateVanKritiekZijn	6	0 .. 1
	-	-	-		LaatsteReactieDatumTijd	7	0 .. 1
	subjectOf2/annotation	0..*	6.12 heeft bij de comment ook verplicht een auteur, waarin een tijdstip en zorgverlener/id kan worden vastgelegd.		Toelichting	8	0 .. 1
	-	-	Bestaat niet in 6.12		Reactie	9	0 .. *
	-	-	-		Symptoom	10	1 .. *
	-	-	-		SpecifiekeStof	11	0 .. 1
	-	-	-		ReactieBeschrijving	12	0 .. 1
	-	-	-		Ernst	13	0 .. 1
	-	-	-		WijzeVanBlootstelling	14	0 .. 1
	-	-	-		ReactieTijdstip	15	0 .. 1

2.2 Alert

MP-6.12 Potentiële contraindicaties			Conversie beschrijving (mapping)	CIO dataset (beschikbaarstellen icavertaling
Type	Concept	Card		Type	Concept	#	Card
	/REPC_IN000024NL/ControlActProcess/subject/Condition[code = ('DX')][not(@negationInd = 'true')]	0..1	In 6.12 is het niet toegestaan om condities te ontkennen, als dit tóch gebeurt worden deze condities niet gemapt.		Alert	16	0 .. *
	-	-	6.12 kent geen apart concept voor Alert, maar legt alleen een diagnose vast én maakt deze onderdeel van een ICA-transactie. Diagnose mapt op zib Probleem, die ook onderdeel is van Alert. De gegevens uit basiscomponenten worden gevuld bij de zib Alert en niet bij Probleem omdat aangenomen wordt dat dit qua betekenis het beste aansluit bij wat nu geregistreerd wordt voor ICA 6.12.		ZIBRoot	32	0 .. 1
	id	1..1	-		Identificatienummer	33	1 .. 1
	informant	0..*	ZIB BasisElementen heeft nu exact 1 informant. FHIR kent 0..1 informant. De 6.12 condition kan er echter 0..* bevatten. Aangemeld bij het bestaande [https://bits.nictiz.nl/browse/ZIB-737 ZIB issue 737]		Informatiebron	34	0 .. 1
	subject/patient	1..1	de referentie naar de patiënt die deze allergie/intolerantie heeft (en dus opgenomen is in Condition/subject)		PatientAlsBron	35	0 .. 1
	-	-	-		Patient	36	1 .. 1
	exists(assignedPerson)	0..1	deze groep is van toepassing voor iedere informant/assignedPerson		Zorgverlener	37	0 .. 1
	assignedPerson	0..1	hierin zit de zib zorgverlener		Zorgverlener	38	1 .. 1
	exists(responsibleParty)	0..1	deze groep is van toepassing voor iedere informant/responsibleParty		BetrokkeneAlsBron	39	0 .. 1
	responsibleParty	0..1	hierin zit de zib contactpersoon		Contactpersoon	40	1 .. 1
	author	1..1	-		Auteur	41	0 .. 1
	patient	0..1	-		PatientAlsAuteur	42	0 .. 1
	subject/patient	1..1	de referentie naar de patiënt die deze allergie/intolerantie heeft (en dus opgenomen is in Condition/subject)		Patient	43	0 .. 1
	exists(assignedPerson)	0..1	deze groep is van toepassing voor iedere informant/assignedPerson		ZorgverlenerAlsAuteur	44	0 .. 1
	assignedPerson	0..1	hierin zit de zib zorgverlener		Zorgverlener	45	0 .. 1
	-	-	Deze bestaat niet in 6.12		BetrokkeneAlsAuteur	46	0 .. 1
	-	-	-		Contactpersoon	47	0 .. 1
	subject	1..1	-		Onderwerp	48	1 .. 1
	patient	1..1			Patient	49	0 .. 1
	-	-	-		Patient	50	0 .. 1
	author/time	0..1	-		DatumTijd	53	0 .. 1
	/REPC_IN000024NL/ControlActProcess/subject/Condition[code = ('DX')][not(@negationInd = 'true')]	0..*	In 6.12 is het niet toegestaan om condities te ontkennen, als dit tóch gebeurt worden deze condities niet gemapt.		Conditie	17	0 .. *
	""	0..1	-		Probleem	18	1 .. 1
	-	-	-		AlertNaam	19	0 .. *
	-	-	-		BeginDatumTijd	20	0 .. 1
	vaste waarde	0..1	mappen als 'conditie'. 6.12 kent het type 'alert' niet.		AlertType	21	0 .. 1

2.3 Probleem

MP-6.12 Potentiële contraindicaties			Conversie beschrijving (mapping)	CIO dataset (beschikbaarstellen icavertaling
Type	Concept	Card		Type	Concept	#	Card
	/REPC_IN000024NL/ControlActProcess/subject/Condition[code = ('DX')][not(@negationInd = 'true')]	0..*	In 6.12 is het niet toegestaan om condities te ontkennen, als dit tóch gebeurt worden deze condities niet gemapt.		Probleem	22	0 .. 1
	TODO	0..1	-		ZIBRoot	76	0 .. 1
	TODO	0..1	-		Identificatienummer	77	1 .. 1
	TODO	0..1	-		Informatiebron	78	0 .. 1
	TODO	0..1	-		PatientAlsBron	79	0 .. 1
	TODO	0..1	-		Patient	80	1 .. 1
	TODO	0..1	-		Zorgverlener	81	0 .. 1
	TODO	0..1	-		Zorgverlener	82	1 .. 1
	TODO	0..1	-		BetrokkeneAlsBron	83	0 .. 1
	TODO	0..1	-		Contactpersoon	84	1 .. 1
	TODO	0..1	-		Auteur	85	0 .. 1
	TODO	0..1	-		PatientAlsAuteur	86	0 .. 1
	TODO	0..1	-		Patient	87	1 .. 1
	TODO	0..1	-		ZorgverlenerAlsAuteur	88	0 .. 1
	TODO	0..1	-		Zorgverlener	89	1 .. 1
	TODO	0..1	-		BetrokkeneAlsAuteur	90	0 .. 1
	TODO	0..1	-		Contactpersoon	91	1 .. 1
	TODO	0..1	-		Onderwerp	92	1 .. 1
	TODO	0..1	-		Patient	93	1 .. 1
	TODO	0..1	-		Patient	94	0 .. 1
	TODO	0..1	-		DatumTijd	97	0 .. 1
	-	-	-		ProbleemAnatomischeLocatie	23	0 .. 1
	-	-	-		ProbleemLateraliteit	24	0 .. 1
	vaste waarde: Diagnose (SNOMED CT 282291009)	1..1	Condition/code heeft vaste waarde 'DX', hetgeen mapt op Diagnose		ProbleemType	25	0 .. 1
	value	1..1	-		ProbleemNaam	26	1 .. 1
	effectiveTime/low	0..1	-		ProbleemBeginDatum	27	0 .. 1
	effectiveTime/high	0..1	-		ProbleemEindDatum	28	0 .. 1
	statusCode	0..1	active -> actueel completed, obsolete, nullified -> niet actueel		ProbleemStatus	29	0 .. 1
	-	-	-		VerificatieStatus	30	0 .. 1
	subjectOf2/annotation	0..*	6.12 heeft bij de comment ook verplicht een auteur, waarin een tijdstip en zorgverlener/id kan worden vastgelegd.		Toelichting	31	0 .. 1

@@ Regel 7: / Regel 7: @@
 = Inleiding =
-Deze pagina beschrijft hoe een ICA versie 6.12 'opleveren potentiële contraindicaties' response te converteren naar MedMij versie 1.1 voor de transactie: 'Beschikbaarstellen AllergieIntolerantie gegevens'.
+Deze pagina beschrijft hoe een MP ICA (Medicatieproces Intoleranties Contraindicaties en Allergieën) versie 6.12 'opleveren potentiële contraindicaties' response te converteren naar de transactie: 'Beschikbaarstellen ICAvertaling' uit de informatiestandaard 'Contraindicaties en overgevoeligheden' (CIO).
-Een ICA versie 6.12 'opleveren potentiële contraindicaties' converteert zich in het MedMij datamodel naar de zib AllergieIntolerantie (en zorgverlener, zorgaanbieder en patiënt).
+Een ICA versie 6.12 'opleveren potentiële contraindicaties' converteert zich in het datamodel van de informatiestandaard 'Contraindicaties en overgevoeligheden' naar de zibs AllergieIntolerantie en Alert (en de daarbij behorende zibs probleem, zorgverlener, zorgaanbieder, contactpersoon en patiënt).
-Aangezien deze conversie plaatsvindt tussen verschillende versies van de standaard zijn er een aantal zaken waarmee rekening gehouden moet worden:
+Aangezien deze conversie plaatsvindt tussen verschillende versies van standaarden zijn er een aantal zaken waarmee rekening gehouden moet worden:
-* niet alle MedMij-functionaliteit is beschikbaar in ICA 6.12
+* niet alle CIO-functionaliteit is beschikbaar in MP ICA 6.12 en andersom:
-* de informatie uit ICA 6.12 past niet altijd naadloos op het MedMij-datamodel.
+* de informatie uit MP ICA 6.12 past niet altijd naadloos op het CIO-datamodel.
 Deze twee aspecten zijn hieronder verder uitgewerkt.
-==Missende MedMij functionaliteit bij converteren vanaf ICA 6.12 ==
+==Missende CIO functionaliteit bij converteren vanaf ICA 6.12 ==
-Sommige elementen uit de zib basiselementen kunnen niet worden gevuld vanuit 6.12. Dat wordt echter niet gezien als een omissie, omdat die basiscomponenten ontworpen zijn voor alle zibs en voor een specifieke zib niet alle elementen van toepassing zullen zijn.
+Sommige elementen uit de zib basiselementen (zibroot) kunnen niet worden gevuld vanuit MP ICA 6.12. Dat wordt echter niet gezien als een omissie, omdat die basiscomponenten ontworpen zijn voor alle zibs en voor een specifieke zib niet alle elementen van toepassing zullen zijn.
 Onderstaande tabel toont de overige elementen die niet (goed) gevuld kunnen worden vanuit 6.12.
@@ Regel 26: / Regel 26: @@
 | 1|| Type overgevoeligheid ||  In 6.12 zijn er alleen overgevoeligheden voor medicatie, overige overgevoeligheden zijn geen onderdeel van de 6.12 informatiestandaard. De zib kent bijvoorbeeld ook overgevoeligheden voor voeding, omgeving, stof/product of 'anders'.
 |-
-| 2|| Reactie ||  In 6.12 bestaat geen informatie over reactie, deze bestaan wel in de zib. De datum/tijd laatste reactie is er ook niet in 6.12.
+| 2|| Reactie ||  In 6.12 bestaat geen informatie over reactie, deze bestaat wel in de zib. De datum/tijd laatste reactie is er ook niet in 6.12.
 |-
-| 3|| Ernst ||  In 6.12 bestaat geen informatie over ernst, deze bestaan wel in de zib.
+| 3|| Ernst ||  In 6.12 bestaat geen informatie over ernst, deze bestaat wel in de zib.
 |}
-==Informatie in ICA 6.12 die niet past op het MedMij datamodel==
+==Informatie in ICA 6.12 die niet past op het CIO datamodel==
 {| class="wikitable sortable"
 | style="background-color: #1F497D;; color: white; font-weight: bold; text-align:center;"  | # || style="background-color: #1F497D;; width:400px; color: white; font-weight: bold; text-align:center;" | Informatie / Functionaliteit|| style="background-color: #1F497D;; color: white; font-weight: bold; text-align:center;" | Omschrijving
 |-
-|1||6.12 Condition || Bij deze transactie kunnen alleen overgevoeligheden worden gemapt. De overige condities (met code 'DX', denk bijvoorbeeld aan een aandoening of zwangerschap) kunnen niet worden gemapt op AllergieIntolerantie.
+|1||6.12 Condition/text || 6.12 kent een text element dat een voor mensen leesbare presentatie van de conditie is én meer informatie mag bevatten. Het is onduidelijk hoe deze te mappen.
 |-
-|2||informant || ZIB BasisElementen heeft nu exact 1 informant. FHIR kent 0..1 informant. De 6.12 condition kan er echter 0..* bevatten. Aangemeld bij het bestaande [https://bits.nictiz.nl/browse/ZIB-737 ZIB issue 737]
+|2||informant || ZIB BasisElementen heeft nu exact 1 informant. FHIR kent 0..1 informant. De 6.12 condition kan er - in theorie - 0..* bevatten. Aangemeld bij het bestaande [https://bits.nictiz.nl/browse/ZIB-737 ZIB issue 737]. In de CIO-transactie is gekozen voor 0..1 informant.
 |-
 |3||toelichting || in 6.12 is er nog informatie over tijdstip vastleggen van de toelichting en een aparte auteur voor de toelichting. Deze kan alleen in vrije tekst meegezonden worden als onderdeel van de toelichting zelf naar de zib.
 |-
-|4||(on)zekerheid || in 6.12 bestaat de zogenaamde 'uncertaintyCode', die overigens op vaste waarde 'N' (geen uitspraak over onzekerheid) gezet wordt. Deze ontbreekt in de zib en kan daarom niet gemapt worden. Omdat dit een vaste waarde is in 6.12 levert dit eigenlijk geen verlies van informatie op.
+|4||(on)zekerheid || in 6.12 bestaat de zogenaamde 'uncertaintyCode', die overigens op vaste waarde 'N' (geen uitspraak over onzekerheid) gezet wordt. Deze ontbreekt in de zib en kan daarom niet gemapt worden. Omdat dit een vaste waarde is in 6.12 levert dit geen verlies van informatie op.
 |-
-|5||ontkenning || in 6.12 is het niet de bedoeling om de ontkenning van een conditie (er is géén allergie voor antibiotica) uit te wisselen. Technisch is het echter wel mogelijk (met een @negationInd), ontvangers moeten daarom negatieve conditities negeren. De mapping mapt om deze reden alleen positieve condities.
+|5||ontkenning || in 6.12 is het niet de bedoeling om de ontkenning van een conditie (er is géén allergie voor antibiotica) uit te wisselen. Technisch is het echter wel mogelijk (met een @negationInd), ontvangers moeten daarom negatieve conditities negeren. De mapping mapt om deze reden alleen positieve condities. Echter hierover is nog discussie en daarvoor is een issue aangemeld: [https://bits.nictiz.nl/browse/CIO-2 CIO-2].
 |}

Mappings/MP612ICA 2 CioIcaVertaling: verschil tussen versies