אוטומציה של הזדמנות למכירה ב-Salesforce להזמנה ב-BigQuery

במדריך הזה מתואר תרחיש שימוש שמראה איך אפשר להשתמש ב-Application Integration כדי להפוך לאוטומטי את תהליך ניהול ההזמנות בין אפליקציה לניהול קשרי לקוחות (CRM) לבין אפליקציה לתכנון משאבים ארגוניים (ERP).

סקירה כללית

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

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

תרשים של הזדמנות במכירות ב-Salesforce להזמנה ב-BigQuery תרשים של הזדמנות במכירות ב-Salesforce להזמנה ב-BigQuery

מטרות

במדריך הזה מוסבר איך לבצע את הפעולות הבאות בשילוב:

  • מגדירים טריגר של Salesforce כדי להפעיל את השילוב.
  • מוסיפים ומגדירים משימות של מחברים לחיבורים ל-Salesforce, ל-BigQuery ול-ServiceNow.
  • מוסיפים ומגדירים משימות של מיפוי נתונים כדי לחלץ ולמפות פרטים של הזדמנויות.

עלויות

במדריך הזה משתמשים ברכיבים הבאים של Google Cloud, והשימוש בהם כרוך בתשלום:

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

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

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

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

  2. 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 the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the BigQuery API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

  5. Create a service account:

    1. 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.

    2. In the Google Cloud console, go to the Create service account page.

      Go to Create service account
    3. Select your project.

    4. 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.

    5. Click Create and continue.

    6. Grant the following roles to the service account: BigQuery Data Editor (roles/bigquery.dataEditor), BigQuery Read Session User (roles/bigquery.readSessionUser), 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.

    7. Click Continue.

    8. Click Done to finish creating the service account.

  6. 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 the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  7. Verify that billing is enabled for your Google Cloud project.

  8. Enable the BigQuery API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

  9. Create a service account:

    1. 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.

    2. In the Google Cloud console, go to the Create service account page.

      Go to Create service account
    3. Select your project.

    4. 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.

    5. Click Create and continue.

    6. Grant the following roles to the service account: BigQuery Data Editor (roles/bigquery.dataEditor), BigQuery Read Session User (roles/bigquery.readSessionUser), 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.

    7. Click Continue.

    8. Click Done to finish creating the service account.

הכנת הסביבה

אימות הגדרת משתמש Salesforce

במדריך הזה אנחנו מניחים שיש לכם חשבון פיתוח קיים ב-Salesforce עם הגדרת המשתמשים וקבוצת ההרשאות הנדרשות. מוודאים שהלכידת נתונים משתנים (CDC) מופעלת בחשבון. מידע על יצירת חשבון חדש זמין במאמר בנושא הגדרת משתמש שילוב.

הגדרת מערך נתונים וטבלה ב-BigQuery

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

הגדרת מערך נתונים ב-BigQuery

כדי להגדיר את מערך הנתונים ב-BigQuery:

  1. עוברים לדף BigQuery במסוף Google Cloud .

    כניסה לדף BigQuery

  2. לוחצים על החלונית Explorer (סייר) ובוחרים את הפרויקט שבו משתמשים במדריך הזה.
  3. מרחיבים את (פעולות) ובוחרים באפשרות יצירת מערך נתונים.
  4. בדף Create dataset, מגדירים את הפרטים הבאים:
    1. מזהה קבוצת נתונים: מזינים Demo_order_dataset.
    2. Location type > Region: בוחרים את האזור us-central1 (lowa).
  5. לוחצים על יצירת מערך נתונים.

    6. מערך הנתונים החדש Demo_order_dataset אמור להופיע עכשיו בפרויקט בחלונית Explorer.

הגדרת טבלאות ב-BigQuery

כדי ליצור את הטבלאות ב-BigQuery:

  1. בחלונית Explorer, לוחצים על מערך הנתונים Demo_order_dataset שנוצר כדי לפתוח אותו.
  2. כדי ליצור טבלה ריקה בשם Orders לאחסון פרטי ההזדמנויות ב-Salesforce, פועלים לפי השלבים הבאים:
    1. לוחצים על יצירת טבלה.
    2. בקטע Destination (יעד), מזינים Orders בתור שם הטבלה.
    3. בקטע Schema, לוחצים על Edit as text ומדביקים את הגדרת סכימת ה-JSON הבאה: 
      [
  {
    "name": "order_number",
    "type": "STRING",
    "mode": "NULLABLE",
    "description": "Salesforce order number"
  },
  {
    "name": "order_status",
    "type": "STRING",
    "mode": "NULLABLE",
    "description": "Sale order status"
  },
  {
    "name": "tracking_number",
    "type": "INTEGER",
    "mode": "NULLABLE",
    "description": "Salesforce tracking number"
  }
]
    4. לוחצים על יצירת טבלה.
  3. כדי ליצור טבלת Accounts ריקה לאחסון פרטי חשבון Salesforce:
    1. לוחצים על יצירת טבלה.
    2. בקטע Destination (יעד), מזינים Accounts בתור שם הטבלה.
    3. בקטע Schema, לוחצים על Edit as text ומדביקים את הגדרת סכימת ה-JSON הבאה: 
      [
  {
    "name": "account_id",
    "type": "STRING",
    "mode": "NULLABLE",
    "description": "Account ID for the opportunity"
  },
  {
    "name": "name",
    "type": "STRING",
    "mode": "NULLABLE",
    "description": "Account name for the opportunity"
  }
]
    4. לוחצים על יצירת טבלה.

    עכשיו הטבלאות החדשות Orders ו-Accounts אמורות להופיע במערך הנתונים Demo_order_dataset בחלונית Explorer.

אימות מופע ServiceNow

במדריך הזה נעשה שימוש במופע חינמי של ServiceNow Personal Developer Instance ‏ (PDI). אתם יכולים להשתמש במופע ServiceNow הקיים או ליצור מופע חדש. מוודאים שהמופע פעיל ורושמים את כתובת ה-URL של המופע. מידע נוסף על PDI זמין במסמכי התיעוד של ServiceNow PDI.

הגדרת חיבורים

כדי לבצע את המדריך הזה, צריך להגדיר את החיבורים הבאים ב-Integration Connectors:

חיבור ל-Salesforce
הגדרת חיבור ל-Salesforce בכלי Integration Connectors. מידע על הגדרת מחבר Salesforce זמין במאמר מחבר Salesforce.
חיבור ל-BigQuery
הגדרת חיבור ל-BigQuery ב-Integration Connectors כדי לאחזר, לעדכן ולאמת פרטי הזמנה וחשבון במערך הנתונים Demo_order_dataset. מידע על הגדרת מחבר BigQuery זמין במאמר מחבר BigQuery.
חיבור ל-ServiceNow
מגדירים חיבור ל-ServiceNow ב-Integration Connectors באמצעות כתובת ה-URL של המופע כדי ליצור ולאחזר פרטי חשבון ב-ServiceNow. מידע על הגדרת מחבר ServiceNow זמין במאמר מחבר ServiceNow.

יצירת שילוב

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

  1. במסוף Google Cloud, עוברים לדף Application Integration.

    מעבר אל Application Integration

  2. בתפריט הניווט שמימין, לוחצים על שילובים כדי לפתוח את הדף שילובים.
  3. לוחצים על יצירת שילוב ומזינים את הפרטים הבאים בדף יצירת שילוב:
    1. שם השילוב: מזינים opportunity-to-order-integration.
    2. תיאור: מזינים Demo integration created for tutorial.
    3. אזור: בוחרים באפשרות us-central1 מתוך רשימת האזורים הנתמכים.
    4. לוחצים על יצירה כדי לפתוח את כלי העריכה של השילוב.

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

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

במדריך הזה, טריגר של Salesforce משמש להפעלת השילוב בכל פעם שנוצרת הזדמנות חדשה במופע של Salesforce. כדי להוסיף ולהגדיר טריגר של Salesforce בשילוב opportunity-to-order-integration:

  1. בכלי לעריכת שילובים, לוחצים על טריגרים כדי להציג רשימה של טריגרים זמינים.
  2. לוחצים על הרכיב Salesforce trigger (טריגר של Salesforce) וממקמים אותו בכלי לעריכת שילובים.
  3. בוחרים את רכיב Salesforce trigger (טריגר של Salesforce) באזור העיצוב כדי לפתוח את חלונית ההגדרות של הטריגר של Salesforce.
  4. מגדירים את השדות הבאים בקטע Trigger Input (קלט הטריגר):
    1. סוג האירוע: בוחרים באפשרות Change Data Capture (CDC) (לכידת שינויים בנתונים) מהרשימה הנפתחת.
    2. הגדרת מופע Salesforce: לוחצים על האפשרות + הוספת הגדרה חדשה של מופע Salesforce מהרשימה הנפתחת.

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

      • שם החיבור של המכונה ב-Salesforce: מזינים שם חיבור למכונה ב-Salesforce. לדוגמה, test.
      • דומיין ב-Salesforce: מזינים את שם הדומיין ב-Salesforce. אפשר למצוא את המידע הזה בדף חשבון Salesforce > הצגת הפרופיל.
      • פרופיל אימות: בוחרים פרופיל אימות. אם אין לכם פרופיל אימות, אתם צריכים ליצור פרופיל חדש. מידע נוסף זמין במאמר בנושא יצירת פרופיל אימות חדש.
      • לוחצים על הוספה.
    3. הגדרת ערוץ Salesforce: לוחצים על האפשרות + הוספת הגדרה חדשה של ערוץ Salesforce מהרשימה הנפתחת.

      בתיבת הדו-שיח הוספת ערוץ Salesforce:

      • שם האובייקט ב-Salesforce: מזינים Opportunity.
      • לוחצים על הוספה.
    4. פעולה: בוחרים באפשרות יצירה מהרשימה הנפתחת.

      5. השינויים במאפיינים נשמרים אוטומטית.

מיפוי של מטען ייעודי (payload) של טריגר למחבר Salesforce

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

התחברות לחשבון Salesforce

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

  1. בכלי לעריכת שילובים, לוחצים על משימות כדי להציג רשימה של משימות זמינות.
  2. לוחצים על הרכיב Connectors (מחברים) וממקמים אותו בעורך השילובים.
  3. בוחרים את רכיב המשימה Connectors (מחברים) בכלי העיצוב כדי להציג את חלונית ההגדרות של משימת Connectors.
  4. לוחצים על ומשנים את השם של התווית Connectors (מחברים) ל-Fetch Salesforce Data.
  5. לוחצים על Configure connector (הגדרת מחבר).
  6. בדף Connectors Task Editor (עורך משימות של מחברים), מבצעים את הפעולות הבאות:
    1. בקטע בחירת חיבור, בוחרים באזור us-central1.
    2. בוחרים את החיבור ל-Salesforce מתוך רשימת החיבורים הזמינים.
    3. לוחצים על הבא.
    4. בקטע סוג, בוחרים באפשרות ישויות.
    5. בקטע Set entities/actions (הגדרת ישויות/פעולות), בוחרים באפשרות Opportunity (הזדמנות) מתוך רשימת הישויות הזמינות, ואז בוחרים באפשרות Get (קבלת נתונים) בתור Operation (פעולה).
    6. לוחצים על סיום כדי להשלים את הגדרת הקישור ולסגור את החלונית.

חילוץ ומיפוי של מזהה ההזדמנות

משימת מיפוי נתונים משמשת למיפוי ולחילוץ של פרטי ההזדמנות בין הטריגר של Salesforce לבין מחבר Salesforce.

כדי להוסיף ולערוך את מיפוי הנתונים בשילוב:

  1. בכלי לעריכת שילובים, לוחצים על משימות כדי להציג רשימה של משימות זמינות.
  2. לוחצים על הרכיב מיפוי נתונים וממקמים אותו בכלי לעריכת שילובים.
  3. בוחרים את הרכיב מיפוי נתונים בכלי העיצוב כדי להציג את חלונית הגדרת המשימה.
  4. לוחצים על ומשנים את השם של המשימה מיפוי נתונים ל-Map to opportunity ID.
  5. לוחצים על פתיחת הכלי למיפוי נתונים.

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

  6. ממפים את משתנה הפלט של הטריגר —SalesforceTriggerCdcRecordID—למשתנה הקלט של המחבר שנוצר אוטומטית —entityId(Fetch Salesforce Data)—.

    אחרי שמסיימים את המיפוי, סוגרים את החלונית. כל השינויים יישמרו אוטומטית.

  7. מוסיפים חיבור Edge מהטריגר Salesforce למשימה מיפוי למזהה הזדמנות.
  8. מוסיפים חיבור קצה מהמשימה מיפוי למזהה הזדמנות למחבר Fetch Salesforce Data.

אימות חשבון Salesforce בטבלה ב-BigQuery

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

התחברות לטבלה ב-BigQuery

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

  1. בכלי לעריכת שילובים, לוחצים על משימות כדי להציג רשימה של משימות זמינות.
  2. לוחצים על הרכיב Connectors (מחברים) וממקמים אותו בעורך השילובים.
  3. לוחצים על רכיב המשימה Connectors (מחברים) בכלי העיצוב כדי להציג את חלונית ההגדרות של המשימה Connectors.
  4. לוחצים על ומשנים את השם של Connectors (מחברים) ל-Check account in BigQuery.
  5. לוחצים על Configure connector (הגדרת מחבר).
  6. בדף Connectors Task Editor (עורך משימות של מחברים), מבצעים את הפעולות הבאות:
    1. בקטע בחירת חיבור, בוחרים באזור us-central1.
    2. בוחרים את החיבור ל-BigQuery מתוך רשימת החיבורים הזמינים.
    3. לוחצים על הבא.
    4. בקטע סוג, בוחרים באפשרות ישויות.
    5. בקטע הגדרת ישויות/פעולות, בוחרים באפשרות חשבונות מתוך רשימת הישויות הזמינות, ואז בוחרים באפשרות רשימה בתור פעולה.
    6. לוחצים על סיום כדי להשלים את הגדרת הקישור ולסגור את החלונית.
  7. מוסיפים חיבור קצה מהמחבר Fetch Salesforce Data (אחזור נתונים מ-Salesforce) למחבר Check account in BigQuery (בדיקת החשבון ב-BigQuery).

חילוץ ואימות של מזהה חשבון Salesforce

כדי לחלץ, למפות ולאמת את מזהה החשבון של ההזדמנות:

  1. בכלי לעריכת שילובים, לוחצים על משימות כדי להציג רשימה של משימות זמינות.
  2. לוחצים על הרכיב מיפוי נתונים וממקמים אותו בכלי לעריכת שילובים.
  3. לוחצים על הרכיב מיפוי נתונים בכלי העיצוב כדי לראות את חלונית הגדרת המשימה.
  4. לוחצים על ומשנים את השם של המשימה מיפוי נתונים ל-Check account.
  5. לוחצים על פתיחת הכלי למיפוי נתונים.
  6. לוחצים על + הוספת משתנה חדש ויוצרים את משתני הפלט הבאים:
    שם משתנה הפלט סוג נתונים
    sf_account_id STRING
    sf_account_name STRING
    account_exists BOOLEAN
  7. יוצרים את המיפוי הבא בין משתנה מטען הייעודי (payload) של מחבר Salesforce לבין המשתנה המקומי:
    קלט תשובה 
    connectorOutputPayload ( Fetch Salesforce Data)
.GET_PROPERTY("AccountId")
    		sf_account_id 
    connectorOutputPayload ( Fetch Salesforce Data)
.GET_PROPERTY("Name")
    		sf_account_name 
    connectorOutputPayload (Check account in BigQuery)
.FILTER(~obj1 ->
~obj1
.GET_PROPERTY("account_id")
.TO_STRING()
.EQUALS(sf_account_id)
)
.SIZE()
.EQUALS("1")
    		account_exists

    אחרי שמסיימים את המיפוי, סוגרים את החלונית. כל השינויים יישמרו אוטומטית.

  8. מוסיפים חיבור קצה מהמחבר Check account in BigQuery (בדיקת החשבון ב-BigQuery) למשימה Check account (בדיקת החשבון).

יצירת חשבון חדש ב-BigQuery

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

הוספת חשבון ל-BigQuery

כדי להגדיר משימת Connectors שיוצרת ישות חדשה בטבלה Accounts ב-BigQuery:

  1. בכלי לעריכת שילובים, לוחצים על משימות כדי להציג רשימה של משימות זמינות.
  2. לוחצים על הרכיב Connectors (מחברים) וממקמים אותו בעורך השילובים.
  3. לוחצים על רכיב המשימה Connectors (מחברים) בכלי העיצוב כדי להציג את חלונית ההגדרות של המשימה Connectors.
  4. לוחצים על ומשנים את השם של Connectors (מחברים) ל-Create account in BigQuery.
  5. לוחצים על Configure connector (הגדרת מחבר).
  6. בדף Connectors Task Editor (עורך משימות של מחברים), מבצעים את הפעולות הבאות:
    1. בקטע בחירת חיבור, בוחרים באזור us-central1.
    2. בוחרים את החיבור ל-BigQuery מתוך רשימת החיבורים הזמינים.
    3. לוחצים על הבא.
    4. בקטע סוג, בוחרים באפשרות ישויות.
    5. בקטע הגדרת ישויות/פעולות, בוחרים באפשרות חשבונות מתוך רשימת הישויות הזמינות, ואז בוחרים באפשרות יצירה בתור פעולה.
    6. לוחצים על סיום כדי להשלים את הגדרת הקישור ולסגור את החלונית.

יצירת חשבון חדש ב-ServiceNow

כדי להגדיר משימת Connectors שמוסיפה חשבון חדש למופע ServiceNow:

  1. בכלי לעריכת שילובים, לוחצים על משימות כדי להציג רשימה של משימות זמינות.
  2. לוחצים על הרכיב Connectors (מחברים) וממקמים אותו בעורך השילובים.
  3. לוחצים על רכיב המשימה Connectors (מחברים) בכלי העיצוב כדי להציג את חלונית ההגדרות של המשימה Connectors.
  4. לוחצים על ומשנים את השם של Connectors (מחברים) ל-Create account in ServiceNow.
  5. לוחצים על Configure connector (הגדרת מחבר).
  6. בדף Connectors Task Editor (עורך משימות של מחברים), מבצעים את הפעולות הבאות:
    1. בקטע בחירת חיבור, בוחרים באזור us-central1.
    2. בוחרים את החיבור ל-BigQuery מתוך רשימת החיבורים הזמינים.
    3. לוחצים על הבא.
    4. בקטע סוג, בוחרים באפשרות ישויות.
    5. בקטע הגדרת ישויות/פעולות, בוחרים באפשרות system_user מתוך רשימת הישויות הזמינות, ואז בוחרים באפשרות יצירה בתור פעולה.
    6. לוחצים על סיום כדי להשלים את הגדרת הקישור ולסגור את החלונית.

שינוי ומיפוי של פרטי החשבון

כדי לשנות את פרטי החשבון ולמפות אותם למחברים של BigQuery ו-ServiceNow:

  1. בכלי לעריכת שילובים, לוחצים על משימות כדי להציג רשימה של משימות זמינות.
  2. לוחצים על הרכיב מיפוי נתונים וממקמים אותו בכלי לעריכת שילובים.
  3. לוחצים על הרכיב מיפוי נתונים בכלי העיצוב כדי לראות את חלונית הגדרת המשימה.
  4. לוחצים על ומשנים את השם של המשימה מיפוי נתונים ל-Mapping for Account Creation.
  5. לוחצים על פתיחת הכלי למיפוי נתונים.
  6. לוחצים על + הוספת משתנה חדש ויוצרים את משתני הקלט הבאים:
    שם משתנה הקלט סוג נתונים
    new_BQaccount JSON
    new_SNaccount JSON
  7. יוצרים את המיפוי הבא כדי למפות את המזהה והשם של חשבון Salesforce לטבלה ב-BigQuery:
    קלט תשובה 
    new_BQaccount
.SET_PROPERTY(
sf_account_id,
"account_id"
)
.SET_PROPERTY(
  sf_account_name,
  "name"
  )
    		connectorInputPayload (Create account in BigQuery) 
    new_SNaccount
.SET_PROPERTY(
sf_account_id,
"sys_id"
)
.SET_PROPERTY(
 sf_account_name,
 "first_name"
 )
    		connectorInputPayload (Create account in ServiceNow)

    אחרי שמסיימים את המיפוי, סוגרים את החלונית. כל השינויים יישמרו אוטומטית.

  8. מוסיפים חיבור קצה מהמשימה מיפוי ליצירת חשבון למחבר יצירת חשבון ב-BigQuery.
  9. מוסיפים חיבור קצה מהמשימה מיפוי ליצירת חשבון למחבר יצירת חשבון ב-ServiceNow.

יצירת הזמנה חדשה ב-BigQuery

כדי ליצור מספר הזמנה ולהוסיף אותו ב-BigQuery:

הוספת הזמנה ל-BigQuery

כדי להגדיר משימת Connectors שיוצרת ישות חדשה בטבלת Orders ב-BigQuery:

  1. בכלי לעריכת שילובים, לוחצים על משימות כדי להציג רשימה של משימות זמינות.
  2. לוחצים על הרכיב Connectors (מחברים) וממקמים אותו בעורך השילובים.
  3. לוחצים על רכיב המשימה Connectors (מחברים) בכלי העיצוב כדי להציג את חלונית ההגדרות של המשימה Connectors.
  4. לוחצים על ומשנים את השם של Connectors (מחברים) ל-Create order in BigQuery.
  5. לוחצים על Configure connector (הגדרת מחבר).
  6. בדף Connectors Task Editor (עורך משימות של מחברים), מבצעים את הפעולות הבאות:
    1. בקטע בחירת חיבור, בוחרים באזור us-central1.
    2. בוחרים את החיבור ל-BigQuery מתוך רשימת החיבורים הזמינים.
    3. לוחצים על הבא.
    4. בקטע סוג, בוחרים באפשרות ישויות.
    5. בקטע הגדרת ישויות/פעולות, בוחרים באפשרות הזמנות מתוך רשימת הישויות הזמינות ואז בוחרים באפשרות יצירה בתור פעולה.
    6. לוחצים על סיום כדי להשלים את הגדרת הקישור ולסגור את החלונית.

יצירת הזמנה ומיפוי שלה ל-BigQuery

  1. בכלי לעריכת שילובים, לוחצים על משימות כדי להציג רשימה של משימות זמינות.
  2. לוחצים על הרכיב מיפוי נתונים וממקמים אותו בכלי לעריכת שילובים.
  3. לוחצים על הרכיב מיפוי נתונים בכלי העיצוב כדי לראות את חלונית הגדרת המשימה.
  4. לוחצים על ומשנים את השם של המשימה מיפוי נתונים ל-Mapping for Order Creation.
  5. לוחצים על פתיחת הכלי למיפוי נתונים.
  6. לוחצים על + הוספת משתנה חדש ויוצרים את המשתנה הבא:
    שם המשתנה סוג נתונים
    order_number STRING
  7. יוצרים את המיפוי הבא כדי ליצור מספר הזמנה חדש ולמפות את פרטי ההזמנה למחבר BigQuery:
    קלט תשובה 
    GENERATE_UUID()
.SPLIT("-")
.GET("0")
    		new_order_number 
    "{}"
.TO_JSON()
.SET_PROPERTY(
connectorOutputPayload ( Fetch Salesforce Data)
.GET_PROPERTY("DeliveryInstallationStatus__c")
,  
"order_status"
)
.SET_PROPERTY(
connectorOutputPayload ( Fetch Salesforce Data)
.GET_PROPERTY("TrackingNumber__c")
,  
"tracking_number"
)
.SET_PROPERTY(
new_order_number
,
"order_number"
)
    		connectorInputPayload (Create Order in BigQuery)

    אחרי שמסיימים את המיפוי, סוגרים את החלונית. כל השינויים יישמרו אוטומטית.

  8. מוסיפים חיבור קצה מהמחבר Create account in BigQuery (יצירת חשבון ב-BigQuery) למשימה Mapping for Order Creation (מיפוי ליצירת הזמנה).
  9. מוסיפים חיבור קצה מהמחבר Create account in ServiceNow למשימה Mapping for Order Creation.
  10. מוסיפים חיבור קצה מהמשימה מיפוי ליצירת הזמנה למחבר יצירת הזמנה ב-BigQuery.

עדכון הזדמנות ב-Salesforce

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

הגדרת המחבר של Salesforce

כדי להגדיר משימה של Connectors שמעדכנת את ההזדמנות הקיימת ב-Salesforce:

  1. בכלי לעריכת שילובים, לוחצים על משימות כדי להציג רשימה של משימות זמינות.
  2. לוחצים על הרכיב Connectors (מחברים) וממקמים אותו בעורך השילובים.
  3. לוחצים על רכיב המשימה Connectors (מחברים) בכלי העיצוב כדי להציג את חלונית ההגדרות של המשימה Connectors.
  4. לוחצים על ומשנים את השם של Connectors (מחברים) ל-Update Salesforce.
  5. לוחצים על Configure connector (הגדרת מחבר).
  6. בדף Connectors Task Editor (עורך משימות של מחברים), מבצעים את הפעולות הבאות:
    1. בקטע בחירת חיבור, בוחרים באזור us-central1.
    2. בוחרים את החיבור ל-Salesforce מתוך רשימת החיבורים הזמינים.
    3. לוחצים על הבא.
    4. בקטע סוג, בוחרים באפשרות ישויות.
    5. בקטע הגדרת ישויות/פעולות, בוחרים באפשרות הזדמנות מתוך רשימת הישויות הזמינות, ואז בוחרים באפשרות עדכון בתור פעולה.
    6. לוחצים על סיום כדי להשלים את הגדרת הקישור ולסגור את החלונית.

מיפוי של מספר ההזמנה ל-Salesforce

  1. בכלי לעריכת שילובים, לוחצים על משימות כדי להציג רשימה של משימות זמינות.
  2. לוחצים על הרכיב מיפוי נתונים וממקמים אותו בכלי לעריכת שילובים.
  3. לוחצים על הרכיב מיפוי נתונים בכלי העיצוב כדי לראות את חלונית הגדרת המשימה.
  4. לוחצים על ומשנים את השם של המשימה מיפוי נתונים ל-Mapping to update opportunity.
  5. לוחצים על פתיחת הכלי למיפוי נתונים.
  6. יוצרים את המיפוי הבא כדי לעדכן את ההזדמנות ב-Salesforce:
    קלט תשובה 
    "{}"
.TO_JSON()
.SET_PROPERTY(
new_order_number
,  
"OrderNumber__c"
)
    		connectorInputPayload (Update Salesforce) 
    entityId ( Fetch Salesforce Data)
    		entityId (Update Salesforce ) 
    "'"
.CONCAT(entityId ( Fetch Salesforce Data))
.CONCAT("'")
    		filterClause (Update Salesforce )

    אחרי שמסיימים את המיפוי, סוגרים את החלונית. כל השינויים יישמרו אוטומטית.

  7. מוסיפים חיבור קצה מהמחבר Create Order in BigQuery (יצירת הזמנה ב-BigQuery) למשימה Mapping to update opportunity (מיפוי לעדכון הזדמנות).
  8. מוסיפים חיבור Edge מהמשימה מיפוי לעדכון הזדמנות למחבר עדכון Salesforce.

הוספת תנאי קצה

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

תנאי הקצה הבא שולט בזרימת האינטגרציה על סמך האימות של פרטי החשבון:

  1. מוסיפים קשר קצה מהמשימה Check account למשימה Mapping for Account Creation עם תנאי הקצה הבא: 
      $account_exists$ = False
  2. מוסיפים עוד קשר קצה מהמשימה Check account למשימה Mapping for Order Creation עם תנאי הקצה הבא: 
      $account_exists$ = True

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

באיור הבא מוצג פריסה לדוגמה של השילוב שנוצר באמצעות המדריך הזה.

תמונה לדוגמה שמציגה את תהליך השילוב תמונה לדוגמה שמציגה את תהליך השילוב

פרסום השילוב ובדיקתו

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

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

מקרה בדיקה 1: בדיקה אם נוצר מספר הזמנה למזהה חשבון חדש

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

כדי לוודא שהשילוב בוצע בהצלחה:

  1. עוברים לדף BigQuery.

    כניסה לדף BigQuery

    • פותחים את הטבלה Accounts (חשבונות) ובודקים כדי לוודא שמזהה החשבון של ההזדמנות החדשה הוכנס.
    • פותחים את הטבלה Orders ומוודאים שפרטי ההזמנה החדשים הוכנסו.
  2. עוברים למופע ServiceNow.
    • בודקים אם חשבון חדש נוסף למופע שלכם ומכיל את אותו מזהה של חשבון ההזדמנות ב-Salesforce.
  3. פותחים את Salesforce.
    • בודקים אם מספר ההזמנה החדש עודכן בהזדמנות.

מקרה בדיקה 2: בדיקה אם נוצר מספר הזמנה למזהה חשבון קיים ב-BigQuery

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

כדי לוודא שהשילוב בוצע בהצלחה:

  1. עוברים לדף BigQuery.

    כניסה לדף BigQuery

    • פותחים את הטבלה Accounts ומוודאים שלא נוסף מזהה חשבון חדש.
    • פותחים את הטבלה Orders ומוודאים שפרטי ההזמנה החדשים הוכנסו.
  2. פותחים את Salesforce.
    • בודקים אם מספר ההזמנה החדש עודכן בהזדמנות.

הסרת המשאבים

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

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