FHIR SearchParameter period-of-use vraagt te veel van FHIR's standaard search framework

Description

Omschrijving: Bij het implementeren van MP9 binnen de Firely FHIR server, stuiten we op uitdagingen met betrekking tot de door MP9 gedefinieerde SearchParameter period-of-use (https://simplifier.net/packages/nictiz.fhir.nl.r4.medicationprocess9/2.0.0-beta.5/files/2361676 ). Onze ervaring is dat deze SearchParameter momenteel te veel vraagt van het standaard RESTful search framework van FHIR.

In vergelijking met eerdere versies (zoals te zien in https://simplifier.net/packages/nictiz.fhir.nl.r4.medicationprocess9/2.0.0-beta.1/files/1952069 ) is in de meest recente versie extra definitie toegevoegd. Dit brengt significante implementatie-uitdagingen met zich mee:

Verwijdering van de expressies: De expressies die eerder gedefinieerd waren, zijn verwijderd. Dit impliceert dat iedere FHIR server maatwerk moet implementeren om deze SearchParameter correct te laten functioneren. Hoewel het jammer is dat je hiermee de SearchParameter niet meer out-of-the-box kan gebruiken, lijkt dit in nog wel haalbaar.
Toevoeging van complexe logica in de omschrijving (niet opgenomen in de TO):
De huidige omschrijving van de SearchParameter vereist extra logica die verder gaat dan de standaard search-functionaliteit van FHIR:

Next to the search results obtained by taking into account the Period and Duration as described above, it is required to also include the latest stopped MedicationRequest and MedicationDispense resources (corresponding with the MedicationAgreement, VariableDosingRegimen and AdministrationAgreement building blocks) within each pharmaceutical treatment, even if these have a period of use outside the PeriodOfUse that is being searched on. For this all MedicationRequest and MedicationDispense resources wherein the ext-StopType extension is present should be considered, before including, for each pharmaceutical treatment, only the latest one based on the value of MedicationRequest.authoredOn and the ext-AdministrationAgreement.AdministrationAgreementDateTime extension, respectively.

Deze toevoeging vereist echter logica die eerder past bij een custom operation dan een standaard SearchParameter. Het is onwaarschijnlijk dat deze functionaliteit volledig geïmplementeerd kan worden in de standaard zoekmodules van een FHIR server.

Voorstel is om te bekijken of dit niet alsonog op een standaard manieer gedaan kan worden. Zo niet, lijkt het ons verstandiger om deze logica te verplaatsen naar een OperationDefinition gezien de complexiteit van de gevraagde functionaliteit. Dit zou duidelijk maken dat er maatwerk vereist is van leveranciers, en biedt meer mogelijkheid om specifieke voorbeelden en beschrijvingen te geven voor het correct leveren van de benodigde resources. Hier ontbreekt het nu namelijk ook aan.

---------
Product of dienst: Medicatie
Informatiestandaard: Medicatieproces (MP9)
Usecase(s):
Versie:
---------

Proposed solution (NL)

Er wordt op dit moment gekeken of het terugdraaien naar hoe het eerst was in https://simplifier.net/packages/nictiz.fhir.nl.r4.medicationprocess9/2.0.0-beta.1/files/1952069 voldoende is voor de beta.5 release. Gesprek met FHIR kickstartleveranciers wordt ingepland om oplossingsrichting te bespreken

update 29 april 2025

Besproken met VZVZ, MP9 SGU-leden en ook de FHIR kickstartleveranciers en blijkt dat de complexe logica in de search parameter period-of-use al door hen is geïmplementeerd of zelfs niet relevant is omdat zij geen MA, WDS of TA beschikbaarstellen.

De complexe logica over de stop bouwsteen zal verwijderd worden uit de description van de Search Parameter period-of-use en verplaatst worden naar het TO (onder section https://informatiestandaarden.nictiz.nl/wiki/mp:V3.0.0_MedicationProcess9_FHIR#Serve_.28response_message.29. Een nieuwe wijzigingsverzoek zal aangemaakt worden voor de technische implementatie van het beschikbaar stellen van de laatste stop bouwsteen (MA,TA en WDS) per MBH. Dit is niet alleen voor FHIR leveranciers relevant maar ook voor v3 leveranciers en zal dit verder opgepakt worden met VZVZ en de vervolgleveranciers.

Proposed solution (EN)

None

Release notes (NL)

De omschrijving van de SearchParameter period-of-use is aangepast in het FHIR package en bevat de complexe logica om de laatste stop bouwsteen op te leveren per medicamenteuze behandeling niet meer. Deze eis is geplaatst in een nieuwe paragraaf genaamd 3.1.2.1 Serving resources with a stoptype onder sectie 3.1.2 Serve (response message) https://informatiestandaarden.nictiz.nl/wiki/mp:V3.0.0_MedicationProcess9_FHIR#Serve_.28response_message.29.

Release notes (EN)

The description of the SearchParameter period-of-use is updated in the FHIR package and no longer contains the complex logic regarding the last stop building block for each pharmaceutical treatment. This requirement is added as a new paragraph called 3.1.2.1 Serving resources with a stoptype under the section 3.1.2 Serve (response message) https://informatiestandaarden.nictiz.nl/wiki/mp:V3.0.0_MedicationProcess9_FHIR#Serve_.28response_message.29.