Come usare funzioni personalizzate con il mapping dei dispositivi del servizio MedTech

Molte funzioni sono disponibili quando si usa JMESPath come linguaggio di espressione. Oltre alle funzioni predefinite disponibili come parte della specifica JMESPath, è possibile usare anche molte funzioni personalizzate. Questo articolo descrive come usare le funzioni personalizzate specifiche del servizio MedTech con il mapping dei dispositivi del servizio MedTech.

Firma della funzione

Ogni funzione ha una firma che segue la specifica JMESPath. Questa firma può essere rappresentata come:

return_type function_name(type $argname)

La firma indica i tipi validi per gli argomenti. Se un tipo non valido viene passato per un argomento, si verifica un errore.

Come indicato in precedenza, queste funzioni possono essere usate solo quando si specifica JmesPath come linguaggio di espressione. Per impostazione predefinita, il linguaggio delle espressioni è JsonPath. Il linguaggio delle espressioni può essere modificato durante la definizione dell'espressione.

Ad esempio:

"templateType": "CalculatedContent",
    "template": {
        "typeName": "heartrate",
        "patientIdExpression": {
            "value": "insertString('123', 'patient', `0`) ",
            "language": "JmesPath"
        },
        ...
    }

In questo esempio viene usata l'espressione insertString per generare l'ID patient123paziente.

Valori letterali

I valori costanti possono essere forniti alle funzioni.

• I valori numerici devono essere racchiusi tra backticks: '
  • Esempio: add('10', '10')
• I valori stringa devono essere racchiusi tra virgolette singole: '
  • Esempio: insertString('mple', 'sa', '0')

Per altre informazioni, vedere la specifica JMESPath.

Gestione delle eccezioni

Le eccezioni possono verificarsi in vari punti all'interno del ciclo di vita dell'elaborazione dei dati del dispositivo. Ecco i vari punti in cui possono verificarsi eccezioni:

Funzioni matematiche

add

number add(number $left, number $right)

Restituisce il risultato dell'aggiunta dell'argomento sinistro all'argomento destro.

Esempi:

Dividere

number divide(number $left, number $right)

Restituisce il risultato della divisione dell'argomento sinistro in base all'argomento destro.

Esempi:

Moltiplicare

number multiply(number $left, number $right)

Restituisce il risultato della moltiplicazione dell'argomento sinistro con l'argomento destro.

Esempi:

pow

number pow(number $left, number $right)

Restituisce il risultato dell'aumento dell'argomento sinistro alla potenza dell'argomento di destra.

Esempi:

sottrarre

number subtract(number $left, number $right)

Restituisce il risultato della sottrazione dell'argomento destro dall'argomento sinistro.

Esempi:

Funzioni per i valori stringa

insertString

string insertString(string $original, string $toInsert, number pos)

Produce una nuova stringa inserendo il valore di toInsert nella stringa original. La stringa viene inserita nella posizione pos all'interno della stringa original.

Se l'argomento posizionale è in base zero, la posizione di zero fa riferimento al primo carattere all'interno della stringa.

Se l'argomento posizionale specificato non è compreso nell'intervallo di lunghezza di original, si verifica un errore.

Esempi:

Funzioni di data

fromUnixTimestamp

string fromUnixTimestamp(number $unixTimestampInSeconds)

Produce un timestamp conforme a ISO 8061 dal timestamp Unix specificato. Il timestamp è rappresentato come numero di secondi dall'epoca (1 gennaio 1970).

Esempi:

fromUnixTimestampMs

string fromUnixTimestampMs(number $unixTimestampInMs)

Produce un timestamp conforme a ISO 8061 dal timestamp Unix specificato. Il timestamp è rappresentato come numero di millisecondi dall'epoca (1 gennaio 1970).

Esempi:

Passaggi successivi

In questo articolo si è appreso come usare le funzioni personalizzate del servizio MedTech all'interno del mapping dei dispositivi.

Per una panoramica del mapping dei dispositivi del servizio MedTech, vedere

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

Per una panoramica degli esempi di mapping basati sullo scenario del servizio MedTech, vedere

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