הרשמה לאירועים

בנוסף לאפשרות לבצע פעולות קריאה וכתיבה בשרת העורפי, Integration Connectors מאפשר גם להירשם לאירועים שמתרחשים באפליקציות בשרת העורפי. לדוגמה, נניח שאתם רוצים לקבל התראה כשכרטיס חדש ב-Jira נוצר. כדי לעשות את זה, צריך להגדיר את המחבר של Jira Cloud להרשמה לאירועים. באמצעות המינויים לאירועים יחד עם Application Integration, תוכלו ליצור שילובים שימושיים שיענו על הצרכים העסקיים שלכם. מידע נוסף זמין במאמר בנושא שימוש במינויים לאירועים באינטגרציות

הפעלת מינויים לאירועים בחיבורים

אפשר להשתמש בחיבור שיוצרים לכל אחת מהמטרות הבאות:

  • לביצוע פעולות של מחברים (ישויות ופעולות) בלבד
  • למינויים לאירועים בלבד
  • לביצוע פעולות של מחבר ולמינויים לאירועים

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

מחברים שמאפשרים להירשם לאירועים:

העשרת נתונים בהתראות לגבי אירועים

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

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

מטען ייעודי (payload) ללא העשרת נתונים

בדוגמה הבאה מוצג מטען ייעודי (payload) של תגובה לאירוע ליצירת כרטיס תמיכה ב-Zendesk, ללא העשרת נתונים.

{
  "account_id": 12345,
  "integration_key": "my_integration_key",
  "subdomain": "my_zendesk_subdomain",
  "input": {
    "ticket_event": {
      "meta": {
        "version": "1.0",
....
....
        "position": 1,
          "total": 9
        }
      },
      "type": "Ticket Created",
      "ticket": {
        "id": 35436,
....
....
        "external_id": "TEST1234",
        "tags": [
          "enterprise"
        ],
        "via": {
          "channel": "web"
        }
      }
    }
  }

Payload עם העשרת נתונים

בדוגמה הבאה מוצג מטען ייעודי (payload) של תגובה לאירוע ליצירת כרטיס ב-Zendesk עם העשרת נתונים.

{
    "context-data": {
    "AllowChannelback": false,
    "Assignee": null,
    "AssigneeId": 1.6696812051473E13,
    "Brand": null,
    "BrandId": 1.6696812163985E13,
    "Cc": null,
    "CollaboratorIds": null,
    "Commenter": null,
    "HasAttachment": null,
    "CreatedAt": "2023-07-08 11:37:19.0",
    "CustomFields": null,
    "Description": "Test desc 2",
....
....
    "Status": "open",
    "Subject": "Test Zendesk Ticket Created -2 -DA",
    "Submitter": null,
    "SubmitterId": 1.6696812051473E13,
    "Tags": "tag-changed-after-cache,ticket-created",
....
....
    "ViaChannel": "web",
    "ViaFollowupSourceId": null,
    "ViaSource": "{\r\n  \"from\": null,\r\n  \"to\": null,\r\n  \"rel\": null\r\n}",
    "View_Id": null
  },
   "data":{
  "account_id": 12345,
  "integration_key": "my_integration_key",
  "subdomain": "my_zendesk_subdomain",
  "input": {
    "ticket_event": {
      "meta": {
        "version": "1.0",
....
....
        "position": 1,
          "total": 9
        }
      },
      "type": "Ticket Created",
      "ticket": {
        "id": 35436,
....
....
        "external_id": "TEST1234",
        "tags": [
          "enterprise"
        ],
        "via": {
          "channel": "web"
        }
      }
    }
  }
 }

קישוריות פרטית להרשמה לאירועים

כדי לשפר את האבטחה, אתם יכולים להגדיר קישוריות פרטית בין אפליקציית הבק-אנד לבין החיבור. בקישוריות פרטית, רכיב event listener של החיבור לא יהיה גלוי לכולם באופן ישיר. במקום זאת, אתם צריכים לאפשר תנועה נכנסת ברשת למאזין האירועים דרך קובץ מצורף לשירות PSC שיועבר אליכם על ידי Integration Connectors.

במהלך יצירת החיבור, אם בחרתם באפשרות הפעלת קישוריות פרטית להרשמה לאירועים, Integration Connectors יוצר קובץ מצורף לשירות PSC. צריך לחשוף את קובץ ה-PSC service attachment לאפליקציית הבק-אנד באמצעות כל שיטה שמתאימה לכם. אחת האפשרויות היא להשתמש בצירוף שירות PSC במאזן עומסים, ואז להגדיר את מאזן העומסים כך שיקבל אירועים מאפליקציית הבק-אנד. החיבור מקשיב לאירועים של ה-backend בכתובת של מאזן העומסים. בשלבים הבאים מוצג תהליך כללי להגדרת קישוריות פרטית באמצעות מאזן עומסים:

  1. עוברים לדף פרטי החיבור של החיבור החדש שנוצר.
  2. לוחצים על עריכת נקודת הכניסה. יוצג החלונית הגדרות הרשמה לאירועים.
  3. מעתיקים את השם של קובץ השירות המצורף שמופיע בשדה PSC service attachment name.
  4. יוצרים קבוצת נקודות קצה ברשת PSC שמפנה לצירוף השירות שקיבלתם בשלב הקודם.
  5. יוצרים מאזן עומסים חיצוני עם קבוצת נקודות הקצה ברשת PSC שנוצרה בשלב הקודם בתור קצה עורפי.
  6. מגדירים את מאזן העומסים כך שיקבל בקשות מכתובת ה-IP של ספק האירועים (אפליקציית ה-Backend).

    השלבים הבאים (7 עד 11) רלוונטיים רק למחברים שהקצה העורפי שלהם תומך ברישום אוטומטי של מינוי לאירועים. לדוגמה, Zendesk ו-Jira.

  7. עוברים לדף פרטי החיבור של החיבור החדש שנוצר.
  8. לוחצים על עריכת נקודת הכניסה. יוצג החלונית הגדרות הרשמה לאירועים.
  9. מזינים את הכתובת של מאזן העומסים בשדה Event listener ingress endpoint (נקודת כניסה של רכיב event listener).
  10. לוחצים על סיום.
  11. לוחצים על שמירה כדי לשמור את השינויים בחיבור.

שימוש במינויים לאירועים בשילובים

כשמשתמשים במינויים לאירועים יחד עם השילובים, אפשר ליצור שילובים כדי לפתור בעיות עסקיות מורכבות. לדוגמה, אתם יכולים להתחיל את ההפעלה של האינטגרציה כולה על סמך אירוע ב-ServiceNow. Application Integration מספק את הטריגרים הבאים שמקשיבים להתראות על אירועים מאפליקציות ה-Backend שלכם:

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

להצגת המינויים הפעילים

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

  1. פותחים את הדף 'כל החיבורים' בפרויקט Google Cloud.

    כניסה לדף Connections

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

    ייפתח הדף פרטי החיבור.

  3. לוחצים על הכרטיסייה מינויים.

    כאן מוצגים כל המינויים של הקישור. מינוי שמופיע בדף הזה יכול להיות באחד מהמצבים הבאים:

    • ‫Creating – המינוי נוצר על ידי שילוב.
    • ‫Active – המינוי תקף ופועל.
    • מושעה – החיבור נמצא במצב מושעה.
    • שגיאה – יצירת המינוי נכשלה. לדוגמה, אימות נכשל במהלך יצירת מינוי.

תמחור של מינוי לאירועים

לא נגבה תשלום על הנתונים (מטען ייעודי (payload) של אירועים) שעוברים עיבוד עבור מינויים לאירועים בטריגרים של גרסת הבטא. עם זאת, תחויבו על נתונים של מינוי לאירועים שעברו עיבוד בטריגרים שזמינים לכולם.