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:
Mit der Funktion für benutzerdefinierte Connectors können Sie Connectors verwenden, die nicht Teil der Standard-Connectors sind, die von Integration Connectors bereitgestellt werden. Angenommen, Sie haben ein internes Human Resource Management System (HRMS) mit einem proprietären Verbindungsprotokoll, das Sie über einen Connector für die Application Integration freigeben 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.
- Integrierte Connectors sind in Integration Connectors verfügbar, erfüllen jedoch nicht Ihre Anforderungen.
Wie unterstützt Integration Connectors einen benutzerdefinierten Connector?
Integration Connectors unterstützt benutzerdefinierte Connectors gemäß der OpenAPI-Spezifikation (Version 3.0.0 und alle zugehörigen Nebenversionen). Sie können Ihr Back-End als öffentlichen Endpunkt freigeben und dann mithilfe der OpenAPI-Spezifikation Ihres Endpunkts einen neuen Connector erstellen, der eine Verbindung zu Ihrem Endpunkt (Back-End) 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 im JSON- oder YAML-Format vorliegen. Das Folgende ist ein Auszug aus einer OpenAPI-Beispielspezifikation 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 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 Back-End-Konnektivität
Integrations-Connectors unterstützen benutzerdefinierte Connectors für die folgenden Back-End-Konnektivitätsszenarien:
- Direkte Backend-Verbindung
- Indirekte Backend-Verbindung
Szenario – Direkte Back-End-Verbindung
In diesem Szenario stellt die Integration Connectors-Laufzeit eine direkte Verbindung zu Ihrem OpenAPI-konformen Back-End her. Die folgende Abbildung zeigt die Connector-Konnektivität in diesem Szenario:
Szenario – Indirekte Back-End-Verbindung
In diesem Szenario stellt die Integration Connectors-Laufzeit über einen zwischengeschalteten Dienst (Fassadendienst), der OpenAPI-konform ist, eine Verbindung zu Ihrem Back-End her. Der Vermittlungsdienst stellt wiederum eine Verbindung zu Ihrem Back-End her. Die folgende Abbildung zeigt die Connector-Konnektivität in diesem Szenario:
Benutzerdefinierte Connector-Versionen
Mit der Versionsfunktion können Sie mehrere Versionen eines benutzerdefinierten Connectors erstellen. Jede Version kann eine andere OpenAPI-Spezifikation, Authentifizierungsmethode und andere Back-End-Variablen haben. Daher sind Sie beim Erstellen eines Connectors mit verschiedenen Konfigurationen sehr flexibel.
Wenn Sie einen neuen Connector erstellen, wird die erste Version des Connectors automatisch für Sie 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 .
Nächste Schritte
Benutzerdefinierten Connector erstellen