Overzicht van de bestemmingstoewijzing van de MedTech-service FHIR

Artikel
11/08/2023

Dit artikel bevat een overzicht van de bestemmingstoewijzing van de MedTech-service FHIR®.

Voor de MedTech-service zijn twee typen JSON-toewijzingen vereist die via de Azure-portal of Azure Resource Manager-API aan uw MedTech-service worden toegevoegd. De apparaattoewijzing is het eerste type en bepaalt de toewijzingswaarden in de apparaatgegevens die naar de MedTech-service worden verzonden naar een intern, genormaliseerd gegevensobject. De apparaattoewijzing bevat expressies die de MedTech-service gebruikt voor het extraheren van typen, apparaat-id's, datum en meetwaarde(s). De FHIR-doeltoewijzing is het tweede type en bepaalt hoe de genormaliseerde gegevens worden toegewezen aan FHIR-waarnemingen.

Notitie

De doeltoewijzingen voor apparaten en FHIR worden telkens wanneer een apparaatbericht wordt verwerkt, opnieuw geëvalueerd. Alle updates voor beide toewijzingen worden onmiddellijk van kracht.

Basisbeginselen van FHIR-doeltoewijzing

De FHIR-doeltoewijzing bepaalt hoe de genormaliseerde gegevens die zijn geëxtraheerd uit een apparaatbericht, worden toegewezen aan een FHIR-observatie.

Moet een waarneming worden gemaakt voor een bepaald tijdstip of gedurende een periode van een uur?
Welke codes moeten worden toegevoegd aan de observatie?
Moet de waarde worden weergegeven als SampledData of een Hoeveelheid?

Deze gegevenstypen zijn alle opties voor de configuratiebesturingselementen voor de FHIR-doeltoewijzing.

Zodra apparaatgegevens zijn getransformeerd in een genormaliseerd gegevensmodel, worden de genormaliseerde gegevens verzameld voor transformatie naar een FHIR-observatie. Als het observatietype SampledData is, worden de gegevens gegroepeerd op basis van de apparaat-id, het meettype en de tijdsperiode (de periode kan 1 uur of 24 uur zijn). De uitvoer van deze groepering wordt verzonden voor conversie naar één FHIR-observatie die de periode voor dat gegevenstype aangeeft. Voor andere observatietypen (Hoeveelheid, CodeableConcept en Tekenreeks) worden gegevens niet gegroepeerd, maar in plaats daarvan wordt elke meting omgezet in één observatie die een bepaald tijdstip vertegenwoordigt.

Fooi

Zie Overzicht van de berichtverwerkingsfasen van het MedTech-serviceapparaat voor meer informatie over hoe de MedTech-service berichtgegevens verwerkt in FHIR Observations voor persistentie op de FHIR-service.

Dit diagram geeft een illustratie van wat er gebeurt tijdens de transformatiefase binnen de MedTech-service.

Notitie

De FHIR-observatie in dit diagram is niet de volledige resource. Zie voorbeeld in dit overzicht voor de volledige FHIR-observatie.

CollectionFhir

CollectionFhir is het basissjabloontype dat wordt gebruikt door de doeltoewijzing van de MedTech-service FHIR. CollectionFhir is een lijst met alle sjablonen die worden gebruikt tijdens de transformatiefase. U kunt een of meer sjablonen definiëren in CollectionFhir, waarbij elk genormaliseerd bericht wordt geëvalueerd op basis van alle sjablonen.

CodeValueFhir

CodeValueFhir is momenteel de enige sjabloon die wordt ondersteund in de FHIR-doeltoewijzing. Hiermee kunt u codes, de effectieve periode en de waarde van de observatie definiëren. Er worden meerdere waardetypen ondersteund: SampledData, CodeableConcept, Quantity en String. Naast deze configureerbare waarden worden de id voor de observatieresource en het koppelen aan de juiste resources voor apparaten en patiënten automatisch verwerkt.

Belangrijk

Het oplossingstype geeft aan hoe de MedTech-service apparaatgegevens koppelt aan apparaatbronnen en patiëntbronnen. De MedTech-service leest apparaat- en patiëntbronnen uit de FHIR-service met behulp van apparaat-id's en patiënt-id's. Als een ontmoetings-id is opgegeven en geëxtraheerd uit de nettolading van de apparaatgegevens, wordt deze gekoppeld aan de observatie als er een ontmoeting op de FHIR-service met die id bestaat. Als de ontmoetings-id is genormaliseerd, maar er geen FHIR-ontmoeting bestaat met die ontmoetings-id, wordt er een FhirResourceNotFound-uitzondering gegenereerd. Zie Het tabblad Bestemming configureren voor meer informatie over het configureren van het type MedTech-serviceomzetting.

Element	Omschrijving	Vereist
Typename	Het type meting waaraan deze sjabloon moet worden gekoppeld. Opmerking: er moet ten minste één sjabloon voor apparaattoewijzing zijn die hetzelfde `typeName`heeft. Het `typeName` element wordt gebruikt om een FHIR-doeltoewijzingssjabloon te koppelen aan een of meer sjablonen voor apparaattoewijzing. Apparaattoewijzingssjablonen met hetzelfde `typeName` element genereren genormaliseerde gegevens die worden geëvalueerd met een FHIR-doeltoewijzingssjabloon die hetzelfde `typeName`heeft.	Waar
periodInterval	De periode waarin de gemaakte observatie moet staan. Ondersteunde waarden zijn 0 (een exemplaar), 60 (een uur), 1440 (een dag).	Waar wanneer het observatietype SampledData is; Genegeerd voor andere observatietypen.
category	Een willekeurig aantal CodeableConcepts om het type observatie te classificeren dat is gemaakt.	Onwaar
Codes	Een of meer coderingen die moeten worden toegepast op de gemaakte observatie.	Waar
codes[].code	De code voor een codering in het `codes` element.	Waar
codes[].system	Het systeem voor een codering in het `codes` element.	Onwaar
codes[].display	De weergave voor een codering in het `codes` element.	Onwaar
value	De waarde die moet worden geëxtraheerd en weergegeven in de observatie. Zie Waardetypen voor meer informatie over de elementen die het `value` element bevat.	Waar wanneer het element niet wordt gebruikt (tenzij het `components` observatietype CodebleConcept is, in dat geval is dit element niet alleen 'niet vereist' maar ook genegeerd).
onderdelen	Een of meer onderdelen die op de observatie moeten worden gemaakt.	Waar wanneer het `value` element niet wordt gebruikt.
components[].codes	Een of meer coderingen die op het onderdeel moeten worden toegepast.	Onwaar
components[].value	De waarde die moet worden geëxtraheerd en weergegeven in het onderdeel. Zie Waardetypen voor meer informatie over de elementen die het `components[].value` element bevat.	Waar wanneer het `components` element wordt gebruikt (tenzij het observatietype CodebleConcept is, in dat geval is dit element niet alleen 'niet vereist' maar ook genegeerd).

Waardetypen

Het element van alle CodeValueFhir-sjablonen value bevat deze elementen:

Element	Omschrijving	Vereist
Valuetype	Type van de waarde. Deze waarde is 'SampledData', 'Quantity', 'CodeableConcept' of 'String' afhankelijk van het waardetype.	Waar
valueName	Naam van de waarde.	Waar tenzij `valueType` CodeableConcept.

Deze waardetypen worden ondersteund in de doeltoewijzing van de MedTech-service FHIR:

SampledData

Vertegenwoordigt het gegevenstype SampledData FHIR. Observatiemetingen worden naar een waardestroom geschreven, beginnend op een bepaald tijdstip en worden stapsgewijs verhoogd met behulp van de gedefinieerde periode. Als er geen waarde aanwezig is, wordt een E waarde naar de gegevensstroom geschreven. Als de periode zodanig is dat twee of meer waarden dezelfde positie in de gegevensstroom innemen, wordt de meest recente waarde gebruikt. Dezelfde logica wordt toegepast wanneer een observatie met behulp van sampledData wordt bijgewerkt. Voor een CodeValueFhir-sjabloon met het waardetype SampledData bevat het element van value de sjabloon de volgende elementen:

Element	Omschrijving	Vereist
defaultPeriod	De standaardperiode in milliseconden die moet worden gebruikt.	Waar
Eenheid	De eenheid die moet worden ingesteld op de oorsprong van sampledData.	Waar

Aantal

Vertegenwoordigt het gegevenstype Hoeveelheid FHIR. Met dit type maakt u één punt in de tijd, observatie. Als er een nieuwe waarde binnenkomt die dezelfde apparaat-id, hetzelfde meettype en tijdstempel bevat, wordt de vorige observatie bijgewerkt naar de nieuwe waarde. Voor een CodeValueFhir-sjabloon met het waardetype Hoeveelheid bevat het element van value de sjabloon de volgende elementen:

Element	Omschrijving	Vereist
Eenheid	Eenheidsweergave.	Onwaar
code	Gecodeerde vorm van de eenheid.	Onwaar
systeem	Systeem waarmee het gecodeerde eenheidsformulier wordt gedefinieerd.	Onwaar

CodeableConcept

Vertegenwoordigt het gegevenstype CodeableConcept FHIR. De waarde in het genormaliseerde gegevensmodel wordt niet gebruikt en in plaats daarvan wanneer dit type gegevens wordt ontvangen, wordt er een observatie gemaakt met een specifieke code die aangeeft dat een observatie op een bepaald tijdstip is vastgelegd. Voor een CodeValueFhir-sjabloon met het waardetype CodeableConcept bevat het element van value de sjabloon de volgende elementen:

Element	Omschrijving	Vereist
sms verzenden	Weergave van tekst zonder opmaak.	Onwaar
Codes	Een of meer coderingen die moeten worden toegepast op de gemaakte observatie.	Waar
codes[].code	De code voor een codering in het `codes` element.	Waar
codes[].system	Het systeem voor een codering in het `codes` element.	Onwaar
codes[].display	De weergave voor een codering in het `codes` element.	Onwaar

String

Vertegenwoordigt het gegevenstype String FHIR. Met dit type maakt u één punt in de tijd, observatie. Als er een nieuwe waarde binnenkomt die dezelfde apparaat-id, hetzelfde meettype en tijdstempel bevat, wordt de vorige observatie bijgewerkt naar de nieuwe waarde. Er zijn geen andere elementen gedefinieerd.

Voorbeeld

Fooi

U kunt het foutopsporingsprogramma voor de MedTech-servicetoewijzing gebruiken voor hulp bij het maken, bijwerken en oplossen van problemen met het MedTech-serviceapparaat en de FHIR-doeltoewijzingen. Met het foutopsporingsprogramma voor toewijzingen kunt u eenvoudig inline aanpassingen in realtime bekijken en doorvoeren, zonder dat u de Azure-portal hoeft te verlaten. Het foutopsporingsprogramma voor toewijzingen kan ook worden gebruikt voor het uploaden van testapparaatberichten om te zien hoe deze worden verwerkt in genormaliseerde berichten en omgezet in FHIR-waarnemingen.

Notitie

Dit voorbeeld en genormaliseerde bericht is een vervolg van overzicht van de toewijzing van het MedTech-serviceapparaat.

In dit voorbeeld gebruiken we een genormaliseerd bericht waarin heartRate gegevens worden vastgelegd:

[
  {
    "type": "heartrate",
    "occurrenceTimeUtc": "2023-03-13T22:46:01.875Z",
    "deviceId": "device01",
    "properties": [
      {
        "name": "hr",
        "value": "78"
      }
    ]
  }
]

We gebruiken deze FHIR-doeltoewijzing voor de transformatiefase:

{
  "templateType": "CollectionFhir",
  "template": [
    {
      "templateType": "CodeValueFhir",
      "template": {
        "codes": [
          {
            "code": "8867-4",
            "system": "http://loinc.org",
            "display": "Heart rate"
          }
        ],
        "typeName": "heartrate",
        "value": {
          "system": "http://unitsofmeasure.org",
          "code": "count/min",
          "unit": "count/min",
          "valueName": "hr",
          "valueType": "Quantity"
        }
      }
    }
  ]
}

De resulterende FHIR-observatie ziet er als volgt uit na de transformatiefase:

[
  {
    "code": {
      "coding": [
        {
          "system": {
            "value": "http://loinc.org"
          },
          "code": {
            "value": "8867-4"
          },
          "display": {
            "value": "Heart rate"
          }
        }
      ],
      "text": {
        "value": "heartrate"
      }
    },
    "effective": {
      "start": {
        "value": "2023-03-13T22:46:01.8750000Z"
      },
      "end": {
        "value": "2023-03-13T22:46:01.8750000Z"
      }
    },
    "issued": {
      "value": "2023-04-05T21:02:59.1650841+00:00"
    },
    "value": {
      "value": {
        "value": 78
      },
      "unit": {
        "value": "count/min"
      },
      "system": {
        "value": "http://unitsofmeasure.org"
      },
      "code": {
        "value": "count/min"
      }
    }
  }
]

Fooi

Zie Problemen met de implementatie van medTech-services oplossen voor hulp bij het oplossen van veelvoorkomende fouten bij de implementatie van de MedTech-service.

Zie Problemen oplossen met behulp van de MedTech-servicelogboeken voor hulp bij het oplossen van medtech-servicefouten.