Come usare i modelli IotJsonPathContent con il mapping dei dispositivi del servizio MedTech

Questo articolo offre una panoramica dell'uso dei modelli IotJsonPathContent all'interno di un mapping dei dispositivi del servizio MedTech.

Nozioni di base sul modello IotJsonPathContent

IotJsonPathContent modelli possono essere usati quando il servizio MedTech inserisce i messaggi del dispositivo indirizzati da un hub IoT di Azure. Quando i modelli IotJsonPathContent vengono usati nel mapping dei dispositivi, il servizio MedTech estrae l'ID dispositivo e il timestamp di misurazione dai metadati forniti da un hub IoT. DeviceIdExpression e TimestampExpression non devono essere inclusi nei modelli IotJsonPathContent.

I modelli IotJsonPathContent del servizio MedTech supportano JSON Expression Language JSONPath. Le espressioni vengono usate per identificare il modello da usare con un determinato messaggio di dispositivo JSON (ad esempio TypeMatchExpression) e per estrarre valori specifici necessari per creare un messaggio normalizzato, ad esempio PatientIdExpression, ValueExpression e così via. I modelli IotJsonPathContent sono simili ai modelli CalculatedContent , ad eccezione dei modelli DeviceIdExpression e TimestampExpression non sono supportati.

Un'espressione è definita come:

<name of expression> : <the expression>

Nell'esempio seguente viene typeMatchExpression definito come:

"templateType": "IotJsonPathContent",
"template": {
   "typeName": "heartrate",
   "typeMatchExpression": "$..[?(@heartRate)]",
...
}

Se il servizio MedTech è configurato per inserire i messaggi dei dispositivi da un hub IoT, non è necessario usare i modelli IotJsonPathContent. I modelli CalculatedContent possono essere usati presupponendo che si definiscano correttamente DeviceIdExpression e TimestampExpression.

I modelli IotJsonPathContent consentono la corrispondenza e l'estrazione di valori da un messaggio del dispositivo letti da un hub eventi di Hub eventi di Azure tramite le espressioni seguenti:

Linguaggi di espressione

JSONPath è il linguaggio di espressione predefinito e l'inclusione di un linguaggio di espressione all'interno di un modello IotJsonPathContent non è supportato. Se si tenta di specificare il linguaggio dell'espressione in un oggetto expression, il modello IotJsonPathContent contenente l'oggetto expression ha esito negativo.

"templateType": "IotJsonPathContent",
   "template": {
      "typeName": "heartrate",
      "typeMatchExpression": "$..[?(@heartRate)]",
...
}

Esempio

Quando il servizio MedTech elabora un messaggio di dispositivo, i modelli in CollectionContent vengono usati per valutare il messaggio. Viene typeMatchExpression usato per determinare se il modello deve essere usato per creare un messaggio normalizzato dal messaggio del dispositivo. Se restituisce typeMatchExpression true, il valueExpression valore viene usato per individuare ed estrarre i valori JSON dal messaggio del dispositivo e creare un messaggio normalizzato.

In questo esempio viene usato un messaggio del dispositivo che acquisisce heartRate i dati:

{
    "PatientId": "patient1",
    "HeartRate" : "78"
}

L'hub IoT arricchisce e indirizza il messaggio del dispositivo all'hub eventi prima che il servizio MedTech legge il messaggio del dispositivo dall'hub eventi:

{
    "Body": {
        "PatientId": "patient1",
        "HeartRate": "78"
    },
    "SystemProperties": {
        "iothub-enqueuedtime": "2023-07-25T20:41:26.046Z",
        "iothub-connection-device-id": "sampleDeviceId"
    },
    "Properties": {
        "iothub-creation-time-utc": "2023-07-25T20:41:26.046Z"
    }
}   

Questo mapping dei dispositivi viene usato per la fase di normalizzazione:

{
    "templateType": "CollectionContent",
    "template": [
        {
            "templateType": "IotJsonPathContent",
            "template": {
                "typeName": "HeartRate",
                "typeMatchExpression": "$..[?(@Body.HeartRate)]",
                "patientIdExpression": "$.Body.PatientId",
                "values": [
                    {
                        "required": true,
                        "valueExpression": "$.Body.HeartRate",
                        "valueName": "HeartRate"
                    }
                ]
            }
        }
    ]    
}

Il messaggio normalizzato risultante avrà un aspetto simile al seguente dopo la fase di normalizzazione:

{
    "type": "HeartRate",
    "occurrenceTimeUtc": "2023-07-25T20:41:26.046Z",
    "deviceId": "sampleDeviceId",
    "patientId": "patient1",
    "properties": [
        {
            "name": "HeartRate",
            "value": "78"
        }
    ]
}

Passaggi successivi

In questo articolo si è appreso come usare i modelli IotJsonPathContent con il mapping dei dispositivi del servizio MedTech.

Per distribuire il servizio MedTech con il routing dei messaggi del dispositivo abilitato tramite un hub IoT di Azure, vedere

Per una panoramica del mapping di destinazione del servizio MedTech FHIR, vedere

Per una panoramica degli esempi di mapping basati su scenari di servizio MedTech, vedere

FHIR® è un marchio registrato di Health Level Seven International, registrato in U.S. Trademark Office e viene usato con l'autorizzazione.