Hapus Massal

'$bulk-delete' memungkinkan Anda menghapus sumber daya dari server FHIR secara asinkron. Operasi penghapusan massal dapat dijalankan pada tingkat sistem atau untuk jenis sumber daya individual.

• Tingkat sistem: Eksekusi operasi di tingkat sistem memungkinkan penghapusan sumber daya FHIR di semua jenis sumber daya di server FHIR.

    DELETE  /$bulkDelete
  

• Jenis sumber daya individual: Eksekusi operasi pada jenis sumber daya individual memungkinkan penghapusan pemetaan sumber daya FHIR ke jenis sumber daya yang ditentukan di url.

    DELETE /<Resource Type>/$bulkDelete
  

Catatan

Penghapusan massal adalah operasi yang akan digunakan dengan hati-hati. Sumber daya dalam layanan FHIR setelah dihapus tidak dapat dikembalikan.

Operasi penghapusan massal saat ini dalam pratinjau publik. Tinjau penafian untuk detailnya.

Penting

API pratinjau dan SDK disediakan tanpa perjanjian tingkat layanan. Kami menyarankan agar Anda tidak menggunakannya untuk beban kerja produksi. Beberapa fitur mungkin tidak didukung, atau mungkin memiliki kemampuan yang dibatasi. Untuk informasi selengkapnya, tinjau Ketentuan Penggunaan Tambahan untuk Pratinjau Microsoft Azure.

Header

Operasi Hapus Massal memerlukan dua parameter header

• Terima: application/fhir+json
• Lebih suka: respons-asinkron

Parameter Kueri:

Parameter kueri memungkinkan Anda memfilter sumber daya mentah yang ingin Anda hapus. Untuk mendukung pemfilteran, parameter kueri layanan FHIR adalah:

Parameter kueri	Nilai Default	Deskripsi
_hardDelete	Salah	Untuk penghapusan sumber daya termasuk versi riwayat, berikan nilai true.
_purgeHistory	Salah	Memungkinkan untuk menghapus versi riwayat yang terkait dengan sumber daya.
Parameter pencarian yang didukung layanan FHIR		Memungkinkan untuk menentukan kriteria pencarian dan sumber daya yang cocok dengan kriteria pencarian dihapus. Contoh: address:contains=Meadow subject:Patient.birthdate=1987-02-20

Semua parameter kueri bersifat opsional.

Respons penghapusan $bulk

Setelah permintaan dibuat untuk menghapus sumber daya FHIR secara massal, sebagai respons, Anda harus menerima header Content-Location dengan URL absolut titik akhir untuk permintaan status berikutnya, seperti titik akhir polling.

Titik akhir polling: Permintaan ke titik akhir polling memiliki salah satu dari empat hasil tergantung pada status pekerjaan penghapusan massal. Hasil disediakan dalam OperationOutcome respons FHIR

1. Pekerjaan sedang berlangsung: Hasil ini menyatakan pekerjaan sedang berlangsung. Kode Status 202
2. Selesai: Hasil ini menyatakan pekerjaan telah berhasil diselesaikan. Setelah selesai, informasi jumlah sumber daya yang dihapus akan disediakan pada tingkat jenis sumber daya individual. Kode status 200
3. Dibatalkan: Pekerjaan status hasil ini dibatalkan oleh pengguna dan memberikan informasi tentang jumlah penghapusan sumber daya pada tingkat jenis sumber daya individual. Kode status 200
4. Gagal: Pekerjaan status hasil ini gagal. Kode status tergantung pada jenis kegagalan.

Contoh permintaan dan respons untuk menentukan permintaan status:

{{fhir_url}}/_operations/bulk-delete/<id>

Sampel respons dari pekerjaan penghapusan yang berhasil diselesaikan.

{
    "resourceType": "Parameters",
    "parameter": [
        {
            "name": "ResourceDeletedCount",
            "part": [
                {
                    "name": "Practitioner",
                    "valueDecimal": 10.0
                },
                {
                    "name": "Specimen",
                    "valueDecimal": 7.0
                },
                {
                    "name": "Device",
                    "valueDecimal": 3.0
                }
            ]
        }
    ]
}

Langkah berikutnya

Dalam artikel ini, Anda mempelajari cara menghapus sumber daya secara massal di layanan FHIR. Untuk informasi tentang fitur FHIR yang didukung, lihat

Fitur FHIR yang didukung

Kemampuan FHIR REST API untuk layanan FHIR Azure Health Data Services

FHIR® adalah merek dagang terdaftar HL7 dan digunakan dengan izin HL7.