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, puedes tener un equipo un sistema de administración de recursos humanos (HRMS, por sus siglas en inglés) con un protocolo de conectividad propio, el cual quieres 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 la fuente de datos o el servicio que quieres conectar.
- Los conectores integrados están disponibles en Integration Connectors, pero no cumplen con tus requisitos.
¿Cómo admite Integration Connectors 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 conector nuevo que se conecte a tu extremo (backend).
La especificación de OpenAPI de un extremo define el contrato entre los conectores de integración 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 OpenAPI 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!\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 tienda de mascotas.
Supongamos que usas esta especificación de muestra para crear un conector personalizado. Los conectores de integración generarán una acción independiente para cada elemento en path. Por ejemplo, uploadImage y findByStatus se indicarían como acciones admitidas por el conector personalizado.
Situaciones de conectividad del backend
Los conectores de integración admiten conectores personalizados para las siguientes situaciones de conectividad de backend:
- Conectividad de backend directa
- Conectividad indirecta del backend
Situación: Conectividad directa con el backend
En esta situación, el entorno de ejecución de los conectores de integración establece directamente la conectividad con tu backend compatible con la API abierta. En la siguiente ilustración, se muestra la conectividad del conector en este caso:
Situación: Conectividad indirecta del backend
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 cumpla con Open API. El intermediario, a su vez, se conecta a tu backend. En la siguiente ilustración, se muestra el conectividad del conector en esta situación:
Versiones de conectores personalizados
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 del conector se crea automáticamente por ti, y los detalles de la versión se muestran en la pestaña Versiones de la página de detalles del conector personalizado. Para comprender cómo crear una versión nueva de un conector, consulta .
¿Qué sigue?
Obtén información para crear un conector personalizado.