ServiceNow

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

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

לפני שמשתמשים במחבר של ServiceNow, צריך לבצע את המשימות הבאות:

• בפרויקט ב-Google Cloud:
  • מוודאים שהחיבור לרשת מוגדר. למידע על דפוסי רשת, ראו קישוריות לרשת.
  • מקצים את התפקיד roles/connectors.admin ב-IAM למשתמש שמגדיר את המחבר.
  • מקצים את התפקידים הבאים ב-IAM לחשבון השירות שבו רוצים להשתמש בשביל המחבר:
    • roles/secretmanager.viewer
    • roles/secretmanager.secretAccessor

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

  • מפעילים את השירותים הבאים:
    • secretmanager.googleapis.com (Secret Manager API)
    • connectors.googleapis.com (Connectors API)

    במאמר הפעלת שירותים מוסבר איך להפעיל שירותים.

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

• נותנים גישה לטבלאות הבאות במופע של ServiceNow:

  • sys_db_object
  • sys_dictionary
  • sys_glide_object

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

  1. באפליקציית ServiceNow, עוברים אל System Security > בקרת גישה (ACL)‎.
  2. לוחצים על New (חדש) כדי ליצור אובייקט של בקרת גישה.
  3. בשדה Type, בוחרים באפשרות record.
  4. ב-Operation, בוחרים באפשרות read.
  5. בשדה Name, בוחרים באפשרות Table [sys_db_object]‎ בתפריט הנפתח הראשון ובאפשרות --None--‎ בתפריט הנפתח השני.
  6. בקטע Requires role, לוחצים לחיצה כפולה על תיבת הטקסט Insert a new row....‎, מחפשים את התפקיד הרצוי ובוחרים אותו.
  7. לוחצים על Submit כדי ליצור את אובייקט ה-ACL.
  8. מקצים את התפקיד עם רשימת ה-ACL שנוצרה למשתמש המאמת. כדי לעשות את זה, עוברים אל User Administration (ניהול משתמשים) > Users (משתמשים) > Select authenticating user (בחירת משתמש לאימות) > Roles (תפקידים) > Edit... (עריכה...) > . ואז להוסיף את התפקיד מהאוסף.

• משיגים את כתובת ה-URL, שם המשתמש והסיסמה של המכונה של ServiceNow.

הגדרת המחבר

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

1. במסוף Cloud, נכנסים לדף Integration Connectors > Connections ובוחרים או יוצרים פרויקט בענן.

   כניסה לדף Connections

2. לוחצים על ‎+ CREATE NEW כדי לפתוח את הדף Create Connection.
3. בקטע Location בוחרים את המיקום של החיבור.
   1. אזור: בוחרים מיקום מהרשימה הנפתחת.

      לרשימה של כל האזורים הנתמכים, ראו מיקומים.

   2. לוחצים על הבא.
4. בקטע Connection Details, ממלאים את הפרטים הבאים:
   1. מחבר: בוחרים באפשרות Servicenow מהרשימה הנפתחת של המחברים הזמינים.
   2. גרסת המחבר: בוחרים את גרסת המחבר מהרשימה הנפתחת של הגרסאות הזמינות.
   3. בשדה Connection Name, נותנים שם למכונה של החיבור.

      שמות החיבורים צריכים לעמוד בקריטריונים הבאים:

      • שמות החיבורים יכולים להכיל אותיות, מספרים או מקפים.
      • האותיות חייבות להיות קטנות.
      • שמות החיבורים חייבים להתחיל באות ולהסתיים באות או במספר.
      • שמות החיבורים יכולים להכיל עד 49 תווים.
      • במחברים שתומכים במינוי לאירועים, שמות החיבורים לא יכולים להתחיל בקידומת "goog".
   4. אם רוצים, מזינים תיאור למופע החיבור.
   5. אם רוצים, מפעילים את Cloud logging ובוחרים רמת יומן. כברירת מחדל, רמת היומן מוגדרת ל-Error.
   6. חשבון שירות: בוחרים חשבון שירות עם התפקידים הנדרשים.
   7. כדי להשתמש בחיבור למינויים לאירועים, בוחרים באפשרות הפעלת מינוי לאירועים. כשבוחרים באפשרות הזו, מוצגות האפשרויות הבאות:
      • ‫Enable event subscription with entity and actions: בוחרים באפשרות הזו כדי להשתמש בחיבור גם למינוי לאירועים וגם לפעולות של המחבר (ישויות ופעולות).
      • ‫Enable only event subscription: בוחרים באפשרות הזו כדי להשתמש בחיבור רק למינוי לאירועים. אם בוחרים באפשרות הזו, לוחצים על Next ואז מגדירים מינוי לאירועים.
   8. Include System Tables: בוחרים באפשרות הזו כדי לאחזר טבלאות מערכת שמאחסנות נתוני אבטחה ומטא-נתונים. רק משתמשים עם הרשאת אדמין יכולים לגשת לטבלאות האלה.
   9. סינון טבלאות: מציינים את הטבלאות כרשימה מופרדת בפסיקים. אפשר להשתמש בשדה הזה כדי לסנן את הטבלאות שרוצים שהחיבור יאחזר, במקום לאחזר את כל הטבלאות.
   10. ערך לתצוגה: מציינים אם החיבור צריך לאחזר את הערך לתצוגה, את הערך בפועל או את שני הערכים ממסד הנתונים.

   הערה: אם מחליטים להגדיר את מאפיין החיבור הזה כ-"true", כל השדות שיוחזרו יהיו מסוג "String" בגלל מגבלות ה-API של ServiceNow.

   • ‫TRUE: הפונקציה מחזירה ערכים לתצוגה בכל השדות.
   • ‫FALSE: הפונקציה מחזירה ערכים בפועל ממסד הנתונים.
   • ALL: הפונקציה מחזירה גם את הערכים בפועל וגם את הערכים המוצגים.
   11. אם רוצים, מגדירים את Connection node settings:
       • מספר מינימלי של צמתים: מזינים את המספר המינימלי של צומתי החיבור.
       • מספר הצמתים המקסימלי: מזינים את מספר צמתי החיבור המקסימלי.

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

   הערה: אתם יכולים להתאים אישית את ערכי צומת החיבור רק אם אתם לקוחות בתשלום לפי שימוש.
   12. אם רוצים, לוחצים על ‎+ ADD LABEL כדי להוסיף תווית לחיבור בצורה של צמד מפתח/ערך.
   13. לוחצים על הבא.
5. בקטע יעדים, מזינים את הפרטים של המארח המרוחק (מערכת לקצה העורפי) שאליו רוצים להתחבר.
   1. סוג היעד: בוחרים סוג יעד.
      • כדי לציין את שם המארח או את כתובת ה-IP של היעד, בוחרים באפשרות כתובת המארח ומזינים את הכתובת בשדה מארח 1.
      • כדי ליצור חיבור פרטי, בוחרים באפשרות Endpoint attachment. ברשימה Endpoint Attachment, בוחרים את נקודת הקצה של הקישור שנוצרה למערכת לקצה העורפי.
      הערה: במאמר קישוריות לרשת פרטית מוסבר איך יוצרים נקודת קצה של קישור. אחרי שיוצרים את נקודת הקצה של הקישור, היא מופיעה ברשימה Endpoint Attachment.

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

      כדי להזין יעדים נוספים, לוחצים על +הוספת יעד.

   2. לוחצים על הבא.
6. בקטע אימות, מזינים את פרטי האימות.
   1. בוחרים סוג אימות ומזינים את הפרטים הרלוונטיים.

      החיבור ל-ServiceNow תומך בסוגי האימות הבאים:

      • שם משתמש וסיסמה

   במאמר הגדרת אימות מוסבר איך להגדיר את סוגי האימות האלה.

   2. לוחצים על הבא.
7. אם הפעלתם מינוי לאירועים, הקטע Event Subscription Details יופיע בדף ליצירת החיבור. כדי להבין איך להגדיר את פרטי המינוי לאירועים, קראו את המאמר הגדרת מינוי לאירועים.
8. בדיקה: בודקים את פרטי החיבור והאימות.
9. לוחצים על יצירה.

הגדרת אימות

מזינים את הפרטים בהתאם לאימות שבו רוצים להשתמש.

• שם משתמש וסיסמה
  • שם משתמש: שם המשתמש ב-ServiceNow שבו משתמשים לחיבור.
  • סיסמה: סוד ב-Secret Manager שמכיל את הסיסמה שמשויכת לשם המשתמש ב-ServiceNow.

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

אם הפעלתם את המינוי לאירועים, הזינו את הערכים הבאים בקטע Event Subscription Details:

• ‫Authentication Token: (אופציונלי) בוחרים את הסוד של אסימון האימות ב-Secret Manager, ואת גרסת הסוד המתאימה מהתפריט הנפתח Secret Version.
• ‫HMAC Algorithm: בוחרים את אלגוריתם ה-HMAC להצפנת המטען הייעודי (payload) של התגובה.
• ‫HMAC Secret Key: אם בחרתם באפשרות HMAC Algorithm, בחרו את הסוד של מפתח ה-HMAC ב-Secret Manager, ואת גרסת הסוד המתאימה מהתפריט הנפתח Secret Version.
• הפעלת קישוריות פרטית: בוחרים באפשרות הזו כדי להאזין לאירועים באופן מאובטח דרך חיבור פרטי.
• מזינים את ההגדרות הבאות של הודעות שלא נמסרו:
  • ‫Dead-letter project ID:: מזהה הפרויקט בענן של Google שבו הגדרתם את נושא ה-Pub/Sub להודעות שלא נמסרו.
  • נושא להודעות ללא מוצא: הנושא ב-Pub/Sub שבו רוצים לכתוב את פרטי האירוע שלא עבר עיבוד.

השלבים אחרי יצירת החיבור

כדי להשלים את הגדרת המינוי לאירועים, צריך לרשום את כתובת ה-URL של ה-webhook באפליקציית ServiceNow. לכן, אחרי שיוצרים את החיבור, צריך לבצע את הפעולות הבאות:

1. עוברים לדף פרטי החיבור של החיבור החדש שנוצר, ומעתיקים את כתובת ה-webhook למינוי לאירועים.
2. מתחברים לאפליקציית ServiceNow ומבצעים את הפעולות הבאות:
   1. בדף All > Business Rules > When to run, בוחרים את הפעולה שרוצים להאזין לה.
   2. לוחצים על הכרטיסייהמתקדם. פעולה זו תפתח את עורך הסקריפטים.
   3. מזינים קוד JavaScript ששולח בקשה לכתובת ה-URL לקריאה חוזרת (callback). הבקשה מכילה את המטען הייעודי (payload) שמופעל בכל פעם שמתרחשת אחת מהפעולות שהופעלו. דוגמה ל-JavaScript:

      תבנית

      (function executeRule(current, previous /*null when async*/ ) {
      var request = new sn_ws.RESTMessageV2();
      request.setEndpoint('WEBHOOK_URL'); // here you must the listener url where you want send the event payload
      
      request.setHttpMethod('POST');
      
      var authToken = "AUTHENTICATION_TOKEN"
      request.setRequestHeader("authorization", authToken);
      request.setRequestHeader("Accept", "application/json");
      request.setRequestHeader('Content-Type', 'application/json');
      
      request.setRequestBody("{\"eventType\":\"" +
      "EVENT_TYPE" + CUSTOM_FIELDS "\"}");
      
      var data = request.getRequestBody();
      var secretKey = "SECRET_KEY";
      
      var signature = SncAuthentication.encode(data, secretKey, "ENCRYPTION_ALGORITHM");
      request.setRequestHeader("hmacauthorization",signature);
      var response = request.execute();
      
      })(current, previous);

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

      • ‫WEBHOOK_URL: כתובת ה-webhook URL למינוי לאירועים, שקיבלתם מדף פרטי החיבור של Integration Connectors.
      • ‫AUTHENTICATION_TOKEN: הטקסט בפועל של אסימון האימות שהגדרתם לחיבור.
      • ‫EVENT_TYPE: הטקסט בפועל של סוג האירוע שהגדרתם בטריגר של ServiceNow.
      • ‫CUSTOM_FIELDS: גוף הבקשה חייב תמיד לכלול את השדה eventType. בנוסף לשדה הזה, אפשר להוסיף שדות אחרים לפי הצורך.
      • ‫SECRET_KEY: הטקסט בפועל של המפתח הסודי שהגדרתם לחיבור.
      • ‫ENCRYPTION_ALGORITHM: צריך להיות אחד מהערכים הבאים:
        • HmacSHA224
        • HmacSHA256
        • HmacSHA384
        • HmacSHA512

        האלגוריתם צריך להיות זהה לאלגוריתם שהגדרתם לחיבור.

      דוגמה

      (function executeRule(current, previous /*null when async*/ ) {
      var request = new sn_ws.RESTMessageV2();
      request.setEndpoint('https://webhook.site/bb37937e-24ea-19b3-9dcd-84eca77f60eg'); // here you must the listener url where you want send the event payload
      
      request.setHttpMethod('POST');
      
      var authToken = "YWRtaW46ZkVpNypxVzhCL3VY"
      request.setRequestHeader("authorization", authToken);
      request.setRequestHeader("Accept", "application/json");
      request.setRequestHeader('Content-Type', 'application/json');
      
      request.setRequestBody("{\"caller_id\":\"" +
      current.caller_id + "\",\"eventType\":\"" +
      "service_now_event_type_1" + "\",\"company\":\"" +
      current.company + "\",\"number\":\"" +
      current.number + "\",\"description\":\"" +
      current.description + "\",\"FirstName\":\"" +
      current.u_firstname + "\",\"LastName\":\"" +
      current.u_lastname + "\",\"status\":\"" +
      current.u_status + "\",\"Element\":\"" +
      current.getElement() + "\",\"category\":\"" +
      current.category + "\",\"opened_at\":\"" +
      current.opened_at + "\",\"opened_by\":\"" +
      current.opened_by + "\",\"location\":\"" +
      current.location + "\",\"salesforceId\":\"" +
      current.u_salesforceid + "\"}"); //fields you want
      
      var data = request.getRequestBody();
      var secretKey = "YWRtaW46ZkVpNypxVzhCL3VY";
      
      // var MAC_ALG_4 = "HmacSHA384";
      var MAC_ALG_3 = "HmacSHA256";
      // var MAC_ALG_5 = "HmacSHA512";
      // var MAC_ALG_2 = "HmacSHA224";
      
      var signature = SncAuthentication.encode(data, secretKey, MAC_ALG_3);
      request.setRequestHeader("hmacauthorization",signature);
      var response = request.execute();
      
      })(current, previous);

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

דוגמאות להגדרת חיבורים

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

סוג חיבור לאימות בסיסי

שם השדה	פרטים
מיקום	us-central1
מחבר	Servicenow
גרסת המחבר	1
שם החיבור	google-cloud-servicenow-conn
חשבון השירות	Your_Project_Number@serviceaccount
הערכים המוצגים	True
מספר הצמתים המינימלי	2
מספר הצמתים המקסימלי	50
סוג היעד	כתובת המארח
מארח 1	https://Your-domainname.com
שם משתמש	User_name
סיסמה	סיסמה
גרסת הסוד	1

דוגמאות להגדרת חיבורים

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

סוג החיבור לאינטרנט של ServiceNow

שם השדה	פרטים
מיקום	us-central1
מחבר	ServiceNow
גרסת המחבר	1
שם החיבור	gcp-servicenow-conn
חשבון השירות	SERVICE_ACCOUNT_NAME@serviceaccount
מספר הצמתים המינימלי	2
מספר הצמתים המקסימלי	50
סוג היעד	כתובת המארח
מארח 1	https://host_name.com
שם משתמש	שם משתמש
סיסמה	סיסמה
גרסת הסוד	1

ישויות, פעולות ופעילויות

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

הערה: אפשר לראות את הישויות, הפעולות והפעילויות של מחבר במשימה Connectors.

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

  עם זאת, יכול להיות שמחבר מסוים לא תומך בישויות או שאין לו ישויות, ובמקרה כזה הרשימה Entities תהיה ריקה.

• פעולה: פעולה היא הפעילות שאפשר לבצע על ישות. אפשר לבצע כל אחת מהפעולות הבאות בישות:
  • רשימה
  • הורדה
  • יצירה
  • עדכון
  • מחיקה

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

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

הערה: לכל הישויות והפעולות תהיה סכימה משויכת. לדוגמה, סכמת פעולה תכלול את פרטי הפרמטרים, כמו שמות הפרמטרים וסוג הנתונים המתאים. הסכימה (המטא-נתונים) של הישויות והפעולות נשלפת על ידי החיבור בזמן הריצה מה-backend. אם יש עדכונים לסכימה, הם לא יופיעו באופן אוטומטי בחיבורים הקיימים. צריך לרענן את הסכימה באופן ידני. כדי לרענן את הסכימה של החיבור, פותחים את הדף Connection details של החיבור ולוחצים על Refresh connection schema.

פעולות

בקטע הזה מפורטות כל הפעולות שנתמכות בחיבור ל-ServiceNow.

פעולת UploadAttachment

הפעולה הזו מעלה קובץ כקובץ מצורף לרשומה שצוינה.

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

שם הפרמטר	סוג נתונים	חובה	תיאור
תוכן	String	לא	תוכן מחרוזת להעלאה כקובץ.
ContentBytes	String	לא	תוכן בבייטים להעלאה כקובץ.
HasBytes	בוליאני	לא	אם להעלות תוכן כבייטים.
TableName	String	לא	שם הטבלה שאליה רוצים לצרף את הקובץ.
TableSysId	String	לא	Sys_id של הרשומה בטבלה שצוינה ב-TableName, שאליה רוצים לצרף את הקובץ.

פרמטרים של פלט לפעולה UploadAttachment

הפעולה הזו מחזירה קבוצה של פרמטרים מהישות שהועלתה

בקטע דוגמאות מוסבר איך להגדיר את הפעולה UploadAttachment.

הפעולה DownloadAttachment

הפעולה הזו מורידה קובץ מצורף מרשומה ספציפית.

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

שם הפרמטר	סוג נתונים	חובה	תיאור
SysId	String	כן	‫Sys_id של הקובץ המצורף.
HasBytes	בוליאני	לא	אם להוריד תוכן כבייטים.

פרמטרים של פלט לפעולה DownloadAttachment

הפעולה הזו מחזירה את הערך True או False לגבי ההורדה באמצעות פרמטר ההצלחה, ואם הערך הוא True, היא מוציאה את התוכן של DownloadAttachment

בקטע דוגמאות מוסבר איך להגדיר את הפעולה DownloadAttachment.

דוגמאות

בקטע הזה מוסבר איך לבצע חלק מהפעולות על ישויות במחבר הזה.

דוגמה – העלאת קובץ מצורף לאירוע

1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
2. בוחרים את הפעולה UploadAttachment ולוחצים על סיום.
3. בקטע Task Input של המשימה Connectors, לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:

   {
     "Content": "File is uploaded",
     "TableName": "Incident",
     "TableSysId": "018f4057473ae5104593a6b5316d4357"
   }

בדוגמה הזו, הערך Content מועלה מ-Payload כקובץ מצורף, ומוחזרת קבוצת הפרמטרים של הישות שהועלתה . אם הפעולה בוצעה בהצלחה, לפרמטר התגובה connectorOutputPayload של המשימה UploadAttachment יהיה ערך דומה לזה:

{
"SysId": "a667f5d1939be110ff87352d6cba10fc",
"FileName": "7043426257788756581.connector.txt",
"TableSysId": "018f4057473ae5104593a6b5316d4357",
"TableName": "Incident",
"DownloadLink": "https://gcp.service-now.com/api/now/v1/attachment/a667f5d1939be110ff87352d6cba10fc/file",
"ContentType": "text/plain",
"SizeBytes": "16",
"ChunkSizeBytes": "700000",
"Compressed": "true",
"SizeCompressed": "36",
"SysTags": "",
"ImageHeight": "",
"ImageWidth": "",
"AverageImageColor": "",
"SysModCount": "0",
"Hash": "807e96c2942c41ad699d004a9d6a74595c84fab09111d479b6bbe013d5debff6",
"State": "pending",
"SysUpdatedBy": "gcp2",
"SysUpdatedOn": "2023-06-07 07:23:34",
"SysCreatedBy": "gcp2",
"SysCreatedOn": "2023-06-07 07:23:34",
"encryption_context": ""
}

דוגמה – הורדת קובץ מצורף של אירוע

1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
2. בוחרים את הפעולה DownloadAttachment ולוחצים על סיום.
3. בקטע Task Input של המשימה Connectors, לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value:

   {
     "SysId": "440c3995471fe1104593a6b5316d4384"
   }

בדוגמה הזו, הפונקציה מחזירה את הערך True או False של ההורדה באמצעות Success Parameter, ואם הערך הוא True, היא מוציאה את התוכן של DownloadAttachment. אם הפעולה בוצעה בהצלחה, לפרמטר התגובה connectorOutputPayload של המשימה DownloadAttachment יהיה ערך דומה לזה:

[{
"Success": "True"
},
{
"Content": " A Simple Text File \r\n\r\n\r\n This is a small demonstration .txt file - \r\n just for use in the Virtual Mechanics tutorials. More text. And more \r\n text. And more text. And more text. And more text. \r\n And more text. And more text. And more text. And more text. And more \r\n text. And more text. Boring, zzzzz. And more text. And more text. And \r\n more text. And more text. And more text. And more text. And more text. \r\n And more text. And more text. \r\n And more text. And more text. And more text. And more text. And more \r\n text. And more text. And more text. Even more. Continued on page 2 ...\r\n Simple PDF File 2 \r\n ...continued from page 1. Yet more text. And more text. And more text. \r\n And more text. And more text. And more text. And more text. And more \r\n text. Oh, how boring typing this stuff. But not as boring as watching \r\n paint dry. And more text. And more text. And more text. And more text. \r\n Boring. More, a little more text. The end, and just as well. "
}]

דוגמאות לפעולות בישויות

בקטע הזה מוסבר איך לבצע חלק מהפעולות של הישויות במחבר הזה.

דוגמה – בקשת GET של רשומה אחת לישות "אירוע"

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
2. בוחרים באפשרות Incident מהרשימה Entity.
3. בוחרים את הפעולה GET ולוחצים על Done.
4. מגדירים את מזהה הישות לערך "0c5f3cece1b12010f877971dea0b1449", שהוא המפתח שצריך להעביר. כדי להגדיר את מזהה הישות, בקטע Data Mapper של Data Mapping, לוחצים על Open Data Mapping Editor, מזינים "0c5f3cece1b12010f877971dea0b1449" בשדה Input Value ובוחרים ב-EntityId כמשתנה מקומי.

הערה:

צריך להעביר את הערך של מזהה הישות ישירות, למשל "0c5f3cece1b12010f877971dea0b1449". בדוגמה הזו, הערך "0c5f3cece1b12010f877971dea0b1449" הוא הערך הייחודי של המפתח הראשי.

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

כדי לאחזר את פרטי שדה התגובה מתחת לישות האירוע, צריך לסמן את ערך התצוגה כ-true ברמת החיבור.

מגבלות המערכת

המחבר של ServiceNow יכול לעבד עד 10 טרנזקציות בשנייה לכל צומת, ומגביל את כל הטרנזקציות מעבר למגבלה הזו. כברירת מחדל, Integration Connectors מקצה 2 צמתים (לזמינות טובה יותר) לחיבור.

למידע על המגבלות שחלות על Integration Connectors, ראו מגבלות.

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

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

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

יצירת חיבורים באמצעות Terraform

אפשר להשתמש במשאב של Terraform כדי ליצור חיבור חדש.

כדי ללמוד איך להחיל הגדרות ב-Terraform או להסיר אותן, ראו פקודות בסיסיות ב-Terraform.

בתבנית לדוגמה אפשר לראות תבנית Terraform לדוגמה ליצירת חיבור.

כשיוצרים את החיבור הזה באמצעות Terraform, צריך להגדיר את המשתנים הבאים בקובץ התצורה של Terraform:

שם הפרמטר	סוג נתונים	חובה	תיאור
proxy_enabled	בוליאני	לא נכון	מסמנים את התיבה הזו כדי להגדיר שרת proxy לחיבור.
proxy_auth_scheme	ENUM	לא נכון	סוג האימות שבו צריך להשתמש כדי לאמת את שרת ה-Proxy ב-ProxyServer. הערכים הנתמכים הם: BASIC, ‏ DIGEST, ‏ NONE
proxy_user	מחרוזת	לא נכון	שם משתמש שישמש לאימות בשרת ה-proxy‏ ProxyServer.
proxy_password	SECRET	לא נכון	סיסמה לאימות בשרת ה-Proxy שצוין ב-ProxyServer.
proxy_ssltype	ENUM	לא נכון	סוג ה-SSL שבו צריך להשתמש כשמתחברים לשרת ה-proxy של ProxyServer. הערכים הנתמכים הם: AUTO, ALWAYS, NEVER, TUNNEL
include_system_tables	בוליאני	לא נכון	ההגדרה קובעת אם לחשוף את טבלאות המערכת או לא.
filter_tables	מחרוזת	לא נכון	מציינים את הטבלאות שרוצים ברשימה מופרדת בפסיקים.

שימוש בחיבור ל-ServiceNow בשילוב

אחרי שיוצרים את החיבור, הוא זמין גם ב-Apigee Integration וגם ב-Application Integration. אתם יכולים להשתמש בחיבור בשילוב באמצעות המשימה Connectors.

• כדי להבין איך יוצרים את המשימה Connectors ומשתמשים בה ב-Apigee Integration, קראו את המאמר המשימה Connectors.
• כדי להבין איך יוצרים את המשימה Connectors ומשתמשים בה ב-Application Integration, קראו את המאמר המשימה Connectors.

קבלת עזרה מקהילת Google Cloud

אתם יכולים לפרסם שאלות ולדון במחבר הזה בקהילת Google Cloud בפורומים של Cloud.

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

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