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

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

הטנגו של Salesforce: הבנת ריקוד ה-API בין הלקוח לשרת.

מבוא

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

הטנגו של Salesforce: ריקוד של אינטראקציה

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

תרשים: במה מטפל כל אחד, הלקוח והשרת, בקריאת API: מיקום, OAuth, פרוטוקול, חוזה, מטען, מעקב וניפוי באגים, ושגיאות

האחריות של צד השרת

בין אם Salesforce ובין אם ישות חיצונית משמשת כשרת, האחריות נשארת אותה אחריות. השרת חייב להיות נגיש, להחזיק תהליך מאזין (listener) על פורט מסוים (בדרך כלל 443 ל-SSL), ואולי שרת אימות אם משתמשים ב-OAuth. השרת מגדיר את הפרוטוקול, מספק ללקוח את הקבצים הנדרשים, מחליט על המטען, ויכול לעקוב אחרי המטען הנכנס ואחרי הביצועים בעיבוד הפנימי.

האחריות של צד הלקוח

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

‏Salesforce כשרת

תרשים: ממשקי ה-API של Salesforce שלקוח חיצוני יכול לקרוא להם (SOAP, ‏REST, ‏Bulk, ‏Apex SOAP ו-REST, ‏Metadata, ‏Tooling, ‏Streaming ו-Pub/Sub) אחרי אימות דרך אפליקציה מחוברת ומשתמש אינטגרציה

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

‏Salesforce כלקוח

תרשים: ‏Salesforce כלקוח שקורא לשרתים חיצוניים: מחברים ל-Marketing Cloud, ל-Account Engagement ול-B2C Commerce, קריאות Apex SOAP ו-REST יוצאות, ‏External Services, הודעות יוצאות (outbound messages), ‏Salesforce Connect עם OData, ו-Heroku Connect

‏Salesforce יכולה גם לשמש כלקוח, ולבצע קריאות יוצאות לשרתים חיצוניים. התהליך הזה יכול לכלול ייבוא קובצי WSDL, יצירת Apex והגדרת named credentials לשרתי SOAP ו-REST. נדרשות הגדרות שונות למנגנונים היוצאים השונים, וכולם פועלים לפי פרוטוקולי הלקוח-שרת שתוארו קודם.

סיכום

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

הישארו איתנו

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

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

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

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

STA 1.3