¿Cómo crear una integración? 

FlexiPaaS es una herramienta poderosa que permite crear integraciones entre APIs o sistemas de manera eficiente.

Dirigiéndose al módulo de integraciones puedes acceder a la opción de visualizar o crear nuevas integraciones:  

1. Configuración del Nodo Origen

El nodo Origen permite definir el origen de los datos para la integración. Al seleccionarlo, se muestra un listado de opciones:

• SFTP
• REST

1.1 Configuración de Origen REST

• Usuario y contraseña: Se utilizan credenciales específicas para ejecutar la integración dentro del sistema, no para acceder a la plataforma de flexiPaaS.

Opciones adicionales:

• Otras configuraciones (deshabilitadas por defecto):
  • Forzar respuesta sincrónica:  Indica que la integración será request-response.
     
  • Evitar solicitudes duplicadas: Si se activa, se debe seleccionar qué campos del archivo de entrada se utilizarán para evitar duplicados en un período de 24 horas.
     

(Esta configuración se define en el nodo Archivo de Entrada.)

1.2 Configuración de Origen SFTP

Si se elige SFTP, se pueden seleccionar los siguientes métodos:

• IP: Se debe ingresar la IP y su puerto correspondiente.
• URL: Se debe ingresar la URL y su puerto correspondiente.

Se deben completar también los siguientes datos:

• Credenciales de conexión: Usuario y contraseña del servidor SFTP.
• Path del directorio: Ubicación del archivo dentro del servidor. (Si se deja vacío, se entenderá que aplica a cualquier archivo en ese directorio.)

2. Configuración del Nodo Archivo de Entrada

Permite definir el formato de los archivos que se recibirán como entrada.

2.1 Tipos de archivo admitidos:

• JSON
• CSV
• XML
• Posicional
• Excel

Al seleccionar un formato, se muestra una pantalla con:

• Un panel lateral con las variables detectadas automáticamente.
• Un editor para ver y modificar la estructura del archivo.
• Botón Buscar Archivo para seleccionar un archivo de ejemplo y cargarlo.

(El archivo de ejemplo permite identificar las variables de entrada que luego podrán mapearse en la salida.)

3. Configuración del Nodo Archivo de Salida

Permite definir el formato del archivo de salida.

3.1 Tipos de archivo admitidos:

• JSON
• EDI

Al configurarlo, se visualizará:

• Un editor para definir la estructura de salida.
• Un panel lateral con variables disponibles.
• Opción "Buscar Archivo" para subir un archivo de salida de prueba.

4. Configuración del Nodo Compositor

Permite conectarse a una API externa para obtener información.

4.1 Configuración del Compositor

• Método HTTP:  GET, POST o PUT.
• IP o URL destino: Dirección de la API.
• Parámetros URI: Se pueden ingresar manualmente o seleccionar variables de nodos anteriores.
• Body de la solicitud: Puede contener un archivo de salida, texto personalizado o estar vacío.
• Headers: Se agregan clave-valor con datos fijos o se pueden agregar variables de nodos anteriores.
• Control de errores:
  • Detener ejecución.
  • Reintentar.
  • Continuar en error.
• Opciones de autenticación:
  • Ninguna.
  • Básica (usuario y contraseña).
  • JWT (definir método, URL de autenticación y ubicación del token).

Una vez configurado, se puede presionar "Obtener JSON de IP" para probar la conexión y obtener las variables disponibles de esa api, para ser seleccionadas y podes ser utilizadas en nodos posteriores.

5. Configuración del Nodo Condición

Este nodo permite definir bifurcaciones en el flujo en función de condiciones.

5.1 Configuración

• Definir condiciones: Se puede agregar hasta 10 condiciones utilizando operadores lógicos.
• Agrupar condiciones: Se pueden combinar múltiples comparaciones en un mismo bloque.
• Resultados:
  • Camino "Verdadero" (cuando la condición se cumple).
  • Camino "Falso" (cuando no se cumple).

5.2 Nodo Finalizar

Si se desea finalizar la integración en caso de una condición, se puede agregar el nodo Finalizar Camino.

6. Configuración del Nodo Creador de Funciones

Permite definir funciones personalizadas en Java para crear nuevas variables.

Las variables creadas en este nodo, solo podrán utilizarse en nodos posteriores.

6.1 Configuración

• Botón "Nueva Función".
• Editor de código (Java puro).
• Nombre de función: Nombre por defecto: “Función Avanzada 1, 2, 3…”
• Tipo de retorno: String, Number, Boolean o Lista.
• Variables disponibles: Se pueden seleccionar de nodos anteriores.
• Compilación y ejecución: Se muestra un mensaje de éxito o error.
• Guardar: Una vez que la compilación es exitosa, permite guardar.

7. Configuración del Nodo Servidor Destino

Permite definir dónde se enviarán los datos procesados.

7.1 Configuración de Servidor REST

Misma configuración que en el nodo Servidor Origen.

• Método HTTP: GET, POST, PUT o DELETE
• IP/URL destino
• Parámetros URI
• Headers
• Control de errores
• Autenticación

7.2 Configuración de Servidor SFTP

• IP o Dominio.
• Puerto.
• Path del directorio.
• Nombre y extensión del archivo.
• Credenciales (Usuario y Contraseña).

8. Configuración del Nodo Respuesta

Este nodo solo está disponible si en el Origen REST se activó Forzar respuesta sincrónica.

8.1 Configuración

• Código HTTP: Se selecciona un código de respuesta.
• Body de la respuesta:
  • Archivo de salida.
  • Texto personalizado.
  • Sin contenido.

9. Publicación de la Integración

Una vez configurados todos los nodos, se puede publicar la integración.

Al publicar, la integración queda disponible y lista para comenzar a ejecutarse.

9.1 Proceso de Publicación

• Botón "Publicar" (habilitado solo cuando todos los nodos están configurados correctamente).
  • Modal publicar:
    • Origen SFTP.
      Cuando se clickea desde una integración cuyo origen es SFTP sobre el margen derecho se despliega una pantalla con indicaciones sobre la configuración.
    • Origen REST
      Cuando se clickea desde una integración cuyo origen es REST se despliegue un menú lateral sobre el margen derecho con las indicaciones de configuración y alerta sobre el inicio de la integración.
      La configuración permite, nombrar, crear una descripción y elegir que usuarios de que grupo puede ejecutar la integración. 
      Las instrucciones de uso informar como ejecutar la integración.
       
• Indicador de errores: muestra los elementos pendientes para la publicación.

Próximos Pasos

Si estás listo para comenzar a construir un proceso de integración, consulta la sección Integraciones.

Si ya tienes tu integración y quieres monitorearla, dirígete a la sección Inicio o consulta nuestra sección Monitoreo de integraciones.