View a markdown version of this page

使用 在術語之間映射程式碼 $translate - AWS HealthLake
Usage支援的參數範例回應參數Behavior (行為)錯誤處理警告

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

使用 在術語之間映射程式碼 $translate

AWS HealthLake 支援 ConceptMap 資源$translate的操作，可讓您使用已擷取至資料存放區的 ConceptMaps，將程式碼從一個程式碼系統映射至另一個程式碼中的對等程式碼。當您需要執行下列動作時，此操作特別有用：

  • 在術語之間映射代碼 （例如 ICD-10-CM 到 SNOMED CT)

  • 標準化正式程式碼系統的傳入資料

  • 支援使用不同術語的跨系統互通性

  • 透過標準化異質來源術語來執行臨床資料分析

Usage

您可以使用 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 R4 $translate 參數的子集：

參數 Type 必要 說明
code code 是 要翻譯的原始程式碼
system uri 是 程式碼所屬的程式碼系統
url uri 否 要轉譯的特定 ConceptMap 正式 URL
source uri 否 僅限於來源值設定為等於此 URI 的映射
target uri 否 僅限於目標值設定為等於此 URI 的映射
targetsystem uri 否 限制與此程式碼系統中的目標程式碼相符
注意

url、 source和 target 參數是範圍篩選條件，僅適用於類型層級調用 ([base]/ConceptMap/$translate)。在執行個體叫用 (ConceptMap/[id]/$translate) 上，它們會被忽略，因為只有 code、 system和 targetsystem生效。

範例

GET 請求 （依 ConceptMap ID)

GET [base]/ConceptMap/example-conceptmap/$translate?system=http://snomed.info/sct&code=44054006
GET 請求 （依正式 URL)

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

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 boolean 是否找到相符項目
match BackboneElement 在 ConceptMap 中找到相符項目
match.equivalence code 來源和目標概念之間的同等程度
match.concept 編碼 目標概念 （包括系統、程式碼和顯示器）

Behavior (行為)

$translate 操作：

  1. 驗證所需的參數 (code 和 system)。

  2. 依執行個體[id]或正式 解析 ConceptMapurl。

  3. 翻譯原始程式碼，在提供targetsystem時選擇性地篩選相符項目至 。

  4. match 傳回 result: true，每個對等目標碼各一個，或result: false當沒有映射時。

錯誤處理

操作會處理下列錯誤條件：

  • 400 錯誤的請求：無效的$translate請求 （不符合的請求或缺少必要的參數）

  • 找不到 404：在資料存放區中找不到 ConceptMap

警告

在此版本中，不支援下列項目：

  • reverse 參數 （從目標到來源的反向轉譯）

  • 跨多個 ConceptMaps 的鏈結轉換

  • 由於超過 10 個 ConceptMap 資源可以符合$translate查詢，因此只會傳回前 10 個 ConceptMaps 的相符項目，並依 ConceptMap 的 date 欄位排序 （以最新者為準）。

如需 $translate操作規格的詳細資訊，請參閱 FHIR R4 ConceptMap $translate 文件。