טריגר HL7

הטריגר HL7 הוא טריגר של אירוע מחבר שמאפשר להפעיל שילוב על סמך אירועי HL7 שנרשמתם אליהם בחיבור HL7.

לפני שמתחילים

  • יוצרים נושא Pub/Sub.
  • יוצרים מאגר HL7.

  • כדי לקבל הודעות HL7 דרך חיבורי TCP/IP באמצעות פרוטוקול השכבה התחתונה המינימלי (MLLP), צריך להגדיר מתאם MLLP. אין צורך להגדיר מתאם MLLP אם מקבלים הודעות HL7 דרך REST ‏ (Google Cloud HealthCare API). כדי להריץ את המתאם:

    1. מגדירים את הפרויקט והאזור ב-CLI של gcloud: 
      gcloud config set project PROJECT_ID \
gcloud config set compute/region LOCATION

      מידע נוסף מופיע במאמר בנושא הגדרת מאפיינים.

    2. יוצרים מופע של מכונה וירטואלית. 
         gcloud compute instances create VM_NAME \
       --service-account=SERVICE_ACCOUNT_EMAIL \
       --scopes=https://www.googleapis.com/auth/cloud-platform

      מחליפים את מה שכתוב בשדות הבאים:

      • SERVICE_ACCOUNT_EMAIL: כתובת האימייל של חשבון השירות שיצרתם.
      • ‫VM_NAME: השם של מופע ה-VM.
    3. מוסיפים תג למופע החדש של המכונה הווירטואלית. 
         gcloud compute instances add-tags INSTANCE_NAME \
   --zone ZONE \
   --tags TAGS

      מחליפים את מה שכתוב בשדות הבאים:

      • ‫INSTANCE_NAME: השם של מופע ה-VM.
      • ‫ZONE: האזור של המופע של מכונה וירטואלית.
      • ‫TAGS: התגים שרוצים להוסיף למופע של המכונה הווירטואלית.
    4. מוסיפים כלל לחומת האש כדי לחשוף את היציאה שבה פועל מתאם MLLP. 
         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

      מחליפים את מה שכתוב בשדות הבאים:

      • ‫FIREWALL_RULE: השם של כלל חומת האש.
      • ‫PORT: היציאה שבה פועל מתאם MLLP.
    5. מתחברים ב-SSH למכונה הווירטואלית. 
         gcloud compute ssh VM_NAME --zone ZONE

      מחליפים את מה שכתוב בשדות הבאים:

      • ‫VM_NAME: השם של מופע ה-VM.
      • ‫ZONE: האזור של המופע של מכונה וירטואלית.
    6. מתקינים את Docker במכונת ה-VM באמצעות הפקודה הבאה: 
         sudo apt-get update && sudo apt-get install -y docker.io
    7. מפעילים את שירות Docker על ידי הרצת הפקודות הבאות: 
         sudo systemctl start docker
   sudo systemctl enable docker
    8. מושכים את קובץ האימג' של Docker ממאגר הקונטיינרים. 
         docker pull gcr.io/cloud-healthcare-containers/mllp-adapter:latest
    9. מריצים את מתאם MLLP במופע ה-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

      מחליפים את מה שכתוב בשדות הבאים:

      • ‫PROJECT_ID: מזהה הפרויקט ב-Google Cloud.
      • ‫LOCATION: המיקום של מאגר HL7.
      • ‫DATASET_ID: המזהה של מערך הנתונים שמכיל את מאגר HL7.
      • ‫HL7V2_STORE_ID: המזהה של מאגר HL7.
      • ‫PORT: היציאה שבה פועל מתאם MLLP.
    10. מריצים את הפקודה הבאה כדי לוודא שהקונטיינר פועל: 
         sudo docker ps
    11. כדי לבדוק את היומנים של מאגר התגים, מריצים את הפקודה הבאה: 
         sudo docker logs CONTAINER_ID

התפקידים הנדרשים

אם אתם מתכננים ליצור או להגדיר חיבור חדש לטריגר HL7, ודאו שיש לכם את תפקיד ה-IAM הבא בפרויקט:

  • אדמין של מחבר (roles/connectors.admin)

    • מידע על הקצאת תפקידים מופיע במאמר ניהול הגישה.

מקצים לחשבון השירות שרוצים להשתמש בו בשביל הטריגר של HL7 את ההרשאות או את תפקידי ה-IAM הבאים:

  • Application Integration Invoker (roles/integrations.integrationInvoker)
  • צרכן הודעות של Healthcare HL7v2 (roles/healthcare.hl7V2Consumer)
  • הטמעה של הודעות Healthcare HL7v2‏ (roles/healthcare.hl7V2Ingest)
  • הרשאה (healthcare.hl7V2Stores.update)
  • Pub/Sub Editor (roles/pubsub.editor)

    • במאמר ניהול הגישה לחשבונות שירות מוסבר איך נותנים לחשבון שירות תפקיד.

הוספת טריגר HL7

כדי להוסיף טריגר HL7 לשילוב:

  1. נכנסים לדף Application Integration במסוף Google Cloud .

    מעבר אל Application Integration

  2. בתפריט הניווט, לוחצים על Integrations (שילובים).

    מוצגת רשימה של כל השילובים שזמינים בפרויקט Google Cloud בדף Integrations List.

  3. בוחרים שילוב קיים או לוחצים על יצירת שילוב כדי ליצור שילוב חדש.

    אם יוצרים שילוב חדש:

    1. מזינים שם ותיאור בחלונית יצירת שילוב.
    2. בוחרים אזור לשילוב.
    3. בוחרים חשבון שירות לאינטגרציה. אפשר לשנות או לעדכן את פרטי חשבון השירות של שילוב בכל שלב מחלונית סיכום השילוב בסרגל הכלים של השילוב.
    4. לוחצים על יצירה.

    השילוב החדש שנוצר ייפתח בכלי השילובים.

  4. בסרגל הניווט של כלי העריכה של השילוב, לוחצים על טריגרים כדי לראות את רשימת הטריגרים הזמינים.
  5. לוחצים על הרכיב HL7 trigger (טריגר HL7) וממקמים אותו בכלי לעריכת שילובים.

    6. כדי להגדיר את הטריגר של HL7, אפשר להשתמש בחיבור HL7 קיים עם REST ‏ (Cloud HealthCare API) כפרוטוקול היעד שזמין ב-Integration Connectors, או ליצור חיבור HL7 REST ‏(Google Cloud HealthCare API) חדש באמצעות האפשרות ליצירת חיבור מוטבע.

הגדרת טריגר HL7 באמצעות חיבור קיים

אתם יכולים להגדיר את הטריגר HL7 באמצעות חיבור HL7 קיים עם REST (Cloud HealthCare API) כפרוטוקול היעד ב-Integration Connectors. הטריגר של HL7 הוא טריגר של אירוע במחבר, ולכן אפשר להשתמש רק בחיבור HL7 REST ‏(Google Cloud HealthCare API) עם מינוי לאירועים כדי להגדיר את הטריגר.

למידע על הגדרת טריגר HL7 באמצעות חיבור חדש ל-HL7 REST(Google Cloud HealthCare API), אפשר לעיין במאמר הגדרת טריגר HL7 באמצעות חיבור חדש ל-HL7 REST(Google Cloud HealthCare API).

כדי להגדיר טריגר HL7 באמצעות חיבור HL7 קיים עם REST ‏ (Cloud HealthCare API) כפרוטוקול היעד, מבצעים את השלבים הבאים:

  1. לוחצים על הרכיב HL7 trigger (טריגר HL7) בכלי לעריכת שילובים כדי לפתוח את חלונית הגדרת הטריגר.
  2. לוחצים על Configure trigger (הגדרת הטריגר).
  3. בדף Connector Event Trigger Editor (עורך טריגרים של אירועים של מחבר), מזינים את פרטי ההגדרה הבאים:
    1. אזור: בוחרים את האזור של חיבור HL7 REST(Google Cloud HealthCare API).
    2. חיבור: בוחרים את החיבור של HL7 REST(Google Cloud HealthCare API) שרוצים להשתמש בו.

      ב-Application Integration מוצגים רק חיבורים של HL7 REST ‏(Google Cloud HealthCare API) שהם פעילים ושהופעל בהם מינוי לאירועים.

    3. בתפריט הנפתח, בוחרים באפשרות HL7 Message Content Type (סוג התוכן של הודעת HL7): text או bytes.
    4. מזינים את סוג ההודעה ב-HL7. לדוגמה, ADT_A01 או ADT_02.
  4. לוחצים על סיום כדי להשלים את הגדרת הטריגר ולסגור את הדף.

הגדרת טריגר HL7 באמצעות חיבור חדש

כדי להגדיר את הטריגר HL7 באמצעות חיבור חדש ל-HL7 REST ‏(Google Cloud HealthCare API), מבצעים את השלבים הבאים:

  1. לוחצים על הרכיב HL7 trigger (טריגר HL7) בכלי לעריכת שילובים כדי לפתוח את חלונית הגדרת הטריגר.
  2. לוחצים על Configure trigger (הגדרת הטריגר).
  3. בוחרים את האזור של טריגר HL7.
  4. לוחצים על Connection (חיבור) ובוחרים באפשרות Create Connection (יצירת חיבור) מהתפריט הנפתח.
  5. בחלונית Create Connection (יצירת חיבור), מבצעים את השלבים הבאים:
  6. בשלב פרטי החיבור, מזינים פרטים על חיבור HL7 החדש:
    1. גרסת המחבר: בוחרים גרסה זמינה של מחבר HL7 מהרשימה הנפתחת.
    2. שם החיבור: מזינים שם לחיבור HL7.
    3. (אופציונלי) תיאור: מזינים תיאור לקישור.
    4. אופציונלי: מפעילים את Cloud Logging ואז בוחרים רמת יומן. כברירת מחדל, רמת היומן מוגדרת כ-Error.
    5. חשבון שירות: בוחרים חשבון שירות עם תפקידי ה-IAM הנדרשים לחיבור HL7.
    6. הפעלת מינוי לאירועים: בוחרים באפשרות הזו כדי להפעיל את המינוי לאירועים עבור חיבור HL7.
    7. (אופציונלי) מזינים את הערך של Receive Timeout (זמן קצוב לתקבלת נתונים): הערך של SO_TIMEOUT (באלפיות שנייה) משמש להמתנה לתחילת מסגרת. ערך ברירת המחדל הוא 15,000 אלפיות השנייה.
    8. פרוטוקול יעד: בוחרים בפרוטוקול היעד HL7 REST(Google Cloud HealthCare API) ומציינים את הפרטים הבאים:
      1. מזהה הפרויקט: מזהה הפרויקט ב-Google Cloud שבו נמצא מאגר HL7.
      2. מיקום: המיקום של מערך הנתונים והחנות ב-HL7v2.
      3. מזהה מערך הנתונים: המזהה של מערך הנתונים שמכיל את החנות ב-HL7v2.
      4. מזהה של חנות HL7: המזהה של חנות HL7v2 שבה מאחסנים את הודעת HL7v2.
    9. אופציונלי: מגדירים את ההגדרות של צומת החיבור:

      • מספר מינימלי של צמתים: מזינים את המספר המינימלי של צמתי חיבור.
      • מספר הצמתים המקסימלי: מזינים את מספר צמתי החיבור המקסימלי.

      צומת הוא יחידה (או עותק) של חיבור שמבצעת עיבוד של עסקאות. כדי לעבד יותר עסקאות לחיבור נדרשים יותר צמתים, ולהפך: כדי לעבד פחות עסקאות נדרשים פחות צמתים. כדי להבין איך הצמתים משפיעים על התמחור של המחבר, אפשר לעיין במאמר בנושא תמחור של צמתי חיבור. אם לא מזינים ערכים, כברירת מחדל, מספר הצמתים המינימלי מוגדר כ-2 (לזמינות טובה יותר) ומספר הצמתים המקסימלי מוגדר כ-50.

    10. אופציונלי: לוחצים על + הוספת תווית כדי להוסיף תווית לקישור בצורה של צמד מפתח/ערך.
    11. אם רוצים להשתמש ב-SSL, בוחרים באפשרות הפעלת SSL. יוצגו פרטי ההגדרה של SSL.
      1. בוחרים סוג של מאגר אישורים. הוא יכול להיות גלוי לכולם, פרטי או חיבור לא מאובטח.
      2. בוחרים את האישורים שמוצגים על סמך הבחירה שלכם במאגר האישורים.
      3. אם אתם משתמשים ב-mTLS, בוחרים את האישורים של מאגר המפתחות בקטע Key Store.
      4. אופציונלי: בוחרים את גרסת ה-TLS.
      5. מזינים את סט האלגוריתמים להצפנה הנתמך. מזינים כמה חבילות הצפנה, כערכים מופרדים בפסיקים. מידע נוסף זמין במאמר בנושא חבילות הצפנה נתמכות.
    12. לוחצים על הבא.
  7. מדלגים על הקטע יעדים.
  8. לוחצים על הבא.
  9. בקטע אימות, לא צריך לציין פרטי אימות כי חיבור HL7 לא דורש אימות.
  10. בקטע פרטי המינוי לאירוע, מגדירים את הפרטים שקשורים לאירוע.
    • שם הפרויקט: הפרויקט ב-Google Cloud שבו נמצא מופע Pub/Sub.
    • שם נושא Pub/Sub: שם נושא Pub/Sub שישויך למאגר HL7v2 שאליו יישלחו הודעות ההתראה.
  11. בדיקה: בודקים את פרטי החיבור והאימות.
  12. לוחצים על יצירה.

סטים נתמכים של אלגוריתמים להצפנה

גרסת TLS סטים נתמכים של אלגוריתמים להצפנה
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

פלט של טריגר

תהליך ההגדרה של מינוי לאירועים באמצעות הטריגר HL7 נמשך כמה דקות. אפשר לראות את הסטטוס של המינוי לאירוע בחלונית ההגדרה של הטריגר, בקטע פרטי המינוי לאירוע.

הטריגר של HL7 מציין את הסטטוס של מינוי לאירוע באמצעות המצבים הבאים:

  • ‫Creating: מציין שהטריגר נרשם למינוי האירוע.
  • ‫Active: מציין שהטריגר נרשם בהצלחה למינוי לאירוע.
  • ‫Error: מציין שיש בעיה במינוי לאירועים שהוגדר.

בנוסף לסטטוס המינוי לאירוע, בקטע פרטי המינוי לאירוע מוצגים גם פרטים אחרים כמו אזור החיבור, שם החיבור ושם המינוי לאירוע.

משתנה הפלט של הטריגר

לכל אירוע, טריגר HL7 יוצר משתנה פלט ConnectorEventPayload (בפורמט JSON) שבו אפשר להשתמש במשימות בהמשך. המשתנה יכיל את מטען הייעודי (payload) מאירוע HL7. לדוגמה: 

 {
 "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"
}

הצגת מינויים לאירועים

כדי לראות ולנהל את כל המינויים לאירועים שמשויכים לחיבור ב-Integration Connectors, פועלים לפי השלבים הבאים:

  1. עוברים לדף Integration Connectors > Connections.

    כניסה לדף Connections

  2. לוחצים על החיבור שרוצים לראות את המינויים שלו.
  3. לוחצים על הכרטיסייה מינויים לאירועים.

    כאן מוצגים כל המינויים לאירועים של החיבור.

עריכה של טריגר HL7

אתם יכולים לערוך טריגר HL7 כדי לשנות או לעדכן את הגדרות החיבור ואת פרטי המינוי לאירועים.

כדי לערוך טריגר HL7:

  1. לוחצים על הרכיב HL7 trigger (טריגר HL7) בכלי לעריכת שילובים כדי לפתוח את חלונית הגדרת הטריגר.
  2. לוחצים על Configure HL7 trigger (הגדרת טריגר HL7).
  3. בדף Connector Event Trigger Editor (עורך טריגרים של אירועים במחבר), מבצעים את הפעולות הבאות:
    1. כדי לשמור את המינוי הקודם לאירועים, לוחצים על שמירה. אחרת, לוחצים על מחיקה.
    2. מעדכנים את הגדרות החיבור ואת פרטי המינוי לאירועים לפי הצורך.
    3. לוחצים על סיום.

    4. אפשר לראות את פרטי החיבור וההרשמה לאירועים המעודכנים בחלונית ההגדרות של הטריגר, בקטע פרטי הרשמה לאירועים.

מכסות ומגבלות

מידע על מכסות ומגבלות זמין במאמר מכסות ומגבלות.

המאמרים הבאים