Vorschau

Dieses Produkt oder diese Funktion unterliegt den „Pre-GA-Angebotsbedingungen“ im Abschnitt „Allgemeine Dienstbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA-Produkte und ‑Funktionen sind „wie gesehen“ verfügbar und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie in den Beschreibungen der Produkteinführungsphasen.

Benutzerdefinierte Connectors

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

• Integration Connectors
• Connector im Vergleich zu Verbindung
• OpenAPI-Spezifikationen

Mit benutzerdefinierten Connectors können Sie Connectors verwenden, die nicht Teil der von Integration Connectors bereitgestellten Standard-Connectors sind. Sie haben beispielsweise ein internes HRMS (Human Resource Management System) mit einem proprietären Verbindungsprotokoll, das Sie über einen Connector für Application Integration verfügbar machen möchten. Die Funktion für benutzerdefinierte Connectors ist in folgenden Szenarien nützlich:

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

Wie werden benutzerdefinierte Connectors von Integration Connectors unterstützt?

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

Die Open API-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. Die API-Spezifikation kann eine JSON- oder eine YAML-Datei 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"
    ],
.....
.....  
},
"api_key":{
  "type":"apiKey",
  "name":"api_key",
  "in":"header"
}
}
}
}

Die vollständige Beispielspezifikation finden Sie im Beispielrepository für einen Tierbedarfsladen. Wenn Sie diese Beispielspezifikation verwenden, um einen benutzerdefinierten Connector zu erstellen, generiert Integration Connectors eine separate Aktion für jedes Element in path. Beispielsweise würden 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 Backend-Verbindungsszenarien:

• Direkte Backend-Verbindung
• Indirekte Backend-Verbindung

Hinweis : Unabhängig von den Verbindungsszenarien können Integration Connectors nur eine Verbindung zu Endpunkten herstellen, die Open API-kompatibel sind.

Szenario – Direkte Backend-Verbindung

In diesem Szenario stellt die Integration Connectors-Laufzeit direkt eine Verbindung zu Ihrem Open API-kompatiblen Backend her. Die folgende Abbildung zeigt die Konnektivität des Connectors in diesem Szenario:

Szenario – Indirekte Backend-Verbindung

In diesem Szenario stellt die Integration Connectors-Laufzeit über einen Zwischen- (Fassaden-)Dienst, der Open API-kompatibel ist, eine Verbindung zu Ihrem Backend her. Der Vermittlungsdienst stellt dann eine Verbindung zu Ihrem Backend her. Die folgende Abbildung zeigt die Konnektivität des Connectors in diesem Szenario:

• Integration Connectors verwaltet nicht die Verbindung zwischen dem Vermittlungsdienst und Ihrem Backend. Daher fallen Verzögerungen, die aufgrund von Verbindungsproblemen zwischen dem Vermittlungsdienst und dem Backend auftreten, nicht unter das SLA für Integration Connectors.
• Integration Connectors unterstützt den OAuth 2.0-Authentifizierungstyp zwischen dem Vermittlungsdienst und dem Back-End nicht.

Versionen benutzerdefinierter Connectors

Mit der Versionsfunktion können Sie mehrere Versionen eines benutzerdefinierten Connectors erstellen. Jede Version kann eine andere OpenAPI-Spezifikation, Authentifizierungsmethode und Back-End-Variablen haben. Das bietet Ihnen viel Flexibilität beim Erstellen eines Connectors mit verschiedenen Konfigurationen.

Wenn Sie einen neuen Connector erstellen, wird automatisch die erste Version des Connectors erstellt und die Versionsdetails werden auf dem Tab Versionen auf 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