View a markdown version of this page

使用 $translate 在术语之间映射代码 - AWS HealthLake
用量支持的参数示例响应参数行为错误处理警告

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

使用 $translate 在术语之间映射代码

AWS HealthLake 支持 ConceptMap 资源$translate操作，使您能够使用 ConceptMaps 已摄取到数据存储库的代码将一个代码系统中的代码映射到另一个代码系统的等效代码。当您需要执行以下操作时，此操作特别有用：

  • 在术语之间映射代码（例如， ICD-10-CM 到 SNOMED CT）

  • 将传入数据标准化到权威代码系统

  • 支持使用不同术语的系统之间的互操作性

  • 通过标准化异构来源术语来进行临床数据分析

用量

可以使用 GET 和 POST 方法在 ConceptMap 资源上调用该$translate操作：

支持的操作

GET  [base]/ConceptMap/$translate?url={...}&system={...}&code={...}
GET  [base]/ConceptMap/[id]/$translate?system={...}&code={...}
POST [base]/ConceptMap/$translate
POST [base]/ConceptMap/[id]/$translate

支持的参数

HealthLake 支持 FHIR R $translate 4 参数的子集：

参数 Type 必需 说明
code 代码 是 要翻译的源代码
system uri 是 代码所属的代码系统
url uri 否 ConceptMap 要翻译的特定内容的权威网址
source uri 否 仅限源值集等于此 URI 的地图
target uri 否 仅限目标值设置等于此 URI 的地图
targetsystem uri 否 将匹配限制在此代码系统中的目标代码
注意

urlsource、和target参数是范围过滤器，仅适用于类型级调用 () [base]/ConceptMap/$translate。在实例调用 (ConceptMap/[id]/$translate) 时，它们仅code被忽略并生targetsystem效。system

示例

GET 请求（按 ConceptMap ID）

GET [base]/ConceptMap/example-conceptmap/$translate?system=http://snomed.info/sct&code=44054006
GET 请求（按权威网址）

GET [base]/ConceptMap/$translate?url=http://example.com/ConceptMap/sct-to-icd10&system=http://snomed.info/sct&code=44054006
发布请求

POST [base]/ConceptMap/$translate
Content-Type: application/fhir+json

{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "url",
      "valueUri": "http://example.com/ConceptMap/sct-to-icd10"
    },
    {
      "name": "system",
      "valueUri": "http://snomed.info/sct"
    },
    {
      "name": "code",
      "valueCode": "44054006"
    },
    {
      "name": "targetsystem",
      "valueUri": "http://hl7.org/fhir/sid/icd-10-cm"
    }
  ]
}
示例响应

该操作返回一个Parameters资源。该result参数表示是否找到了匹配项。每个都match包含目标concept和一个equivalence：

{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "result",
      "valueBoolean": true
    },
    {
      "name": "match",
      "part": [
        {
          "name": "equivalence",
          "valueCode": "equivalent"
        },
        {
          "name": "concept",
          "valueCoding": {
            "system": "http://hl7.org/fhir/sid/icd-10-cm",
            "code": "E11.9",
            "display": "Type 2 diabetes mellitus without complications"
          }
        }
      ]
    }
  ]
}

响应参数

响应包含以下参数：

参数 类型 描述
result 布尔值 是否找到了匹配项
match BackboneElement 在中找到匹配项 ConceptMap
match.equivalence 代码 源概念和目标概念之间的等效程度
match.concept 编码 目标概念（包括系统、代码和显示器）

行为

$translate操作：

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

  2. ConceptMap 按实例[id]或规范url解析问题。

  3. 转换源代码，可选择将匹配项筛选为（targetsystem如果提供）。

  4. match每个等效目标代码返回result: true一个，或者不存在映射result: false时返回。

错误处理

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

  • 400 错误请求：请求无效（$translate请求不一致或缺少必需的参数）

  • 404 未找到：在数据存储中找 ConceptMap 不到

警告

在此版本中，不支持以下内容：

  • reverse参数（从目标到源的反向转换）

  • 跨多个链接翻译 ConceptMaps

  • 由于超过 10 个 ConceptMap 资源可以匹配$translate查询，因此仅返回前 10 个 ConceptMaps 资源中的匹配项，按 ConceptMap's date 字段排序（最近的在最前面）。

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