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

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

Nozioni di base sul modello CalculatedContent

I modelli Calcolaticontent del servizio MedTech supportano due linguaggi di espressione JSON: JSONPath e JMESPath. 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 TimestampExpression, DeviceIdExpression e così via.

Un'espressione è definita come:

<name of expression> : {
   "value" : <the expression>,
   "language": <the expression language>
}

Nell'esempio seguente viene typeMatchExpression definito come:

"templateType": "CalculatedContent",
"template": {
   "typeName": "heartrate",
   "typeMatchExpression": {
      "value" : "$..[?(@heartRate)]",
      "language": "JsonPath"
   },
...
}

I modelli CalculatedContent consentono la corrispondenza sui valori 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

Quando si specifica la lingua da usare per l'espressione, i valori seguenti sono validi:

Poiché JSONPath è il linguaggio di espressione predefinito, non è necessario includere il linguaggio dell'espressione all'interno di un modello CalculatedContent.

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

È anche possibile impostare in modo esplicito il linguaggio di espressione predefinito per un modello CalculatedContent usando il defaultExpressionLanguage parametro:

"templateType": "CalculatedContent",
   "template": {
      "typeName": "heartrate",
      "defaultExpressionLanguage": "JmesPath",
      "typeMatchExpression": "[Body][?contains(keys(@), `heartRate`)] | @[0]",
...
}

Funzioni personalizzate

È disponibile anche un set di funzioni personalizzate per il servizio MedTech. Le funzioni personalizzate del servizio MedTech non sono incluse nelle funzioni fornite come parte della specifica JMESPath. Per altre informazioni sulle funzioni personalizzate del servizio MedTech, vedere Come usare funzioni personalizzate con il mapping dei dispositivi del servizio MedTech.

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, i deviceIdExpressionvalori , timestampExpressione valueExpression vengono usati per individuare ed estrarre i valori JSON dal messaggio del dispositivo e creare un messaggio normalizzato. In questo esempio tutte le espressioni vengono scritte in JSONPath, ma sarebbe valido scrivere tutte le espressioni in JMESPath. Si tratta dell'autore del modello per determinare quale linguaggio delle espressioni è più appropriato.

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

{
    "heartRate": "78",
    "endDate": "2023-03-13T22:46:01.8750000",
    "deviceId": "device01"
}

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

{
    "Body": {
        "heartRate": "78",
        "endDate": "2023-03-13T22:46:01.8750000",
        "deviceId": "device01"
    }
}

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

{
    "templateType": "CollectionContent",
    "template": [
        {
            "templateType": "CalculatedContent",
            "template": {
                "typeName": "heartrate",
                "typeMatchExpression": "$..[?(@heartRate)]",
                "deviceIdExpression": "$.matchedToken.deviceId",
                "timestampExpression": "$.matchedToken.endDate",
                "values": [
                    {
                        "required": true,
                        "valueExpression": "$.matchedToken.heartRate",
                        "valueName": "hr"
                    }
                ]
            }
        }
    ]
}

{
    "Body": {
        "heartRate": "78",
        "endDate": "2023-03-13T22:46:01.8750000",
        "deviceId": "device01"
    },
    "matchedToken": {
        "heartRate": "78",
        "endDate": "2023-03-13T22:46:01.8750000",
        "deviceId": "device01"
    }
}

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

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

Passaggi successivi

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

Per informazioni su come usare le funzioni personalizzate del servizio MedTech, 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.