טריגר של Salesforce

הטריגר של Salesforce מאפשר לכם להאזין לאירועים של Change Data Capture (CDC) או של Enterprise Messaging Platform. באמצעות הטריגר הזה, אתם יכולים להתחיל את השילוב על סמך כל אחד מאירועי ה-CDC (יצירה, עדכון, מחיקה או ביטול מחיקה) או אירועי הפלטפורמה במופע Salesforce שלכם.

מידע נוסף זמין במדריכים הבאים:

• כדי להשתמש ב-Application Integration כדי להפוך לאוטומטי את תהליך העבודה העסקי של ניתוב והקצאה של פנייה של לקוח ב-Salesforce, אפשר לעיין במדריך בנושא אוטומציה של הקצאת ניתוב של פניות ב-Salesforce.
• כדי להשתמש ב-Application Integration כדי להפוך לאוטומטי את תהליך ניהול ההזמנות בין אפליקציה לניהול קשרי לקוחות (CRM) לבין אפליקציה לתכנון משאבים ארגוניים (ERP), אפשר לעיין במדריך בנושא אוטומציה של הזדמנות ב-Salesforce להזמנה ב-BigQuery.
• כדי להשתמש בטריגר Salesforce כדי להפעיל שילוב ב-Application Integration עבור אירוע Salesforce Change Data Capture ‏ (CDC), אפשר לעיין במדריך בנושא הפעלת שילוב עבור אירוע Salesforce Change Data Capture ‏ (CDC).

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

בקטע הזה מפורטים השלבים שנדרשים כדי לחבר ולהגדיר מופע של Salesforce לשימוש ב-Change Data Capture (CDC) או באירועי Platform כדי להזרים שינויים אל Application Integration באופן של פרסום/הרשמה. צריך לבצע את השלבים הבאים לפני שמגדירים משימה או טריגר שקשורים ל-Salesforce ב-Application Integration:

• הגדרה של משתמש שילוב
• הגדרת קבוצת הרשאות
• הגדרת טוקן אבטחה
• יצירת אפליקציה מקושרת

הגדרת משתמש שילוב

כדי להגדיר משתמש לשילוב, פועלים לפי השלבים הבאים:

1. מתחברים למופע Salesforce באמצעות פרטי הכניסה שלכם ב-sysadmin.
2. לוחצים על סמל גלגל השיניים ואז בוחרים באפשרות הגדרה, כמו שמוצג בתמונה הבאה:
3. בתפריט ניהול, לוחצים על משתמשים > משתמשים.
4. בחלונית משתמשים, לוחצים על הלחצן משתמש חדש.
5. בתיבת הדו-שיח עריכת משתמש, ממלאים את הפרטים הבאים:
   1. שם פרטי: השם הפרטי של המשתמש בשילוב.
   2. ‫Last Name: שם המשפחה של המשתמש בשילוב.
   3. כתובת אימייל: כתובת האימייל של משתמש האינטגרציה. מומלץ להשתמש בכתובת אימייל קבוצתית.
   4. שם משתמש: שם משתמש שעומד בכל מוסכמות מתן השמות ברמת הארגון.

      אם יוצרים משתמש חדש לשילוב, משתמשים בפורמט הבא: EMAIL.SALESFORCE_ORG_NAME.SANDBOX_NAME

      אם יש לכם משתמש שילוב קיים, ודאו ששם המשתמש שלו הוזן כאן.

   5. תפקיד: בוחרים אפשרות מהתפריט הנפתח.
   6. רישיון משתמש: מזינים Salesforce או, אם משתמשים בארגון ניסיון, מזינים Salesforce Platform.
   7. פרופיל: בתפריט הנפתח, בוחרים את פרופיל ההרשאות למשתמשי השילוב.

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

   8. לוחצים על Save.
6. כדי לעדכן את הסיסמה של משתמש השילוב החדש, פועלים לפי השלבים הבאים:
   1. בחלונית משתמשים, לוחצים על הלחצן איפוס סיסמאות. הודעת אימייל לאיפוס הסיסמה נשלחת לכתובת האימייל שמשויכת למשתמש.
   2. מבצעים את תהליך איפוס הסיסמה דרך חשבון האימייל. חשוב לשים לב לסיסמה החדשה, כי תצטרכו אותה בשלב מאוחר יותר.

הגדרת קבוצת הרשאות

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

כדי להגדיר קבוצת הרשאות למשתמש השילוב:

1. בתפריט הגדרה, לוחצים על משתמשים > קבוצות הרשאות.
2. בחלונית Permission Sets, לוחצים על הלחצן New.
3. בתיבת הדו-שיח Permission Sets, מזינים את הפרטים הבאים:
   • תווית: מזינים שם לסט הרשאות.
   • רישיון: בוחרים באפשרות Salesforce מהתפריט הנפתח רישיון.
   • לוחצים על Save.
4. ברשימת אפשרויות ההגדרה של מערכת, גוללים למטה ובוחרים באפשרות הרשאות מערכת.
5. בדף הרשאות מערכת, לוחצים על הלחצן עריכה.
6. גוללים למטה ברשימת ההרשאות הזמינות ומסמנים את תיבת הסימון API Enabled (ה-API מופעל).

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

7. (אופציונלי) גוללים ובוחרים באפשרות שינוי כל הנתונים ובאפשרות הצגת כל הנתונים, אם רלוונטי. ההרשאות האלה לא נדרשות, אבל הן יכולות להיות שימושיות אם רוצים לתת למשתמש האינטגרציה גישה אוטומטית לאובייקטים חדשים. מומלץ להפעיל את ההרשאות האלה רק לצורך בדיקה בסביבת ארגז חול.
8. גוללים לחלק העליון של רשימת ההרשאות ולוחצים על שמירה.
9. מאשרים את ההגדרות ולוחצים על שמירה.

כדי להגדיר את קבוצת ההרשאות לאובייקט Salesforce:

1. לוחצים על Permission Set Overview (סקירה כללית של קבוצת הרשאות) כדי לחזור לדף ההגדרות הראשי של Permissions Set (קבוצת הרשאות).
2. בקטע Apps (אפליקציות) בחלונית Permissions Set (קבוצת הרשאות), בוחרים באפשרות Object Settings (הגדרות אובייקט).
3. גוללים למטה ובוחרים את האובייקטים ב-Salesforce שנדרשת להם קבוצת הרשאות. בדוגמה הזו נעשה שימוש באובייקט Opportunity.
4. לוחצים על הלחצן עריכה בדף הפרטים של האובייקט.
5. מסמנים את תיבות הסימון של סוגי הרשומות. אם אתם יודעים אילו סוגי רשומות נדרשים, מסמנים אותם. אם אתם לא יודעים אילו סוגי רשומות נדרשים, בוחרים את כולם.
6. מסמנים את תיבות הסימון של הרשאות לאובייקט כדי להפעיל אותן. מומלץ להשתמש בהרשאות קריאה והצגת כל ההמלצות.
7. מסמנים את תיבת הסימון המתאימה כדי להעניק הרשאת קריאה או הרשאת עריכה לכל שדה של אובייקט.
8. גוללים לחלק העליון של הדף ולוחצים על שמירה.

הגדרת טוקן אבטחה

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

אחרת, פועלים לפי השלבים הבאים כדי לאפס את אסימון האבטחה של משתמש השילוב:

1. מתחברים ל-Salesforce בתור המשתמש לשילוב, באמצעות שם המשתמש והסיסמה שהוגדרו בשלב הקודם.
2. בתפריט הראשי, לוחצים על תמונת הפרופיל ואז על הגדרות.
3. בתפריט הגדרות, בוחרים באפשרות איפוס אסימון האבטחה שלי כדי לפתוח את החלונית איפוס אסימון האבטחה.
4. לוחצים על הלחצן איפוס אסימון האבטחה.
5. בודקים את חשבון האימייל שמשויך למשתמש האינטגרציה כדי למצוא אימייל עם אסימון האבטחה החדש. חשוב לשים לב לאסימון האבטחה החדש, כי תצטרכו אותו בשלב מאוחר יותר.
6. (אופציונלי) מפעילים את ההרשאה Api User Only בSystem Permissions עבור קבוצת ההרשאות, כמו שמתואר בקטע Configure a permission set למעלה.

יצירת אפליקציה מקושרת

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

כדי להגדיר אפליקציה מקושרת:

1. לוחצים על סמל גלגל השיניים ואז על הגדרה.
2. בתפריט הגדרה, מחפשים את האפשרות המרכז לניהול אפליקציות ולוחצים עליה, כמו שמוצג בתמונה הבאה:
3. לוחצים על New Connected App (אפליקציה מקושרת חדשה).
4. בחלונית ההגדרות, מזינים את הפרטים הבאים:
   • שם האפליקציה המקושרת: מזינים שם לאפליקציה המקושרת.
   • שם ה-API: מזינים את שם ה-API.
   • כתובת אימייל ליצירת קשר: מזינים כתובת אימייל לאפליקציה המקושרת, רצוי כתובת אימייל קבוצתית.
   • ‫API (הפעלת הגדרות OAuth): בוחרים באפשרות הפעלת הגדרות OAuth. לאחר מכן מגדירים את האפשרויות הבאות:
     1. כתובת URL של קריאה חוזרת: נדרשת רק אם רוצים ששירות חיצוני יקבל את תגובת ההרשאה של OAuth (לדוגמה, קודי הרשאה או אסימונים) ויבצע אימות. אם בוחרים לספק מספר לחזרה, צריך לכלול את הקידומת http(s)://.
     2. היקפי ההרשאות של OAuth שנבחרו: בוחרים:
        • גישה לנתונים שלכם וניהול שלהם (API)
        • ביצוע בקשות בשמכם בכל שלב (refresh_token, offline_access)
5. לוחצים על Save.
6. לוחצים על Continue. תצטרכו לאשר מחדש באמצעות קוד אימות שיישלח לכתובת האימייל שלכם.
7. אחרי אימות הקוד בהצלחה, בדף הבא מוצגים סוד לשימוש עם טוקן צרכן וטוקן צרכן. חשוב לרשום את הערכים האלה, כי תצטרכו אותם כשמגדירים את מודול האימות ל-Application Integration.
8. לוחצים על הלחצן ניהול.
9. בדף Connected App Detail (פרטי האפליקציה המקושרת), לוחצים על הלחצן Edit Policies (עריכת מדיניות).
10. בקטע OAuth Policies (מדיניות OAuth), משנים את הערך בתפריט הנפתח Permitted Users (משתמשים מורשים) ל-Admin approved users are pre-authorized (משתמשים שאושרו על ידי האדמין מורשים מראש).
11. לוחצים על Save.
12. גוללים לקטע Profiles (פרופילים) ו-Permission Sets (קבוצות הרשאות) בדף כדי לבחור את הפרופיל או את קבוצת ההרשאות שרוצים להחיל על האפליקציה המקושרת.
13. בוחרים את הפרופיל או את קבוצת ההרשאות הרצויים.
14. לוחצים על Save.

שלבים מקדימים לשימוש באירועי CDC

לפני שמגדירים את הטריגר של Application Integration לשימוש באירועי CDC, צריך לוודא שמוסיפים אובייקט מוגדר ל-CDC ב-Salesforce:

1. מתחברים ל-Salesforce בתור sysadmin.
2. לוחצים על סמל גלגל השיניים ואז על הגדרה.
3. בסרגל הניווט הימני, מחפשים את האפשרות Change Data Capture (סימון נתונים שהשתנו (CDC)) ובוחרים בה.
4. בדף ההגדרה Change Data Capture, מאתרים את אובייקט Salesforce שרוצים להשתמש בו בעמודה Available Entities וגוררים אותו לעמודה Selected Entities.
5. לוחצים על Save.

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

לפני שמגדירים את הטריגר של Application Integration לשימוש באירועים של הפלטפורמה, צריך לבצע את השלבים הבאים ב-Salesforce:

• יצירת אירוע פלטפורמה
• עדכון ההרשאות לאירוע הפלטפורמה

יצירת אירוע פלטפורמה

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

1. מתחברים למכונה ב-Salesforce באמצעות פרטי הכניסה sysadmin.
2. לוחצים על סמל גלגל השיניים ואז בוחרים באפשרות הגדרה.
3. בחלונית הניווט, מחפשים את Platform ולוחצים על Platform events.

4. בדף Platform events (אירועים בפלטפורמה), לוחצים על New Platform Event (אירוע חדש בפלטפורמה) ומגדירים את המאפיינים הבאים:

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

לוחצים על Save.

יוצרים שדות מותאמים אישית. כדי ליצור את השדות המותאמים אישית, לוחצים על New (חדש) בקטע Custom Fields and Relationships (שדות מותאמים אישית וקשרים) ובוחרים את סוג השדה המותאם אישית. אפשר ליצור כמה שדות מותאמים אישית שרוצים.

אחרי שיוצרים את השדות המותאמים אישית, בדף Platform events, שימו לב לערך בשדה API Name. שם האובייקט מסתיים ב-_e, מה שאומר שהאובייקט הוא אובייקט של אירוע פלטפורמה. בשביל אובייקט CDC, שם האובייקט מסתיים ב-_c.

עדכון ההרשאות לאירוע הפלטפורמה

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

כדי לעדכן את ההרשאות, פועלים לפי השלבים הבאים:

1. בתפריט הגדרה, לוחצים על משתמשים > קבוצות הרשאות.
2. בדף Permission Sets, לוחצים על ההרשאה שנוצרה קודם.
3. לוחצים על הגדרות אובייקט > Plural Label of the Platform Event.
4. בקטע Object Permissions, מפעילים את ההרשאות Read ו-Create.
5. לוחצים על Save.

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

כדי להוסיף טריגר של Salesforce לשילוב חדש או קיים, פועלים לפי השלבים הבאים:

1. נכנסים לדף