Operasi FHIR R4 $davinci-data-export untuk HealthLake - AWS HealthLake
Fitur UtamaTitik Akhir OperasiParameter PermintaanPermintaan SampelHubungan Sumber DayaManajemen JobFormat OutputPenanganan KesalahanKeamanan dan OtorisasiPraktik TerbaikBatasan

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

Operasi FHIR R4 $davinci-data-export untuk HealthLake

$davinci-data-exportOperasi ini adalah operasi FHIR asinkron yang memungkinkan ekspor data Daftar Atribusi Anggota dari. AWS HealthLake Operasi ini adalah versi khusus dari $export operasi FHIR standar, yang dirancang khusus untuk memenuhi persyaratan Panduan Implementasi Daftar Atribusi DaVinci Anggota (ATR).

Fitur Utama

  • Pemrosesan Asinkron: Mengikuti pola permintaan asinkron FHIR standar

  • Ekspor Tingkat Grup: Mengekspor data untuk anggota dalam daftar atribusi tertentu (Grup)

  • Penanganan Sumber Daya Khusus: Berfokus pada sumber daya terkait atribusi

  • Penyaringan Fleksibel: Mendukung penyaringan oleh pasien, jenis sumber daya, dan rentang waktu

  • Output NDJSON: Menyediakan data dalam format JSON yang dibatasi baris baru

Titik Akhir Operasi

GET  [base]/Group/[id]/$davinci-data-export
POST [base]/Group/[id]/$davinci-data-export

Parameter Permintaan

Parameter Kardinalitas Deskripsi
sabar 0.. * Anggota tertentu yang datanya harus diekspor. Ketika dihilangkan, semua anggota di Grup diekspor
_ketik 0.. 1 Daftar tipe sumber daya FHIR yang dibatasi koma untuk diekspor
_sejak 0.. 1 Hanya sertakan sumber daya yang diperbarui setelah tanggal/waktu ini
ExportType 0.. 1 Jenis ekspor yang akan dilakukan (default: hl7.fhir.us.davinci-atr)

Jenis Sumber Daya yang Didukung

Saat menggunakan _type parameter, hanya jenis sumber daya berikut yang didukung:

  • Kelompok

  • Pasien

  • Cakupan

  • RelatedPerson

  • Praktisi

  • PractitionerRole

  • Organisasi

  • Lokasi

Permintaan Sampel

Memulai Job Ekspor

GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Group/example-group/$davinci-data-export?_type=Group,Patient,Coverage&exportType=hl7.fhir.us.davinci-atr

or

POST https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Group/example-group/$davinci-data-export?_type=Group,Patient,Coverage&exportType=hl7.fhir.us.davinci-atr
Content-Type: application/json

{
  "DataAccessRoleArn": "arn:aws:iam::444455556666:role/your-healthlake-service-role",
  "JobName": "attribution-export-job",
  "OutputDataConfig": {
    "S3Configuration": {
      "S3Uri": "s3://your-export-bucket/EXPORT-JOB",
      "KmsKeyId": "arn:aws:kms:region:444455556666:key/1234abcd-12ab-34cd-56ef-1234567890ab"
    }
  }
}

Contoh Respons

{
  "datastoreId": "eaee622d8406b41eb86c0f4741201ff9",
  "jobStatus": "SUBMITTED",
  "jobId": "48d7b91dae4a64d00d54b70862f33f61"
}

Hubungan Sumber Daya

Operasi mengekspor sumber daya berdasarkan hubungan mereka dalam Daftar Atribusi Anggota:

Group (Attribution List)
├── Patient (Members)
├── Coverage → RelatedPerson (Subscribers)
├── Practitioner (Attributed Providers)
├── PractitionerRole → Location
└── Organization (Attributed Providers)

Sumber Sumber Daya

Sumber daya Lokasi Sumber Deskripsi
Pasien Group.member.entity Pasien yang menjadi anggota daftar atribusi
Cakupan Group.member.extension:CoverageReference Cakupan yang mengakibatkan keanggotaan pasien
Organisasi group.member.extension:AttributedProvider Organizations pasien dikaitkan dengan
Praktisi group.member.extension:AttributedProvider Praktisi individu pasien dikaitkan dengan
PractitionerRole group.member.extension:AttributedProvider Peran praktisi pasien dikaitkan dengan
RelatedPerson Liputan.Subscriber Pelanggan cakupan
Lokasi PractitionerRole.lokasi Lokasi yang terkait dengan peran praktisi
Kelompok Titik akhir masukan Daftar atribusi itu sendiri

Manajemen Job

Periksa Status Job

GET [base]/export/[job-id]

Batalkan Tugas

DELETE [base]/export/[job-id]

Siklus Hidup Tugas

  • SUBMITTED- Job telah diterima dan diantrian

  • IN_PROGRESS- Job sedang aktif memproses

  • COMPLETED- Job selesai dengan sukses, file tersedia untuk diunduh

  • FAILED- Job mengalami kesalahan

Format Output

  • Format File: NDJSON (JSON Terbatas Baris Baru)

  • Organisasi File: File terpisah untuk setiap jenis sumber daya

  • Ekstensi File: .ndjson

  • Lokasi: Bucket dan jalur S3 yang ditentukan

Penanganan Kesalahan

Operasi mengembalikan HTTP 400 Bad Request dengan OperationOutcome untuk kondisi berikut:

Kesalahan Otorisasi

  • Izin tidak valid atau tidak memadai untuk akses data

  • Masalah akses bucket S3

  • Masalah akses kunci KMS

Kesalahan Validasi Parameter

  • patientparameter tidak diformat sebagai "Patient/id,Patient/id,...”

  • Referensi pasien tidak valid atau pasien yang bukan bagian dari Grup

  • exportTypenilai selain hl7.fhir.us.davinci-atr

  • _typeparameter yang berisi jenis sumber daya yang tidak didukung

  • _typeparameter tidak ada tipe minimum yang diperlukan (Grup, Pasien, Cakupan) untuk ExportType hl7.fhir.us.davinci-atr

Kesalahan Validasi Sumber Daya

  • Sumber daya Grup yang Diminta tidak ada

  • Grup memiliki daftar anggota kosong

  • Anggota grup tidak mereferensikan sumber daya Pasien yang valid

Keamanan dan Otorisasi

  • Mekanisme otorisasi FHIR standar berlaku

  • Klien harus memiliki izin baca yang sesuai untuk Grup dan sumber daya terkait

  • Izin tulis bucket S3 yang diperlukan untuk lokasi keluaran

  • Izin kunci KMS diperlukan jika enkripsi ditentukan

Praktik Terbaik

  • Pemilihan Jenis Sumber Daya: Hanya minta jenis sumber daya yang Anda perlukan untuk meminimalkan ukuran ekspor dan waktu pemrosesan

  • Penyaringan Berbasis Waktu: Gunakan _since parameter untuk ekspor tambahan

  • Penyaringan Pasien: Gunakan patient parameter saat Anda hanya membutuhkan data untuk anggota tertentu

  • Job Monitoring: Secara teratur memeriksa status pekerjaan untuk ekspor besar

  • Penanganan Kesalahan: Menerapkan logika coba lagi yang tepat untuk pekerjaan yang gagal

Batasan

  • Maksimal 512 pasien dapat ditentukan dalam parameter patient

  • Ekspor terbatas hanya untuk operasi tingkat Grup

  • Hanya mendukung kumpulan tipe sumber daya terkait atribusi yang telah ditentukan sebelumnya

  • Output selalu dalam format NDJSON