טריגר ServiceNow

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

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

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

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

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

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

הוספת הטריגר של ServiceNow

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

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

    מעבר אל Application Integration

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

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

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

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

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

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

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

    6. כדי להגדיר את הטריגר של ServiceNow, אפשר להשתמש בחיבור ServiceNow קיים שזמין ב-Integration Connectors, או ליצור חיבור ServiceNow חדש באמצעות האפשרות ליצירת חיבור מוטבע.

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

אפשר להגדיר את הטריגר של ServiceNow באמצעות חיבור קיים של ServiceNow ב-Integration Connectors. שימו לב שהטריגר של ServiceNow הוא טריגר של אירוע מחבר, ולכן אפשר להשתמש בחיבור ServiceNow רק אם מופעלת בו הרשמה לאירועים כדי להגדיר את הטריגר.

מידע על הגדרת טריגר של ServiceNow באמצעות חיבור חדש ל-ServiceNow זמין במאמר הגדרת טריגר של ServiceNow באמצעות חיבור חדש

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

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

      ב-Application Integration מוצגים רק חיבורים ל-ServiceNow שהם פעילים ושהופעלה בהם הרשמה לאירועים.

    3. סוג המינוי לאירוע: מזינים את סוג האירוע שרוצים להשתמש בו כדי להפעיל את השילוב. צריך להגדיר את סוגי האירועים האלה בכלל העסקי של מופע ServiceNow.
    4. חשבון שירות: בוחרים חשבון שירות עם תפקידי ה-IAM הנדרשים להפעלת הטריגר של ServiceNow.
  4. לוחצים על סיום כדי להשלים את הגדרת הטריגר ולסגור את הדף.

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

כדי להגדיר את הטריגר של ServiceNow באמצעות חיבור חדש ל-ServiceNow, פועלים לפי השלבים הבאים:

  1. לוחצים על הרכיב ServiceNow trigger (טריגר של ServiceNow) בכלי לעריכת שילובים כדי לפתוח את חלונית הגדרת הטריגר.
  2. לוחצים על Configure trigger (הגדרת הטריגר).
  3. מדלגים על השדה אזור.
  4. לוחצים על Connection (חיבור) ובוחרים באפשרות Create Connection (יצירת חיבור) מהתפריט הנפתח.
  5. מבצעים את השלבים הבאים בחלונית Create Connection (יצירת חיבור):
    1. בשלב מיקום, בוחרים את המיקום של החיבור החדש ל-ServiceNow:
      1. אזור: בוחרים אזור מהרשימה הנפתחת.
      2. לוחצים על הבא.
    2. בשלב פרטי החיבור, מזינים את הפרטים של החיבור החדש ל-ServiceNow:
      1. גרסת המחבר: בוחרים גרסה זמינה של המחבר ServiceNow מהרשימה הנפתחת.
      2. שם החיבור: מזינים שם לחיבור ServiceNow.
      3. (אופציונלי) תיאור: מזינים תיאור לקישור.
      4. (אופציונלי) הפעלת Cloud Logging: מסמנים את התיבה הזו כדי לאחסן את כל נתוני היומן של החיבור.
      5. חשבון שירות: בוחרים חשבון שירות עם תפקידי ה-IAM הנדרשים לחיבור ServiceNow.
      6. הפעלת מינוי לאירועים: בוחרים באפשרות הזו כדי ליצור ולהפעיל מינוי חדש לאירועים עבור חיבור ServiceNow. אתם יכולים להפעיל רק מינויים לאירועים, או לכלול גם ישויות, פעולות ופעילויות של חיבורים.
      7. כולל טבלאות מערכת: בוחרים באפשרות הזו כדי לכלול טבלאות מערכת בדוח או בחיבור.
      8. (אופציונלי) סינון טבלאות: מזינים את רשימת טבלאות המערכת (מתחילות ב-sys_, מופרדות בפסיקים) שרוצים לכלול.
      9. (אופציונלי) מרחיבים את הגדרות מתקדמות כדי להגדיר את ההגדרות של צומת החיבור.

        מידע נוסף על הגדרות צומת החיבור ל-ServiceNow זמין במאמר בנושא חיבור ל-ServiceNow.

      10. (אופציונלי) לוחצים על + הוספת תווית כדי להוסיף תווית לקישור בצורה של צמד מפתח/ערך.
      11. לוחצים על הבא.
    3. בשלב יעדים, מספקים את פרטי מופע ServiceNow:
      1. סוג היעד: בוחרים באפשרות כתובת המארח.
      2. מארח: מזינים את שם המארח או את כתובת ה-IP של מכונת ServiceNow.
      3. לוחצים על הבא.
    4. בשלב אימות, מזינים את פרטי האימות של מופע ServiceNow:
      1. שם משתמש: מזינים את שם המשתמש כדי לגשת לכתובת היעד שצוינה.
      2. סיסמה: בוחרים את הסוד ב-Secret Manager שמכיל את הסיסמה שמשויכת לשם המשתמש ב-ServiceNow.
      3. גרסת סוד: בוחרים גרסת סוד.

        4. מידע נוסף על הגדרת אימות זמין במאמר הגדרת אימות.

      4. לוחצים על הבא.
    5. בשלב Event subscription details (פרטי המינוי לאירועים), מספקים את פרטי האימות שישמשו לאימות מטען ה-token של ServiceNow:
      1. אסימון אימות: (אופציונלי) בוחרים את הסוד של אסימון האימות ב-Secret Manager ואת גרסת הסוד המתאימה מהתפריט הנפתח גרסת הסוד.
      2. ‫HMAC Algorithm: (אופציונלי) בוחרים את אלגוריתם ה-HMAC להצפנת מטען הייעודי (payload) של התגובה.
      3. מפתח סודי של HMAC: אם בחרתם אלגוריתם HMAC, בוחרים את הסוד של מפתח ה-HMAC ב-Secret Manager ואת הגרסה המתאימה של הסוד בתפריט הנפתח גרסת הסוד.
      4. לוחצים על הבא.
    6. בדיקה: בודקים את פרטי החיבור ל-ServiceNow שסופקו.
    7. לוחצים על יצירה כדי לסיים את יצירת החיבור החדש ל-ServiceNow.
  6. אחרי שיוצרים את החיבור ל-ServiceNow, צריך לעבור למופע ServiceNow וליצור כלל עסקי באופן ידני.
  7. סוג המינוי לאירוע: מזינים את סוג האירוע שרוצים להשתמש בו כדי להפעיל את השילוב. צריך להגדיר את סוגי האירועים האלה בכלל העסקי של מופע ServiceNow.
  8. לוחצים על סיום וסוגרים את הדף.

יצירת כלל עסקי

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

במסמכי העזרה של ServiceNow מוסבר איך ליצור כלל עסקי.

בתמונה הבאה מוצגת דוגמה לכלל עסקי ב-ServiceNow עם סוג האירוע update_ticket:

תמונה שבה מוצג כלל עסקי לדוגמה ב-ServiceNow תמונה שבה מוצג כלל עסקי לדוגמה ב-ServiceNow

פלט של טריגר

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

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

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

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

בתמונה הבאה מוצגת דוגמה לפריסה של חלונית ההגדרות של טריגר ServiceNow:

תמונה שבה מוצגת חלונית הגדרת הטריגר של ServiceNow תמונה שמציגה את חלונית הגדרת הטריגר של ServiceNow

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

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

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

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

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

    כניסה לדף Connections

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

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

עריכת טריגר של ServiceNow

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

כדי לערוך טריגר של ServiceNow:

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

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

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

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

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