Halaman ini memberikan 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, diperbarui, atau dihapus di penyimpanan FHIR. Namun, notifikasi tidak 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 secara memadai. Setelah topik Pub/Sub menerima pesan, pesan tersebut akan diteruskan ke sejumlah pelanggan topik tersebut.
Notifikasi DICOM
Untuk informasi tentang cara menggunakan notifikasi Pub/Sub dengan data DICOM, lihat Notifikasi Pub/Sub DICOM.
Notifikasi FHIR
Untuk informasi tentang penggunaan notifikasi Pub/Sub dengan data FHIR, lihat Notifikasi Pub/Sub FHIR.
Notifikasi HL7v2
Diagram berikut menunjukkan alur notifikasi yang terjadi saat pesan HL7v2 dimasukkan atau dibuat:
- Cloud Healthcare API menyerap pesan HL7v2 dari sistem perawatan.
- Pesan disimpan di penyimpanan HL7v2.
- Penyimpanan HL7v2 membuat dan mengirim pesan Pub/Sub ke topik Pub/Sub penyimpanan yang memiliki filter yang cocok dengan pesan HL7v2.
- Pub/Sub meneruskan pesan Pub/Sub ke langganan topik.
- Pelanggan menerima notifikasi, dalam bentuk pesan Pub/Sub, dari langganan mereka. Setiap langganan dapat memiliki satu atau beberapa subscriber 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 yang disimpan tidak berisi
nilai attribute
apa pun.
Data dan atribut pesan HL7v2
Saat pesan HL7v2 dibuat atau diserap ke dalam 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 |
Jenis pesan HL7v2 apa pun. | ADT |
Jenis pesan HL7v2 yang dibuat atau diserap. |
Langkah selanjutnya
- Baca dokumentasi Pub/Sub.
- Untuk penjelasan mendalam tentang Pub/Sub, lihat Apa yang dimaksud dengan Cloud Pub/Sub?