Halaman ini menyediakan ringkasan tentang penggunaan Pub/Sub untuk menerima notifikasi saat peristiwa klinis terjadi di penyimpanan data Cloud Healthcare API. Untuk mempelajari cara menyiapkan dan menggunakan pesan Pub/Sub, lihat Mengonfigurasi notifikasi Pub/Sub.
Ringkasan
Anda dapat menerima notifikasi menggunakan Pub/Sub saat salah satu peristiwa klinis berikut terjadi:
- Anda menyimpan instance DICOM di penyimpanan DICOM menggunakan metode
dicomStores.dicomWeb.studies.storeInstances
. - Anda mengimpor instance DICOM ke penyimpanan DICOM menggunakan metode
dicomStores.import
. - Resource FHIR dibuat, di-patch, diupdate, atau dihapus di penyimpanan FHIR. Namun, notifikasi tidak akan dikirim saat resource FHIR diimpor dari Cloud Storage.
- Pesan HL7v2 diserap atau dibuat di penyimpanan HL7v2.
Informasi tentang setiap peristiwa ditambahkan ke topik Pub/Sub penyimpanan data yang sesuai dalam bentuk pesan.
Anda dapat memublikasikan pesan ke topik Pub/Sub mana pun dalam project apa pun yang izinnya Anda miliki. Setelah topik Pub/Sub menerima pesan, pesan akan diteruskan ke sejumlah pelanggan yang mengakses topik tersebut.
Notifikasi DICOM
Untuk mengetahui informasi tentang cara menggunakan notifikasi Pub/Sub dengan data DICOM, lihat Notifikasi Pub/Sub DICOM.
Notifikasi FHIR
Untuk mengetahui informasi tentang cara menggunakan notifikasi Pub/Sub dengan data FHIR, lihat Notifikasi Pub/Sub FHIR.
Notifikasi HL7v2
Diagram berikut menunjukkan alur notifikasi yang terjadi saat pesan HL7v2 diserap atau dibuat:
- Cloud Healthcare API menyerap pesan HL7v2 dari sistem perawatan.
- Pesan tersebut disimpan di penyimpanan HL7v2.
- Penyimpanan HL7v2 membuat dan mengirimkan pesan Pub/Sub ke topik Pub/Sub toko yang memiliki filter yang cocok dengan pesan HL7v2.
- Pub/Sub meneruskan pesan Pub/Sub ke langganan topik.
- Pelanggan akan menerima notifikasi dalam bentuk pesan Pub/Sub dari langganan mereka. Setiap langganan dapat memiliki satu atau beberapa pelanggan untuk meningkatkan paralelisme.
Format notifikasi
Notifikasi yang dikirim ke topik Pub/Sub terdiri dari dua bagian:
- Atribut: Kumpulan key:value pair yang mendeskripsikan peristiwa. Nilai ini dapat digunakan untuk memfilter peristiwa yang diterima klien dengan memfilter pesan dari langganan.
- Data: String yang berisi ID untuk resource FHIR, instance DICOM, atau pesan HL7v2 yang relevan.
Data instance DICOM
Saat instance DICOM disimpan di penyimpanan DICOM, ID berikut selalu disertakan dalam kolom data
pesan Pub/Sub:
projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies/STUDY_UID/series/SERIES_UID/instances/INSTANCE_UID
Notifikasi untuk instance DICOM tersimpan tidak berisi
nilai attribute
apa pun.
Data dan atribut pesan HL7v2
Saat pesan HL7v2 dibuat atau diserap ke penyimpanan HL7v2, ID berikut selalu disertakan dalam kolom data
pesan Pub/Sub:
projects/PROJECT_ID/locations/us-central1/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/HL7V2_MESSAGE_ID
Kumpulan key:value pair berikut selalu disertakan dalam kolom attributes
pesan Pub/Sub:
Nama atribut | Nilai yang memungkinkan | Contoh | Deskripsi |
---|---|---|---|
msgType |
Semua jenis pesan HL7v2. | ADT |
Jenis pesan HL7v2 yang dibuat atau diserap. |
Langkah selanjutnya
- Baca dokumentasi Pub/Sub.
- Untuk penjelasan mendalam tentang Pub/Sub, lihat Apa itu Cloud Pub/Sub?