Conectores personalizados
En esta página se ofrece una descripción general de la función de conectores personalizados de Integration Connectors. Se presupone que conoces los siguientes conceptos:
La función de conectores personalizados te permite usar conectores que no forman parte de los conectores estándar proporcionados por Integration Connectors. Por ejemplo, puede que tengas un sistema de gestión de recursos humanos interno con un protocolo de conectividad propietario que quieras exponer a Integración de aplicaciones a través de un conector. La función de conectores personalizados es útil en los siguientes casos:
- Los conectores integrados no están disponibles en Integration Connectors para una fuente de datos o un servicio al que quieras conectarte.
- Los conectores integrados están disponibles en Integration Connectors, pero no cumplen tus requisitos.
¿Cómo admite Integration Connectors un conector personalizado?
Integration Connectors admite conectores personalizados a través de la especificación de API abierta (versión 3.0.0 y todas sus versiones secundarias). Puedes exponer tu backend como un endpoint público y, a continuación, usar la especificación de la API abierta de tu endpoint para crear un conector que se conecte a tu endpoint (backend).
La especificación de OpenAPI de un endpoint define el contrato entre Integration Connectors y el endpoint. 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. A continuación, se muestra un fragmento de una especificación de OpenAPI de ejemplo de un servicio 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 de muestra completa, consulta el repositorio de la tienda de mascotas de muestra.
Supongamos que usa esta especificación de ejemplo para crear un conector personalizado. Integration Connectors generará una acción independiente para cada elemento de 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 los siguientes casos de conectividad backend:
- Conectividad directa con el backend
- Conectividad de backend indirecta
Situación: conectividad directa del backend
En este caso, el tiempo 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 este caso:
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 API Open. El servicio intermediario se conecta a tu backend. En la siguiente ilustración se muestra la conectividad del conector en este caso:
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. Por lo tanto, te ofrece mucha flexibilidad a la hora de crear un conector con varias configuraciones.
Cuando creas un conector, se genera automáticamente la primera versión del conector y los detalles de la versión se muestran en la pestaña Versiones de la página de detalles del conector personalizado. Para saber cómo crear una nueva versión de un conector, consulta Gestionar versiones de conectores personalizados.
Siguientes pasos
Consulta cómo crear un conector personalizado.