Chapter 1

Bericht structuur

Structuur

Het uitgangspunt van een eerste versie van een NICE FHIR oplossing, is om dit zo simpel mogelijk te houden maar dat dit in de toekomst kan veranderen. Door in elke resource (in de meta) aan te geven welk profile is gebruikt, kan er worden bepaald hoe de data moet worden geintrepreteerd. NICE heeft altijd de regel gehanteerd dat als er een opname wordt aangeleverd, dat deze dan altijd compleet, dwz inclusief alle gerelateerde gegevens zoals SOFA, KIIC, moet worden verstuurd. Voor FHIR zal hetzelfde gelden, met de kanttekening dat niet alles direct hoeft te worden ingevuld. Per onderdeel moet worden aangegeven wanneer dit verwacht wordt.

Ter illustratie (alleen MDS):

  • Bij opname: bundle met patient en QR MDS opname gegevens.
  • Na 24 uur: bundle met patient en QR MDS aangevuld met gegevens eerste 24uur.
  • bundle met patient en QR MDS ontslag gegevens.
  • bundle met patient en QR MDS en goedkeuring. (zie randvoorwaarden)

Voor bijvoorbeeld de aanleveing glucose-metingen, is het voldoende om alle metingen op te sturen als de opname is afgerond.

XML vs JSON

HL7-FHIR ondersteunt formeel XML en JSON. Beide zal de NICE server ondersteunen. JSON zal naar verwachting minder overhead geven, waardoor de berichten wat compacter zullen zijn. Op deze site is ervoor gekozen de voorbeelden in XML te tonen, omdat deze beter leesbaar zijn voor mensen. De tags geven namelijk aan wat het is.

Encoding: UTF-8

Zowel XML als JSON behoren geëncodeerd te zijn volgens UTF-8.

Profiles

De FHIR resources moeten worden voorzien van een profile. Met deze profile kunnen we de resource herkennen én bepalen op basis van welke versie deze is gemaakt. Nice stuurt elk kwartaal een Data Dictionary update, met daarin (eventuele) wijzigingen. Daarom zullen we in de profiles gebruik maken van het jaartal + kwartaal. Bijvoorbeeld in de Bundle:

<Bundle xmlns="http://hl7.org/fhir">
  <meta>
    <profile value="https://fhir.stichting-nice.nl/fhir/R4/StructureDefinition/BundleAdmission-2021Q1"/>
  </meta>
    <!--  De rest van de bundle -->
</Bundle>

Een uitzondering voor de verplichting van een profile wordt gemaakt voor de QuestionnaireResponses. Voor de QuestionnaireResponse geldt dat er een verwijzing naar een Questionnaire met een versie aanduiding verplicht is. Hieronder is een QuestionnaireResponse in een bundle te zien, waar dus geen meta tag is opgenomen, maar wel een verwijzing naar een QuestionnaireResponse.

<Bundle xmlns="http://hl7.org/fhir">
  <meta>
    <profile value="https://fhir.stichting-nice.nl/fhir/R4/StructureDefinition/BundleAdmission-2021Q1"/>
  </meta>
    <!-- weggelaten  -->
  <entry>
    <resource>
      <QuestionnaireResponse>
        <id value="123"/>
        <questionnaire value="https://fhir.stichting-nice.nl/fhir/R4/Questionnaire/mds-2021Q1"/>
        <status value="completed"/>
          <!--  etc  -->
      </QuestionnaireResponse>
    </resource>
    <request>
      <method value="PUT"/>
      <url value="QuestionnaireResponse"/>
    </request>
  </entry>
</Bundle>

Bundle

Per opname wordt er een bundle samengesteld met daarin verschillende QuestionnaireResponses voor één opname. Er kan per module één QuestionnaireResponse worden opgenomen. Binnen de QuestionnaireResponse kunnen er herhaalde items zijn (groepen). Zo zit er in de SOFA-QuestionnaireResponse een item ‘sofa’ welke per dag herhaald kan worden. Voordeel van deze aanpak is dat ziekenhuizen die niet meedoen met een NICE-module, deze hele QuestionnaireResponse kunnen weglaten.

Bundle voor niet opname-gerelateerde informatie

Omdat een admission-bundle gaat over één opname, is het niet mogelijk hier ook bijv. fte verpleegkundigen op te nemen. Daarom zal er een aparte bundle worden gedefiniëerd voor niet-opname-gerelateerde informatie. De niet-opname-gerelateerde informatie zijn:

  • MDS_year (al kan deze ook online via een formulier worden ingevuld)
  • KIIC_quarter_2017 (ook deze kan online worden ingevuld)
  • KIIC_bezetting.
  • ZZ_personeel

Questionnaire

De Questionnaire (Q) resource is de definitie van wat er gevraagd wordt. Hiermee kunnen we aangeven:

  • Welke items er zijn,
  • Welke items verplicht zijn,
  • Welke antwoord opties de items hebben

De questionnaire zal door NICE worden gedefiniëerd. Bij veranderingen zal het versienummer (jaartal + kwartaal) worden verhoogd.

Er zal een Questionnaire per module worden gemaakt: MDS, KIIC, SOFA etc.

QuestionnaireResponse

De QuestionnaireResponse (QR) is de resource die wordt gebruikt om de data te versturen. Binnen een QR wordt de informatie van één opname opgenomen door per item een ‘answer’ op te nemen. In de Questionnaire staat gedefinieerd welke opties er zijn.

Voorbeelden van QR’s kan je hier vinden

Onderdelen

  • Bundle: Een ID wordt door NICE server toegekend als de bundle deze nog niet heeft. Een identifier moet worden toegekend door het EPD, Deze moet de (IC) opname uniek kunnen identificeren. Wanneer de bundle nog geen ID heeft, wordt de identifier gebruikt om te controleren of deze al bestaat. Het type bericht is Transaction: We willen de bundle als een geheel zien.

  • Questionnaire MDS

Datatypen

FHIR beschrijft haar datatypen hier : FHIR Datatype

  • Decimal: Veel (lab-)waarden krijgen een eenheid mee. Daardoor verandert het datatype integer of float naar Quantity, maar daarin een code voor de eenheid en een decimaal voor de waarde. Onduidelijk is hoe in FHIR te definieren hoeveel decimalen wenselijk zijn, maar het is mogelijk om een geheel getal en een reeël getal te versturen.