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 interno de administración de recursos humanos (HRMS) con un protocolo de conectividad propietario que deseas exponer a la integración de aplicaciones 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 los conectores de integración para una fuente de datos o un servicio que deseas conectar.
- Los conectores integrados están disponibles en Integration Connectors, pero no cumplen con tus requisitos.
¿Cómo admiten los conectores de integración un conector personalizado?
Los conectores de integración admiten conectores personalizados a través de la especificación de Open API (versión 3.0.0 y todas sus versiones menores). 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 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! 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 del ejemplo, consulta el repositorio de ejemplo de la 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 enumerarí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 directa al backend
- 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 esta situación:
Situación: Conectividad indirecta del backend
En esta situación, el entorno de ejecución de Integration Connectors establece conectividad con tu backend a través de un servicio de intermediario (fachada) que cumple con la API abierta. El servicio intermediario, a su vez, se conecta a tu backend. En la siguiente ilustración, se muestra la 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 obtener información sobre cómo crear una versión nueva de un conector, consulta Administra las versiones de conectores personalizados.
¿Qué sigue?
Obtén información para crear un conector personalizado.