View a markdown version of this page

を使用した用語間のコードのマッピング $translate - AWS HealthLake
使用方法サポートされているパラメータ例レスポンスパラメータ動作エラー処理注意

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

を使用した用語間のコードのマッピング $translate

AWS HealthLake は ConceptMap リソースの $translateオペレーションをサポートしているため、データストアに取り込んだ ConceptMaps を使用して、あるコードシステムから別のコードの同等のコードにコードをマッピングできます。このオペレーションは、以下が必要な場合に特に役立ちます。

  • 用語間でコードをマッピングする (ICD-10-CM から SNOMED CT など)

  • 正規コードシステムに受信データを正規化する

  • さまざまな用語を使用するシステム間の相互運用性をサポート

  • 異種ソース用語を標準化して臨床データ分析を実行する

使用方法

$translate オペレーションは、GET メソッドと POST メソッドの両方を使用して ConceptMap リソースで呼び出すことができます。

サポートされているオペレーション

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パラメータのサブセットをサポートしています。

パラメータ タイプ 必須 説明
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、、 のみtargetsystemが有効であるためsystem無視されます。

例

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 パラメータは、一致が見つかったかどうかを示します。各 には、ターゲットconceptと matchが含まれます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"
          }
        }
      ]
    }
  ]
}

レスポンスパラメータ

レスポンスには、次のパラメータが含まれます。

パラメータ Type 説明
result ブール型 一致が見つかったかどうか
match BackboneElement ConceptMap で見つかった一致
match.equivalence コード ソース概念とターゲット概念の同等性の程度
match.concept コーディング ターゲットの概念 (システム、コード、ディスプレイを含む)

動作

$translate オペレーション:

  1. 必要なパラメータを検証します (code および system)。

  2. ConceptMap をインスタンス[id]または正規 で解決しますurl。

  3. ソースコードを翻訳し、オプションで指定されたtargetsystem場合に一致をフィルタリングします。

  4. 同等のターゲットコードmatchごとに 1 つずつ、またはマッピングが存在しないresult: false場合は result: trueを返します。

エラー処理

オペレーションは、次のエラー条件を処理します。

  • 400 不正なリクエスト: 無効な$translateリクエスト (非準拠のリクエストまたは必須パラメータの欠落)

  • 404 Not Found: データストアに ConceptMap が見つかりません

注意

このリリースでは、以下はサポートされていません。

  • reverse パラメータ (ターゲットからソースへの逆変換)

  • 複数の ConceptMaps 間の連鎖翻訳

  • $translate クエリに一致する ConceptMap リソースは 10 個を超えるため、最初の 10 個の ConceptMapsからの一致のみが ConceptMap の dateフィールド (最新のもの) 順に返されます。

$translate オペレーション仕様の詳細については、FHIR R4 ConceptMap $translate ドキュメントを参照してください。