Connettori personalizzati
Questa pagina fornisce una panoramica della funzionalità dei connettori personalizzati in Integration Connectors e presuppone che tu abbia familiarità con i seguenti concetti:
La funzionalità dei connettori personalizzati ti consente di utilizzare connettori che non fanno parte dei connettori standard forniti da Integration Connectors. Ad esempio, potresti avere un sistema di gestione delle risorse umane (HRMS) interno con un protocollo di connettività proprietario che vuoi esporre all'integrazione delle applicazioni tramite un connettore. La funzionalità del connettore personalizzato è utile nei seguenti scenari:
- I connettori integrati non sono disponibili nei connettori di integrazione per un'origine dati o un servizio che vuoi collegare.
- I connettori integrati sono disponibili in Integration Connectors, ma non soddisfano i tuoi requisiti.
In che modo i connettori di integrazione supportano un connettore personalizzato?
Integration Connectors supporta i connettori personalizzati tramite la specifica Open API (versione 3.0.0 e tutte le relative versioni minori). Puoi esporre il tuo backend come endpoint pubblico e poi utilizzare la specifica OpenAPI dell'endpoint per creare un nuovo connettore che si connette al tuo endpoint (backend).
La specifica OpenAPI di un endpoint definisce il contratto tra Integration Connectors e l'endpoint. Integration Connectors utilizza la specifica dell'API per generare le azioni e le entità del connettore. La specifica dell'API può essere JSON o YAML. Di seguito è riportato un estratto di una specifica OpenAPI di esempio di un servizio di backend:
{
"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"
}
}
}
}Per visualizzare la specifica completa del campione, consulta il repository del negozio di animali domestici di esempio.
Supponiamo che tu utilizzi questa specifica di esempio per creare un connettore personalizzato. Integration Connectors genererà un'azione separata per ogni elemento in path. Ad esempio, uploadImage e findByStatus verrebbero elencate come azioni supportate dal connettore personalizzato.
Scenari di connettività del backend
Integration Connectors supporta connettori personalizzati per i seguenti scenari di connettività del backend:
- Connettività diretta al backend
- Connettività indiretta al backend
Scenario: connettività diretta al backend
In questo scenario, il runtime di Integration Connectors stabilisce direttamente la connettività con il tuo backend compatibile con l'API aperta. L'illustrazione seguente mostra la connettività del connettore in questo scenario:
Scenario: connettività al backend indiretta
In questo scenario, il runtime di Integration Connectors stabilisce la connettività al backend tramite un servizio intermediario (facade) conforme all'API Open. Il servizio intermediario si connette a sua volta al tuo backend. L'illustrazione seguente mostra la connettività del connettore in questo scenario:
Versioni del connettore personalizzato
Con la funzionalità di gestione delle versioni, puoi creare più versioni di un connettore personalizzato. Ogni versione può avere una specifica OpenAPI, un metodo di autenticazione e variabili di backend diversi. Di conseguenza, offre molta flessibilità nella creazione di un connettore con varie configurazioni.
Quando crei un nuovo connettore, la prima versione viene creata automaticamente per te e i dettagli della versione vengono visualizzati nella scheda Versioni della pagina dei dettagli del connettore personalizzato. Per scoprire come creare una nuova versione di un connettore, consulta Gestire le versioni dei connettori personalizzati.
Passaggi successivi
Scopri come creare un connettore personalizzato.