Mappings/FHIR 2 MP9MedicationInformation: verschil tussen versies
k (Tekst vervangen - "{{#customtitle:" door "{{DISPLAYTITLE:") |
|||
| (10 tussenliggende versies door 2 gebruikers niet weergegeven) | |||
| Regel 1: | Regel 1: | ||
| − | {{ | + | {{DISPLAYTITLE:MP-9 FHIR naar MP-9 datamodel - beschikbaarstellen medicatiegegevens}} |
[[Bestand:Nictiz_logo_PO_rechts_rgb.png |link=https://www.nictiz.nl/|rechts|Naar nictiz.nl]] | [[Bestand:Nictiz_logo_PO_rechts_rgb.png |link=https://www.nictiz.nl/|rechts|Naar nictiz.nl]] | ||
| Regel 5: | Regel 5: | ||
{{TOClimit|4}} | {{TOClimit|4}} | ||
= Inleiding = | = Inleiding = | ||
| − | Deze pagina beschrijft hoe van de Medicatieproces (MP) versie 9 transactie | + | 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. |
| − | MP-9 FHIR | + | 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 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 [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 = | ||
| − | |||
| − | |||
{| class="wikitable sortable" | {| 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 | | 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|| | + | | 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: | ||
| + | |||
| + | <syntaxhighlight lang="xml"> | ||
| + | <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> | ||
| + | </syntaxhighlight> | ||
| + | |||
| + | 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 = | = 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| | + | 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]] | ||
Huidige versie van 20 jul 2020 om 02:59
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.
