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 estás familiarizado con 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, imagina que tienes un sistema de administración de recursos humanos (HRMS) interno con un protocolo de conectividad de propiedad, que deseas 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 servicio que quieras conectar.
  • Hay conectores integrados disponibles en Integration Connectors, pero no cumplen con tus requisitos.

¿Cómo Integration Connectors admite un conector personalizado?

Integration Connectors admite conectores personalizados a través de la especificación de Open API (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 Open API de tu extremo para crear un nuevo conector que se conecte a tu extremo (backend).

La especificación de Open API 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 JSON o YAML. El siguiente es un extracto de una especificación de Open API de muestra 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!\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"
}
}
}
}

Para ver la especificación de muestra completa, consulta Ejemplo de repositorio de la tienda de mascotas. 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 enumerarían como acciones admitidas por el conector personalizado.

Situaciones de conectividad de backend

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

  • Conectividad de backend directa
  • Conectividad de backend indirecta

Situación: conectividad de backend directa

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

conectividad de backend directa

Situación: conectividad de backend indirecta

En esta situación, el entorno de ejecución de Integration Connectors establece la conectividad a tu backend a través de un servicio intermediario (facade) que cumple con 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 de backend indirecta

¿Qué sigue?

Descubre cómo crear un conector personalizado.