Conectores personalizados

En esta página, se proporciona una descripción general de la función de conectores personalizados en Integration Connectors y se supone que conoces los siguientes conceptos:

La función de conectores personalizados te permite usar conectores que no forman parte de los conectores estándar que proporciona Integration Connectors. Por ejemplo, es posible que tengas un sistema de administración de recursos humanos (HRMS) interno con un protocolo de conectividad propietario que desees exponer a Application Integration a través de un conector. La función de conector personalizado es útil en las siguientes situaciones:

  • Los conectores integrados no están disponibles en Integration Connectors para una fuente de datos o un servicio al que deseas conectarte.
  • Los conectores integrados están disponibles en Integration Connectors, pero no cumplen con tus requisitos.

¿Cómo admiten los Integration Connectors un conector personalizado?

Integration Connectors admite conectores personalizados a través de la especificación de OpenAPI (versión 3.0.0 y todas sus versiones secundarias). Puedes exponer tu backend como un extremo público y, luego, usar la especificación de OpenAPI de tu extremo para crear un conector nuevo que se conecte a tu extremo (backend).

La especificación de la API abierta de un extremo define el contrato entre Integration Connectors y el extremo. Integration Connectors usa la especificación de la API para generar las acciones y entidades del conector. La especificación de la API puede ser un archivo JSON o YAML. A continuación, se muestra un fragmento de una especificación de Open API de ejemplo de un servicio de 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"
}
}
}
}

Para ver la especificación completa de la muestra, consulta el repositorio de la tienda de mascotas de muestra. Supongamos que usas esta especificación de muestra para crear un conector personalizado. Integration Connectors generará una acción independiente para cada elemento en path. Por ejemplo, uploadImage y findByStatus se mostrarían como acciones admitidas por el conector personalizado.

Situaciones de conectividad del backend

Integration Connectors admite conectores personalizados para las siguientes situaciones de conectividad de backend:

  • Conectividad directa al backend
  • Conectividad indirecta del backend

Situación: Conectividad directa del backend

En este caso, el entorno de ejecución de Integration Connectors establece directamente la conectividad con tu backend compatible con la API abierta. En la siguiente ilustración, se muestra la conectividad del conector en esta situación:

conectividad directa al backend

Situación: Conectividad indirecta del backend

En este caso, el tiempo de ejecución de Integration Connectors establece la conectividad con tu backend a través de un servicio intermediario (fachada) que cumple con la especificación de Open API. A su vez, el servicio intermediario se conecta a tu backend. En la siguiente ilustración, se muestra la conectividad del conector en esta situación:

Conectividad indirecta del backend

Versiones del conector personalizado

Con la función de control de versiones, puedes crear varias versiones de un conector personalizado. Cada versión puede tener una especificación de OpenAPI, un método de autenticación y variables de backend diferentes. Como resultado, te brinda mucha flexibilidad para crear un conector con varias configuraciones.

Cuando creas un conector nuevo, la primera versión se crea automáticamente y los detalles de la versión se muestran en la pestaña Versions de la página de detalles del conector personalizado. Para comprender cómo crear una nueva versión de un conector, consulta Administra versiones de conectores personalizados.

¿Qué sigue?

Aprende a crear un conector personalizado.