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 a Application Integration tramite un connettore. La funzionalità di connettore personalizzato è utile nei seguenti scenari:

  • I connettori integrati non sono disponibili in Integration Connectors per un'origine dati o un servizio a cui vuoi connetterti.
  • I connettori integrati sono 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 Open API (versione 3.0.0 e tutte le relative versioni secondarie). Puoi esporre il backend come un endpoint pubblico, quindi utilizzare la specifica OpenAPI dell'endpoint per creare un nuovo connettore che si connette all'endpoint (backend).

La specifica Open API di un endpoint definisce il contratto tra Integration Connectors e l'endpoint. Integration Connectors utilizza la specifica API per generare le azioni e le entità del connettore. La specifica dell'API può essere un file JSON o YAML. Di seguito è riportato un estratto di una specifica Open API di un servizio di backend di esempio:

{
"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 di esempio completa, consulta il repository del negozio di animali 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 verranno elencate come azioni supportate dal connettore personalizzato.

Scenari di connettività del backend

Integration Connectors supporta i connettori personalizzati per i seguenti scenari di connettività di backend:

  • Connettività backend diretta
  • Connettività backend indiretta

Scenario: connettività backend diretta

In questo scenario, il runtime di Integration Connectors stabilisce direttamente la connettività al tuo backend conforme all'API aperta. La seguente illustrazione mostra la connettività dei connettori in questo scenario:

connettività backend diretta

Scenario: connettività indiretta del backend

In questo scenario, il runtime di Integration Connectors stabilisce la connettività al backend tramite un servizio intermedio (facade) conforme all'API aperta. Il servizio intermediario a sua volta si connette al tuo backend. La seguente illustrazione mostra la connettività del connettore in questo scenario:

connettività indiretta al backend

Versioni del connettore personalizzato

Con la funzionalità di controllo 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 e i dettagli della versione vengono visualizzati nella scheda Versioni della pagina dei dettagli del connettore personalizzato. Per capire come creare una nuova versione di un connettore, consulta Gestire le versioni dei connettori personalizzati.

Passaggi successivi

Scopri come creare un connettore personalizzato.