‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

SAP Ariba Procurement

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

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

המחבר הזה תומך ב-SAP Ariba Procurement REST APIs.

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

בפרויקט Google Cloud, מבצעים את המשימות הבאות:

מוודאים שהגדרתם חיבור לרשת. מידע נוסף זמין במאמר קישוריות לרשת.
נותנים למשתמש שמגדיר את המחבר את תפקיד ה-IAM‏ roles/connectors.admin.
מקצים את תפקידי ה-IAM‏ roles/secretmanager.viewer ו-roles/secretmanager.secretAccessor לחשבון השירות שבו רוצים להשתמש עבור המחבר.
מפעילים את secretmanager.googleapis.com (Secret Manager API) ואת connectors.googleapis.com (Connectors API). מידע נוסף זמין במאמר בנושא הפעלת שירותים.

הגדרת המחבר

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

במסוף Cloud, עוברים לדף Integration Connectors > Connections ובוחרים או יוצרים פרויקט בענן.
כניסה לדף Connections
לוחצים על + יצירת חיבור חדש כדי לפתוח את הדף יצירת חיבור.
בקטע מיקום, מבצעים את הפעולות הבאות:
1. אזור: בוחרים מיקום מהרשימה הנפתחת.
  רשימה של כל האזורים הנתמכים מופיעה במאמר מיקומים.
2. לוחצים על הבא.
בקטע פרטי החיבור, ממלאים את הפרטים הבאים:
1. מחבר: בוחרים באפשרות SAP Ariba Procurement מתוך רשימת המחברים הזמינים.
2. גרסת המחבר: בוחרים את גרסת המחבר מתוך רשימת הגרסאות הזמינות.
3. בשדה Connection Name, מזינים שם למופע החיבור. שם החיבור יכול להכיל אותיות קטנות, מספרים או מקפים. השם צריך להתחיל באות ולהסתיים באות או במספר, והוא לא יכול להכיל יותר מ-49 תווים.
4. תיאור: מזינים תיאור של מופע החיבור.
5. אופציונלי: מפעילים את Cloud Logging ואז בוחרים רמת יומן. כברירת מחדל, רמת היומן מוגדרת כ-Error.
6. חשבון שירות: בוחרים חשבון שירות שיש לו את התפקידים הנדרשים.
7. ‫ANID: מציינים את מזהה הרשת של SAP Ariba.
8. מפתח API: מזינים את מפתח אפליקציית OAuth לאימות.
9. תחום: מזינים את התחום של SAP Ariba לחיבור.
10. ‫API: מזינים את SAP Ariba API כדי לאחזר נתונים ממנו.
11. מרכז נתונים: מזינים את המיקום הגיאוגרפי שבו מתארח החשבון שלכם.
12. סביבה: מזינים את סביבת SAP Ariba שאליה רוצים להתחבר.
13. אופציונלי: מגדירים את ההגדרות של צומת החיבור:
  - מספר מינימלי של צמתים: מזינים את המספר המינימלי של צמתי חיבור.
  - מספר הצמתים המקסימלי: מזינים את מספר צמתי החיבור המקסימלי.
  צומת הוא יחידה (או עותק) של חיבור שמבצעת עיבוד של עסקאות. כדי לעבד יותר עסקאות לחיבור נדרשים יותר צמתים, ולהפך: כדי לעבד פחות עסקאות נדרשים פחות צמתים. כדי להבין איך הצמתים משפיעים על התמחור של המחבר, אפשר לעיין במאמר בנושא תמחור של צמתי חיבור. אם לא מזינים ערכים, כברירת מחדל, מספר הצמתים המינימלי מוגדר כ-2 (לזמינות טובה יותר) ומספר הצמתים המקסימלי מוגדר כ-50.
14. + הוספת תווית: לוחצים על האפשרות הזו כדי להוסיף תווית לחיבור בצורה של צמד מפתח/ערך.
15. לוחצים על הבא.
בקטע אימות, מזינים את פרטי האימות.
1. בוחרים סוג אימות ומזינים את הפרטים הרלוונטיים.
  החיבור ל-SAP Ariba Procurement תומך בסוגי האימות הבאים:
  - ‫OAuth 2.0 – פרטי כניסה של לקוח
  כדי להבין איך להגדיר את סוגי האימות האלה, אפשר לעיין במאמר בנושא הגדרת אימות.
2. לוחצים על הבא.
בדיקה: בודקים את פרטי החיבור והאימות.
לוחצים על יצירה.

הגדרת אימות

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

OAuth 2.0 – פרטי לקוח
- ‫Client ID (מזהה לקוח): מזינים את מזהה הלקוח של האפליקציה שיצרתם.
- סוד לקוח: מזינים את הסוד של מנהל הסודות שמכיל את סוד הלקוח של האפליקציה המקושרת שיצרתם.
- Secret version: בוחרים את גרסת הסוד של סוד הלקוח.
- הפעלת ביטול של אימות: מפעילים את האפשרות הזו כדי לבטל את האימות.

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

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

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

שם השדה	פרטים
מיקום	europe-west1
מחבר	SAP Ariba Procurement
גרסת המחבר	1
שם החיבור	gcp-sapariba-procurement-po-supplier
הפעלת Cloud Logging	כן
חשבון השירות	my-service-account@my-project.iam.gserviceaccount.com
רמת הרישום ביומן	ניפוי באגים
ANID	AN11234322444-T
מפתח API	gaTawAf8m3gtAs8gPyUbU9Be1eLXbvFq
Realm	745628447-T
API	PurchaseOrdersSupplierAPI-V1
מרכז נתונים	ארה"ב
סביבה	בדיקה
מספר הצמתים המינימלי	2
מספר הצמתים המקסימלי	50
אימות	‫OAuth 2.0 – פרטי כניסה של לקוח
מזהה לקוח	4c71c4d4-d7e9-494e-807f-9dead41abc6f
סוד לקוח	projects/617888503870/secrets/AribaProcurement/versions/10
גרסה של סוד	10

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

מחבר SAP Ariba Procurement יכול לעבד עד 3 עסקאות בשנייה, לכל צומת, ומגביל את מספר העסקאות מעבר למגבלה הזו. כברירת מחדל, Integration Connectors מקצה 2 צמתים (לזמינות טובה יותר) לחיבור.

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

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

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

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

שימוש בחיבור SAP Ariba Procurement בשילוב

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

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

פעולות

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

פעולת CreateChildElementSchema

הפעולה הזו יוצרת קובץ סכימה למערך של מסמכים בתבנית התצוגה.

פרמטרים של קלט לפעולה CreateChildElementSchema

שם הפרמטר	סוג	מקבל זרמי פלט	תיאור
ViewTemplateName	String	לא נכון	השם של תבנית תצוגה קיימת.
ChildElement	String	לא נכון	אלמנט צאצא או מערך של מסמכים בתבנית התצוגה בסימון נקודות, כמו `LineItems.SplitAccountings`.
TableName	String	לא נכון	השם של הטבלה החדשה, למשל `View_LineItems_SplitAccountings`.
FileName	String	לא נכון	שם הקובץ של הסכימה שנוצרה. אפשר להזין נתיב יחסי או נתיב מוחלט למיקום השמירה הרצוי.
FileStream	String	נכון	מופע של זרם פלט שבו נכתבים נתונים של קובץ.

דוגמה להגדרת הפעולה CreateChildElementSchema מופיעה במאמר דוגמאות.

פעולת CreateSchema

יוצרת קובץ סכימה לטבלה או לתצוגה שצוינו.

פרמטרים של קלט לפעולה CreateSchema

שם הפרמטר	סוג	מקבל זרמי פלט	תיאור
TableName	String	לא נכון	השם של הטבלה החדשה.
FileName	String	לא נכון	שם הקובץ של הסכימה שנוצרה. אפשר להזין נתיב יחסי או נתיב מוחלט למיקום השמירה הרצוי.
FileStream	String	לא נכון	מופע של זרם פלט שבו נכתבים נתונים של קובץ.

דוגמה להגדרת הפעולה CreateSchema מופיעה במאמר דוגמאות.

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

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

דוגמה – יצירת סכימה של רכיב צאצא

בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
בוחרים את הפעולה CreateChildElementSchema ולוחצים על סיום.
בקטע Task Input (קלט משימה) של המשימה connectors (מחברים), לוחצים על connectorInputPayload ואז מזינים ערך דומה לערך הבא בשדה Default Value:
```
{
  "ViewTemplateName": "InvoiceReconciliation_SAP_createdRange",
  "ChildElement": "Payments",
  "TableName": "View_LineItems_SplitAccountings"
}
```

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

[
  {
    "FileData": "",
    "Result": "success"
  }
]

דוגמה – יצירת סכימה

בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
בוחרים את הפעולה CreateSchema ולוחצים על סיום.
בקטע Task Input (קלט משימה) של המשימה connectors (מחברים), לוחצים על connectorInputPayload ואז מזינים ערך דומה לערך הבא בשדה Default Value:
```
{
  "TableName": "Views"
}
```

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

[
  {
    "FileData": "",
    "Result": "success"
  }
]

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

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

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

בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
בוחרים באפשרות Orders מהרשימה Entity.
בוחרים את הפעולה List ולוחצים על סיום.
בקטע Task Input של המשימה connectors, אפשר להגדיר את filterClause בהתאם לדרישות הלקוח.

חובה להשתמש במירכאות בודדות (') כדי להקיף את הערך של filterClause. אפשר להשתמש ב-filterClause כדי לסנן רשומות על סמך העמודות.

דוגמה – רשימת כל הפריטים

בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
בוחרים באפשרות LineItems מהרשימה Entity.
בוחרים את הפעולה List ולוחצים על סיום.
בקטע Task Input (קלט משימה) של משימת connectors (מחברים), אפשר להגדיר את filterClause (סעיף סינון) בהתאם לדרישות הלקוח.

דוגמה – קבלת פרטי הזמנה

בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
בוחרים באפשרות Orders מהרשימה Entity.
בוחרים את הפעולה Get ולוחצים על סיום.
מגדירים את entityId לערך DO240, שהוא המפתח שיועבר. כדי להגדיר את entityId, בקטע Data Mapper (מיפוי נתונים) של Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor (פתיחת כלי מיפוי הנתונים), מזינים "DO240" בשדה Input Value (ערך קלט) ובוחרים את entityId כמשתנה מקומי.

צריך להעביר את הערך של entityId ישירות, למשל DO240. בדוגמה הזו, הערך הייחודי של המפתח הראשי הוא DO240.

אם העברת entityId יחיד גורמת לשגיאה בגלל נוכחות של שני מפתחות מורכבים, אפשר להשתמש ב-filterClause כדי להעביר את הערך, כמו DocumentNumber='DO240'.

דוגמה – קבלת נתוני הפריט

בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
בוחרים באפשרות LineItems מהרשימה Entity.
בוחרים את הפעולה Get ולוחצים על סיום.
מגדירים את filterClause ל-LineNumber='1' AND DocumentNumber='DO240', שהם המפתחות המורכבים שיועברו. כדי להגדיר את filterClause, בקטע Data Mapper של Data Mapping, לוחצים על Open Data Mapping Editor, מזינים "LineNumber='1' AND DocumentNumber='DO240'" בשדה Input Value ובוחרים את filterClause כמשתנה מקומי.

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

בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
בוחרים באפשרות Views מהרשימה Entity.
בוחרים את הפעולה Create ולוחצים על סיום.
בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor ואז מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים את entityId,‏ connectorInputPayload או filterClause כמשתנה מקומי.
```
{
  "ViewTemplateName": "TestView1754629881645",
  "Status": "published",
  "FilterExpressions": "[{\"name\":\"ExampleFilter\",\"field\":\"UniqueName\",\"op\":\"IN\",\"defaultValue\":[\"P011\"]}]",
  "DocumentType": "DirectOrder",
  "SelectAttributes": "[\"SubmitDate\"]"
}
```
הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:
```
{
  "Success": true
}
```

דוגמה – עדכון תצוגה

בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
בוחרים באפשרות Views מהרשימה Entity.
בוחרים את הפעולה Update ולוחצים על סיום.
בקטע Data Mapper (מיפוי נתונים) במשימה Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor ומזינים ערך דומה לערך הבא בשדה Input Value.
```
{
  "Status": "published"
}
```
מגדירים את entityId בכלי למיפוי נתונים למזהה של התצוגות. כדי להגדיר את entityId, לוחצים על Open Data Mapping Editor, מזינים ערך דומה לערך הבא בשדה Input Value ובוחרים את entityId, ‏ connectorInputPayload או filterClause כמשתנה מקומי.
במקום לציין את entityId, אפשר גם להגדיר את filterClause לערך TestView = '1754629881645'.
הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:
```
{
}
```
אובייקט JSON ריק {}בתגובה מציין שפעולת העדכון בוצעה בהצלחה.

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

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