Saltar al contenido principal

Introducción

El módulo "Integrations" permite combinar APIs y servicios en línea mediante programación visual. En su interfaz arrastras bloques (nodos) y los conectas entre sí para construir visualmente la lógica de tus aplicaciones. Así el desarrollo resulta accesible incluso para quienes no son programadores profesionales, y la integración de distintos sistemas es mucho más rápida:

Elementos principales de la interfaz del módulo Integrations​

1. Panel izquierdo con nodos​

En el panel izquierdo están todos los nodos disponibles. Son los elementos con los que construyes tus flujos de datos.

Para usar un nodo, arrástralo al área de trabajo. Cada nodo tiene su propia función y su propia configuración.

Ejemplos de nodos:

  • Inject: envía datos al flujo manualmente.
  • Debug: muestra datos y mensajes en el menú de depuración.
  • Function: permite escribir código personalizado en JavaScript.
  • Template: sirve para crear plantillas de texto o HTML.

2. Pestañas​

Las pestañas están encima del área de trabajo y permiten cambiar entre distintos proyectos o flujos de datos. Son útiles si trabajas en varias integraciones a la vez o quieres repartir la lógica en varios flujos.

  • Crear pestañas: haz clic en el botón con el signo más +. Cada pestaña nueva es un flujo de datos independiente, lo que ayuda a organizar el proyecto.
  • Renombrar pestañas: haz doble clic en el nombre de la pestaña y escribe uno nuevo. Resulta especialmente útil cuando tienes muchas pestañas y quieres saber con claridad qué contiene cada una.
  • Eliminar pestañas: haz clic derecho en la pestaña y elige Delete en el menú contextual. Ten cuidado de no perder datos importantes.
  • Desactivar pestañas: en el mismo menú contextual, Disable desactiva el flujo de la pestaña sin eliminarla. En una pestaña desactivada la opción se llama Enable y vuelve a activar el flujo. En el esquema JSON, este estado se guarda en el campo disabled de la pestaña.

Ejemplo: si trabajas en una integración de pagos, puedes crear una pestaña para cada servicio.

3. Área de trabajo​

El área de trabajo es la parte central de la interfaz, donde construyes y editas tus flujos de datos.

  • Colocar nodos: el nodo que arrastras desde el panel izquierdo aparece en el área de trabajo. Ahí puedes moverlo, conectarlo con otros nodos y construir la lógica del flujo.
  • Conectar nodos: arrastra una línea desde la salida de un nodo hasta la entrada de otro. Los datos pasarán por el flujo de un nodo al siguiente.
  • Gestionar flujos: el área de trabajo admite varios flujos de datos, lo que ayuda a organizar integraciones y lógica complejas.

Consejo: puedes acercar o alejar el área de trabajo con el mouse o el panel táctil para ver todos los detalles del flujo.

4. Formulario de edición de nodo​

Al hacer doble clic en un nodo del área de trabajo se abre el formulario de edición de nodo, la ventana donde configuras su comportamiento.

  • Campos de configuración: cada nodo tiene sus propios parámetros editables. Por ejemplo, en el nodo Function puedes escribir y editar código.
  • Guardar cambios: cuando termines de editar el nodo, haz clic en Submit para guardar los cambios.

Ejemplo: en el nodo Function puedes escribir código JavaScript que transforma datos. En el nodo Template puedes crear una plantilla que inserta datos de forma dinámica.

5. Panel de depuración​

El panel de depuración está a la derecha y muestra los datos de salida y los mensajes del nodo Debug. Tiene dos pestañas: Debug (los mensajes del flujo) y Configuration.

  • Ver mensajes: al ejecutar el flujo de datos, el nodo Debug envía mensajes a la pestaña Debug. Así ves qué ocurre en el flujo y compruebas que los datos son correctos.
  • Filtrar mensajes: la lista situada sobre los mensajes define de qué nodos se muestran: all nodes (todos los nodos) o current workflow (solo los nodos de la pestaña actual). Es útil cuando tienes mucha salida de distintos nodos Debug.
  • Limpiar la ventana Debug: haz clic en el ícono de la cruz junto al filtro para borrar los mensajes antiguos y centrarte en los nuevos.

Ejemplo: si usas un nodo Function para hacer cálculos, agrega un nodo Debug al final del flujo para comprobar que tu código procesa bien los datos.

6. Botones de control​

Botón Open full screen​

  • Muestra la interfaz del módulo Integrations a pantalla completa. Es útil al trabajar con flujos de datos complejos o al presentar el proyecto en un monitor grande.
  • Con este botón tienes más espacio para editar y ves mejor todos los detalles de tus flujos.

Botón Publish​

  • Es el botón principal: guarda y despliega todos los cambios hechos en tus flujos de datos y los activa. Después de agregar o modificar nodos, haz clic en este botón para que la configuración empiece a funcionar.

Botón Import​

Input Schema y paso del esquema entre nodos​

En el formulario de edición, cada nodo muestra el bloque Input Schema: el esquema de los datos que llegan del nodo anterior del flujo. El esquema presenta los campos disponibles como pares "clave: tipo" y refleja cómo están anidados los objetos.

Si la descripción de la API incluye una descripción del campo, esta aparece junto a la clave. El editor de código usa esas mismas descripciones para el autocompletado y las sugerencias al escribir plantillas Mustache.

Qué nodos pasan el esquema al siguiente nodo​

No todos los nodos pueden pasar el esquema. Lo hacen estos:

  • Function: el esquema se genera a partir del campo Output Example (JSON). Este campo también sirve como datos de prueba cuando el flujo se invoca sin ejecutar realmente el código de Function.
  • Admin API: el esquema se toma de la descripción del método en la descripción de la API. Al hacer clic en Execute, el esquema se actualiza con la respuesta real de la API. Los campos que coinciden con la descripción de la API conservan sus descripciones de texto.
  • Http Request: al principio no tiene esquema. El esquema aparece después de hacer clic en Execute y se toma de la respuesta real.

Botón Execute​

Los nodos Admin API y Http Request tienen el botón Execute en el formulario de edición. Ejecuta toda la cadena de nodos, desde el inicio del flujo hasta el nodo actual.

Ten en cuenta:

  • El servidor ejecuta el flujo según el estado del último Publish, así que asegúrate de que el flujo esté publicado antes de probarlo.
  • Si un nodo function de la cadena no pasa datos al siguiente pero tiene completado Output Example (JSON), ese valor se usa como datos de prueba.
  • Si la respuesta es correcta, el resultado pasa al siguiente nodo como esquema.
  • Si hay un error, el esquema no pasa al siguiente nodo.

Llamada automática a nodos de solo lectura​

Todos los nodos admin-api que solo hacen solicitudes de lectura (GET) se llaman automáticamente al abrir la página Integrations y al actualizar el flujo con el botón Publish. Así el esquema de datos está siempre actualizado sin tener que ejecutarlos manualmente.

Última actualización en