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)

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

הגדרת המחבר

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

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

    כניסה לדף Connections

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

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

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

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

      • שמות החיבורים יכולים לכלול אותיות, מספרים או מקפים.
      • האותיות צריכות להיות קטנות.
      • שמות החיבורים צריכים להתחיל באות ולהסתיים באות או במספר.
      • שמות החיבורים לא יכולים לכלול יותר מ-49 תווים.
    4. אופציונלי: מזינים תיאור למופע החיבור.
    5. אופציונלי: מפעילים את Cloud Logging ואז בוחרים רמת יומן. כברירת מחדל, רמת היומן מוגדרת כ-Error.
    6. חשבון שירות: בוחרים חשבון שירות שיש לו את התפקידים הנדרשים.
    7. אופציונלי: מגדירים את ההגדרות של צומת החיבור:

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

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

    8. הרחבת השדות: פרמטר השדה מסנן את מאפייני המשאב. כשמריצים שאילתות SELECT * ‎, אם השדה הזה מוגדר כ-true, מוחזרים רק המאפיינים שצוינו.
    9. כולל אובייקטים בהתאמה אישית: מציין אם אובייקטים בהתאמה אישית מאוחזרים באופן דינמי. אם הנכס הזה מוגדר כ-false, טבלאות בהתאמה אישית לא יוצגו.
    10. זמן קצוב לתפוגת חיבור: מציינים את הזמן הקצוב לתפוגת חיבור בשניות.
    11. יצירת קובצי סכימה: מציינים מתי ליצור ולשמור את הסכימות. אפשר לבחור באחת מהאפשרויות הבאות:
      • אף פעם: לא ייווצרו קובצי סכימה.
      • OnUse: יוצר את קובץ הסכימה כשמתבצעת הפניה לטבלה בפעם הראשונה וקובץ הסכימה לא קיים.
      • OnStart: יוצר את קובץ הסכימה לטבלאות שאין להן קובץ סכימה כשנוצר החיבור.
      • OnCreate: יוצר את קובץ הסכימה כשמריצים שאילתת SQL של CREATE TABLE.
    12. (אופציונלי) כדי להגדיר שרת 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.
        1. לוחצים על + הוספת יעד.
        2. בוחרים סוג יעד.
          • כתובת המארח: מציינים את שם המארח או את כתובת ה-IP של היעד.

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

    13. אופציונלי: לוחצים על + הוספת תווית כדי להוסיף תווית לקישור בצורה של צמד מפתח/ערך.
    14. לוחצים על הבא.
  5. בקטע יעדים, מזינים את הפרטים של המארח המרוחק (מערכת העורף) שאליו רוצים להתחבר.
    1. סוג היעד: בוחרים סוג יעד.
      • כדי לציין את שם המארח או את כתובת ה-IP של היעד, בוחרים באפשרות כתובת המארח ומזינים את הכתובת בשדה מארח 1.
      • כדי ליצור חיבור פרטי, בוחרים באפשרות Endpoint attachment (צירוף נקודת קצה). ברשימה Endpoint Attachment, בוחרים את קובץ ה-Endpoint Attachment שנוצר עבור מערכת ה-Backend.

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

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

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

      החיבור ל-Oracle Sales Cloud תומך בסוגי האימות הבאים:

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

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

הגדרת אימות

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

  • שם משתמש וסיסמה
    • שם משתמש: שם המשתמש של המחבר
    • סיסמה: סוד ב-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 זמין במאמר משימת מחברים.

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

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

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

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Opportunities מהרשימה Entity.
  3. בוחרים את הפעולה List ולוחצים על סיום.
  4. צריך להשתמש בפעולת List עם פסקה של מסנן בישויות שבהן נדרש יותר ממפתח אחד כדי לאחזר רשומה יחידה.

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

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Contacts מהרשימה Entity.
  3. בוחרים את הפעולה Get ולוחצים על סיום.
  4. מגדירים את מזהה הישות ל'אנשי קשר'. כדי להגדיר את מזהה הישות, בקטע Data Mapper (מיפוי נתונים) של Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor (פתיחת כלי מיפוי הנתונים), מזינים 3046 בשדה Input Value (ערך קלט) ובוחרים באפשרות EntityId בתור Local variable (משתנה מקומי).
  5. חובה להשתמש בפעולת Get עם פסוקית filter בישויות שבהן נדרש יותר ממפתח אחד כדי לאחזר רשומה יחידה.

דוגמה – מחיקת הזדמנויות

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Opportunities מהרשימה Entity.
  3. בוחרים את הפעולה Delete ולוחצים על סיום.
  4. מגדירים את מזהה הישות לערך Delete Opportunities (מחיקת הזדמנויות). כדי להגדיר את מזהה הישות, בקטע Data Mapper (מיפוי נתונים) של Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor (פתיחת כלי מיפוי הנתונים), מזינים 203002 בשדה Input Value (ערך קלט) ובוחרים באפשרות EntityId בתור Local variable (משתנה מקומי).

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

דוגמה – יצירת אנשי קשר

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Contacts מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע מיפוי נתונים של המשימה, לוחצים על OpenDataMapping editor ומזינים ערך דומה לערך הבא ב field:
     { "FirstName": "Googlecloud2", "LastName": "TestCreate3" }

    הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:

    { "PartyNumber": "807006" }
    

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

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות ContactAddresses מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע מיפוי נתונים של המשימה, לוחצים על OpenDataMapping editor ומזינים ערך דומה לערך הבא ב field:
    { "City": "CreatingAddGooglecloud", "State": "France", "Country": "FR", "Address1": "Googlecloud Contact Address 1", "PartyNumber": "3046" }

    הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:

    { "AddressNumber": "411001", "PartyNumber": "3046" }
    

דוגמה – יצירת חשבונות

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות 'חשבונות' מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע מיפוי נתונים של המשימה, לוחצים על OpenDataMapping editor ומזינים ערך דומה לערך הבא ב field:
    { "OrganizationName": "Test Account7Googlecloud", "AddressLine1": "E-City", "City": "Paris", "Country": "FR" }

    הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:

    { "PartyNumber": "804006" }
    

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

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות 'הזדמנויות' מתוך הרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע מיפוי נתונים של המשימה, לוחצים על OpenDataMapping editor ומזינים ערך דומה לערך הבא ב field:
    { "Name": "OpportunityGooglecloud1" } 

    הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:

    { "OptyNumber": "203001" }
    

דוגמה – יצירת מקבל הקצאה של פעילות

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות ActivityAssignee מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע מיפוי נתונים של המשימה, לוחצים על OpenDataMapping editor ומזינים ערך דומה לערך הבא ב field:
    { "ActivityId": 300000010836710, "AssigneeId": 300000001962681, "ActivityNumber": "212380" }

    הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:

    { "ActivityAssigneeId": 300000014424799 }
    

דוגמה – יצירת איש קשר לפעילות

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות ActivityContact מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע מיפוי נתונים של המשימה, לוחצים על OpenDataMapping editor ומזינים ערך דומה לערך הבא ב field:
    { "ActivityNumber": "212544", "ContactId": 100000001886382 }

    הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:

    { "ActivityContactId": 300000014968493 }
    

דוגמה – עדכון הזדמנויות

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Opportunities מהרשימה Entity.
  3. בוחרים את הפעולה Update ולוחצים על סיום.
  4. מגדירים את EntityID ל-Opportunities. כדי להגדיר את EntityID, בקטע Data mapper של Tasks, לוחצים על EntityID ומזינים 5 בשדה שמופיע.
  5. בקטע מיפוי נתונים של המשימה, לוחצים על OpenDataMapping editor ומזינים ערך דומה לערך הבא ב field:
     { "Name": "Updated Googlecloud Opportunity again" }
    
  6. הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:

    { "OptyNumber": "150364" }
    

דוגמה – עדכון חשבונות

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Accounts מהרשימה Entity.
  3. בוחרים את הפעולה Update ולוחצים על סיום.
  4. מגדירים את EntityID ל-Accounts. כדי להגדיר את EntityID, בקטע Data mapper של Tasks, לוחצים על EntityID ומזינים 804006 בשדה שמופיע.
  5. בקטע מיפוי נתונים של המשימה, לוחצים על OpenDataMapping editor ומזינים ערך דומה לערך הבא ב field:
     { "OrganizationName": "updated Test Account7Googlecloud" }
    
  6. הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:

    { "PartyNumber": "804006" }
    

דוגמה – עדכון פעילויות

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Activities מהרשימה Entity.
  3. בוחרים את הפעולה Update ולוחצים על סיום.
  4. מגדירים את EntityID ל-Activities. כדי להגדיר את EntityID, בקטע Data mapper של Tasks, לוחצים על EntityID ומזינים 201001 בשדה שמופיע.
  5. בקטע מיפוי נתונים של המשימה, לוחצים על OpenDataMapping editor ומזינים ערך דומה לערך הבא ב field:
    { "ActivityFunctionCode": "APPOINTMENT", "ActivityStartDate": "2025-05-27 07:10:23", "ActivityEndDate": "2025-05-27 08:10:23" }
    
  6. הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט connectorOutputPayload של משימת המחבר:

    { "ActivityNumber": "201001" }
    

דוגמה – עדכון אנשי קשר

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Contacts מהרשימה Entity.
  3. בוחרים את הפעולה Update ולוחצים על סיום.
  4. מגדירים את EntityID (מזהה הישות) ל-Contacts (אנשי קשר). כדי להגדיר את EntityID, בקטע Data mapper של Tasks, לוחצים על EntityID ומזינים 59 בשדה שמופיע.
  5. בקטע מיפוי נתונים של המשימה, לוחצים על OpenDataMapping editor ומזינים ערך דומה לערך הבא ב field:
      { "FirstName": "GooglecloudUpdated2", "LastName": "Testlatency3" }
    
  6. הרצת הדוגמה הזו מחזירה תגובה שדומה לתגובה הבאה במשתנה הפלט 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

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

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

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