מחברים בהתאמה אישית

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

התכונה 'מחברים בהתאמה אישית' מאפשרת לכם להשתמש במחברים שלא נכללים במחברים הרגילים שסופקו על ידי Integration Connectors. לדוגמה, יכול להיות שיש לכם מערכת לניהול משאבי אנוש (HRMS) שפותחה בתוך החברה עם פרוטוקול חיבור קנייני שאתם רוצים לחשוף ל-Application Integration באמצעות מחבר. התכונה 'מחבר בהתאמה אישית' שימושית בתרחישים הבאים:

  • מחברים מובנים לא זמינים ב-Integration Connectors למקור נתונים או לשירות שרוצים להתחבר אליו.
  • מחברים מובנים זמינים ב-Integration Connectors, אבל הם לא עונים על הדרישות שלכם.

איך מחברים לשילוב תומכים במחבר בהתאמה אישית?

‫Integration Connectors תומך במחברים בהתאמה אישית באמצעות מפרט Open API (גרסה 3.0.0 וכל גרסאות המשנה שלה). אפשר לחשוף את ה-Backend כנקודת קצה ציבורית, ואז להשתמש במפרט Open API של נקודת הקצה כדי ליצור מחבר חדש שמתחבר לנקודת הקצה (Backend).

מפרט Open API של נקודת קצה מגדיר את החוזה בין Integration Connectors לבין נקודת הקצה. ‫Integration Connectors משתמש במפרט ה-API כדי ליצור את הפעולות והישויות של המחבר. מפרט ה-API יכול להיות בפורמט JSON או YAML. הקטע הבא הוא קטע מתוך מפרט לדוגמה של Open API של שירות קצה עורפי:

{
  "openapi":"3.0.2",
  "info":{
    "title":"Swagger Petstore - OpenAPI 3.0",
    "description":"This is a sample Pet Store Server based on the OpenAPI 3.0 specification.
  You can find out more about\nSwagger at [
    http://swagger.io](http://swagger.io). In the third iteration of the pet store,
    we've switched to the design first approach! You can now help us improve the API whether
  it's by making changes to the definition itself or to the code.\nThat way,
    with time, we can improve the API in general, and expose some of the new
  features in OAS3.\n\nSome useful links:\n-
  [
       The Pet Store repository
  ]
  .....
  .....
    },
  "paths":{
    "/pet/{petId}/uploadImage":{
      "post":{
        "tags":[
        ]
      }
    },
    .....
    .....
    "/pet/findByStatus":{
      "get":{
        "tags":[
          "pet"
        ],
        .....
        .....
      }
    }
  },
  "components": {
    "securitySchemes": {
      "api_key":{
        "type":"apiKey",
        "name":"api_key",
        "in":"header"
      }
    }
  }
}

כדי לראות את המפרט המלא לדוגמה, אפשר לעיין במאגר של חנות חיות מחמד לדוגמה. נניח שאתם משתמשים במפרט לדוגמה הזה כדי ליצור מחבר מותאם אישית. מחברים לשילובים ייצרו פעולה נפרדת לכל רכיב ב-path. לדוגמה, uploadImage ו-findByStatus יופיעו ברשימת הפעולות הנתמכות במחבר המותאם אישית.

תרחישים של קישוריות לקצה העורפי

‫Integration Connectors תומך במחברים בהתאמה אישית לתרחישי קישוריות לשרת העורפי הבאים:

  • קישוריות ישירה לקצה העורפי
  • קישוריות עקיפה לקצה העורפי

תרחיש – קישוריות ישירה לקצה העורפי

בתרחיש הזה, סביבת זמן הריצה של Integration Connectors יוצרת ישירות קישוריות לקצה העורפי שתואם ל-Open API. האיור הבא מראה את הקישוריות של המחבר בתרחיש הזה:

קישוריות ישירה לקצה העורפי

תרחיש – קישוריות עקיפה לקצה העורפי

בתרחיש הזה, זמן הריצה של Integration Connectors יוצר קישוריות לקצה העורפי באמצעות שירות ביניים (facade) שתואם ל-Open API. שירות הביניים מתחבר בתורו לבק-אנד שלכם. באיור הבא מוצגת הקישוריות של המחבר בתרחיש הזה:

קישוריות עקיפה לקצה העורפי

גרסאות של מחברים בהתאמה אישית

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

כשיוצרים מחבר חדש, הגרסה הראשונה של המחבר נוצרת באופן אוטומטי, ופרטי הגרסה מוצגים בכרטיסייה Versions (גרסאות) בדף הפרטים של המחבר המותאם אישית. במאמר ניהול גרסאות של מחברים בהתאמה אישית מוסבר איך ליצור גרסה חדשה של מחבר.

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

איך יוצרים מחבר בהתאמה אישית