Vorschau

Dieses Produkt oder diese Funktion unterliegt den „Nutzungsbedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Nutzungsbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA-Produkte und -Funktionen sind unverändert verfügbar und werden möglicherweise nur eingeschränkt unterstützt. Weitere Informationen finden Sie in den Beschreibungen der Startphase.

Benutzerdefinierte Connectors

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

• Integration Connectors
• Connector und Verbindung
• OpenAPI-Spezifikationen

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

• Integrierte Connectors sind in Integration Connectors für eine Datenquelle oder einen Dienst, die Sie verbinden möchten, nicht verfügbar.
• In Integration Connectors sind integrierte Connectors verfügbar, die Ihre Anforderungen jedoch nicht erfüllen.

Wie unterstützt Integration Connectors einen benutzerdefinierten Connector?

Integration Connectors unterstützt benutzerdefinierte Connectors über OpenAPI-Spezifikation (Version 3.0.0 und alle zugehörigen Nebenversionen). Sie können Ihr Backend als öffentlichen Endpunkt freigeben und dann mithilfe der Open API-Spezifikation Ihres Endpunkts einen neuen Connector 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. Die API-Spezifikation kann JSON oder YAML sein. Im Folgenden finden Sie einen Auszug aus einem Beispiel. Öffnen Sie die API-Spezifikation eines Back-End-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!\nYou 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 unter Beispiel-Repository für eine Tierhandlung. Angenommen, Sie verwenden diese Beispielspezifikation, um einen benutzerdefinierten Connector zu erstellen. Integration Connectors generiert eine separate Aktion für jeden Element in path. Beispielsweise werden uploadImage und findByStatus vom benutzerdefinierten Connector als unterstützte Aktionen aufgeführt.

Szenarien für Back-End-Konnektivität

Integrations-Connectors unterstützen benutzerdefinierte Connectors für die folgenden Back-End-Konnektivitätsszenarien:

• 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-konform sind.

Szenario – Direkte Back-End-Verbindung

In diesem Szenario stellt die Integration Connectors-Laufzeit eine direkte Verbindung zu Ihrem Open API-kompatiblen Back-End her. Die folgende Abbildung zeigt die Anschlussverbindung in diesem Szenario:

Szenario – Indirekte Back-End-Verbindung

In diesem Szenario stellt die Integration Connectors-Laufzeit die Verbindung her. über einen mit OpenAPI kompatiblen Vermittlungsdienst (Fassadendienst) in Ihr Back-End. Der Vermittlungsdienst stellt wiederum eine Verbindung zu Ihrem Backend her. Die folgende Abbildung zeigt die Anschlussverbindung in diesem Szenario:

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

Versionen des benutzerdefinierten Connectors

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

Wenn Sie einen neuen Connector erstellen, wird automatisch die erste Version erstellt. 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 .

Nächste Schritte

Weitere Informationen zum Erstellen eines benutzerdefinierten Connectors