View a markdown version of this page

Memetakan Kode Antar Terminologi dengan $translate - AWS HealthLake
PenggunaanParameter yang DidukungContohParameter ResponPerilakuPenanganan KesalahanPeringatan

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Memetakan Kode Antar Terminologi dengan $translate

AWS HealthLake mendukung $translate operasi untuk ConceptMap sumber daya, memungkinkan Anda untuk memetakan kode dari satu sistem kode ke kode yang setara di yang lain menggunakan yang telah ConceptMaps Anda konsumsi ke penyimpanan data Anda. Operasi ini sangat berguna ketika Anda perlu:

  • Kode peta antar terminologi (misalnya, ICD-10-CM ke SNOMED CT)

  • Menormalkan data masuk ke sistem kode kanonik

  • Mendukung interoperabilitas di seluruh sistem yang menggunakan terminologi yang berbeda

  • Jalankan analisis data klinis dengan menstandarkan terminologi sumber heterogen

Penggunaan

$translateOperasi dapat dipanggil pada ConceptMap sumber daya menggunakan metode GET dan POST:

Operasi yang Didukung

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

Parameter yang Didukung

HealthLake mendukung subset parameter FHIR R4: $translate

Parameter Tipe Diperlukan Deskripsi
code code Ya Kode sumber untuk diterjemahkan
system type Ya Sistem kode milik kode
url type Tidak URL kanonik khusus ConceptMap untuk diterjemahkan
source type Tidak Membatasi peta yang set nilai sumbernya sama dengan URI ini
target type Tidak Membatasi peta yang nilai targetnya ditetapkan sama dengan URI ini
targetsystem type Tidak Membatasi kecocokan ke kode target dalam sistem kode ini
catatan

targetParam url etersource,, dan adalah filter cakupan yang hanya berlaku untuk pemanggilan tingkat tipe ()[base]/ConceptMap/$translate. Pada instance invocation (ConceptMap/[id]/$translate) mereka diabaikan, hanya saja codesystem, dan mulai targetsystem berlaku.

Contoh

DAPATKAN Permintaan (dengan ConceptMap ID)

GET [base]/ConceptMap/example-conceptmap/$translate?system=http://snomed.info/sct&code=44054006
DAPATKAN Permintaan (dengan URL kanonik)

GET [base]/ConceptMap/$translate?url=http://example.com/ConceptMap/sct-to-icd10&system=http://snomed.info/sct&code=44054006
Permintaan 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"
    }
  ]
}
Contoh Respons

Operasi mengembalikan sumber Parameters daya. resultParameter menunjukkan apakah kecocokan ditemukan. Masing-masing match berisi target concept danequivalence:

{
  "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"
          }
        }
      ]
    }
  ]
}

Parameter Respon

Responsnya mencakup parameter berikut:

Parameter Jenis Deskripsi
result boolean Apakah kecocokan ditemukan
match BackboneElement Sebuah kecocokan ditemukan di ConceptMap
match.equivalence code Tingkat kesetaraan antara konsep sumber dan target
match.concept Pengkodean Konsep target (termasuk sistem, kode, dan tampilan)

Perilaku

$translateOperasi:

  1. Memvalidasi parameter yang diperlukan (codedansystem).

  2. Menyelesaikan ConceptMap berdasarkan contoh [id] atau dengan kanonikurl.

  3. Menerjemahkan kode sumber, secara opsional memfilter kecoco targetsystem kan saat disediakan.

  4. Meng result: true embalikan dengan satu match per kode target yang setara, atau result: false ketika tidak ada pemetaan.

Penanganan Kesalahan

Operasi menangani kondisi kesalahan berikut:

  • 400 Permintaan Buruk: Per $translate mintaan tidak valid (permintaan tidak sesuai atau parameter yang diperlukan hilang)

  • 404 Tidak Ditemukan: ConceptMap tidak ditemukan di datastore

Peringatan

Untuk rilis ini, berikut ini tidak didukung:

  • reverseparameter (terjemahan terbalik dari target ke sumber)

  • Terjemahan beranTAI di beberapa ConceptMaps

  • Karena lebih dari 10 ConceptMap sumber daya dapat cocok dengan ku $translate eri, hanya kecocokan dari 10 ConceptMaps yang pertama yang dikembalikan, diur ConceptMap utkan date berdasarkan bidang (yang terbaru pertama).

Untuk informasi selengkapnya tentang spesifikasi $translate operasi, lihat dokumentasi FHIR R4 ConceptMap $translate.