Menggunakan Patient-everything dalam layanan FHIR

Operasi Pasien-semuanya digunakan untuk memberikan tampilan semua sumber daya yang terkait dengan pasien. Operasi ini dapat berguna untuk memberikan akses pasien ke seluruh catatan mereka, atau bagi penyedia atau pengguna lain untuk melakukan unduhan data massal yang terkait dengan pasien. Menurut spesifikasi Fast Healthcare Interoperability Resources (FHIR®), Patient-everything mengembalikan semua informasi yang terkait dengan satu atau beberapa pasien yang dijelaskan dalam sumber daya atau konteks tempat operasi ini dipanggil. Dalam layanan FHIR di Azure Health Data Services, Semuanya tersedia untuk menarik data yang terkait dengan pasien tertentu.

Gunakan Semua Tentang Pasien

Untuk memanggil Patient-everything, gunakan perintah berikut:

GET {FHIRURL}/Patient/{ID}/$everything

Nota

Anda harus menentukan ID untuk pasien tertentu. Jika Anda memerlukan semua data untuk semua pasien, lihat $export.

Layanan FHIR memvalidasi bahwa ia dapat menemukan pasien yang cocok dengan ID pasien yang disediakan. Jika hasil ditemukan, responsnya adalah bundel jenis searchset dengan informasi berikut:

• Sumber daya pasien.
• Sumber daya yang langsung dirujuk oleh sumber daya pasien
• Jika ada seealso referensi tautan ke pasien lain, hasilnya termasuk operasi Pasien-semuanya terhadap pasien yang seealso tercantum.
• Sumber daya di Kompartemen Pasien.
• Sumber daya perangkat yang mereferensikan sumber daya pasien.

Nota

Hingga 100 perangkat pertama yang ditautkan ke pasien akan dikembalikan.

Parameter untuk semua pasien

Layanan FHIR mendukung parameter kueri berikut. Semua parameter ini bersifat opsional.

Parameter pencarian	Deskripsi
_jenis	Memungkinkan Anda menentukan jenis sumber daya mana yang akan disertakan dalam respons. Misalnya, _type=Encounter akan mengembalikan hanya Encounter sumber daya yang terkait dengan pasien.
_sejak	Hanya akan mengembalikan sumber daya yang telah dimodifikasi sejak waktu yang disediakan.
mulai	Menentukan tanggal mulai akan menampilkan sumber daya dengan tanggal klinis setelah tanggal mulai yang ditetapkan. Jika tidak ada tanggal mulai yang disediakan, semua rekaman sebelum tanggal akhir berada dalam cakupan.
akhir	Menentukan tanggal berakhir menghimpun sumber daya di mana tanggal klinisnya sebelum tanggal berakhir yang ditentukan. Jika tidak ada tanggal selesai yang disediakan, semua rekaman setelah tanggal mulai berada dalam cakupan.

Nota

Implementasi Patient-everything ini tidak mendukung parameter _count.

Memproses tautan pasien

Pada sumber daya pasien, ada elemen yang disebut tautan, yang menghubungkan pasien dengan pasien lain atau orang terkait. Pasien yang ditautkan ini membantu memberikan pandangan holistik tentang pasien asli. Referensi tautan dapat digunakan ketika pasien mengganti pasien lain atau ketika dua sumber daya pasien memiliki informasi pelengkap. Satu kasus penggunaan untuk tautan adalah ketika pesan ADT 38 atau 39 HL7v2 datang. Ini menjelaskan pembaruan mengenai pasien. Pembaruan ini dapat disimpan sebagai referensi antara dua pasien dalam elemen tautan.

Spesifikasi FHIR memiliki gambaran umum terperinci tentang berbagai jenis tautan pasien, tetapi di sini kami menyertakan ringkasan tingkat tinggi:

• replaces - Sumber daya Pasien menggantikan Pasien yang berbeda.
• rujuk - Pasien valid, tetapi tidak dianggap sebagai sumber informasi utama. Arahkan ke pasien lain untuk mengambil informasi tambahan.
• seealso - Pasien berisi tautan ke pasien lain yang sama validnya.
• digantikan oleh - Sumber daya Pasien digantikan oleh Pasien yang berbeda.

Detail tautan semua hal tentang pasien

Operasi Pasien-semuanya dalam layanan FHIR memproses tautan pasien dengan cara yang berbeda untuk memberi Anda pandangan pasien yang paling holistik.

Nota

Tautan juga dapat mereferensikan RelatedPerson. Saat ini, RelatedPerson sumber daya tidak diproses dalam Patient-everything dan tidak dikembalikan dalam bundel.

Saat ini, tautan pengganti dan tautan referensi disertakan dalam operasi Patient-everything sebagai bagian dari pasien yang terhubung dalam kompartemen pasien.

Seperti yang dijelaskan, seealso menautkan referensi pasien lain yang dianggap sama validnya dengan aslinya. Setelah operasi Pasien-semuanya dijalankan, jika pasien memiliki seealso tautan ke pasien lain, operasi ini menjalankan Pasien-semuanya pada setiap tautan seealso. Ini berarti jika pasien menautkan ke lima pasien lain dengan tautan jenis seealso , kami menjalankan Pasien-semuanya pada masing-masing dari lima pasien tersebut.

Nota

Ini diatur untuk hanya mengikuti seealso tautan satu lapisan saja. Ini tidak memproses tautan seealso dari tautan-tautan seealso.

Tipe tautan terakhir adalah digantikan oleh. Dalam hal ini, sumber data pasien yang asli tidak lagi digunakan dan replaced-by tautan menunjuk ke pasien yang seharusnya digunakan. Implementasi Patient-everything secara default ini mencakup hasil operasi pada awal bundel dengan peringatan bahwa pasien tidak lagi valid. Ini juga akan menjadi perilaku ketika Prefer header diatur ke handling=lenient.

Selain itu, Anda dapat mengatur Prefer header ke handling=strict untuk melemparkan kesalahan sebagai gantinya. Dalam hal ini, pengembalian kode kesalahan 301 MovedPermanently menunjukkan bahwa pasien saat ini kedaluwarsa dan mengembalikan ID pasien yang benar yang disertakan dalam tautan. Header ContentLocation dari kesalahan yang dikembalikan menunjuk ke permintaan yang benar dan up-to-date.

Nota

Jika tautan replaced-by ada, Prefer: handling=lenient dan hasil dikembalikan secara asinkron dalam beberapa bundel; hanya hasil operasi yang dikembalikan dalam satu bundel tertentu.

Urutan respons pasien-semuanya

Operasi Pasien-semuanya mengembalikan hasil dalam fase:

1. Fase 1 mengembalikan sumber daya itu Patient sendiri selain sumber daya dan generalPractitioner apa pun managingOrganization yang dirujuknya.
2. Fase 2 dan 3 mengembalikan sumber daya di kompartemen pasien. start Jika parameter kueri atau end ditentukan, Fase 2 mengembalikan sumber daya dari kompartemen yang dapat difilter berdasarkan tanggal klinisnya, dan Fase 3 mengembalikan sumber daya dari kompartemen yang tidak dapat difilter berdasarkan tanggal klinisnya. Jika tidak satu pun dari parameter ini ditentukan, Fase 2 dilewati dan Fase 3 mengembalikan semua sumber daya kompartemen pasien.
3. Fase 4 mengembalikan perangkat apa pun yang merujuk pada pasien.

Setiap fase mengembalikan hasil dalam satu bundel. Jika hasil mencakup beberapa halaman, tautan berikutnya dalam bundel akan menunjuk ke halaman hasil berikutnya untuk fase tersebut. Setelah semua hasil dari fase dikembalikan, tautan berikutnya dalam bundel akan menunjuk ke panggilan untuk memulai fase berikutnya.

Jika pasien asli memiliki tautan dengan pasien lain, fase 1 hingga 4 akan diulang untuk setiap pasien yang terkait.

Contoh Pasien-semuanya

Berikut adalah beberapa contoh penggunaan operasi Pasien-semuanya. Selain contoh-contoh ini, kami memiliki sampel file REST yang menggambarkan seealso cara kerja perilaku dan replaced-by .

Untuk menggunakan Patient-everything untuk mengkueri "semuanya" pasien antara 2010 dan 2020, gunakan panggilan berikut.

GET {FHIRURL}/Patient/{ID}/$everything?start=2010&end=2020

Untuk menggunakan Patient-everything untuk mengkueri Observasi dan Encounter pasien, gunakan panggilan berikut.

GET {FHIRURL}/Patient/{ID}/$everything?_type=Observation,Encounter 

Untuk menggunakan Patient-everything untuk mengkueri "semuanya" pasien sejak 2021-05-27T05:00:00Z, gunakan panggilan berikut.

GET {FHIRURL}/Patient/{ID}/$everything?_since=2021-05-27T05:00:00Z 

Jika pasien ditemukan untuk setiap panggilan ini, Anda akan mendapatkan respons 200 dengan sumber daya yang Bundle sesuai.

Langkah selanjutnya

Sekarang setelah Anda memahami bagaimana menggunakan operasi Patient-everything, Anda dapat mempelajari tentang opsi pencarian. Untuk informasi selengkapnya, lihat

Gambaran umum pencarian FHIR

Nota

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