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-export`Operasi ini adalah operasi FHIR asinkron yang dapat Anda gunakan untuk mengekspor data perawatan kesehatan. AWS HealthLake Operasi ini mendukung beberapa jenis ekspor, termasuk Atribusi Anggota (ATR), Akses PDex Penyedia Payer-to-Payer, dan Akses Anggota. APIs Ini adalah versi khusus dari `$export` operasi FHIR standar, yang dirancang untuk memenuhi persyaratan panduan DaVinci implementasi. ## Fitur Utama + *Pemrosesan Asinkron: Mengikuti* pola permintaan asinkron FHIR standar + *Ekspor Tingkat Grup: Mengekspor* data untuk anggota dalam sumber daya Grup tertentu + *Beberapa Jenis Ekspor*: Mendukung ATR (Atribusi Anggota), Akses PDex Penyedia Payer-to-Payer, dan Akses Anggota APIs + *Dukungan Profil Komprehensif*: Termasuk US Core, CARIN Blue Button, dan PDex profil + *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 | | --- | --- | --- | | patient | 0.. \* | Anggota tertentu yang datanya akan diekspor. Ketika dihilangkan, semua anggota dalam Grup diekspor. | | \_type | 0.. 1 | Daftar tipe sumber daya FHIR yang dibatasi koma untuk diekspor. Saat dihilangkan, semua jenis sumber daya yang didukung untuk jenis ekspor yang ditentukan disertakan. Untuk ekspor ATR, ini default ke 8 jenis sumber daya atribusi. Untuk PDex ekspor, ini mencakup semua jenis sumber daya atribusi ditambah jenis sumber daya klinis dan klaim dari US Core, CARIN Blue Button, dan profil. PDex | | \_since | 0.. 1 | Hanya sertakan sumber daya yang diperbarui setelah tanggal dan waktu ini. | | \_until | 0.. 1 | Hanya sertakan sumber daya yang diperbarui sebelum tanggal dan waktu ini. | | exportType | 0.. 1 | Jenis ekspor yang akan dilakukan. Nilai yang valid:hl7.fhir.us.davinci-atr,hl7.fhir.us.davinci-pdex,hl7.fhir.us.davinci-pdex.p2p,hl7.fhir.us.davinci-pdex.member. Default: hl7.fhir.us.davinci-atr. | | \_includeEOB2xWoFinancial | 0.. 1 | Menentukan apakah akan menyertakan ExplanationOfBenefit sumber daya CARIN BB 2.x dengan data keuangan dihapus. Default: false. | | \_security | 0.. \* | Filter sumber daya yang diekspor dengan nilai meta.security Coding. Gunakan system\|code format (karakter pipa harus dikodekan URL sebagai). %7C Ketika beberapa nilai disediakan, sumber daya harus cocok dengan semuanya (DAN semantik). Gunakan system\| (trailing pipe, no code) untuk mencocokkan kode apa pun dari sistem tertentu. | | \_tag | 0.. \* | Filter sumber daya yang diekspor dengan nilai meta.tag Coding. Menggunakan system\|code format yang sama dan dan semantik sebagai. \_security Ketika keduanya \_security dan \_tag ditentukan, sumber daya harus cocok dengan kedua filter. | ### Jenis Sumber Daya yang Didukung Jenis sumber daya yang didukung bergantung pada jenis ekspor yang Anda tentukan. Untuk ekspor ATR, jenis sumber daya berikut didukung: + `Group` + `Patient` + `Coverage` + `RelatedPerson` + `Practitioner` + `PractitionerRole` + `Organization` + `Location` Untuk PDex ekspor (Akses Penyedia Payer-to-Payer, dan Akses Anggota), semua jenis sumber daya klinis dan klaim didukung selain jenis sebelumnya. Untuk daftar lengkap jenis sumber daya yang didukung, lihat [Panduan Implementasi Inti AS (STU 6.1), Panduan Implementasi](https://hl7.org/fhir/us/core/STU6.1/) [Tombol Biru CARIN, dan Panduan Implementasi](https://hl7.org/fhir/us/carin-bb/) Dukungan [Otorisasi Sebelumnya Da Vinci](https://hl7.org/fhir/us/davinci-pas/). ## Jenis Ekspor `$davinci-data-export`Operasi ini mendukung jenis ekspor berikut. Anda menentukan jenis ekspor dengan menggunakan `exportType` parameter. | Jenis Ekspor | Tujuan | Lingkup Data | Batas Temporal | | --- | --- | --- | --- | | hl7.fhir.us.davinci-atr | Daftar Atribusi Anggota | Sumber daya terkait atribusi | Tidak ada | | hl7.fhir.us.davinci-pdex | API Akses Penyedia | Data klinis dan klaim untuk pasien yang dikaitkan | 5 tahun | | hl7.fhir.us.davinci-pdex.p2p | Payer-to-Payer Pertukaran | Data anggota historis untuk transisi asuransi | 5 tahun | | hl7.fhir.us.davinci-pdex.member | API Akses Anggota | Data kesehatan anggota sendiri | 5 tahun | **catatan** Untuk PDex ekspor, batas temporal 5 tahun tidak berlaku untuk jenis sumber daya ATR (`Group`,,,`Patient`,`Coverage`, `RelatedPerson` `Practitioner``PractitionerRole`,`Organization`). `Location` Sumber daya ini selalu disertakan tanpa memandang usia. ### ATR (hl7.fhir.us.davinci-atr) Dengan tipe ekspor ATR, Anda dapat mengekspor data Daftar Atribusi Anggota. Gunakan jenis ekspor ini untuk mengambil sumber daya terkait atribusi bagi anggota dalam Grup. Untuk informasi lebih lanjut, lihat Operasi [Ekspor ATR Da Vinci](https://build.fhir.org/ig/HL7/davinci-atr/OperationDefinition-davinci-data-export.html). Jenis Sumber Daya yang Didukung `Group`, `Patient`, `Coverage`, `RelatedPerson`, `Practitioner`, `PractitionerRole`, `Organization`, `Location` Penyaringan Temporal Tidak ada penyaringan temporal yang diterapkan. Semua sumber daya yang cocok diekspor terlepas dari tanggal. ### PDex Jenis Ekspor Semua jenis PDex ekspor berbagi profil yang didukung dan logika pemfilteran yang sama. Untuk informasi selengkapnya, lihat [Da Vinci PDex Provider Access API](https://build.fhir.org/ig/HL7/davinci-epdx/provider-access-api.html). Profil berikut didukung: + US Core 3.1.1, 6.1.0, dan 7.0.0 + PDex Otorisasi Sebelumnya (tidak didukung untuk Akses Anggota) + CARIN BB 2.x Profil dasar: Institusional Rawat Inap, Kelembagaan Rawat Jalan, Profesional, Lisan, Farmasi NonClinician Untuk PDex ekspor, sumber daya klinis dan klaim secara otomatis ditemukan untuk setiap pasien dalam Grup. Anda tidak perlu secara eksplisit mereferensikan sumber daya ini di sumber daya Grup. Operasi mencari semua sumber daya kompartemen pasien (seperti`Observation`,,,`Condition`, `Coverage` `RelatedPerson``MedicationRequest`, dan`ExplanationOfBenefit`) milik pasien yang dikaitkan. Hanya`Patient`,`Group`, dan tipe non-patient-compartment ATR (`Practitioner`,, `PractitionerRole``Organization`,`Location`) yang memerlukan referensi eksplisit dalam Grup. Akses Penyedia (`hl7.fhir.us.davinci-pdex`) Memungkinkan penyedia dalam jaringan untuk mengambil data pasien untuk pasien yang dikaitkan. Payer-to-Payer (`hl7.fhir.us.davinci-pdex.p2p`) Memungkinkan pertukaran data antara pembayar ketika pasien mengubah asuransi. Akses Anggota (`hl7.fhir.us.davinci-pdex.member`) Memungkinkan anggota untuk mengakses data kesehatan mereka sendiri. Jenis ekspor ini dapat mencakup data keuangan dalam sumber klaim. ## Dukungan Profil dan Logika Inklusi Untuk PDex ekspor, `$davinci-data-export` operasi menggunakan deklarasi profil dalam `meta.profile` elemen untuk menentukan sumber daya mana yang akan disertakan dalam ekspor. ### ExplanationOfBenefit Penanganan Sumber Daya `ExplanationOfBenefit`(EOB) sumber daya dimasukkan atau dikecualikan dari PDex ekspor berdasarkan deklarasinya`meta.profile`: + ExplanationOfBenefit sumber daya dengan profil CARIN BB 1.x dikecualikan dari ekspor. + ExplanationOfBenefit sumber daya tanpa `meta.profile` set dikecualikan dari ekspor. + ExplanationOfBenefit sumber daya dengan profil CARIN BB 2.x Basis selalu disertakan. + ExplanationOfBenefit sumber daya dengan profil CARIN BB 2.x yang berisi data keuangan dikecualikan secara default. Ketika `_includeEOB2xWoFinancial=true` diatur, mereka disertakan dengan data keuangan yang dilucuti dan sumber daya diubah ke profil Basis yang sesuai. + ExplanationOfBenefit sumber daya dengan profil Otorisasi PDex Sebelumnya selalu disertakan. ### Transformasi Data Keuangan Ketika Anda mengatur`_includeEOB2xWoFinancial=true`, operasi mengubah ExplanationOfBenefit sumber daya [CARIN BB 2.x](https://hl7.org/fhir/us/carin-bb/) ke profil Basis yang sesuai dengan menghapus data keuangan. Misalnya, `C4BB ExplanationOfBenefit Oral` sumber daya diubah menjadi`C4BB ExplanationOfBenefit Oral Basis`, yang menghapus data keuangan dari catatan per spesifikasi FHIR. Elemen data keuangan berikut dihapus selama transformasi: + Semua mengiris elemen `total` + Semua `adjudication` elemen dengan `amounttype` irisan + Semua `item.adjudication` elemen dengan informasi jumlah Operasi ini juga memperbarui metadata profil selama transformasi: + `meta.profile`diperbarui ke URL kanonik profil Dasar + Versi diperbarui ke versi CARIN BB 2.x Basis + Sumber daya yang ada di penyimpanan data tidak dimodifikasi + Sumber daya yang diekspor tidak disimpan kembali ke penyimpanan data ### Aturan Deteksi Profil Operasi menggunakan aturan berikut untuk mendeteksi dan memvalidasi profil: + Deteksi versi didasarkan pada `meta.profile` kanonik URLs + Sumber daya disertakan jika ADA profil yang dideklarasikan sesuai dengan kriteria ekspor + Validasi profil terjadi selama pemrosesan ekspor ## Penyaringan Temporal Lima Tahun untuk Ekspor PDex Untuk semua jenis PDex ekspor, HealthLake terapkan filter temporal 5 tahun berdasarkan kapan sumber daya terakhir diperbarui. Filter temporal berlaku untuk semua sumber daya kecuali jenis sumber daya atribusi inti berikut, yang selalu diekspor tanpa memandang usia: + `Patient` + `Coverage` + `Organization` + `Practitioner` + `PractitionerRole` + `RelatedPerson` + `Location` + `Group` Sumber daya administratif dan demografis ini dikecualikan karena menyediakan konteks penting untuk data yang diekspor. Ekspor ATR tidak tunduk pada penyaringan temporal apa pun. ## Sampel Permintaan Contoh berikut menunjukkan cara memulai pekerjaan ekspor untuk berbagai jenis ekspor. *Ekspor ATR* ``` GET https://healthlake.{region}.amazonaws.com/datastore/{datastoreId}/r4/Group/example-group/$davinci-data-export?_type=Group,Patient,Coverage,Practitioner,Organization&exportType=hl7.fhir.us.davinci-atr POST https://healthlake.{region}.amazonaws.com/datastore/{datastoreId}/r4/Group/example-group/$davinci-data-export?_type=Group,Patient,Coverage,Practitioner,Organization&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" } } } ``` *Ekspor Akses Penyedia dengan penghapusan data ExplanationOfBenefit keuangan* ``` GET https://healthlake.{region}.amazonaws.com/datastore/{datastoreId}/r4/Group/example-group/$davinci-data-export?_type=Patient,Observation,Condition,MedicationRequest,ExplanationOfBenefit&exportType=hl7.fhir.us.davinci-pdex&_includeEOB2xWoFinancial=true ``` *Payer-to-Payer ekspor* ``` GET https://healthlake.{region}.amazonaws.com/datastore/{datastoreId}/r4/Group/example-group/$davinci-data-export?_type=Patient,Coverage,ExplanationOfBenefit,Condition,Procedure&exportType=hl7.fhir.us.davinci-pdex.p2p&_includeEOB2xWoFinancial=true ``` *Ekspor Akses Anggota untuk pasien tertentu* ``` GET https://healthlake.{region}.amazonaws.com/datastore/{datastoreId}/r4/Group/example-group/$davinci-data-export?_type=Patient,Observation,Condition,ExplanationOfBenefit,MedicationRequest&exportType=hl7.fhir.us.davinci-pdex.member&patient=Patient/example-patient-id ``` ## 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) ``` **catatan** Diagram hubungan sumber daya sebelumnya berlaku untuk ekspor ATR. Untuk PDex ekspor, sumber daya klinis dan klaim secara otomatis ditemukan melalui pencarian pasien dan tidak memerlukan referensi eksplisit dalam sumber daya Grup. ### Sumber Sumber Daya | Sumber daya | Lokasi Sumber | Deskripsi | | --- | --- | --- | | Patient | Group.member.entity | Pasien yang menjadi anggota daftar atribusi | | Coverage | Group.member.extension:coverageReference | Cakupan yang mengakibatkan keanggotaan pasien | | Organization | Group.member.extension:attributedProvider | Organizations yang dikaitkan dengan pasien | | Practitioner | Group.member.extension:attributedProvider | Praktisi individu yang dikaitkan dengan pasien | | PractitionerRole | Group.member.extension:attributedProvider | Peran praktisi yang dikaitkan dengan pasien | | RelatedPerson | Coverage.subscriber | Pelanggan cakupan | | Location | PractitionerRole.location | Lokasi yang terkait dengan peran praktisi | | Group | 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 Peran IAM yang ditentukan dalam `DataAccessRoleArn` tidak memiliki izin yang cukup untuk melakukan operasi ekspor. Untuk daftar lengkap izin S3 dan KMS yang diperlukan, lihat [Menyiapkan izin untuk pekerjaan ekspor](getting-started-setting-up.md#setting-up-export-permissions). Kesalahan Validasi Parameter + `patient`Parameter tidak diformat sebagai `Patient/id,Patient/id,...` + Satu atau lebih referensi pasien tidak valid atau bukan milik Grup yang ditentukan + Nilai `exportType` parameter bukan jenis ekspor yang didukung + `_type`Parameter berisi jenis sumber daya yang tidak didukung untuk jenis ekspor yang ditentukan + `_type`Parameter tidak memiliki tipe sumber daya yang diperlukan (`Group``Patient`,,`Coverage`) untuk jenis `hl7.fhir.us.davinci-atr` ekspor + Nilai `_includeEOB2xWoFinancial` parameter bukan boolean yang valid Kesalahan Validasi Sumber Daya + Sumber daya Grup yang ditentukan tidak ada di penyimpanan data + Sumber daya Grup yang ditentukan tidak memiliki anggota + Satu atau lebih anggota Grup mereferensikan sumber daya Pasien yang tidak ada di penyimpanan data ## Keamanan dan Otorisasi + Mekanisme otorisasi FHIR standar berlaku + Peran akses data harus memiliki izin IAM yang diperlukan untuk operasi S3 dan KMS. Untuk daftar lengkap izin yang diperlukan, lihat [Menyiapkan izin untuk pekerjaan ekspor](getting-started-setting-up.md#setting-up-export-permissions). ## 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 + *Kesadaran Filter Temporal*: Untuk PDex ekspor, pertimbangkan filter temporal 5 tahun saat Anda memilih jenis sumber daya + *Penghapusan Data Keuangan*: Gunakan `_includeEOB2xWoFinancial=true` saat Anda membutuhkan data klaim tanpa informasi keuangan + *Manajemen Profil*: Pastikan sumber daya memiliki deklarasi profil yang sesuai, validasi terhadap profil target sebelum konsumsi, dan gunakan versi profil untuk mengontrol perilaku ekspor ## Batasan + Maksimal 500 pasien dapat ditentukan dalam `patient` parameter + Ekspor terbatas hanya untuk operasi tingkat Grup + Hanya mendukung kumpulan tipe sumber daya yang telah ditentukan untuk setiap jenis ekspor + Output selalu dalam format NDJSON + PDex Ekspor dibatasi hingga 5 tahun data klinis dan klaim + Transformasi data keuangan hanya berlaku untuk profil CARIN BB 2.x ExplanationOfBenefit ## Sumber Daya Tambahan + [Daftar Atribusi Anggota Da Vinci IG](https://build.fhir.org/ig/HL7/davinci-atr/) + [Da Vinci Payer Data Exchange IG](https://hl7.org/fhir/us/davinci-pdex/) + [CARIN IG Pertukaran Data Exchange Pembayar yang Diarahkan Konsumen](https://build.fhir.org/ig/HL7/carin-bb/) + [Panduan Implementasi Inti AS](https://www.hl7.org/fhir/us/core/) + [Spesifikasi Akses Data Massal FHIR](https://hl7.org/fhir/uv/bulkdata/)