Mappings/FHIR 2 MP9MedicationInformation: verschil tussen versies

Uit informatiestandaarden
Naar navigatie springen Naar zoeken springen
k (Spellingverbeteringen)
Regel 5: Regel 5:
 
{{TOClimit|4}}
 
{{TOClimit|4}}
 
= Inleiding =
 
= Inleiding =
Deze pagina beschrijft hoe van de [https://decor.nictiz.nl/medicatieproces/mp-html-20180426T140905/tr-2.16.840.1.113883.2.4.3.11.60.20.77.4.102-2016-03-23T163243.html Medicatieproces (MP) versie 9.0.7 transactie 'beschikbaarstellen medicatiegegevens’] in FHIR STU3 te converteren naar het MP-9.0.7 datamodel. Het MP-9 datamodel is gebaseerd op onder andere de volgende zorginformatiebouwstenen (zibs): Patiënt, Oragnization, Medicatieafspraak, VerstrekkingsVerzoek, Toedieningsafspraak, Medicatieverstrekking, Medicatiegebruik en MedicatieToediening. Het MP-9.0.7 datamodel voegt context toe aan zibs, zoals bijvoorbeeld de medicamenteuze behandeling.
+
Deze pagina beschrijft hoe van de [https://decor.nictiz.nl/medicatieproces/mp-html-20180426T140905/tr-2.16.840.1.113883.2.4.3.11.60.20.77.4.102-2016-03-23T163243.html Medicatieproces (MP) versie 9.0.7 transactie 'beschikbaarstellen medicatiegegevens’] in FHIR STU3 te converteren naar het MP-9.0.7 datamodel. Het MP-9 datamodel is gebaseerd op onder andere de volgende zorginformatiebouwstenen (zibs): Patiënt, Organization, Medicatieafspraak, VerstrekkingsVerzoek, Toedieningsafspraak, Medicatieverstrekking, Medicatiegebruik en MedicatieToediening. Het MP-9.0.7 datamodel voegt context toe aan zibs, zoals bijvoorbeeld de medicamenteuze behandeling.
  
De mapping is volgens de FHIR STU3 profielen op basis van de zibs 2017 release. De exacte versie van de profielen zijn te vinden in het FHIR package: [https://simplifier.net/packages/nictiz.fhir.nl.stu3.zib2017/1.3.10 nictiz.fhir.nl.stu3.zib2017 1.3.10]  
+
De mapping is volgens de FHIR STU3-profielen op basis van de zibs 2017 release. De exacte versie van de profielen zijn te vinden in het FHIR-package: [https://simplifier.net/packages/nictiz.fhir.nl.stu3.zib2017/1.3.10 nictiz.fhir.nl.stu3.zib2017 1.3.10]  
  
De conversiescripts zijn werkend getest met Saxon Versie HE 9.8.0.12. Saxon EE met lax validation. De convervie naar het MP-9 datamodel in ADA gebeurt zonder conceptIds en enkel met Nederlandse conceptnamen. Het toevoegen van conceptIds kan met een ada_2_ada conversersie indien nodig.
+
De conversiescripts zijn werkend getest met Saxon Versie HE 9.8.0.12. Saxon EE met lax validation. De conversie naar het MP-9 datamodel in ADA gebeurt zonder conceptIds en enkel met Nederlandse conceptnamen. Het toevoegen van conceptIds kan met een ada_2_ada conversersie indien nodig.
  
 
== Voorwaarde voor gebruik ==
 
== Voorwaarde voor gebruik ==
Het conversiescript werkt op basis van FHIR Bundles met daarin alle benodigde informatie om het MP-9 datamodel te vullen voor één transactie van één patiënt. FHIR bestaat uit zogenaamde resources die naar elkaar verwijzen. Het MP-9 datamodel zet alle benodigde informatie per transactie onder elkaar zonder verwijzingen. Om tot het MP-9 datamodel te komen dienen de FHIR-verwijzingen te kunnen worden geresolved om te worden geconverteerd. Het conversiescript kan de resources alleen resolven wanneer deze in de FHIR Bundle zitten. Externe referenties worden niet geresolved. Momenteel ondersteund het conversiescript [http://hl7.org/fhir/stu3/references.html#literal literal referenties] op basis van urn:oids:, urn:uuids: en absolute urls. Relative urls worden niet ondersteund. Op sommige plekken worden ook [http://hl7.org/fhir/stu3/references.html#logical logical referenties] geprobeert te resolven in de Bundle. Dit zijn de plekken zoals aangegeven in onderstaande mapping issues tabel.
+
Het conversiescript werkt op basis van FHIR Bundles met daarin alle benodigde informatie om het MP-9 datamodel te vullen voor één transactie van één patiënt. FHIR bestaat uit zogenaamde resources die naar elkaar verwijzen. Het MP-9 datamodel zet alle benodigde informatie per transactie onder elkaar zonder verwijzingen. Om tot het MP-9 datamodel te komen dienen de FHIR-verwijzingen te kunnen worden geresolved om te worden geconverteerd. Het conversiescript kan de resources alleen resolven wanneer deze in de FHIR Bundle zitten. Externe referenties worden niet geresolved. Momenteel ondersteunt het conversiescript [http://hl7.org/fhir/stu3/references.html#literal literal referenties] op basis van urn:oids:, urn:uuids: en absolute urls. Relative urls worden niet ondersteund. Op sommige plekken worden ook [http://hl7.org/fhir/stu3/references.html#logical logical referenties] geprobeerd te resolven in de Bundle. Dit zijn de plekken zoals aangegeven in onderstaande tabel met mapping-issues.
  
 
= Mapping issues =
 
= Mapping issues =
Regel 20: Regel 20:
 
| 1|| MedicationStatement.derivedFrom ||  
 
| 1|| MedicationStatement.derivedFrom ||  
  
Met de huidige FHIR specificaties (profielen) is het niet mogelijk om zonder de referentie op te lossen te bepalen of het gaat om een gerelateerde_afspraak (MA/TA) of een gerelateerde_verstrekking (MV). Het MP-9 datamodel verwacht een identificatie welke in de derivedFrom.identifier kan staan. De derivedFrom.identifier.type kan gebruikt worden om aan te geven om welk MP9 bouwblok het gaat. Het ''type'' wordt dan gevuld met de .catetory code van de betreffende MP waarna verwezen wordt. Een voorbeeld:
+
Met de huidige FHIR-specificaties (profielen) is het niet mogelijk om zonder de referentie op te lossen te bepalen of het gaat om een gerelateerde_afspraak (MA/TA) of een gerelateerde_verstrekking (MV). Het MP-9 datamodel verwacht een identificatie welke in de derivedFrom.identifier kan staan. De derivedFrom.identifier.type kan gebruikt worden om aan te geven om welk MP9-bouwblok het gaat. Het ''type'' wordt dan gevuld met de .catetory code van de betreffende MP waarna verwezen wordt. Een voorbeeld:
  
<pre>
+
<syntaxhighlight lang="xml">
 
<derivedFrom>
 
<derivedFrom>
      <identifier>
+
    <identifier>
  <type>
+
        <type>
  <coding>
+
            <coding>
<system value="http://snomed.info/sct"/>
+
                <system value="http://snomed.info/sct"/>
<value value="373784005"/>
+
                <value value="373784005"/>
<display value="Prescription"/>
+
<display value="Prescription"/>
  </coding>
+
          </coding>
  </type>
+
        </type>
  <system value="urn:oid:2.16.840.1.113883.2.4.3.11.999.77.16076005.12"/>
+
        <system value="urn:oid:2.16.840.1.113883.2.4.3.11.999.77.16076005.12"/>
  <value value="CT-TEST-MBH_907_QA1_MA"/>
+
        <value value="CT-TEST-MBH_907_QA1_MA"/>
</identifier>                      
+
    </identifier>
 
</derivedFrom>
 
</derivedFrom>
</pre>
+
</syntaxhighlight>
  
Het FHIR profiel specificeerd dit niet maar laat dit wel toe. Deze logica zit wel ingebouwd in het conversiescript. Wanneer de referentie niet geresovled kan worden en de het type niet bepaald kan worden zal deze informatie verloren gaan in de conversie. Een non-fetal error message zal dan worden afgegeven in de logging.
+
Het FHIR-profiel specificeert dit niet maar laat dit wel toe. Deze logica zit wel ingebouwd in het conversiescript. Wanneer de referentie niet geresovled kan worden en het type niet bepaald kan worden, zal deze informatie verloren gaan in de conversie. Een non-fatal error message zal dan worden afgegeven in de logging.
 
|-
 
|-
| 2|| MedicationRequest.extension BasedOnAgreementOrUse|| Vergelijkbaar mapping probleem als met #1. Als de referentie niet geresolved kan worden is niet te bepalen of het gaat om relatie_naar_afspraak_of_gebruik/identificatie, identificatie_23288 of identificatie_23289. Wanneer ook het type niet bepaald kan worden vanuit de identifier zal deze informatie verloren gaan in de conversie. Een non-fetal error message zal dan worden afgegeven in de logging.
+
| 2|| MedicationRequest.extension BasedOnAgreementOrUse|| Vergelijkbaar mapping-probleem als met #1. Als de referentie niet geresolved kan worden is niet te bepalen of het gaat om relatie_naar_afspraak_of_gebruik/identificatie, identificatie_23288 of identificatie_23289. Wanneer ook het type niet bepaald kan worden vanuit de identifier zal deze informatie verloren gaan in de conversie. Een non-fatal error message zal dan worden afgegeven in de logging.
 
|-
 
|-
| 3|| MedicationRequest.context || Vergelijkbaar mapping probleem als met #1. Als de referentie niet geresolved kan worden is niet te bepalen of het gaat om een identificatie_contactmoment of een identificatie_episode. Een verschil hier echter is dat de identifier.type niet gebruikt kan worden omdat zowel de Encounter als de Episode geen gekoppelde terminologie code bevat. Deze informatie zal daarom verloren gaan wanneer de referentie niet geresolved wordt.   
+
| 3|| MedicationRequest.context || Vergelijkbaar mapping-probleem als met #1. Als de referentie niet geresolved kan worden is niet te bepalen of het gaat om een identificatie_contactmoment of een identificatie_episode. Een verschil hier echter is dat de identifier.type niet gebruikt kan worden omdat zowel de Encounter als de Episode geen gekoppelde terminologie code bevat. Deze informatie zal daarom verloren gaan wanneer de referentie niet geresolved wordt.   
 
|}
 
|}
  
 
= Beschrijving mappings =
 
= Beschrijving mappings =
De mappings naar het MP-9 datamodel zijn te vinden in de daarvoor bestemde 'mappings' sectie in de FHIR profielen zelf. Een goede ingang om de juiste FHIR-profielen te vinden is via de [[MedMij:Vcurrent_Ontwerpen|ontwerp pagina]], zie ook de schermafdruk hieronder.
+
De mappings naar het MP-9 datamodel zijn te vinden in de daarvoor bestemde 'mappings'-sectie in de FHIR-profielen zelf. Een goede ingang om de juiste FHIR-profielen te vinden is via de [[MedMij:Vcurrent_Ontwerpen|ontwerppagina]], zie ook de schermafdruk hieronder.
  
 
[[Bestand:Link2MP-9 FHIR.png| upright=3.5|kaderloos|links|Link naar technische FHIR profielen|link=MedMij:Vcurrent_Ontwerpen]]
 
[[Bestand:Link2MP-9 FHIR.png| upright=3.5|kaderloos|links|Link naar technische FHIR profielen|link=MedMij:Vcurrent_Ontwerpen]]
  
 
[[Category:Mappings|MP9]]
 
[[Category:Mappings|MP9]]

Versie van 15 jul 2020 13:35

{{#customtitle:MP-9 FHIR naar MP-9 datamodel - beschikbaarstellen medicatiegegevens}}

Naar nictiz.nl

Naar Mapping architectuur

Inleiding

Deze pagina beschrijft hoe van de Medicatieproces (MP) versie 9.0.7 transactie 'beschikbaarstellen medicatiegegevens’ in FHIR STU3 te converteren naar het MP-9.0.7 datamodel. Het MP-9 datamodel is gebaseerd op onder andere de volgende zorginformatiebouwstenen (zibs): Patiënt, Organization, Medicatieafspraak, VerstrekkingsVerzoek, Toedieningsafspraak, Medicatieverstrekking, Medicatiegebruik en MedicatieToediening. Het MP-9.0.7 datamodel voegt context toe aan zibs, zoals bijvoorbeeld de medicamenteuze behandeling.

De mapping is volgens de FHIR STU3-profielen op basis van de zibs 2017 release. De exacte versie van de profielen zijn te vinden in het FHIR-package: nictiz.fhir.nl.stu3.zib2017 1.3.10

De conversiescripts zijn werkend getest met Saxon Versie HE 9.8.0.12. Saxon EE met lax validation. De conversie naar het MP-9 datamodel in ADA gebeurt zonder conceptIds en enkel met Nederlandse conceptnamen. Het toevoegen van conceptIds kan met een ada_2_ada conversersie indien nodig.

Voorwaarde voor gebruik

Het conversiescript werkt op basis van FHIR Bundles met daarin alle benodigde informatie om het MP-9 datamodel te vullen voor één transactie van één patiënt. FHIR bestaat uit zogenaamde resources die naar elkaar verwijzen. Het MP-9 datamodel zet alle benodigde informatie per transactie onder elkaar zonder verwijzingen. Om tot het MP-9 datamodel te komen dienen de FHIR-verwijzingen te kunnen worden geresolved om te worden geconverteerd. Het conversiescript kan de resources alleen resolven wanneer deze in de FHIR Bundle zitten. Externe referenties worden niet geresolved. Momenteel ondersteunt het conversiescript literal referenties op basis van urn:oids:, urn:uuids: en absolute urls. Relative urls worden niet ondersteund. Op sommige plekken worden ook logical referenties geprobeerd te resolven in de Bundle. Dit zijn de plekken zoals aangegeven in onderstaande tabel met mapping-issues.

Mapping issues

# Informatie / Functionaliteit Omschrijving
1 MedicationStatement.derivedFrom

Met de huidige FHIR-specificaties (profielen) is het niet mogelijk om zonder de referentie op te lossen te bepalen of het gaat om een gerelateerde_afspraak (MA/TA) of een gerelateerde_verstrekking (MV). Het MP-9 datamodel verwacht een identificatie welke in de derivedFrom.identifier kan staan. De derivedFrom.identifier.type kan gebruikt worden om aan te geven om welk MP9-bouwblok het gaat. Het type wordt dan gevuld met de .catetory code van de betreffende MP waarna verwezen wordt. Een voorbeeld:

<derivedFrom>
    <identifier>
        <type>
            <coding>
                <system value="http://snomed.info/sct"/>
                <value value="373784005"/>
		<display value="Prescription"/>
           </coding>
        </type>
        <system value="urn:oid:2.16.840.1.113883.2.4.3.11.999.77.16076005.12"/>
        <value value="CT-TEST-MBH_907_QA1_MA"/>
    </identifier>
</derivedFrom>

Het FHIR-profiel specificeert dit niet maar laat dit wel toe. Deze logica zit wel ingebouwd in het conversiescript. Wanneer de referentie niet geresovled kan worden en het type niet bepaald kan worden, zal deze informatie verloren gaan in de conversie. Een non-fatal error message zal dan worden afgegeven in de logging.

2 MedicationRequest.extension BasedOnAgreementOrUse Vergelijkbaar mapping-probleem als met #1. Als de referentie niet geresolved kan worden is niet te bepalen of het gaat om relatie_naar_afspraak_of_gebruik/identificatie, identificatie_23288 of identificatie_23289. Wanneer ook het type niet bepaald kan worden vanuit de identifier zal deze informatie verloren gaan in de conversie. Een non-fatal error message zal dan worden afgegeven in de logging.
3 MedicationRequest.context Vergelijkbaar mapping-probleem als met #1. Als de referentie niet geresolved kan worden is niet te bepalen of het gaat om een identificatie_contactmoment of een identificatie_episode. Een verschil hier echter is dat de identifier.type niet gebruikt kan worden omdat zowel de Encounter als de Episode geen gekoppelde terminologie code bevat. Deze informatie zal daarom verloren gaan wanneer de referentie niet geresolved wordt.

Beschrijving mappings

De mappings naar het MP-9 datamodel zijn te vinden in de daarvoor bestemde 'mappings'-sectie in de FHIR-profielen zelf. Een goede ingang om de juiste FHIR-profielen te vinden is via de ontwerppagina, zie ook de schermafdruk hieronder.

Link naar technische FHIR profielen