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 in Integration Connectors per un'origine dati o un servizio che vuoi connettere.
- I connettori integrati disponibili in Integration Connectors, ma che non soddisfano i tuoi requisiti.
In che modo Integration Connectors supporta un connettore personalizzato?
Integration Connectors supporta i connettori personalizzati tramite la specifica Open API (versione 3.0.0 e tutte le versioni minori). Puoi esporre il backend un endpoint pubblico, quindi utilizza la specifica OpenAPI dell'endpoint per creare 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 usa la specifica API per generare azioni ed entità. La specifica dell'API può essere un file 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!\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"
}
}
}
}Per visualizzare la specifica di esempio completa, consulta Esempio di repository del negozio di animali.
Supponiamo che tu utilizzi questa specifica di esempio per creare un connettore personalizzato. I connettori di integrazione genereranno un'azione separata per ogni elemento in path. Ad esempio, uploadImage e findByStatus sono elencate come azioni supportate dal connettore personalizzato.
Scenari di connettività di backend
Integration Connectors supporta i connettori personalizzati per i seguenti scenari di connettività di backend:
- Connettività backend diretto
- Connettività indiretta al backend
Scenario: connettività di backend diretta
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
La versione versio consente di creare più versioni di un connettore personalizzato. Ciascuna può avere specifiche OpenAPI, metodi di autenticazione e variabili di backend diversi. Come 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 informazioni su come creare una nuova versione di un connettore, consulta .
Passaggi successivi
Scopri come creare un connettore personalizzato.