עברית

תורגם בבינה מלאכותית. הקהילה עוד לא בדקה את התרגום. לקריאה באנגלית

בלוג · 15 בספטמבר 2023 · Steve Simpson · אינטגרציה

השלבים של ה-Bulk API ב-Salesforce: ייבוא נתונים ברציף הטעינה

מבוא:

במאמר הזה נכיר את ה-Bulk API של Salesforce, כלי רב עוצמה שנועד לייבא מערכי נתונים גדולים ל-Salesforce ביעילות. בניגוד ל-REST API, שמגביל אתכם ל-200 רשומות בכל קריאה, ה-Bulk API מאפשר להוסיף מיליוני רשומות בתהליך יעיל.

חלק 1: הבנת התהליך של ה-Bulk API

ה-Bulk API של Salesforce פועל בתהליך של חמישה שלבים כדי לייבא כמויות גדולות של נתונים בצורה חלקה:

תרשים: לקוח חיצוני שטוען 1,000,000 רשומות דרך ה-REST API, ב-200 רשומות לקריאה, צריך 5,000 קריאות API תרשים: חמשת השלבים של ה-Bulk API בין לקוח חיצוני ל-Salesforce: פתיחת job, העלאת קבצים, התחלת העיבוד, בדיקת הסטטוס, והורדת ההצלחות והכישלונות

  1. פתיחת ה-job (שלב 1): מתחילים את התהליך בפתיחת job, שמספק לכם מזהה job ייחודי. השלב הזה דומה לקבלת כרטיס שמכניס אתכם לרציף הטעינה.
  2. העלאת קבצים (שלב 2): עם מזהה ה-job אפשר להתחיל להעלות קובצי נתונים בפורמט CSV. כל קובץ יכול להכיל עד 10,000 רשומות, בכפוף למגבלות גודל. אפשר להעלות כמה קבצים תחת אותו מזהה job.
  3. התחלת העיבוד (שלב 3): כשההעלאה מסתיימת, מודיעים ל-Salesforce להתחיל לעבד את הנתונים בלחיצה על “הכפתור הכחול הגדול” המטפורי. אז Salesforce מתחילה לעבד את הקבצים שהועלו.
  4. בדיקת סטטוס ה-job (שלב 4): בזמן העיבוד אפשר לבדוק את סטטוס ה-job באמצעות מזהה ה-job. השלב הזה מאפשר לכם לעקוב אחרי התקדמות ייבוא הנתונים.
  5. הורדת התוצאות (שלב 5): כשהעיבוד מסתיים, אפשר להוריד את התוצאות. יש לכם אפשרות להוריד את הרשומות שהצליחו, שכוללות את מזהי ה-Salesforce של הרשומות שנוספו או עודכנו, או את הרשומות שנכשלו, שמספקות פרטים על השגיאות שהתרחשו.

חלק 2: הדגמה של ה-Bulk API עם Postman

כדי להמחיש את התהליך של ה-Bulk API, נשתמש ב-Postman מול sandbox של Salesforce:

  1. אימות: מתחילים באימות כדי לקבל אסימון גישה (access token).
  2. יצירת job חדש: מתחילים job חדש בשליחת בקשה ליצירת job. הפעולה הזו תספק לכם מזהה job.
  3. העלאת נתונים: מכניסים את מזהה ה-job לכתובת ה-URL ומעלים את הנתונים. בדוגמה הזו ניצור חשבון חדש בשם “Bart Buildings”.
  4. התחלת העיבוד: מודיעים ל-Salesforce להתחיל לעבד בשליחת בקשה עם מזהה ה-job והסטטוס “Upload Complete”.
  5. בדיקת סטטוס ה-job: עוקבים אחרי התקדמות ה-job בבדיקת הסטטוס שלו באמצעות מזהה ה-job. כשה-job מסתיים, אפשר לעבור לשלב הבא.
  6. הורדת הרשומות שהצליחו: שולפים את מזהה ה-Salesforce של הרשומות החדשות בהורדת הרשומות שהצליחו באמצעות מזהה ה-job.

צילום מסך מ-Postman, שלב 1: ‏POST שיוצר ingest job ב-Bulk API, עם מזהה ה-job החדש בתגובה צילום מסך מ-Postman, שלב 2: ‏PUT שמעלה את נתוני ה-CSV ל-job, ומחזיר 201 Created צילום מסך מ-Postman, שלב 3: ‏PATCH שמגדיר את מצב ה-job ל-UploadComplete כדי להתחיל את העיבוד צילום מסך מ-Postman, שלב 4: ‏GET שבודק את סטטוס ה-job, ומציג JobComplete צילום מסך מ-Postman, שלב 5: ‏GET שמוריד את התוצאות המוצלחות כ-CSV, עם מזהה הרשומה החדשה

חלק 3: סיכום

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

הישארו איתנו

תודה שהצטרפתם אלינו לסיור ב-Bulk API של Salesforce. הישארו איתנו לעוד תוכן מעמיק על ניצול היכולות החזקות של Salesforce!

הצטרפו ל-www.SteveTechArc.com ולערוץ ה-YouTube ‏@SteveTechArc (opens in a new tab). הירשמו והעמיקו את ההבנה שלכם ב-Salesforce ובאופן שבו אפשר לשלב אותה עם מערכות אחרות.

עוזרים לשנות את העולם בשיתוף מידע על אינטגרציה עם עמיתים ארכיטקטים ועם מי שנמצאים במסע שלהם לארכיטקטורה!

תמלול בסיוע בינה מלאכותית

STA 1.7