Memvalidasi Sumber Daya FHIR dengan $validate - AWS HealthLake
PenggunaanMuatan yang DidukungContohPerilakuMode ValidasiPenanganan Kesalahan

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

Memvalidasi Sumber Daya FHIR dengan $validate

AWS HealthLake sekarang mendukung $validate operasi untuk sumber daya FHIR, memungkinkan Anda untuk memvalidasi sumber daya terhadap spesifikasi FHIR dan memeriksa kesesuaiannya dengan profil tertentu atau definisi sumber daya dasar tanpa melakukan operasi penyimpanan apa pun. Operasi ini sangat berguna ketika Anda perlu:

  • Validasi persyaratan kepatuhan FHIR CMS

  • Uji sumber daya sebelum menggunakannya dalam produksi

  • Berikan umpan balik validasi waktu nyata saat pengguna mengedit data klinis

  • Mengurangi pengiriman data yang tidak valid untuk membuat dan memperbarui APIs

Penggunaan

$validateOperasi dapat dipanggil pada sumber daya FHIR menggunakan metode POST:

Operasi yang Didukung

POST [base]/[type]/[id]/$validate
POST [base]/[type]/$validate

Muatan yang Didukung

Parameter sumber daya

HealthLake mendukung $validate parameter FHIR berikut:

Parameter Jenis Diperlukan Deskripsi
resource Sumber Daya Ya Sumber daya yang akan divalidasi
profile canonical Tidak URL kanonik profil untuk memvalidasi
mode code Tidak Mode validasi:create, atau update
Sumber daya langsung dengan Parameter Kueri

Parameter Jenis Diperlukan Deskripsi
profile canonical Tidak URL kanonik profil untuk memvalidasi
mode code Tidak Mode validasi:create, atau update

Contoh

POST Permintaan Sumber Daya dengan ID dan Parameter payload

POST [base]/Patient/example-patient/$validate
Content-Type: application/fhir+json

{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "resource",
      "resource": {
        "resourceType": "Patient",
        "id": "example-patient",
        "name": [
          {
            "family": "Smith",
            "given": ["John"]
          }
        ],
        "gender": "male",
        "birthDate": "1990-01-01"
      }
    },
    {
      "name": "profile",
      "valueCanonical": "http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient"
    },
    {
      "name": "mode",
      "valueString": "create"
    }
  ]
}
POST Permintaan untuk Jenis Sumber Daya dan Parameter payload

POST [base]/Patient/$validate
Content-Type: application/fhir+json

{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "resource",
      "resource": {
        "resourceType": "Patient",
        "name": [
          {
            "family": "Doe",
            "given": ["Jane"]
          }
        ],
        "gender": "female",
        "birthDate": "1985-05-15"
      }
    },
    {
      "name": "profile",
      "valueCanonical": "http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient"
    },
    {
      "name": "mode",
      "valueString": "update"
    }
  ]
}
POST Permintaan Sumber Daya dengan ID dan muatan sumber daya langsung

POST [base]/Patient/example-patient/$validate?profile=http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient&mode=create
Content-Type: application/fhir+json

{
    "resourceType": "Patient",
    "id": "example-patient",
    "name": [
        {
        "family": "Smith",
        "given": ["John"]
        }
    ],
    "gender": "male",
    "birthDate": "1990-01-01"
}
POST Permintaan untuk Jenis Sumber Daya dan muatan sumber daya langsung

POST [base]/Patient/$validate?profile=http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient&mode=create
Content-Type: application/fhir+json

{
    "resourceType": "Patient",
    "id": "example-patient",
    "name": [
        {
        "family": "Smith",
        "given": ["John"]
        }
    ],
    "gender": "male",
    "birthDate": "1990-01-01"
}
Contoh Respons

Operasi mengembalikan OperationOutcome sumber daya dengan hasil validasi:

{
  "resourceType": "OperationOutcome",
  "issue": [
    {
      "severity": "information",
      "code": "informational",
      "diagnostics": "Validation successful"
    }
  ]
}
Sampel Respon dengan Kesalahan Validasi

{
  "resourceType": "OperationOutcome",
  "issue": [
    {
      "severity": "error",
      "code": "required",
      "details": {
        "text": "Missing required element"
      },
      "diagnostics": "Patient.identifier is required by the US Core Patient profile",
      "location": [
        "Patient.identifier"
      ]
    },
    {
      "severity": "warning",
      "code": "code-invalid",
      "details": {
        "text": "Invalid code value"
      },
      "diagnostics": "The provided gender code is not from the required value set",
      "location": [
        "Patient.gender"
      ]
    }
  ]
}

Perilaku

$validateOperasi:

  1. Memvalidasi sumber daya terhadap spesifikasi FHIR dan definisi sumber daya dasar

  2. Memeriksa kesesuaian dengan profil yang ditentukan saat parameter disediakan profile

  3. Memvalidasi berdasarkan mode yang ditentukan (createatauupdate)

  4. Mengembalikan hasil validasi rinci termasuk kesalahan, peringatan, dan pesan informasi

  5. Tidak melakukan operasi penyimpanan apa pun - hanya validasi

  6. Mengembalikan HTTP 200 OK ketika validasi dapat dilakukan, terlepas dari apakah masalah validasi ditemukan

Mode Validasi

  • create: Memvalidasi sumber daya seolah-olah sedang dibuat (sumber daya baru)

  • update: Memvalidasi sumber daya seolah-olah sedang diperbarui (sumber daya yang ada)

Penanganan Kesalahan

Operasi kembali:

  • 200 OK: Validasi berhasil dilakukan (terlepas dari hasil validasi)

  • 400 Permintaan Buruk: Format atau parameter permintaan tidak valid

  • 404 Tidak Ditemukan: Jenis sumber daya atau profil tidak ditemukan

Untuk informasi selengkapnya tentang spesifikasi $validate operasi, lihat dokumentasi FHIR R4 Resource $validate.