MedTech サービス デバイス マッピングでカスタム関数を使用する方法

JMESPath を式言語として使用する場合、多くの関数を使用できます。 JMESPath 仕様の一部として使用できる組み込み関数に加えて、さらに多くのカスタム関数を使用することもできます。 この記事では、MedTech サービス デバイス マッピングで MedTech サービス固有のカスタム関数を使用する方法について説明します。

関数シグネチャ

各関数には、JMESPath 仕様に従うシグネチャがあります。 この署名は、次のように表すことができます。

return_type function_name(type $argname)

シグネチャは、引数の有効な型を示します。 引数に無効な型が渡されると、エラーが発生します。

前述のように、これらの関数は、式言語として JmesPath を指定する場合にのみ使用できます。 既定では、式言語は JsonPath です。 式の定義時に式の言語を変更できます。

次に例を示します。

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

この例では、 insertString 式を使用して、患者 ID を patient123生成します。

リテラル値

定数値は関数に指定できます。

• 数値はバッククォーク内で囲む必要があります: '
  • 例: add('10', '10')
• 文字列値は、単一引用符で囲む必要があります: '
  • 例: insertString('mple', 'sa', '0')

詳細については、 JMESPath の仕様に関するページを参照してください。

例外処理

例外は、デバイス データ処理ライフサイクル内のさまざまな時点で発生する可能性があります。 例外が発生する可能性があるさまざまなポイントを次に示します。

数学関数

add

number add(number $left, number $right)

左引数を右引数に追加した結果を返します。

例:

divide

number divide(number $left, number $right)

左引数を右引数で除算した結果を返します。

例:

multiply

number multiply(number $left, number $right)

左引数と右引数を乗算した結果を返します。

例:

pow

number pow(number $left, number $right)

左引数を右引数の累乗に引き上げた結果を返します。

例:

減算 (subtract)

number subtract(number $left, number $right)

左引数から右引数を減算した結果を返します。

例:

文字列関数

insertString

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

の値 toInsert を文字列 に挿入して、新しい文字列を生成します original。 文字列は、文字列 original内の位置posに挿入されます。

位置引数が 0 から始まる場合、0 の位置は文字列内の最初の文字を参照します。

指定された位置引数が の長さの original範囲外の場合は、エラーが発生します。

例:

データ関数

fromUnixTimestamp

string fromUnixTimestamp(number $unixTimestampInSeconds)

指定された Unix タイムスタンプから ISO 8061 準拠のタイム スタンプを生成します。 タイムスタンプは、エポック (1970 年 1 月 1 日) 以降の秒数として表されます。

例:

fromUnixTimestampMs

string fromUnixTimestampMs(number $unixTimestampInMs)

指定された Unix タイムスタンプから ISO 8061 準拠のタイム スタンプを生成します。 タイムスタンプは、エポック (1970 年 1 月 1 日) 以降のミリ秒数として表されます。

例:

次のステップ

この記事では、デバイス マッピング内で MedTech サービスのカスタム関数を使用する方法について説明しました。

MedTech サービス デバイス マッピングの概要については、次を参照してください。

MedTech サービス FHIR 変換先マッピングの概要については、次を参照してください。

MedTech サービスのシナリオ ベースのマッピング のサンプルの概要については、次を参照してください。

FHIR®は、米国商標庁に登録されている Health Level Seven International の登録商標であり、その許可を得て使用しています。