使用检索概念细节 $lookup - AWS HealthLake
用量支持的参数示例响应参数行为错误处理警告

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

使用检索概念细节 $lookup

AWS HealthLake 现在支持 CodeSystem 资源$lookup操作，使您能够通过提供代码等识别信息来检索有关代码系统中特定概念的详细信息。当您需要执行以下操作时，此操作特别有用：

  • 检索有关特定医疗法规的详细信息

  • 验证代码含义和属性

  • 访问概念定义和关系

  • 利用准确的术语数据支持临床决策

用量

可以使用 GET 和 POST 方法对 CodeSystem 资源调用该$lookup操作：

支持的操作

GET [base]/CodeSystem/$lookup?system=http://snomed.info/sct&code=73211009&version=20230901
POST [base]/CodeSystem/$lookup

支持的参数

HealthLake 支持 FHIR R4 $lookup 参数的子集：

参数 类型 必需 说明
code code 是 你正在查找的概念代码（例如，康涅狄格州 SNOMED 中的 “716200000”）
system uri 是 代码系统的权威网址（例如，“http://snomed.info/sct”）
version 字符串 否 代码系统的特定版本

示例

获取请求

GET [base]/CodeSystem/$lookup?system=http://snomed.info/sct&code=71620000&version=2023-09
POST 请求

POST [base]/CodeSystem/$lookup
Content-Type: application/fhir+json

{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "system",
      "valueUri": "http://snomed.info/sct"
    },
    {
      "name": "code",
      "valueCode": "71620000"
    },
    {
      "name": "version",
      "valueString": "2023-09"
    }
  ]
}
示例响应

该操作返回一个包含概念详细信息的参数资源：

{
    "resourceType": "Parameters",
    "parameter": [{
            "name": "name",
            "valueString": "SNOMED CT Fractures"
        },
        {
            "name": "version",
            "valueString": "2023-09"
        },
        {
            "name": "display",
            "valueString": "Fracture of femur"
        },
        {
            "name": "property",
            "part": [{
                    "name": "code",
                    "valueCode": "child"
                },
                {
                    "name": "value",
                    "valueCode": "263225007"
                },
                {
                    "name": "description",
                    "valueString": "Fracture of neck of femur"
                }
            ]
        },
        {
            "name": "property",
            "part": [{
                    "name": "code",
                    "valueCode": "child"
                },
                {
                    "name": "value",
                    "valueCode": "263227004"
                },
                {
                    "name": "description",
                    "valueString": "Fracture of shaft of femur"
                }
            ]
        }
    ]
}

响应参数

响应包括以下参数（如果有）：

参数 类型 说明
name 字符串 代码系统的名称
version 字符串 代码系统的版本
display 字符串 概念的显示名称
designation BackboneElement 此概念的其他表述。
property BackboneElement 概念的其他属性（定义、关系等）

行为

该$lookup操作：

  1. 验证所需的参数（code和system）

  2. 在存储在数据存储中的指定代码系统中搜索概念

  3. 返回详细的概念信息，包括显示名称、名称和属性。

  4. 提供参数时支持特定版本的version查找

  5. 仅在显式存储在 HealthLake 数据存储中的代码系统上运行

错误处理

该操作处理以下错误情况：

  • 400 错误请求：$lookup操作无效（请求不符合要求或缺少必填参数）

  • 404 未找到：未找到代码系统或在指定的代码系统中找不到代码

警告

此版本不支持以下内容：

  • $lookup通过调用外部术语服务器进行操作

  • $lookup操作由 CodeSystems 管理 HealthLake 但未显式存储在数据存储中

有关$lookup操作规范的更多信息，请参阅 FHIR R4 文档 CodeSystem $lookup。