SAP Gateway

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

גרסאות נתמכות

המחבר הזה משתמש ב-SAP Gateway API כדי לאפשר גישה דו-כיוונית לשירותי SAP שמשתמשים בשער. יש תמיכה במהדורות הבאות של SAP:

  • S/4 HANA Cloud
  • S/4 HANA
  • SAP ERP
  • מהדורות אחרות של SAP שתומכות ב-SAP Gateway API

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

לפני שמשתמשים במחבר SAP Gateway, צריך לבצע את המשימות הבאות:

  • בפרויקט שלכם ב-Google Cloud:
    • מוודאים שהגדרתם חיבור לרשת. מידע על תבניות רשת זמין במאמר קישוריות לרשת.
    • נותנים למשתמש שמגדיר את המחבר את תפקיד ה-IAM‏ roles/connectors.admin.
    • מקצים לחשבון השירות שרוצים להשתמש בו עבור המחבר את תפקידי ה-IAM הבאים:
      • roles/secretmanager.viewer
      • roles/secretmanager.secretAccessor

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

    • מפעילים את השירותים הבאים:
      • ‫secretmanager.googleapis.com (Secret Manager API)
      • ‫connectors.googleapis.com (Connectors API)

      במאמר הפעלת שירותים מוסבר איך להפעיל שירותים.

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

הגדרת שירות SAP OData ב-S/4HANA מקומי

כדי להגדיר את שירות SAP OData ב-S/4HANA מקומי, מבצעים את המשימות הבאות:

  • הפעלת שירותי ICM
  • הפעלה של SAP Gateway
  • הפעלת שירותי OData
  • בדיקה של שירות OData מופעל בשרת SAP

הפעלת שירותי ICM

שירות SAP OData פועל באמצעות פרוטוקולים של HTTP או HTTPS. לכן, חשוב לוודא שהשירותים הרלוונטיים מופעלים ב-Internet Communication Manager‏ (ICM). מומלץ להשתמש ב-HTTPS כדי להגן על הנתונים במהלך ההעברה.

  1. עוברים אל Transaction SMICM.
  2. עוברים אל 'שירותים'.
  3. לוחצים על שירות > יצירה.
  4. מגדירים שירות חדש.

    5. כשמגדירים יציאות שירות, חלק מהפרמטרים מאוכלסים מראש על סמך מערכת SAP.

  5. מגדירים את הפרמטרים שנותרו לפרוטוקולי HTTP ו-HTTPS.

הפעלה של SAP Gateway

כדי להפעיל את SAP Gateway:

  1. עוברים לעסקה SPRO ובוחרים באפשרות SAP Reference IMG.
  2. מרחיבים את הצומת SAP NetWeaver > SAP Gateway > OData Channel > Configuration > User Settings > Connection Settings > Activate or Deactivate SAP Gateway (הפעלה או השבתה של SAP Gateway), ואז לוחצים לחיצה ימנית ובוחרים באפשרות Edit Activity (עריכת פעילות).
  3. לוחצים על הפעלה. אם ההודעה SAP Gateway is currently active (שער SAP פעיל כרגע) מופיעה בתיבת הדו-שיח, לוחצים על Cancel (ביטול).

הפעלת שירותי OData

כדי להפעיל שירותי OData:

  1. עוברים אל העסקה SICF.
  2. לוחצים על Execute (הפעלה) או מקישים על F8.
  3. דילוג על סינון במסך הבחירה.
  4. כדי להפעיל את כל שירותי OData ‏ (V2,‏ V4), עוברים לצומת העץ default_host > sap > opu > OData.
  5. כדי להפעיל שירות ספציפי, עוברים לצומת המתאים בעומק העץ.
  6. לוחצים לחיצה ימנית על הצומת של שירות OData ובוחרים באפשרות הפעלה.

בדיקת שירות OData שהופעל בשרת SAP

משתמשים בכלי SAP Gateway Client כדי להריץ בקשות OData.

מפעילים את הכלי באמצעות העסקה הבאה: /n/IWFND/GW_CLIENT

  1. מציינים את ה-URI של בקשת OData.
  2. בוחרים את ה-method של ה-HTTP, את הפרוטוקול (HTTP או HTTPS), את כותרות הבקשה ואת גוף הבקשה.
  3. אחרי שמזינים את כל הנתונים הנדרשים לבקשה, לוחצים על הפעלה כדי לשלוח את הבקשה.

    4. כותרות התגובה ונתוני התגובה מוצגים אחרי ההפעלה.

הגדרת שירות SAP OData ב-S/4HANA Cloud

כדי להגדיר את שירות SAP OData ב-S/4HANA Cloud, מבצעים את המשימות הבאות:

  • יצירת משתמש תקשורת
  • יצירת מערכת תקשורת
  • יצירת הסדר תקשורת

יצירת משתמש תקשורת

משתמש תקשורת הוא סוג מיוחד של משתמש טכני שמשמש לקריאות שירות חיצוניות של OData. הוא משמש לתקשורת של SAP עם המערכת החיצונית בלבד, ואי אפשר להתחבר באמצעות SAP GUI באמצעות משתמש תקשורת. האפליקציה Maintain Communication Users מאפשרת לכם להגדיר את ההגדרות האלה בענן.

  1. עוברים לאפליקציה Maintain Communication Users (תחזוקת משתמשי תקשורת).
  2. כדי ליצור משתמש חדש, לוחצים על חדש.
  3. מזינים את שם המשתמש ואת התיאור של המשתמש.
  4. מזינים את הסיסמה. משתמשים באפשרות הצעת סיסמה כדי ליצור את הסיסמה.
  5. לוחצים על יצירה.

יצירת מערכת תקשורת

מערכת תקשורת היא מפרט של מערכת שמייצגת שותף תקשורת וכוללת את כל המידע הטכני שנדרש לתקשורת, כמו שם מארח/כתובת IP, זהות, פרטי משתמש ואישורים. במערכות S/4HANA Cloud, יש צורך בישויות האלה לתקשורת חיצונית. אפליקציית מערכות התקשורת מאפשרת לכם להגדיר את ההגדרות האלה בענן.

  1. עוברים לאפליקציה Communication Systems (מערכות תקשורת).
  2. כדי ליצור מערכת תקשורת חדשה, לוחצים על New (חדש).
  3. מזינים את מזהה המערכת ואת שם המערכת.
  4. לוחצים על + כדי להוסיף את המשתמש שנוצר לתקשורת נכנסת. מזינים את הפרטים של המשתמש לצורכי תקשורת.

    5. תקשורת נכנסת היא תקשורת שבה שותף לתקשורת משתמש במערכת מוגדרת כדי להתקשר ממקור חיצוני למערכת SAP S/4HANA.

  5. לוחצים על Save.

יצירת הסדר תקשורת

מידע על הסדר תקשורת זמין במאמר הסדר תקשורת.

  1. עוברים לאפליקציה Communication Arrangements.
  2. כדי ליצור הסדר חדש לתקשורת, לוחצים על New (חדש).
  3. בוחרים את תרחיש התקשורת, מזינים שם להסדר ולוחצים על יצירה.
  4. מוסיפים את מערכת התקשורת ובוחרים את המשתמש במערכת התקשורת שרוצים להשתמש בו בהסדר התקשורת הזה.
  5. כתובת ה-URL לקריאה לשירות OData מופיעה בהסדר התקשורת בפורמט הבא:https://-api.s4hana.ondemand.com/sap/opu/odata/sap/
  6. לוחצים על שמירה

הגדרת חיבור

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

  1. במסוף Cloud, עוברים לדף Integration Connectors > Connections ובוחרים או יוצרים פרויקט בענן.

    כניסה לדף Connections

  2. לוחצים על + יצירת חיבור חדש כדי לפתוח את הדף יצירת חיבור.
  3. בקטע מיקום, בוחרים את המיקום של החיבור.
    1. אזור: בוחרים מיקום מהרשימה הנפתחת.

      רשימה של כל האזורים הנתמכים מופיעה במאמר מיקומים.

    2. לוחצים על הבא.
  4. בקטע פרטי החיבור, ממלאים את הפרטים הבאים:
    1. מחבר: בוחרים באפשרות SAP Gateway מהרשימה הנפתחת של המחברים הזמינים.
    2. גרסת כלי החיבור: בוחרים את גרסת כלי החיבור מהרשימה הנפתחת של הגרסאות הזמינות.
    3. בשדה Connection Name (שם החיבור), מזינים שם למופע החיבור.

      השמות של החיבורים צריכים לעמוד בקריטריונים הבאים:

      • שמות החיבורים יכולים לכלול אותיות, מספרים או מקפים.
      • האותיות צריכות להיות קטנות.
      • שמות החיבורים צריכים להתחיל באות ולהסתיים באות או במספר.
      • שמות החיבורים לא יכולים לכלול יותר מ-49 תווים.
      • במחברים שתומכים בהרשמה לאירועים, שמות החיבורים לא יכולים להתחיל בקידומת goog.
    4. אופציונלי: מזינים תיאור למופע החיבור.
    5. חשבון שירות: בוחרים חשבון שירות שיש לו את התפקידים הנדרשים.
    6. כדי להשתמש בחיבור למינויים לאירועים, בוחרים באפשרות הפעלת מינוי לאירועים. אם בוחרים באפשרות הזו, מוצגות האפשרויות הבאות:
      • הפעלת הרשמה לאירועים עם ישות ופעולות: בוחרים באפשרות הזו כדי להשתמש בחיבור גם להרשמה לאירועים וגם לפעולות של מחבר (יחידות ופעולות).
      • הפעלה של מינוי לאירועים בלבד: בוחרים באפשרות הזו כדי להשתמש בחיבור רק למינוי לאירועים. אם בוחרים באפשרות הזו, לוחצים על הבא ואז מגדירים מינוי לאירועים.
    7. מרחב שמות: מציינים את מרחב השמות של השירות שממנו רוצים לאחזר נתונים. המאפיין הזה נדרש אם השירות לא מצוין בכתובת ה-URL.
    8. שירות: מציינים את השירות שממנו רוצים לאחזר נתונים. המאפיין הזה נדרש אם השירות לא מצוין בכתובת ה-URL.
    9. ‫CustomUrlParams: מציינים פרמטרים מותאמים אישית של מחרוזת שאילתה שנכללים בבקשת ה-HTTP. צריך לקודד את הפרמטרים כמחרוזת שאילתה בפורמט הבא: field1=value1&field2=value2. הערכים במחרוזת השאילתה חייבים להיות מקודדים בכתובת ה-URL.
    10. פורמט נתונים: פורמט הנתונים שרוצים לאחזר. בוחרים XML או JSON.
    11. שימוש בשמות לתצוגה: ערך בוליאני שקובע אם להשתמש בתוויות של SAP.
    12. אופציונלי: מגדירים את ההגדרות של צומת החיבור:

      • מספר מינימלי של צמתים: מזינים את המספר המינימלי של צמתי חיבור.
      • מספר הצמתים המקסימלי: מזינים את מספר צמתי החיבור המקסימלי.

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

    13. אופציונלי: לוחצים על + הוספת תווית כדי להוסיף תווית לקישור בצורה של צמד מפתח/ערך.
    14. לוחצים על הבא.
  5. בקטע יעדים, מגדירים את כתובת ה-URL של סביבת SAP Gateway או את כתובת ה-URL המלאה של שירות OData. לדוגמה, הפורמט הוא ${ENVIRONMENT_URL}/sap/opu/odata/${NAMESPACE}/${SERVICE}/ וכתובת ה-URL לדוגמה היא https://sapes5.sapdevcenter.com/sap/opu/odata/IWBEP/GWSAMPLE_BASIC/. מוסיפים מאפיינים נוספים באמצעות המאפיין CustomUrlParams.
    1. סוג היעד: בוחרים סוג יעד.
      • כדי לציין את שם המארח או את כתובת ה-IP של היעד, בוחרים באפשרות כתובת המארח ומזינים את הכתובת בשדה מארח 1.
      • כדי ליצור חיבור פרטי, בוחרים באפשרות Endpoint attachment (צירוף נקודת קצה). ברשימה Endpoint Attachment, בוחרים את קובץ ה-Endpoint Attachment שנוצר עבור מערכת ה-Backend.

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

      כדי להזין יעדים נוספים, לוחצים על +הוספת יעד.

    2. לוחצים על הבא.
  6. בקטע אימות, מזינים את פרטי האימות.
    1. בוחרים סוג אימות ומזינים את הפרטים הרלוונטיים.

      סוגי האימות הבאים נתמכים בחיבור SAP Gateway:

      • שם משתמש וסיסמה
      • אנונימי
      • תהליך קוד הרשאה OAuth 2.0
      • ‫SAP BTP (OAuth 2.0 – פרטי כניסה של לקוח)

      2. כדי להבין איך להגדיר את סוגי האימות האלה, אפשר לעיין במאמר בנושא הגדרת אימות.

    2. לוחצים על הבא.
  7. בדיקה: בודקים את פרטי החיבור והאימות.
  8. לוחצים על יצירה.

הגדרת אימות

מזינים את הפרטים בהתאם לאימות שבו רוצים להשתמש.

  • שם משתמש וסיסמה
    • שם משתמש: שם המשתמש של המחבר
    • סיסמה: סוד ב-Secret Manager שמכיל את הסיסמה שמשויכת למחבר.
  • אנונימי

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

    • מפתח API: מפתח ה-API של המשתמש שאומת כרגע.
  • תהליך קוד הרשאה של OAuth 2.0
    • Client ID: מזינים את מזהה הלקוח שהתקבל מדף לקוח ה-API.
    • היקפים: מזינים רשימה מופרדת בפסיקים של ההיקפים הרצויים.
    • סוד לקוח: מזינים את סוד הלקוח שהתקבל מדף לקוח ה-API.
    • Secret version (גרסת סוד): מזינים את גרסת הסוד של Client Secret (סוד לקוח) שנבחר.
    • כתובת URL לאישור: מזינים את כתובת ה-URL לאישור שנוצרה כשיוצרים לקוח OAuth במופע SAP Gateway.
    • הפעלת ביטול של אימות: בוחרים באפשרות הזו כדי לאפשר לחיבור לקבל אימות שונה באופן דינמי במהלך זמן הריצה.
  • ‫SAP BTP (OAuth 2.0 – פרטי כניסה של לקוח)
    • Client ID: מזינים את מזהה הלקוח שהתקבל מדף לקוח ה-API.
    • סוד לקוח: מזינים את סוד הלקוח שהתקבל מדף לקוח ה-API.
    • גרסה של סוד: מזינים את הגרסה של הסוד שנבחר למעלה.
    • ‫OAuthAccessTokenURL: מזינים את כתובת ה-URL של אסימון הגישה ל-OAuth.
    • שם היעד: מזינים את השם של היעד ב-SAP BTP.
    • כתובת היעד: מזינים את כתובת היעד של SAP BTP.
    • הפעלת עקיפת אימות: בוחרים באפשרות הזו כדי לאפשר לחיבור לקבל אימות שונה באופן דינמי במהלך זמן הריצה.

הגדרת מינוי לאירועים

אם הפעלתם את המינוי לאירועים, מזינים את הערכים הבאים בקטע פרטי המינוי לאירועים:

  1. בוחרים אחד מסוגי האימות הבאים עבור רכיב event listener.
  2. מזינים את שם השדה של סוג האירוע. בשדה הזה מצוין סוג האירוע שמשויך לבקשת האירוע הנכנסת. 
    {
"event_type": "user.created",
...
// other request fields
...
}
  3. בוחרים באפשרות הפעלת קישוריות פרטית כדי ליצור קישוריות מאובטחת בין אפליקציית הקצה העורפי לבין החיבור. אם בוחרים באפשרות הזו, צריך לבצע שלבי הגדרה נוספים אחרי יצירת הקישור. מידע נוסף זמין במאמר בנושא קישוריות פרטית למינוי לאירועים.
  4. מזינים את ההגדרה של תור ההודעות המתות. אם מגדירים תיבת דואר להודעות שלא נמסרו, החיבור כותב את האירועים שלא עברו עיבוד אל נושא Pub/Sub שצוין. ממלאים את הפרטים הבאים:
    1. מזהה פרויקט של הודעות שלא ניתן למסור: מזהה הפרויקט ב-Google Cloud שבו הגדרתם את נושא ה-Pub/Sub של הודעות שלא ניתן למסור.
    2. נושא להודעות ללא מוצא: נושא Pub/Sub שבו רוצים לכתוב את הפרטים של האירוע שלא עבר עיבוד.

דוגמאות להגדרת חיבור

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

אימות בסיסי – סוג החיבור

שם השדה פרטים
אזור us-central1
מחבר SAP Gateway Connector
גרסת המחבר 1
שם מחבר sapgateway-basicauth-conn
חשבון השירות SERVICE_ACCOUNT-compute@developer.gserviceaccount.com
פורמט נתונים JSON
רמת הפירוט 5
כתובת המארח http://192.0.2.0/sap/opu/odata/sap/HOST_ADDRESS
אימות: סיסמת משתמש
שם משתמש שם משתמש
סיסמה סיסמה
גרסאות 1

טוקן API – סוג החיבור

שם השדה פרטים
אזור us-central1
מחבר SAP Gateway Connector
גרסת המחבר 1
שם מחבר sapgateway-api-token-conn
חשבון השירות SERVICE_ACCOUNT-compute@developer.gserviceaccount.com
פורמט נתונים JSON
רמת הפירוט 5
כתובת המארח http://192.0.2.0/sap/opu/odata/sap/HOST_ADDRESS
מפתח API API_KEY-example-pet-store.com
גרסאות 1

Proxy - connection type

שם השדה פרטים
אזור us-central1
מחבר SAP Gateway Connector
גרסת המחבר 1
שם מחבר sapgateway-basicauth-conn
חשבון השירות SERVICE_ACCOUNT-compute@developer.gserviceaccount.com
פורמט נתונים JSON
רמת הפירוט 5
כתובת המארח http://192.0.2.0/sap/opu/odata/sap/HOST_ADDRESS
פורמט נתונים: JSON
רמת המלל: 5
בשם אחרים נכון
סוג ה-SSL של שרת ה-Proxy אוטומטי
שרת Proxy 34.148.1.XX:XXXX
כתובת המארח: http://192.0.2.0/sap/opu/odata/sap/HOST_ADDRESS
אימות: סיסמת משתמש
שם משתמש שם משתמש
סיסמה: סיסמה
גרסאות 1

תהליך קוד הרשאה OAuth 2.0 – סוג חיבור

שם השדה פרטים
אזור us-central1
מחבר SAP Gateway Connector
גרסת המחבר 1
מרחב שמות sap
שירות API_SALES_ORDER_SRV
פורמט נתונים JSON
כתובת המארח https://Host:Port
אימות OAuth 2.0
מזהה לקוח sb-cloneae083fa9a39742e88774df43216a5dbc!b366296|destination-xsappname!b62
סוד לקוח projects/617888503870/secrets/gateway-oauth/versions/1
היקפים ZAPI_SALES_ORDER_SRV_0001
כתובת אתר להרשאה https://HostIp:Port/sap/bc/sec/oauth2/authorize
גרסאות 1

‫SAP BTP (OAuth 2.0 – פרטי כניסה של לקוח) – סוג החיבור

שם השדה פרטים
אזור us-central1
מחבר SAP Gateway Connector
גרסת המחבר 1
שם מחבר sap-gateway-oauth-client-connection
חשבון השירות SERVICE_ACCOUNT-compute@developer.gserviceaccount.com
פורמט נתונים JSON
כתובת המארח: https://my-api.s4hana.cloud.sap/sap/opu/odata/sap/API_PURCHASEORDER_PROCESS_SRV
אימות: SAP BTP
מזהה לקוח CLIENT_ID
סוד לקוח CLIENT_SECRET
OAuthAccessTokenURL https://atrial.authentication.us10.hana.ondemand.com/oauth/token
שם היעד DESTINATION_NAME
כתובת היעד https://destination-configuration.cfapps.us10.hana.ondemand.com/destination-configuration/v1/destinations/Google
גרסאות 1

ישויות, פעולות ופעולות

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

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

    עם זאת, יכול להיות שמחבר לא תומך בישויות או שאין לו ישויות, ובמקרה כזה הרשימה Entities תהיה ריקה.

  • פעולה: פעולה היא הפעילות שאפשר לבצע בישות. אפשר לבצע כל אחת מהפעולות הבאות בישות:

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

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

מגבלות המערכת

  • מחבר SAP Gateway יכול לעבד עד 9 טרנזקציות בשנייה לכל צומת.

    מידע על המגבלות שחלות על Integration Connectors זמין במאמר מגבלות.

  • אין תמיכה בתכונות הבאות:
    • Etags
    • הוספה עמוקה
    • פעולות שמבוססות על קובץ

דוגמאות לפעולות על ישויות

בקטע הזה מוסבר איך לבצע חלק מהפעולות על ישויות במחבר הזה.

דוגמה – הצגת כל הרשומות

בדוגמה הזו מוצגת רשימה של כל הרשומות בישות SalesOrderSet.

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות SalesOrderSet מהרשימה Entity.
  3. בוחרים את הפעולה List ולוחצים על סיום.
  4. אופציונלי: בקטע Task Input (קלט משימה) במשימה Connectors (מחברים), אפשר לסנן את קבוצת התוצאות על ידי ציון filter clause (סעיף סינון). לדוגמה, City='Bangalore'. אפשר גם לציין כמה תנאי סינון באמצעות אופרטורים לוגיים. לדוגמה, City='Bangalore' and region='asia-south2'.

דוגמה – קבלת רשומה

בדוגמה הזו מאחזרים רשומה עם המזהה שצוין מהישות SalesOrderSet.

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות SalesOrderSet מהרשימה Entity.
  3. בוחרים את הפעולה Get ולוחצים על סיום.
  4. בקטע Task Input (קלט של המשימה) במשימה Connectors (מחברים), לוחצים על EntityId (מזהה הישות) ואז מזינים 13 בשדה Default Value (ערך ברירת המחדל).

    כאן, 13 הוא ערך של מפתח ראשי בישות SalesOrderSet.

דוגמה – יצירת רשומה

בדוגמה הזו נוצרת רשומה בישות SalesOrderSet.

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות SalesOrderSet מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    {
"Vbeln":"999",
"Erdat":"2020-08-25 00:00:00",
"Erzet":"13:12:31",
"Ernam":"Test"
}

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

    {
"Vbeln": "999"
}

דוגמה – יצירת רשומה

בדוגמה הזו נוצרת רשומה בישות SalesPriceSet.

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות SalesPriceSet מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    {
"Vbeln": "129",
"Posnr": "000000",
"Knumh": "SUN25MAY",
"Kpein": 1.0
}

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

    {
"Posnr": "000000",
"Vbeln": "129"
}

דוגמה – עדכון רשומה

בדוגמה הזו מעדכנים רשומה בישות SalesOrderSet.

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות SalesOrderSet מהרשימה Entity.
  3. בוחרים את הפעולה Update ולוחצים על סיום.
  4. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    {
"Ernam": "Test123"
}
  5. לוחצים על entityId ואז מזינים 99 בשדה ערך ברירת מחדל.

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

    {
"Vbeln": "999"
}

יצירת חיבורים באמצעות Terraform

אפשר להשתמש במשאב של Terraform כדי ליצור חיבור חדש.

כדי ללמוד איך להחיל הגדרות ב-Terraform או להסיר אותן, ראו פקודות בסיסיות ב-Terraform.

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

כשיוצרים את החיבור הזה באמצעות Terraform, צריך להגדיר את המשתנים הבאים בקובץ ההגדרות של Terraform:

שם הפרמטר סוג נתונים חובה תיאור
מרחב שמות מחרוזת לא נכון מציינים את מרחב השמות של השירות שממנו רוצים לאחזר נתונים. המאפיין הזה נדרש אם השירות לא מצוין בכתובת ה-URL.
שירות מחרוזת לא נכון מציינים את השירות שממנו רוצים לאחזר נתונים. המאפיין הזה נדרש אם השירות לא מצוין בכתובת ה-URL.
custom_url_params מחרוזת לא נכון הפרמטר CustomUrlParams מאפשר לכם לציין פרמטרים מותאמים אישית של מחרוזת שאילתה שנכללים בבקשת ה-HTTP. הפרמטרים צריכים להיות מקודדים כמחרוזת שאילתה בשדה הטופס field1=value1&field2=value2. הערכים במחרוזת השאילתה חייבים להיות מקודדים בכתובת ה-URL.
data_format ENUM לא נכון פורמט הנתונים שבו יאוחזרו הנתונים. בוחרים XML או JSON. הערכים הנתמכים הם: XML, ‏ JSON
use_display_names בוליאני לא נכון ערך בוליאני שקובע אם להשתמש בתוויות SAP.
דרגת מלל מחרוזת לא נכון רמת המלל של החיבור, משתנה מ-1 עד 5. רמת הפירוט הגבוהה יותר תתעד את כל פרטי התקשורת (בקשה,תגובה ואישורי SSL).
proxy_enabled בוליאני לא נכון מסמנים את תיבת הסימון הזו כדי להגדיר שרת Proxy לחיבור.
proxy_auth_scheme ENUM לא נכון סוג האימות שבו יש להשתמש כדי לבצע אימות לשרת ה-proxy‏ ProxyServer. הערכים הנתמכים הם: BASIC, ‏ DIGEST, ‏ NONE
proxy_user מחרוזת לא נכון שם משתמש שישמש לאימות בשרת ה-proxy ‏ProxyServer.
proxy_password SECRET לא נכון סיסמה שתשמש לאימות בשרת ה-proxy‏ ProxyServer.
proxy_ssltype ENUM לא נכון סוג ה-SSL שבו צריך להשתמש כשמתחברים לשרת ה-proxy של ProxyServer. הערכים הנתמכים הם: AUTO, ‏ ALWAYS, ‏ NEVER, ‏ TUNNEL

שימוש בחיבור SAP Gateway בשילוב

אחרי שיוצרים את החיבור, הוא זמין גם ב-Apigee Integration וגם ב-Application Integration. אפשר להשתמש בחיבור בשילוב באמצעות המשימה Connectors.

  • כדי להבין איך ליצור ולהשתמש במשימה Connectors ב-Apigee Integration, אפשר לעיין במאמר משימת Connectors.
  • מידע על יצירה ושימוש במשימת מחברים ב-Application Integration זמין במאמר משימת מחברים.

קבלת עזרה מקהילת Google Cloud

אתם יכולים לפרסם את השאלות שלכם ולדון במחבר הזה בקהילת Google Cloud בפורומים של Cloud.

המאמרים הבאים