Benutzerdefinierte Connectors

Auf dieser Seite finden Sie eine Übersicht über die Funktion für benutzerdefinierte Connectors in Integration Connectors. Es wird davon ausgegangen, dass Sie mit den folgenden Konzepten vertraut sind:

Mit der Funktion für benutzerdefinierte Connectors können Sie Connectors verwenden, die nicht zu den Standard-Connectors gehören, die von Integration Connectors bereitgestellt werden. Möglicherweise haben Sie beispielsweise ein internes HRMS (Human Resource Management System) mit einem proprietären Verbindungsprotokoll, das Sie Application Integration über einen Connector zur Verfügung stellen möchten. Die Funktion für benutzerdefinierte Connectors ist in den folgenden Szenarien nützlich:

  • In Integration Connectors sind keine integrierten Connectors für eine Datenquelle oder einen Dienst verfügbar, mit dem Sie eine Verbindung herstellen möchten.
  • In Integration Connectors sind integrierte Connectors verfügbar, die aber nicht Ihren Anforderungen entsprechen.

Wie unterstützt Integration Connectors einen benutzerdefinierten Connector?

Integration Connectors unterstützt benutzerdefinierte Connectors über die OpenAPI-Spezifikation (Version 3.0.0 und alle Nebenversionen). Sie können Ihr Backend als öffentlichen Endpunkt zur Verfügung stellen und dann die OpenAPI-Spezifikation Ihres Endpunkts verwenden, um einen neuen Connector zu erstellen, der eine Verbindung zu Ihrem Endpunkt (Backend) herstellt.

Die OpenAPI-Spezifikation eines Endpunkts definiert den Vertrag zwischen Integration Connectors und dem Endpunkt. Integration Connectors verwendet die API-Spezifikation, um die Aktionen und Entitäten des Connectors zu generieren. Aktionen und Entitäten. Die API-Spezifikation kann ein JSON oder ein YAML sein. Das Folgende ist ein Auszug aus einer Beispiel OpenAPI-Spezifikation eines Backend-Dienstes:

{
  "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"
      }
    }
  }
}

Die vollständige Beispielspezifikation finden Sie im Beispiel-Repository für Tierhandlungen. Wenn Sie diese Beispielspezifikation verwenden, um einen benutzerdefinierten Connector zu erstellen, generiert Integration Connectors für jedes Element in path eine separate Aktion. Beispielsweise werden uploadImage und findByStatus als unterstützte Aktionen des benutzerdefinierten Connectors aufgeführt.

Szenarien für die Backend-Verbindung

Integration Connectors unterstützt benutzerdefinierte Connectors für die folgenden Szenarien für die Backend-Verbindung:

  • Direkte Backend-Verbindung
  • Indirekte Backend-Verbindung

Szenario – Direkte Backend-Verbindung

In diesem Szenario stellt die Integration Connectors-Laufzeit direkt eine Verbindung zu Ihrem OpenAPI-konformen Backend her. Die folgende Abbildung zeigt die Connector-Verbindung in diesem Szenario:

direkte Backend-Verbindung

Szenario – Indirekte Backend-Verbindung

In diesem Szenario stellt die Integration Connectors-Laufzeit eine Verbindung zu Ihrem Backend über einen Vermittlungsdienst (Fassade) her, der OpenAPI-konform ist. Der Vermittlungsdienst stellt wiederum eine Verbindung zu Ihrem Backend her. Die folgende Abbildung zeigt die Connector-Verbindung in diesem Szenario:

Indirekte Backend-Verbindung

Versionen benutzerdefinierter Connectors

Mit der Versionierungsfunktion können Sie mehrere Versionen eines benutzerdefinierten Connectors erstellen. Jede Version kann eine andere OpenAPI-Spezifikation, Authentifizierungsmethode und Backend-Variablen haben. So können Sie einen Connector mit verschiedenen Konfigurationen erstellen.

Wenn Sie einen neuen Connector erstellen, wird automatisch die erste Version des Connectors erstellt . Die Versionsdetails werden auf dem Tab Versionen der Detailseite des benutzerdefinierten Connectors angezeigt. Informationen zum Erstellen einer neuen Version eines Connectors finden Sie unter Versionen benutzerdefinierter Connectors verwalten.

Nächste Schritte

Informationen zum Erstellen eines benutzerdefinierten Connectors.