Lihat konektor yang didukung untuk Integration Aplikasi.

Pemicu HL7

Pemicu HL7 adalah Pemicu Peristiwa Konektor yang memungkinkan Anda memanggil integrasi berdasarkan peristiwa HL7 yang telah Anda subscribe di koneksi HL7.

Sebelum memulai

  • Buat topik Pub/Sub.
  • Buat penyimpanan HL7.

  • Untuk menerima pesan HL7 melalui koneksi TCP/IP menggunakan minimal lower layer protocol (MLLP), Anda harus mengonfigurasi adaptor MLLP. Anda tidak perlu mengonfigurasi adaptor MLLP jika menerima pesan HL7 melalui REST (Google Cloud HealthCare API). Untuk menjalankan adaptor, lakukan hal berikut:

    1. Tetapkan project dan region di gcloud CLI: 
      gcloud config set project PROJECT_ID \
gcloud config set compute/region LOCATION

      Untuk mengetahui informasi selengkapnya, lihat Menetapkan properti.

    2. Buat instance VM. 
         gcloud compute instances create VM_NAME \
       --service-account=SERVICE_ACCOUNT_EMAIL \
       --scopes=https://www.googleapis.com/auth/cloud-platform

      Ganti kode berikut:

      • SERVICE_ACCOUNT_EMAIL: alamat email untuk akun layanan yang Anda buat.
      • VM_NAME: Nama instance VM.
    3. Tambahkan tag ke instance VM yang baru dibuat. 
         gcloud compute instances add-tags INSTANCE_NAME \
   --zone ZONE \
   --tags TAGS

      Ganti kode berikut:

      • INSTANCE_NAME: Nama instance VM.
      • ZONE: Zona instance VM.
      • TAGS: Tag yang akan ditambahkan ke instance VM.
    4. Tambahkan aturan firewall untuk mengekspos port tempat adaptor MLLP berjalan. 
         gcloud compute firewall-rules create FIREWALL_RULE \
   --action=ALLOW \
   --direction=INGRESS \
   --priority=1000 \
   --rules=tcp:PORT\
   --network=default \
   --source-ranges=0.0.0.0/0

      Ganti kode berikut:

      • FIREWALL_RULE: Nama aturan firewall.
      • PORT: Port tempat adaptor MLLP berjalan.
    5. SSH ke instance VM. 
         gcloud compute ssh VM_NAME --zone ZONE

      Ganti kode berikut:

      • VM_NAME: Nama instance VM.
      • ZONE: Zona instance VM.
    6. Instal docker di VM menggunakan perintah berikut: 
         sudo apt-get update && sudo apt-get install -y docker.io
    7. Mulai layanan docker dengan menjalankan perintah berikut: 
         sudo systemctl start docker
   sudo systemctl enable docker
    8. Ambil image docker di container registry. 
         docker pull gcr.io/cloud-healthcare-containers/mllp-adapter:latest
    9. Jalankan adaptor MLLP di instance VM. 
         docker run \
   --network=host \
   -v ~/.config:/root/.config \
   gcr.io/cloud-healthcare-containers/mllp-adapter \
   /usr/mllp_adapter/mllp_adapter \
   --hl7_v2_project_id=PROJECT_ID \
   --hl7_v2_location_id=LOCATION \
   --hl7_v2_dataset_id=DATASET_ID \
   --hl7_v2_store_id=HL7V2_STORE_ID \
   --export_stats=false \
   --receiver_ip=0.0.0.0 \
   --port=PORT \
   --api_addr_prefix=https://healthcare.googleapis.com:443/v1 \
   --logtostderr

      Ganti kode berikut:

      • PROJECT_ID: Project ID project Google Cloud.
      • LOCATION: Lokasi penyimpanan HL7.
      • DATASET_ID: ID set data yang menyimpan penyimpanan HL7.
      • HL7V2_STORE_ID: ID penyimpanan HL7.
      • PORT: Port tempat adaptor MLLP berjalan.
    10. Jalankan perintah berikut untuk memastikan bahwa penampung sedang berjalan: 
         sudo docker ps
    11. Untuk memeriksa log penampung, jalankan perintah berikut: 
         sudo docker logs CONTAINER_ID

Peran yang diperlukan

Jika Anda berencana membuat atau mengonfigurasi koneksi baru untuk pemicu HL7, pastikan Anda memiliki peran IAM berikut di project:

  • Connector Admin (roles/connectors.admin)

    • Untuk mengetahui informasi tentang cara memberikan peran, lihat Mengelola akses.

Berikan peran atau Izin IAM berikut ke akun layanan yang ingin Anda gunakan untuk pemicu HL7:

  • Application Integration Invoker (roles/integrations.integrationInvoker)
  • Healthcare HL7v2 Message Consumer (roles/healthcare.hl7V2Consumer)
  • Healthcare HL7v2 Message Ingest (roles/healthcare.hl7V2Ingest)
  • Izin (healthcare.hl7V2Stores.update)
  • Pub/Sub Editor (roles/pubsub.editor)

    • Untuk informasi tentang cara memberikan peran ke akun layanan, lihat Mengelola akses ke akun layanan.

Menambahkan pemicu HL7

Untuk menambahkan pemicu HL7 ke integrasi Anda, lakukan langkah-langkah berikut:

  1. Di Google Cloud console, buka halaman Application Integration.

    Buka Application Integration

  2. Di menu navigasi, klik Integrations

    Halaman Daftar Integrasi akan muncul yang mencantumkan semua integrasi yang tersedia di project Google Cloud.

  3. Pilih integrasi yang ada atau klik Buat integrasi untuk membuat integrasi baru.

    Jika Anda membuat integrasi baru:

    1. Masukkan nama dan deskripsi di panel Buat Integrasi.
    2. Pilih region untuk integrasi.
    3. Pilih akun layanan untuk integrasi. Anda dapat mengubah atau memperbarui detail akun layanan integrasi kapan saja dari panel Ringkasan integrasi di toolbar integrasi.
    4. Klik Create.

    Tindakan ini akan membuka integrasi di editor integrasi.

  4. Di menu navigasi editor integrasi, klik Pemicu untuk melihat daftar pemicu yang tersedia.
  5. Klik dan tempatkan elemen pemicu HL7 di editor integrasi.

    6. Untuk mengonfigurasi pemicu HL7, Anda dapat menggunakan koneksi HL7 yang ada dengan REST (Cloud HealthCare API) sebagai protokol tujuan yang tersedia di Konektor Integrasi, atau membuat koneksi HL7 REST(Google Cloud HealthCare API) baru menggunakan opsi pembuatan koneksi inline.

Mengonfigurasi pemicu HL7 menggunakan koneksi yang ada

Anda dapat mengonfigurasi pemicu HL7 menggunakan koneksi HL7 yang ada dengan REST (Cloud HealthCare API) sebagai protokol tujuan di Konektor Integrasi. Pemicu HL7 adalah Pemicu Peristiwa Konektor, sehingga Anda hanya dapat menggunakan koneksi HL7 REST(Google Cloud HealthCare API) dengan langganan peristiwa diaktifkan untuk mengonfigurasi pemicu.

Untuk informasi tentang cara mengonfigurasi pemicu HL7 menggunakan koneksi HL7 REST(Google Cloud HealthCare API) baru, lihat Mengonfigurasi pemicu HL7 menggunakan koneksi HL7 REST(Google Cloud HealthCare API) baru.

Untuk mengonfigurasi pemicu HL7 menggunakan koneksi HL7 yang ada dengan REST (Cloud HealthCare API) sebagai protokol tujuan, lakukan langkah-langkah berikut:

  1. Klik elemen HL7 trigger di editor integrasi untuk membuka panel konfigurasi pemicu.
  2. Klik Konfigurasi pemicu.
  3. Berikan detail konfigurasi berikut di halaman Editor Pemicu Peristiwa Konektor:
    1. Region: Pilih region koneksi HL7 REST(Google Cloud HealthCare API) Anda.
    2. Koneksi: Pilih koneksi HL7 REST(Google Cloud HealthCare API) yang ingin Anda gunakan.

      Integrasi Aplikasi hanya menampilkan koneksi HL7 REST(Google Cloud HealthCare API) yang aktif dan mengaktifkan langganan peristiwa.

    3. Pilih HL7 Message Content Type: text atau bytes dari menu dropdown.
    4. Masukkan jenis pesan HL7. Misalnya ADT_A01 atau ADT_02.
  4. Klik Selesai untuk menyelesaikan konfigurasi pemicu dan menutup halaman.

Mengonfigurasi pemicu HL7 menggunakan koneksi baru

Untuk mengonfigurasi pemicu HL7 menggunakan koneksi HL7 REST(Google Cloud HealthCare API) baru, lakukan langkah-langkah berikut:

  1. Klik elemen HL7 trigger di editor integrasi untuk membuka panel konfigurasi pemicu.
  2. Klik Konfigurasi pemicu.
  3. Pilih Region untuk pemicu HL7.
  4. Klik Connection, lalu pilih opsi Create Connection dari menu drop-down.
  5. Selesaikan langkah-langkah berikut di panel Create Connection:
  6. Pada langkah Detail Koneksi, berikan detail tentang koneksi HL7 baru:
    1. Versi konektor: Pilih versi konektor HL7 yang tersedia dari menu drop-down.
    2. Nama Koneksi: Masukkan nama untuk koneksi HL7.
    3. (Opsional) Deskripsi: Masukkan deskripsi untuk koneksi.
    4. Secara opsional, aktifkan Cloud Logging, lalu pilih level log. Secara default, level log ditetapkan ke Error.
    5. Service Account: Pilih akun layanan dengan peran IAM yang diperlukan untuk koneksi HL7.
    6. Aktifkan langganan peristiwa: Pilih opsi ini untuk mengaktifkan langganan peristiwa untuk koneksi HL7.
    7. (Opsional) Masukkan Waktu Tunggu Penerimaan: Nilai SO_TIMEOUT (dalam milidetik) digunakan saat menunggu awal frame. Nilai defaultnya adalah 15.000 milidetik.
    8. Destination Protocol: Pilih protokol tujuan HL7 REST(Google Cloud HealthCare API), lalu tentukan hal berikut:
      1. Project ID: Project ID Google Cloud tempat penyimpanan HL7 berada.
      2. Lokasi: Lokasi set data dan penyimpanan HL7v2 Anda.
      3. Dataset ID: ID untuk set data yang menyimpan penyimpanan HL7v2.
      4. HL7 Store ID: ID untuk penyimpanan HL7v2 tempat Anda menyimpan pesan HL7v2.
    9. Secara opsional, konfigurasikan Setelan node koneksi:

      • Jumlah node minimum: Masukkan jumlah minimum node koneksi.
      • Maximum number of nodes: Masukkan jumlah maksimum node koneksi.

      Node adalah unit (atau replika) koneksi yang memproses transaksi. Semakin banyak node yang diperlukan untuk memproses lebih banyak transaksi untuk koneksi, dan sebaliknya, semakin sedikit node yang diperlukan untuk memproses lebih sedikit transaksi. Untuk memahami pengaruh node terhadap harga konektor Anda, lihat Harga untuk node koneksi. Jika Anda tidak memasukkan nilai apa pun, secara default, node minimum ditetapkan ke 2 (untuk ketersediaan yang lebih baik) dan node maksimum ditetapkan ke 50.

    10. Secara opsional, klik + Tambahkan label untuk menambahkan label ke Koneksi dalam bentuk pasangan kunci/nilai.
    11. Jika ingin menggunakan SSL, pilih Enable SSL. Tindakan ini akan menampilkan detail konfigurasi SSL.
      1. Pilih jenis trust store. Statusnya dapat berupa Publik, Pribadi, atau Koneksi Tidak Aman.
      2. Pilih sertifikat seperti yang ditampilkan berdasarkan pilihan penyimpanan kepercayaan Anda.
      3. Jika Anda menggunakan mTLS, pilih sertifikat penyimpanan kunci di bagian Penyimpanan Kunci.
      4. Atau, pilih versi TLS.
      5. Masukkan cipher suite yang didukung. Masukkan beberapa cipher suite, sebagai nilai yang dipisahkan koma. Untuk mengetahui informasi selengkapnya, lihat Suite cipher yang didukung.
    12. Klik Berikutnya.
  7. Lewati bagian Tujuan.
  8. Klik Berikutnya.
  9. Di bagian Autentikasi, Anda tidak perlu menentukan detail autentikasi apa pun karena koneksi HL7 tidak memerlukan autentikasi apa pun.
  10. Di bagian Detail Langganan Peristiwa, konfigurasikan detail terkait peristiwa.
    • Project Name: Project Google Cloud tempat instance Pub/Sub berada.
    • Nama Topik Pub/Sub: Nama topik Pub/Sub yang akan dikaitkan dengan penyimpanan HL7v2 tempat pesan notifikasi akan dikirim.
  11. Tinjau: Tinjau detail koneksi dan autentikasi Anda.
  12. Klik Create.

Cipher suite yang didukung

Versi TLS Cipher suite yang didukung
1,2
  • TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256
  • TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
  • TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256
  • TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384
  • TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
  • TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
  • TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256
  • TLS_DHE_RSA_WITH_AES_128_GCM_SHA256
  • TLS_DHE_RSA_WITH_AES_256_GCM_SHA384
  • TLS_DHE_RSA_WITH_AES_128_CBC_SHA
  • TLS_DHE_RSA_WITH_AES_256_CBC_SHA
  • TLS_DHE_RSA_WITH_AES_128_CBC_SHA256
  • TLS_DHE_RSA_WITH_AES_256_CBC_SHA256
1,3
  • TLS_AES_256_GCM_SHA384
  • TLS_CHACHA20_POLY1305_SHA256
  • TLS_AES_128_GCM_SHA256

Output pemicu

Pemicu HL7 memerlukan waktu beberapa menit untuk menyelesaikan konfigurasi langganan peristiwa. Anda dapat melihat status langganan peristiwa di panel konfigurasi pemicu pada bagian Detail Langganan Peristiwa.

Pemicu HL7 menunjukkan status langganan peristiwa menggunakan status berikut:

  • Creating: Menunjukkan bahwa pemicu berlangganan langganan peristiwa.
  • Active: Menunjukkan bahwa pemicu berhasil berlangganan ke langganan peristiwa.
  • Error: Menunjukkan bahwa ada masalah dengan langganan peristiwa yang dikonfigurasi.

Selain status langganan peristiwa, bagian Detail Langganan Peristiwa juga menampilkan detail lainnya seperti wilayah koneksi, nama koneksi, dan nama langganan peristiwa.

Memicu variabel output

Untuk setiap peristiwa, pemicu HL7 akan menghasilkan variabel output ConnectorEventPayload (dalam format JSON) yang dapat Anda gunakan dalam tugas downstream. Variabel output akan memiliki payload dari peristiwa HL7 Anda. Contoh: 

 {
 "messageType": "ADT_A01",
 "message": "MSH|^~\\&|SendingApp|SendingFacility|ReceivingApp|ReceivingFacility|20240209120000||ADT^A01|123456789|P|2.3|||NE|AL|||||\rEVN|A02222221|20240209120000|||\rPID|1||123456789|^^^Hospital^MR||Doe^John^^^Mr.||19800101|M|||123 Main St^^New York^NY^10001^USA||(555)555-1234|(555)555-1235\rPV1|1|I|2000^2012^01||||123^Doe^John|||SUR||||ADM|A0||\r",
 "contentType": "text/plain"
}

Melihat langganan peristiwa

Untuk melihat dan mengelola semua langganan peristiwa yang terkait dengan koneksi di Konektor Integrasi, lakukan hal berikut:

  1. Buka halaman Integration Connectors > Connections.

    Buka halaman Koneksi

  2. Klik koneksi yang langganannya ingin Anda lihat.
  3. Klik tab Langganan peristiwa.

    Tindakan ini akan menampilkan semua langganan peristiwa untuk koneksi.

Mengedit pemicu HL7

Anda dapat mengedit pemicu HL7 untuk mengubah atau memperbarui konfigurasi koneksi dan detail langganan peristiwa.

Untuk mengedit pemicu HL7, lakukan langkah-langkah berikut:

  1. Klik elemen HL7 trigger di editor integrasi untuk membuka panel konfigurasi pemicu.
  2. Klik Konfigurasi pemicu HL7.
  3. Lakukan tindakan berikut di halaman Editor Pemicu Peristiwa Konektor:
    1. Untuk mempertahankan langganan peristiwa yang dikonfigurasi sebelumnya, klik Pertahankan, atau klik Hapus.
    2. Perbarui konfigurasi koneksi dan detail langganan peristiwa sesuai keinginan.
    3. Klik Done.

    4. Anda dapat melihat detail koneksi dan langganan peristiwa yang diperbarui di panel konfigurasi pemicu di bagian Detail Langganan Peristiwa.

Kuota dan batas

Untuk mengetahui informasi tentang kuota dan batas, lihat Kuota dan batas.

Langkah selanjutnya