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 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 ad Application Integration 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.
- Connettori integrati disponibili in Integration Connectors, ma non soddisfano i tuoi requisiti.
In che modo Integration Connectors supporta un connettore personalizzato?
Integration Connectors supporta i connettori personalizzati tramite la specifica OpenAPI (versione 3.0.0 e tutte le relative versioni secondarie). Puoi esporre il backend come endpoint pubblico e quindi utilizzare la specifica OpenAPI dell'endpoint per creare un nuovo connettore che si connette all'endpoint (backend).
La specifica OpenAPI di un endpoint definisce il contratto tra Integration Connectors e l'endpoint. Integration Connectors utilizza la specifica API per generare azioni ed entità del connettore. 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.
Supponi di utilizzare 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 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à di backend indiretta
Scenario: connettività di backend diretta
In questo scenario, il runtime di Integration Connectors stabilisce direttamente la connettività al backend conforme a Open API. L'illustrazione seguente mostra la connettività del connettore in questo scenario:
Scenario: connettività di backend indiretta
In questo scenario, il runtime di Integration Connectors stabilisce la connettività al backend tramite un servizio intermedio (facade) conforme ad OpenAPI. Il servizio intermediario a sua volta si connette al tuo backend. L'illustrazione seguente mostra la connettività del connettore in questo scenario:
Versioni personalizzate del connettore
La versione versio consente di creare più versioni di un connettore personalizzato. Ogni versione può avere specifiche OpenAPI, 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, viene creata automaticamente la prima versione del connettore 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.