במדריך הזה מתואר תרחיש שימוש שמראה איך אפשר להשתמש ב-Application Integration כדי להפוך לאוטומטי את תהליך העבודה העסקי של ניתוב והקצאה של פנייה של לקוח ב-Salesforce.
סקירה כללית
במדריך הזה ניצור שילוב שמשתמש בטריגר של Salesforce כדי להירשם לערוץ של אירוע ב-Salesforce. פנייה חדשה ב-Salesforce מפעילה את השילוב, שמחלץ את מספר הפנייה ואת סוג הפנייה. בהתאם לסוג הבקשה, נוצרת בעיה או תקרית חדשה ב-Jira Cloud או ב-ServiceNow, בהתאמה.
מטרות
במדריך הזה מוסבר איך לבצע את הפעולות הבאות בשילוב:
- מגדירים טריגר של Salesforce כדי להפעיל את השילוב.
- הוספה והגדרה של משימות Connectors לחיבורים של Salesforce, Jira Cloud ו-ServiceNow.
- מוסיפים ומגדירים משימות של מיפוי נתונים כדי לחלץ ולמפות פרטי אירועים.
עלויות
במדריך הזה משתמשים ברכיבים הבאים של Google Cloud, והשימוש בהם כרוך בתשלום:
ההוראות במדריך הזה נועדו לוודא שהשימוש במשאבים יהיה במסגרת המגבלות של התוכנית בחינם של Google Cloud.
כשמסיימים את המשימות שמתוארות במסמך הזה אפשר למחוק את המשאבים שיצרתם כדי להימנע מחיובים נוספים. מידע נוסף זמין בקטע הסרת המשאבים.
לפני שמתחילים
- נכנסים לחשבון Google Cloud . אם אתם משתמשים חדשים ב- Google Cloud, צרו חשבון כדי שתוכלו להעריך את הביצועים של המוצרים שלנו בתרחישים מהעולם האמיתי. לקוחות חדשים מקבלים בחינם גם קרדיט בשווי 300$ להרצה, לבדיקה ולפריסה של עומסי העבודה.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator role
(
roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
-
Create a service account:
-
Ensure that you have the Create Service Accounts IAM role
(
roles/iam.serviceAccountCreator) and the Project IAM Admin role (roles/resourcemanager.projectIamAdmin). Learn how to grant roles. -
In the Google Cloud console, go to the Create service account page.
Go to Create service account - Select your project.
-
In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.
In the Service account description field, enter a description. For example,
Service account for quickstart. - Click Create and continue.
-
Grant the following roles to the service account: Secret Manager Viewer (
roles/secretmanager.viewer), Secret Manager Secret Accessor (roles/secretmanager).To grant a role, find the Select a role list, then select the role.
To grant additional roles, click Add another role and add each additional role.
- Click Continue.
-
Click Done to finish creating the service account.
-
Ensure that you have the Create Service Accounts IAM role
(
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator role
(
roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
-
Create a service account:
-
Ensure that you have the Create Service Accounts IAM role
(
roles/iam.serviceAccountCreator) and the Project IAM Admin role (roles/resourcemanager.projectIamAdmin). Learn how to grant roles. -
In the Google Cloud console, go to the Create service account page.
Go to Create service account - Select your project.
-
In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.
In the Service account description field, enter a description. For example,
Service account for quickstart. - Click Create and continue.
-
Grant the following roles to the service account: Secret Manager Viewer (
roles/secretmanager.viewer), Secret Manager Secret Accessor (roles/secretmanager).To grant a role, find the Select a role list, then select the role.
To grant additional roles, click Add another role and add each additional role.
- Click Continue.
-
Click Done to finish creating the service account.
-
Ensure that you have the Create Service Accounts IAM role
(
הכנת הסביבה
אימות הגדרת משתמש Salesforce
במדריך הזה אנחנו מניחים שיש לכם חשבון פיתוח קיים ב-Salesforce עם הגדרת המשתמשים וקבוצת ההרשאות הנדרשות. מוודאים שהלכידת נתונים משתנים (CDC) מופעלת בחשבון. מידע על יצירת חשבון חדש זמין במאמר בנושא הגדרת משתמש שילוב.
אימות חשבון Jira Cloud
במדריך הזה משתמשים ב-Jira Cloud. אתם יכולים להשתמש בחשבון Jira Cloud הקיים או ליצור חשבון חדש. מוודאים שהפרויקט בענן והלוחות שלכם ב-Jira מוגדרים. מידע נוסף על Jira Cloud זמין במאמרי העזרה של Jira Software.
אימות מופע ServiceNow
במדריך הזה נעשה שימוש במופע חינמי של ServiceNow Personal Developer Instance (PDI). אתם יכולים להשתמש במופע ServiceNow הקיים או ליצור מופע חדש. מוודאים שהמופע פעיל ורושמים את כתובת ה-URL של המופע. מידע נוסף על PDI זמין במסמכי התיעוד של ServiceNow PDI.
הגדרת חיבורים
כדי לבצע את המדריך הזה, צריך להגדיר את החיבורים הבאים ב-Integration Connectors:
- חיבור ל-Salesforce
- הגדרת חיבור ל-Salesforce בכלי Integration Connectors. מידע על הגדרת מחבר Salesforce זמין במאמר מחבר Salesforce.
- חיבור ל-Jira Cloud
- מגדירים חיבור ל-Jira Cloud ב-Integration Connectors באמצעות כתובת ה-URL של הפרויקט כדי ליצור בעיות ב-Jira בפרויקט. חשוב לרשום את מזהה הפרויקט ומזהה הבעיה. מידע על הגדרת מחבר Jira Cloud זמין במאמר Jira Cloud connector.
- חיבור ל-ServiceNow
- מגדירים חיבור ל-ServiceNow ב-Integration Connectors באמצעות כתובת ה-URL של המופע כדי ליצור אירועים ב-ServiceNow. מידע על הגדרת מחבר ServiceNow זמין במאמר מחבר ServiceNow.
יצירת שילוב
כדי ליצור שילוב חדש, מבצעים את הפעולות הבאות:
- במסוף Google Cloud, עוברים לדף Application Integration.
- בתפריט הניווט שמימין, לוחצים על שילובים כדי לפתוח את הדף שילובים.
- לוחצים על יצירת שילוב ומזינים את הפרטים הבאים בדף יצירת שילוב:
- שם השילוב: מזינים
salesforce-case-integration. - תיאור: מזינים
Demo integration created for tutorial. - אזור: בוחרים באפשרות
us-central1מתוך רשימת האזורים הנתמכים. - לוחצים על יצירה כדי לפתוח את כלי העריכה של השילוב.
- שם השילוב: מזינים
הגדרת טריגר לשילוב
אחרי שיוצרים את השילוב בהצלחה, אפשר להוסיף ולהגדיר טריגר לשילוב שמפעיל את השילוב עבור אירוע מזוהה.
במדריך הזה, טריגר של Salesforce משמש להפעלת השילוב בכל פעם שנוצרת פנייה חדשה ב-Salesforce. כדי להוסיף ולהגדיר טריגר של Salesforce בשילוב salesforce-case-integration:
- בכלי לעריכת שילובים, לוחצים על טריגרים כדי להציג רשימה של טריגרים זמינים.
- לוחצים על הרכיב Salesforce trigger (טריגר של Salesforce) וממקמים אותו בכלי לעריכת שילובים.
- בוחרים את רכיב Salesforce trigger (טריגר של Salesforce) באזור העיצוב כדי לפתוח את חלונית ההגדרות של הטריגר של Salesforce.
- מגדירים את השדות הבאים בקטע Trigger Input (קלט הטריגר):
- סוג האירוע: בוחרים באפשרות Change Data Capture (CDC) (לכידת שינויים בנתונים) מהרשימה הנפתחת.
- הגדרת מופע Salesforce: לוחצים על האפשרות + הוספת הגדרה חדשה של מופע Salesforce מהרשימה הנפתחת.
בתיבת הדו-שיח הוספת הגדרה של מופע Salesforce, מבצעים את הפעולות הבאות:
- שם החיבור של המכונה ב-Salesforce: מזינים שם חיבור למכונה ב-Salesforce. לדוגמה,
test. - דומיין ב-Salesforce: מזינים את שם הדומיין ב-Salesforce. אפשר למצוא את המידע הזה בדף חשבון Salesforce > הצגת הפרופיל.
- פרופיל אימות: בוחרים פרופיל אימות. אם אין לכם פרופיל אימות, אתם צריכים ליצור פרופיל חדש. מידע נוסף זמין במאמר בנושא יצירת פרופיל אימות חדש.
- לוחצים על הוספה.
- שם החיבור של המכונה ב-Salesforce: מזינים שם חיבור למכונה ב-Salesforce. לדוגמה,
- הגדרת ערוץ Salesforce: לוחצים על האפשרות + הוספת הגדרה חדשה של ערוץ Salesforce מהרשימה הנפתחת.
בתיבת הדו-שיח הוספת ערוץ Salesforce:
- שם האובייקט ב-Salesforce: מזינים
Case. - לוחצים על הוספה.
- שם האובייקט ב-Salesforce: מזינים
- פעולה: בוחרים באפשרות יצירה מהרשימה הנפתחת.
השינויים במאפיינים נשמרים אוטומטית.
מיפוי של מטען ייעודי (payload) של טריגר למחבר Salesforce
כשמפעילים את השילוב באמצעות הטריגר של Salesforce, מחלצים את מזהה הפנייה וממפים אותו למחבר Salesforce כדי לאחזר פרטים נוספים של הפנייה.
התחברות לחשבון Salesforce
כדי להוסיף ולהגדיר משימת Connectors לאחזור פרטי הפנייה באמצעות הקישור Salesforce, פועלים לפי השלבים הבאים:
- בכלי לעריכת שילובים, לוחצים על משימות כדי להציג רשימה של משימות זמינות.
- לוחצים על הרכיב Connectors (מחברים) וממקמים אותו בעורך השילובים.
- בוחרים את רכיב המשימה Connectors (מחברים) בכלי העיצוב כדי להציג את חלונית ההגדרות של משימת Connectors.
- לוחצים על ומשנים את השם של התווית Connectors (מחברים) ל-
Fetch Salesforce Data. - לוחצים על Configure connector (הגדרת מחבר).
- בדף Connectors Task Editor (עורך משימות של מחברים), מבצעים את הפעולות הבאות:
- בקטע בחירת חיבור, בוחרים באזור
us-central1. - בוחרים את החיבור ל-Salesforce מתוך רשימת החיבורים הזמינים.
- לוחצים על הבא.
- בקטע סוג, בוחרים באפשרות ישויות.
- בקטע הגדרת ישויות/פעולות, בוחרים באפשרות Case (פנייה) מתוך רשימת הישויות הזמינות, ואז בוחרים באפשרות Get (קבלת נתונים) בתור Operation (פעולה).
- לוחצים על סיום כדי להשלים את הגדרת הקישור ולסגור את החלונית.
- בקטע בחירת חיבור, בוחרים באזור
חילוץ ומיפוי של מספר הפנייה
משימת מיפוי נתונים משמשת למיפוי ולחילוץ של פרטי הפנייה בין הטריגר של Salesforce לבין המחבר של Salesforce.
כדי להוסיף ולערוך את מיפוי הנתונים בשילוב:
- בכלי לעריכת שילובים, לוחצים על משימות כדי להציג רשימה של משימות זמינות.
- לוחצים על הרכיב מיפוי נתונים וממקמים אותו בכלי לעריכת שילובים.
- בוחרים את הרכיב מיפוי נתונים בכלי העיצוב כדי להציג את חלונית הגדרת המשימה.
- לוחצים על ומשנים את השם של המשימה מיפוי נתונים ל-
Get Case ID. - לוחצים על פתיחת הכלי למיפוי נתונים.
הכלי למיפוי נתונים מאפשר לכם למפות משתני קלט למשתני הפלט הרצויים, באמצעות פונקציות ההמרה הזמינות. הפלט זמין כמשתנה לכל משימת שילוב או טריגר אחרים. פרטים נוספים על מיפוי משתנים זמינים במאמר הוספת מיפוי.
- ממפים את משתנה הפלט של הטריגר —
SalesforceTriggerCdcRecordID—למשתנה הקלט של המחבר שנוצר אוטומטית —entityId(Fetch Salesforce Data)—.אחרי שמסיימים את המיפוי, סוגרים את החלונית. כל השינויים יישמרו אוטומטית.
- מוסיפים חיבור Edge מהטריגר Salesforce למשימה קבלת מזהה אירוע.
- מוסיפים חיבור קצה מהמשימה קבלת מזהה פנייה למחבר אחזור נתונים מ-Salesforce.
חילוץ סוג בקשת התמיכה
אחרי שמאחזרים את כל פרטי הפנייה ממחבר Salesforce, מחלצים את סוג הפנייה ומנתבים אותה לאפליקציית Jira Cloud או ServiceNow.
כדי לחלץ את סוג הפנייה ב-Salesforce:
- בכלי לעריכת שילובים, לוחצים על משימות כדי להציג רשימה של משימות זמינות.
- לוחצים על הרכיב מיפוי נתונים וממקמים אותו בכלי לעריכת שילובים.
- לוחצים על הרכיב מיפוי נתונים בכלי העיצוב כדי לראות את חלונית הגדרת המשימה.
- לוחצים על ומשנים את השם של המשימה מיפוי נתונים ל-
Get case type. - לוחצים על פתיחת הכלי למיפוי נתונים.
- לוחצים על + הוספת משתנה חדש ויוצרים את משתנה הפלט הבא:
שם משתנה הפלט סוג נתונים sf_case_typeSTRING - יוצרים את המיפוי הבא בין משתנה מטען הייעודי (payload) של מחבר Salesforce לבין המשתנה המקומי:
קלט תשובה connectorOutputPayload (Fetch Salesforce Data) .GET_PROPERTY("Type")sf_case_typeאחרי שמסיימים את המיפוי, סוגרים את החלונית. כל השינויים יישמרו אוטומטית.
- מוסיפים חיבור קצה מהמחבר Fetch Salesforce Data למשימה Get case type.
יצירת קריאה חדשה ב-Jira
אחרי שמחלצים את סוג האירוע ב-Salesforce, אם האירוע הוא מסוג: Engineering, מעבירים אותו ל-Jira Cloud כבעיה חדשה.
קישור לפרויקט Jira
כדי להגדיר משימת Connectors שיוצרת בעיה חדשה בפרויקט Jira:
- בכלי לעריכת שילובים, לוחצים על משימות כדי להציג רשימה של משימות זמינות.
- לוחצים על הרכיב Connectors (מחברים) וממקמים אותו בעורך השילובים.
- לוחצים על רכיב המשימה Connectors (מחברים) בכלי העיצוב כדי להציג את חלונית ההגדרות של המשימה Connectors.
- לוחצים על ומשנים את השם של Connectors (מחברים) ל-
Create issue in Jira. - לוחצים על Configure connector (הגדרת מחבר).
- בדף Connectors Task Editor (עורך משימות של מחברים), מבצעים את הפעולות הבאות:
- בקטע בחירת חיבור, בוחרים באזור
us-central1. - בוחרים את החיבור ל-Jira Cloud מתוך רשימת החיבורים הזמינים.
- לוחצים על הבא.
- בקטע סוג, בוחרים באפשרות ישויות.
- בקטע הגדרת ישויות/פעולות, בוחרים באפשרות בעיות מתוך רשימת הישויות הזמינות ואז בוחרים באפשרות יצירה בתור פעולה.
- לוחצים על סיום כדי להשלים את הגדרת הקישור ולסגור את החלונית.
- בקטע בחירת חיבור, בוחרים באזור
שינוי ומיפוי של פרטי הבעיה
כדי להמיר את פרטי הפנייה ולמפות אותם לקריאה ב-Jira:
- בכלי לעריכת שילובים, לוחצים על משימות כדי להציג רשימה של משימות זמינות.
- לוחצים על הרכיב מיפוי נתונים וממקמים אותו בכלי לעריכת שילובים.
- לוחצים על הרכיב מיפוי נתונים בכלי העיצוב כדי לראות את חלונית הגדרת המשימה.
- לוחצים על ומשנים את השם של המשימה מיפוי נתונים ל-
Mapping for issue creation. - לוחצים על פתיחת הכלי למיפוי נתונים.
- לוחצים על + הוספת משתנה חדש ויוצרים את המשתנים הבאים:
שם המשתנה סוג נתונים ערך ברירת המחדל jira_project-idSTRING מחליפים את JIRA_PROJECT_ID במזהה הפרויקט ב-Jira.JIRA_PROJECT_ID
jira_issue_type_idSTRING מחליפים את JIRA_ISSUE_TYPE_ID באחד ממזהי סוג הבעיה הבאים:JIRA_ISSUE_TYPE_ID
-
1000– ל-Epic -
1001– עבור סטורי -
1002– עבור משימה -
1003– עבור תת-משימה -
1004– באג
-
- יוצרים את המיפוי הבא:
קלט תשובה "{ "IssueTypeId": jira_issue_type_id, "ProjectId": jira_project_id }" .TO_JSON() .SET_PROPERTY( connectorOutputPayload.Description (Fetch Salesforce Data), "Description" ) .SET_PROPERTY( connectorOutputPayload.Subject (Fetch Salesforce Data), "Summary" )connectorInputPayload (Create issue in Jira)אחרי שמסיימים את המיפוי, סוגרים את החלונית. כל השינויים יישמרו אוטומטית.
- מוסיפים חיבור קצה מהמשימה Mapping for issue creation למחבר Create issue in Jira.
יצירת אירוע חדש ב-ServiceNow
אם הפנייה שחולצה מ-Salesforce היא מסוג: Sales, היא תנותב אל ServiceNow כאירוע חדש.
חיבור ל-ServiceNow
כדי להגדיר משימת Connectors שיוצרת אירוע חדש במופע ServiceNow:
- בכלי לעריכת שילובים, לוחצים על משימות כדי להציג רשימה של משימות זמינות.
- לוחצים על הרכיב Connectors (מחברים) וממקמים אותו בעורך השילובים.
- לוחצים על רכיב המשימה Connectors (מחברים) בכלי העיצוב כדי להציג את חלונית ההגדרות של המשימה Connectors.
- לוחצים על ומשנים את השם של Connectors (מחברים) ל-
Create incident in ServiceNow. - לוחצים על Configure connector (הגדרת מחבר).
- בדף Connectors Task Editor (עורך משימות של מחברים), מבצעים את הפעולות הבאות:
- בקטע בחירת חיבור, בוחרים באזור
us-central1. - בוחרים את החיבור ל-ServiceNow מתוך רשימת החיבורים הזמינים.
- לוחצים על הבא.
- בקטע סוג, בוחרים באפשרות ישויות.
- בקטע הגדרת ישויות/פעולות, בוחרים באפשרות אירוע מתוך רשימת הישויות הזמינות ואז בוחרים באפשרות יצירה בתור פעולה.
- לוחצים על סיום כדי להשלים את הגדרת הקישור ולסגור את החלונית.
- בקטע בחירת חיבור, בוחרים באזור
שינוי ומיפוי של פרטי האירוע
כדי להמיר את פרטי הפנייה ולמפות אותם לאירוע ב-ServiceNow:
- בכלי לעריכת שילובים, לוחצים על משימות כדי להציג רשימה של משימות זמינות.
- לוחצים על הרכיב מיפוי נתונים וממקמים אותו בכלי לעריכת שילובים.
- לוחצים על הרכיב מיפוי נתונים בכלי העיצוב כדי לראות את חלונית הגדרת המשימה.
- לוחצים על ומשנים את השם של המשימה מיפוי נתונים ל-
Mapping for incident creation. - לוחצים על פתיחת הכלי למיפוי נתונים.
- לוחצים על + הוספת משתנה חדש ויוצרים את משתני הקלט הבאים:
- יוצרים את המיפוי הבא:
קלט תשובה "{}" .TO_JSON() .SET_PROPERTY( connectorOutputPayload.Description (Fetch Salesforce Data), "description" ) .SET_PROPERTY( connectorOutputPayload.Subject (Fetch Salesforce Data), "short_description" )connectorInputPayload (Create incident in ServiceNow)אחרי שמסיימים את המיפוי, סוגרים את החלונית. כל השינויים יישמרו אוטומטית.
- מוסיפים חיבור Edge מהמשימה Mapping for incident creation (מיפוי ליצירת אירוע) למחבר Create incident in ServiceNow (יצירת אירוע ב-ServiceNow).
הוספת תנאי קצה
תנאי קצה מאפשר לכם לציין את התנאים שצריכים להתקיים כדי שהשליטה בשילוב תעבור למשימה שמחוברת לקצה. אחרי שמוסיפים ומגדירים את המשימות הנדרשות, אפשר להוסיף תנאי קצה כדי להגדיר את זרימת השילוב.
התנאי הבא שמוגדר בשוליים שולט בזרימת השילוב על סמך סוג הפנייה ב-Salesforce:
- מוסיפים חיבור קצה מהמשימה Get case type למשימה Mapping for issue creation עם תנאי הקצה הבא:
$sf_case_type$ = "Engineering"
- מוסיפים עוד חיבור קצה מהמשימה Get case type למשימה Mapping for incident creation עם תנאי הקצה הבא:
$sf_case_type$ = "Sales"
זרימת שילוב לדוגמה
באיור הבא מוצג פריסה לדוגמה של השילוב שנוצר באמצעות המדריך הזה.
פרסום השילוב ובדיקתו
כדי לפרסם את השילוב, לוחצים על פרסום בסרגל הכלים של כלי העריכה של השילוב.
אחרי שהשילוב יפורסם בהצלחה, תוכלו לראות ולבדוק את יומני הביצוע של השילוב שפורסם. כדי לראות את היומנים, לוחצים על
הצגת יומני הביצוע של השילוב הזה. יופיע הדף יומני ביצוע.
תרחיש בדיקה 1: בדיקה אם נוצרה בעיה ב-Jira עבור פנייה בנושא הנדסי
כדי לבדוק את השילוב, מתחברים למופע של Salesforce ויוצרים פנייה חדשה. כשיוצרים את הפנייה, צריך להזין Engineering בשדה Type (סוג).
כדי לוודא שהשילוב בוצע בהצלחה:
נכנסים לחשבון Jira Cloud.
- בודקים אם נוצרה בעיה חדשה בפרויקט עם תיאור ותקציר של הפנייה ב-Salesforce.
תרחיש בדיקה 2: בדיקה אם נוצר אירוע ServiceNow לכרטיס מכירות
כדי לבדוק את השילוב, מתחברים למופע של Salesforce ויוצרים פנייה חדשה. כשיוצרים את הפנייה, צריך להזין Sales בשדה Type (סוג).
כדי לוודא שהשילוב בוצע בהצלחה:
עוברים למופע ServiceNow.
- בודקים אם נוצרה תקרית חדשה במופע שלכם שכוללת את תיאור הפנייה וסיכום שלה ב-Salesforce.
הסרת המשאבים
כדי להימנע מחיובים בחשבון Google Cloud בגלל השימוש במשאבים שנעשה במסגרת המדריך הזה, צריך לבטל את הפרסום של השילוב ולמחוק את החיבורים שנוצרו ב-Integration Connectors.
- כדי לבטל את הפרסום של השילוב הזה, לוחצים על ביטול הפרסום בסרגל הכלים של כלי העריכה של השילוב. מידע נוסף זמין במאמר בנושא מחיקת אינטגרציות.
- מידע על מחיקת חיבור זמין במאמר בנושא ניהול מחברים.