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:
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 Funktion für benutzerdefinierte Connector ist in folgenden Szenarien nützlich:
- Für die Datenquelle oder den Dienst, mit dem Sie eine Verbindung herstellen möchten, sind keine integrierten Connectors in Integration Connectors 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 OpenAPI-Spezifikation (Version 3.0.0 und alle Minor-Versionen). 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 des Connectors zu generieren. Die API-Spezifikation kann JSON oder YAML sein. Im Folgenden finden Sie einen Auszug aus einer Beispiel-OpenAPI-Spezifikation für einen Backend-Dienst:
{
"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 Repository für Tierhandlungen.
Angenommen, Sie verwenden diese Beispielspezifikation, um einen benutzerdefinierten Connector zu erstellen. Integration Connectors generiert dann für jedes Element in path eine separate Aktion. Beispielsweise werden uploadImage und findByStatus vom benutzerdefinierten Connector als unterstützte Aktionen aufgeführt.
Szenarien für die Backend-Konnektivität
Integration Connectors unterstützt benutzerdefinierte Connectors für die folgenden Backend-Verbindungsszenarien:
- Direkte Backend-Verbindung
- Indirekte Backend-Verbindung
Szenario – Direkte Backend-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 Backend-Verbindung
In diesem Szenario stellt die Integration Connectors-Laufzeit eine Verbindung zu Ihrem Backend über einen Open API-kompatiblen Zwischendienst (Fassadendienst) her. Der Vermittlungsdienst stellt wiederum eine Verbindung zu Ihrem Backend her. Die folgende Abbildung zeigt die Anschlussverbindung in diesem Szenario:
Versionen des benutzerdefinierten 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. So haben Sie beim Erstellen eines Connectors mit verschiedenen Konfigurationen viel Flexibilität.
Wenn Sie einen neuen Connector erstellen, wird die erste Version des Connectors automatisch für Sie erstellt. Die Versionsdetails werden auf der Detailseite des benutzerdefinierten Connectors auf dem Tab Versionen angezeigt. Informationen zum Erstellen einer neuen Version eines Connectors finden Sie unter Benutzerdefinierte Connectorversionen verwalten.
Nächste Schritte
Weitere Informationen zum Erstellen eines benutzerdefinierten Connectors