Oracle Sales Cloud
מחבר Oracle Sales Cloud מאפשר לכם לבצע פעולות של הוספה, מחיקה, עדכון וקריאה של נתונים ב-Oracle Sales Cloud.
גרסאות נתמכות
הגרסה המינימלית הנתמכת של המחבר הזה היא: Oracle Sales Cloud 24D (11.13.24.10.0)
לפני שמתחילים
בפרויקט Google Cloud, מבצעים את המשימות הבאות:
- מוודאים שהגדרתם חיבור לרשת. מידע על תבניות רשת זמין במאמר קישוריות לרשת.
- נותנים למשתמש שמגדיר את המחבר את תפקיד ה-IAM roles/connectors.admin.
- מקצים את התפקידים
roles/secretmanager.viewerו-roles/secretmanager.secretAccessorב-IAM לחשבון השירות שבו רוצים להשתמש עבור המחבר. - מפעילים את השירותים הבאים:
-
secretmanager.googleapis.com(Secret Manager API) -
connectors.googleapis.com(Connectors API)
במאמר הפעלת שירותים מוסבר איך להפעיל שירותים. אם השירותים או ההרשאות האלה לא הופעלו בפרויקט שלכם בעבר, תוצג לכם בקשה להפעיל אותם כשאתם מגדירים את המחבר.
-
הגדרת המחבר
החיבור הוא ספציפי למקור נתונים. אם יש לכם הרבה מקורות נתונים, תצטרכו ליצור חיבור נפרד לכל אחד מהם. כדי ליצור קישור:
- במסוף Cloud, עוברים לדף Integration Connectors > Connections ובוחרים או יוצרים פרויקט בענן.
- לוחצים על + יצירת חיבור חדש כדי לפתוח את הדף יצירת חיבור.
- בקטע מיקום, בוחרים את המיקום של החיבור.
- אזור: בוחרים מיקום מהרשימה הנפתחת.
רשימה של כל האזורים הנתמכים מופיעה במאמר מיקומים.
- לוחצים על הבא.
- אזור: בוחרים מיקום מהרשימה הנפתחת.
- בקטע פרטי החיבור, ממלאים את הפרטים הבאים:
- מחבר: בוחרים באפשרות Oracle Sales Cloud מהרשימה הנפתחת של המחברים הזמינים.
- גרסת כלי החיבור: בוחרים את גרסת כלי החיבור מהרשימה הנפתחת של הגרסאות הזמינות.
- בשדה Connection Name (שם החיבור), מזינים שם למופע החיבור.
השמות של החיבורים צריכים לעמוד בקריטריונים הבאים:
- שמות החיבורים יכולים לכלול אותיות, מספרים או מקפים.
- האותיות צריכות להיות קטנות.
- שמות החיבורים צריכים להתחיל באות ולהסתיים באות או במספר.
- שמות החיבורים לא יכולים לכלול יותר מ-49 תווים.
- אופציונלי: מזינים תיאור למופע החיבור.
- אופציונלי: מפעילים את Cloud Logging ואז בוחרים רמת יומן. כברירת מחדל, רמת היומן מוגדרת כ-
Error. - חשבון שירות: בוחרים חשבון שירות שיש לו את התפקידים הנדרשים.
- אופציונלי: מגדירים את ההגדרות של צומת החיבור:
- מספר מינימלי של צמתים: מזינים את המספר המינימלי של צמתי חיבור.
- מספר הצמתים המקסימלי: מזינים את מספר צמתי החיבור המקסימלי.
צומת הוא יחידה (או עותק) של חיבור שמבצעת עיבוד של עסקאות. כדי לעבד יותר עסקאות לחיבור נדרשים יותר צמתים, ולהפך: כדי לעבד פחות עסקאות נדרשים פחות צמתים. כדי להבין איך הצמתים משפיעים על התמחור של המחבר, אפשר לעיין במאמר בנושא תמחור של צמתי חיבור. אם לא מזינים ערכים, כברירת מחדל, מספר הצמתים המינימלי מוגדר כ-2 (לזמינות טובה יותר) ומספר הצמתים המקסימלי מוגדר כ-50.
- הרחבת השדות: פרמטר השדה מסנן את מאפייני המשאב. כשמריצים שאילתות SELECT * , אם השדה הזה מוגדר כ-true, מוחזרים רק המאפיינים שצוינו.
- כולל אובייקטים בהתאמה אישית: מציין אם אובייקטים בהתאמה אישית מאוחזרים באופן דינמי. אם הנכס הזה מוגדר כ-false, טבלאות בהתאמה אישית לא יוצגו.
- זמן קצוב לתפוגת חיבור: מציינים את הזמן הקצוב לתפוגת חיבור בשניות.
-
יצירת קובצי סכימה: מציינים מתי ליצור ולשמור את הסכימות. אפשר לבחור באחת מהאפשרויות הבאות:
- אף פעם: לא ייווצרו קובצי סכימה.
- OnUse: יוצר את קובץ הסכימה כשמתבצעת הפניה לטבלה בפעם הראשונה וקובץ הסכימה לא קיים.
- OnStart: יוצר את קובץ הסכימה לטבלאות שאין להן קובץ סכימה כשנוצר החיבור.
- OnCreate: יוצר את קובץ הסכימה כשמריצים שאילתת SQL של CREATE TABLE.
- (אופציונלי) כדי להגדיר שרת proxy לחיבור, בוחרים באפשרות שימוש ב-proxy ומזינים את פרטי ה-proxy.
-
סכימת אימות של שרת proxy: בוחרים את סוג האימות לאימות מול שרת ה-proxy. אלה סוגי האימות שנתמכים:
- בסיסי: אימות HTTP בסיסי.
- Digest: אימות HTTP מסוג Digest.
- משתמש proxy: שם משתמש שישמש לאימות בשרת ה-proxy.
- סיסמת ה-Proxy: הסוד במנהל הסודות של סיסמת המשתמש.
-
סוג ה-SSL של ה-Proxy: סוג ה-SSL שבו יש להשתמש כשמתחברים לשרת ה-Proxy. יש תמיכה בסוגי האימות הבאים:
- אוטומטי: הגדרת ברירת המחדל. אם כתובת ה-URL היא כתובת HTTPS, נעשה שימוש באפשרות Tunnel. אם כתובת ה-URL היא כתובת HTTP, נעשה שימוש באפשרות NEVER.
- תמיד: החיבור תמיד מופעל באמצעות SSL.
- לעולם לא: החיבור לא מופעל באמצעות SSL.
- מנהור: החיבור הוא דרך שרת proxy למנהור. שרת ה-proxy פותח חיבור למארח המרוחק, והתנועה זורמת הלוך ושוב דרך ה-proxy.
- בקטע שרת Proxy, מזינים את פרטי שרת ה-Proxy.
- לוחצים על + הוספת יעד.
- בוחרים סוג יעד.
- כתובת המארח: מציינים את שם המארח או את כתובת ה-IP של היעד.
כדי ליצור חיבור פרטי למערכת העורפית, פועלים לפי השלבים הבאים:
- יוצרים קובץ מצורף לשירות PSC.
- יוצרים endpoint attachment ואז מזינים את הפרטים שלו בשדה Host address.
- כתובת המארח: מציינים את שם המארח או את כתובת ה-IP של היעד.
- אופציונלי: לוחצים על + הוספת תווית כדי להוסיף תווית לקישור בצורה של צמד מפתח/ערך.
- לוחצים על הבא.
- בקטע יעדים, מזינים את הפרטים של המארח המרוחק (מערכת העורף) שאליו רוצים להתחבר.
- סוג היעד: בוחרים סוג יעד.
- כדי לציין את שם המארח או את כתובת ה-IP של היעד, בוחרים באפשרות כתובת המארח ומזינים את הכתובת בשדה מארח 1.
- כדי ליצור חיבור פרטי, בוחרים באפשרות Endpoint attachment (צירוף נקודת קצה). ברשימה Endpoint Attachment, בוחרים את קובץ ה-Endpoint Attachment שנוצר עבור מערכת ה-Backend.
אם רוצים ליצור חיבור ציבורי למערכות העורפיות עם אבטחה נוספת, אפשר להגדיר כתובות IP סטטיות יוצאות לחיבורים, ואז להגדיר את כללי חומת האש כך שרק כתובות ה-IP הסטטיות הספציפיות יופיעו ברשימת ההיתרים.
כדי להזין יעדים נוספים, לוחצים על +הוספת יעד.
- לוחצים על הבא.
- סוג היעד: בוחרים סוג יעד.
-
בקטע אימות, מזינים את פרטי האימות.
- בוחרים סוג אימות ומזינים את הפרטים הרלוונטיים.
החיבור ל-Oracle Sales Cloud תומך בסוגי האימות הבאים:
- שם משתמש וסיסמה
- לוחצים על הבא.
כדי להבין איך להגדיר את סוגי האימות האלה, אפשר לעיין במאמר בנושא הגדרת אימות.
- בוחרים סוג אימות ומזינים את הפרטים הרלוונטיים.
- בדיקה: בודקים את פרטי החיבור והאימות.
- לוחצים על יצירה.
הגדרת אימות
מזינים את הפרטים בהתאם לאימות שבו רוצים להשתמש.
-
שם משתמש וסיסמה
- שם משתמש: שם המשתמש של המחבר
- סיסמה: סוד ב-Secret Manager שמכיל את הסיסמה שמשויכת למחבר.
- גרסה של סוד: גרסת הסוד שנבחרה למעלה.
דוגמאות להגדרת חיבור
בקטע הזה מפורטים ערכים לדוגמה לשדות השונים שאתם מגדירים כשאתם יוצרים את החיבור.
| שם השדה | פרטים |
|---|---|
| מיקום | europe-west1 |
| מחבר | Oracle Sales Cloud |
| גרסת המחבר | 1 |
| שם החיבור | oracle-sales-new |
| חשבון השירות | SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com |
| מספר הצמתים המינימלי | 2 |
| מספר הצמתים המקסימלי | 50 |
| סוג היעד | כתובת המארח |
| host1 | https://iaaptz.fa.ocs.oraclecloud.com//td> |
| שם משתמש | OracleSalesCloudUser |
| סיסמה | PASSWORD |
| Secret Version | 1 |
מגבלות המערכת
המחבר של Oracle Sales Cloud יכול לעבד עד 10 עסקאות בשנייה, לכל צומת, ומגביל עסקאות מעבר למגבלה הזו. כברירת מחדל, Integration Connectors מקצה 2 צמתים (לזמינות טובה יותר) לחיבור.
מידע על המגבלות שחלות על Integration Connectors זמין במאמר מגבלות.
שימוש בחיבור Oracle Sales Cloud בשילוב
אחרי שיוצרים את החיבור, הוא זמין גם ב-Apigee Integration וגם ב-Application Integration. אפשר להשתמש בחיבור בשילוב באמצעות המשימה Connectors.
- כדי להבין איך ליצור ולהשתמש במשימה Connectors ב-Apigee Integration, אפשר לעיין במאמר משימת Connectors.
- מידע על יצירה ושימוש במשימת מחברים ב-Application Integration זמין במאמר משימת מחברים.
דוגמאות לפעולות על ישויות
בקטע הזה מובאות דוגמאות לאופן שבו אפשר לבצע את פעולות הישות במחבר הזה.
דוגמה – הצגת כל ההזדמנויות
- בתיבת הדו-שיח
Configure connector task, לוחצים עלEntities. - בוחרים באפשרות
OpportunitiesמהרשימהEntity. - בוחרים את הפעולה
Listולוחצים על סיום.
צריך להשתמש בפעולת List עם פסקה של מסנן בישויות שבהן נדרש יותר ממפתח אחד כדי לאחזר רשומה יחידה.
דוגמה – קבלת אנשי קשר
- בתיבת הדו-שיח
Configure connector task, לוחצים עלEntities. - בוחרים באפשרות
ContactsמהרשימהEntity. - בוחרים את הפעולה
Getולוחצים על סיום. - מגדירים את מזהה הישות ל'אנשי קשר'. כדי להגדיר את מזהה הישות, בקטע Data Mapper (מיפוי נתונים) של Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor (פתיחת כלי מיפוי הנתונים), מזינים
3046בשדה Input Value (ערך קלט) ובוחרים באפשרות EntityId בתור Local variable (משתנה מקומי).
חובה להשתמש בפעולת Get עם פסוקית filter בישויות שבהן נדרש יותר ממפתח אחד כדי לאחזר רשומה יחידה.
דוגמה – מחיקת הזדמנויות
- בתיבת הדו-שיח
Configure connector task, לוחצים עלEntities. - בוחרים באפשרות
OpportunitiesמהרשימהEntity. - בוחרים את הפעולה
Deleteולוחצים על סיום. - מגדירים את מזהה הישות לערך Delete Opportunities (מחיקת הזדמנויות). כדי להגדיר את מזהה הישות, בקטע Data Mapper (מיפוי נתונים) של Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor (פתיחת כלי מיפוי הנתונים), מזינים
203002בשדה Input Value (ערך קלט) ובוחרים באפשרות EntityId בתור Local variable (משתנה מקומי).צריך להשתמש בפעולת המחיקה עם פסקה של מסנן בישויות שבהן נדרש יותר ממפתח אחד כדי לאחזר רשומה יחידה.
דוגמה – יצירת אנשי קשר
- בתיבת הדו-שיח
Configure connector task, לוחצים עלEntities. - בוחרים באפשרות
ContactsמהרשימהEntity. - בוחרים את הפעולה
Createולוחצים על סיום. - בקטע מיפוי נתונים של המשימה, לוחצים על
OpenDataMappingeditor ומזינים ערך דומה לערך הבא בfield:{ "FirstName": "Googlecloud2", "LastName": "TestCreate3" }הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט
connectorOutputPayloadשל משימת המחבר:{ "PartyNumber": "807006" }
דוגמה – יצירת כתובות של אנשי קשר
- בתיבת הדו-שיח
Configure connector task, לוחצים עלEntities. - בוחרים באפשרות ContactAddresses מהרשימה
Entity. - בוחרים את הפעולה
Createולוחצים על סיום. - בקטע מיפוי נתונים של המשימה, לוחצים על
OpenDataMappingeditor ומזינים ערך דומה לערך הבא בfield:{ "City": "CreatingAddGooglecloud", "State": "France", "Country": "FR", "Address1": "Googlecloud Contact Address 1", "PartyNumber": "3046" }הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט
connectorOutputPayloadשל משימת המחבר:{ "AddressNumber": "411001", "PartyNumber": "3046" }
דוגמה – יצירת חשבונות
- בתיבת הדו-שיח
Configure connector task, לוחצים עלEntities. - בוחרים באפשרות 'חשבונות' מהרשימה
Entity. - בוחרים את הפעולה
Createולוחצים על סיום. - בקטע מיפוי נתונים של המשימה, לוחצים על
OpenDataMappingeditor ומזינים ערך דומה לערך הבא בfield:{ "OrganizationName": "Test Account7Googlecloud", "AddressLine1": "E-City", "City": "Paris", "Country": "FR" }הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט
connectorOutputPayloadשל משימת המחבר:{ "PartyNumber": "804006" }
דוגמה – יצירת הזדמנויות
- בתיבת הדו-שיח
Configure connector task, לוחצים עלEntities. - בוחרים באפשרות 'הזדמנויות' מתוך הרשימה
Entity. - בוחרים את הפעולה
Createולוחצים על סיום. - בקטע מיפוי נתונים של המשימה, לוחצים על
OpenDataMappingeditor ומזינים ערך דומה לערך הבא בfield:{ "Name": "OpportunityGooglecloud1" }הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט
connectorOutputPayloadשל משימת המחבר:{ "OptyNumber": "203001" }
דוגמה – יצירת מקבל הקצאה של פעילות
- בתיבת הדו-שיח
Configure connector task, לוחצים עלEntities. - בוחרים באפשרות
ActivityAssigneeמהרשימהEntity. - בוחרים את הפעולה
Createולוחצים על סיום. - בקטע מיפוי נתונים של המשימה, לוחצים על
OpenDataMappingeditor ומזינים ערך דומה לערך הבא בfield:{ "ActivityId": 300000010836710, "AssigneeId": 300000001962681, "ActivityNumber": "212380" }הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט
connectorOutputPayloadשל משימת המחבר:{ "ActivityAssigneeId": 300000014424799 }
דוגמה – יצירת איש קשר לפעילות
- בתיבת הדו-שיח
Configure connector task, לוחצים עלEntities. - בוחרים באפשרות
ActivityContactמהרשימהEntity. - בוחרים את הפעולה
Createולוחצים על סיום. - בקטע מיפוי נתונים של המשימה, לוחצים על
OpenDataMappingeditor ומזינים ערך דומה לערך הבא בfield:{ "ActivityNumber": "212544", "ContactId": 100000001886382 }הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט
connectorOutputPayloadשל משימת המחבר:{ "ActivityContactId": 300000014968493 }
דוגמה – עדכון הזדמנויות
- בתיבת הדו-שיח
Configure connector task, לוחצים עלEntities. - בוחרים באפשרות
OpportunitiesמהרשימהEntity. - בוחרים את הפעולה
Updateולוחצים על סיום. - מגדירים את EntityID ל-Opportunities. כדי להגדיר את EntityID, בקטע Data mapper של Tasks, לוחצים על EntityID ומזינים
5בשדה שמופיע. - בקטע מיפוי נתונים של המשימה, לוחצים על
OpenDataMappingeditor ומזינים ערך דומה לערך הבא בfield:{ "Name": "Updated Googlecloud Opportunity again" }
הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:
{ "OptyNumber": "150364" }
דוגמה – עדכון חשבונות
- בתיבת הדו-שיח
Configure connector task, לוחצים עלEntities. - בוחרים באפשרות
AccountsמהרשימהEntity. - בוחרים את הפעולה
Updateולוחצים על סיום. - מגדירים את EntityID ל-Accounts. כדי להגדיר את EntityID, בקטע Data mapper של Tasks, לוחצים על EntityID ומזינים
804006בשדה שמופיע. - בקטע מיפוי נתונים של המשימה, לוחצים על
OpenDataMappingeditor ומזינים ערך דומה לערך הבא בfield:{ "OrganizationName": "updated Test Account7Googlecloud" }
הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:
{ "PartyNumber": "804006" }
דוגמה – עדכון פעילויות
- בתיבת הדו-שיח
Configure connector task, לוחצים עלEntities. - בוחרים באפשרות
ActivitiesמהרשימהEntity. - בוחרים את הפעולה
Updateולוחצים על סיום. - מגדירים את EntityID ל-Activities. כדי להגדיר את EntityID, בקטע Data mapper של Tasks, לוחצים על EntityID ומזינים
201001בשדה שמופיע. - בקטע מיפוי נתונים של המשימה, לוחצים על
OpenDataMappingeditor ומזינים ערך דומה לערך הבא בfield:{ "ActivityFunctionCode": "APPOINTMENT", "ActivityStartDate": "2025-05-27 07:10:23", "ActivityEndDate": "2025-05-27 08:10:23" }
הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:
{ "ActivityNumber": "201001" }
דוגמה – עדכון אנשי קשר
- בתיבת הדו-שיח
Configure connector task, לוחצים עלEntities. - בוחרים באפשרות
ContactsמהרשימהEntity. - בוחרים את הפעולה
Updateולוחצים על סיום. - מגדירים את EntityID (מזהה הישות) ל-Contacts (אנשי קשר). כדי להגדיר את EntityID, בקטע Data mapper של Tasks, לוחצים על EntityID ומזינים
59בשדה שמופיע. - בקטע מיפוי נתונים של המשימה, לוחצים על
OpenDataMappingeditor ומזינים ערך דומה לערך הבא בfield:{ "FirstName": "GooglecloudUpdated2", "LastName": "Testlatency3" }
הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:
{ "PartyNumber": "807004" }
יצירת חיבורים באמצעות Terraform
אפשר להשתמש במשאב של Terraform כדי ליצור חיבור חדש.
כדי ללמוד איך להחיל הגדרות ב-Terraform או להסיר אותן, ראו פקודות בסיסיות ב-Terraform.
כדי לראות תבנית לדוגמה של Terraform ליצירת חיבור, אפשר לעיין בתבנית לדוגמה.
כשיוצרים את החיבור הזה באמצעות Terraform, צריך להגדיר את המשתנים הבאים בקובץ ההגדרות של Terraform:
| שם הפרמטר | סוג נתונים | חובה | תיאור |
|---|---|---|---|
| expand_fields | בוליאני | לא נכון | קובעת אם מנהל ההתקן ישאיר את הפרמטר של כתובת האתר ריק כשמבצעים שאילתות SELECT * . |
| include_custom_objects | בוליאני | לא נכון | קובעת אם צריך לאחזר אובייקטים מותאמים אישית באופן דינמי או לא. טבלאות בהתאמה אישית לא יוצגו אלא אם הנכס הזה מוגדר כ-true. |
| generate_schema_files | ENUM | לא נכון | מציין את העדפת המשתמש לגבי מתי ליצור ולשמור סכימות. הערכים הנתמכים הם: Never, OnUse, OnStart, OnCreate |
| 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 |