Kebijakan penerapan versi dan manajemen riwayat
Kebijakan penerapan versi dalam layanan FHIR Azure Health Data Services adalah konfigurasi, yang menentukan bagaimana riwayat disimpan untuk setiap jenis sumber daya dengan opsi untuk konfigurasi spesifik sumber daya. Kebijakan ini terkait langsung dengan konsep pengelolaan riwayat untuk sumber daya FHIR.
Riwayat dalam FHIR
Riwayat dalam FHIR memberi Anda kemampuan untuk melihat semua versi sumber daya sebelumnya. Riwayat dalam FHIR dapat dikueri pada tingkat sumber daya, tingkat jenis, atau tingkat sistem. Dokumentasi HL7 FHIR memiliki informasi lebih lanjut tentang interaksi riwayat. Riwayat berguna dalam skenario di mana Anda ingin melihat evolusi sumber daya di FHIR atau jika Anda ingin melihat informasi sumber daya pada titik waktu tertentu.
Semua versi sumber daya sebelumnya dianggap usang dan versi sumber daya saat ini harus digunakan untuk operasi alur kerja bisnis normal. Namun, dapat berguna untuk melihat status sumber daya sebagai titik waktu ketika keputusan sebelumnya dibuat.
Kebijakan penerapan versi
Kebijakan penerapan versi dalam layanan FHIR memungkinkan Anda memutuskan bagaimana riwayat disimpan baik pada tingkat layanan FHIR atau pada tingkat sumber daya tertentu.
Ada tiga tingkat yang berbeda untuk kebijakan penerapan versi:
-
versioned: Riwayat disimpan untuk operasi pada sumber daya. Versi sumber daya dinaikkan. Ini adalah default. -
version-update: Riwayat disimpan untuk operasi pada sumber daya. Versi sumber daya dinaikkan. Updates memerlukan header yang validIf-Match. Untuk informasi selengkapnya, lihat VersionedUpdateExample.http. -
no-version: Riwayat tidak dibuat untuk sumber daya. Versi sumber daya dinaikkan.
Kebijakan penerapan versi tersedia untuk dikonfigurasi sebagai pengaturan di seluruh sistem dan juga untuk mengambil alih pada tingkat sumber daya. Pengaturan seluruh sistem digunakan untuk semua sumber daya dalam layanan FHIR Anda, kecuali kebijakan penerapan versi tingkat sumber daya tertentu telah ditambahkan.
Perbandingan kebijakan penerapan versi
| Nilai Kebijakan | Perilaku Riwayat |
meta.versionId Perilaku Pembaruan |
Default |
|---|---|---|---|
versioned |
Riwayat disimpan | If-Match tidak diperlukan | Ya |
version-update |
Riwayat disimpan | If-Match diperlukan | Tidak |
no-version |
Riwayat tidak disimpan | If-Match tidak diperlukan | Tidak |
Catatan
Mengubah kebijakan penerapan versi menjadi no-version tidak berpengaruh pada riwayat sumber daya yang ada. Jika riwayat perlu dihapus untuk sumber daya, gunakan operasi riwayat $purge .
Mengonfigurasi kebijakan penerapan versi
Untuk mengonfigurasi kebijakan penerapan versi, pilih bilah Konfigurasi Kebijakan Penerapan Versi di dalam layanan FHIR Anda.
Setelah menelusuri Konfigurasi Kebijakan Penerapan Versi, Anda akan dapat mengonfigurasi pengaturan di tingkat sistem dan tingkat sumber daya (sebagai penimpaan tingkat sistem). Konfigurasi tingkat sistem (dianotasikan sebagai 1) akan berlaku untuk setiap sumber daya dalam layanan FHIR Anda kecuali penggantian spesifik sumber daya (dianotasikan pada 2) telah dikonfigurasi.
Saat mengonfigurasi konfigurasi tingkat sumber daya, Anda akan dapat memilih jenis sumber daya FHIR (dianotasikan sebagai 1) dan kebijakan penerapan versi tertentu untuk sumber daya khusus ini (dianotasikan sebagai 2). Pastikan untuk memilih tombol Tambahkan (diannotasikan sebagai 3) untuk mengantre pengaturan ini untuk menyimpan.
Pastikan untuk memilih Simpan setelah Anda menyelesaikan konfigurasi kebijakan penerapan versi.
Manajemen riwayat
Riwayat di FHIR penting bagi pengguna akhir untuk melihat bagaimana sumber daya telah berubah dari waktu ke waktu. Ini juga berguna dalam koordinasi dengan log audit untuk melihat status sumber daya sebelum dan sesudah pengguna memodifikasinya. Secara umum, disarankan untuk menyimpan riwayat untuk sumber daya kecuali Anda tahu bahwa riwayat tidak diperlukan. Pembaruan sumber daya yang sering dapat menghasilkan sejumlah besar penyimpanan data, yang dapat tidak diinginkan dalam layanan FHIR dengan sejumlah besar data.
Mengubah kebijakan penerapan versi baik di tingkat sistem atau tingkat sumber daya tidak akan menghapus riwayat yang ada untuk sumber daya apa pun di layanan FHIR Anda. Jika Anda ingin mengurangi ukuran data riwayat dalam layanan FHIR, Anda harus menggunakan operasi riwayat $purge .
Langkah berikutnya
Dalam artikel ini, Anda mempelajari cara menghapus menyeluruh riwayat untuk sumber daya dalam layanan FHIR. Untuk informasi selengkapnya tentang cara menonaktifkan riwayat dan beberapa konsep tentang manajemen riwayat, lihat
FHIR® adalah merek dagang terdaftar HL7 dan digunakan dengan izin HL7.