如何将自定义函数与医疗技术服务设备映射配合使用

使用 JMESPath 作为表达式语言时，可以使用许多函数。 除了 JMESPath 规范中提供的内置函数外，还可以使用其他许多自定义函数。 本文介绍如何将特定于医疗技术服务的自定义函数与医疗技术服务设备映射配合使用。

可以使用医疗技术服务映射调试器帮助创建、更新和排查医疗技术服务设备和 FHIR® 目标映射问题。 利用映射调试器，可以轻松实时查看和进行内联调整，而无需离开 Azure 门户。 映射调试器还可用于上传测试设备消息，以查看在处理成规范化消息并转换为 FHIR 观察后的外观。

函数签名

每个函数都有一个遵循 JMESPath 规范的签名。 此签名可以表示为：

return_type function_name(type $argname)

签名指示参数的有效类型。 如果为参数传入的类型无效，则会发生错误。

如前所述，仅当指定 JmesPath 作为表达式语言时才能使用这些函数。 默认情况下，表达式语言是 JsonPath。 定义表达式时可以更改表达式语言。

例如：

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

此示例使用 insertString 表达式生成患者 IDpatient123。

文本值

可以向函数提供常量值。

• 数字值应该用反撇号 ` 括住：
  • 示例：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 位置处。

如果位置参数从零开始，则零位置表示字符串中的第一个字符。

如果提供的位置参数超出了 original 的长度范围，则会发生错误。

例子：

日期函数

fromUnixTimestamp

string fromUnixTimestamp(number $unixTimestampInSeconds)

根据给定的 Unix 时间戳生成符合 ISO 8061 规范的时间戳。 该时间戳表示自纪元（1970 年 1 月 1 日）以来经过的秒数。

例子：

fromUnixTimestampMs

string fromUnixTimestampMs(number $unixTimestampInMs)

根据给定的 Unix 时间戳生成符合 ISO 8061 规范的时间戳。 该时间戳表示自纪元（1970 年 1 月 1 日）以来经过的毫秒数。

例子：

后续步骤

医疗技术服务设备映射概述

医疗技术服务 FHIR 目标映射概述

基于医疗技术服务方案的映射示例概述