Text Formatter

Text Formatter es un componente esencial dentro de Nappai diseñado para “limpiar” y preparar el texto antes de que sea utilizado por el resto de tu flujo de automatización. Imagina que tienes una lista de nombres o direcciones con errores de escritura, acentos extraños o espacios sobrantes; este componente actúa como un asistente de edición que corrige y organiza esa información automáticamente, asegurando que los datos que procesas sean consistentes y estén listos para su uso final.

Es ideal para cuando necesitas que el texto sea fácil de leer para usuarios humanos o fácil de procesar para otros sistemas y bases de datos.

¿Cómo funciona?

El componente funciona aplicando una serie de pasos automáticos al texto que le envías. Tú decides cuáles de estos pasos activar, de modo que solo se realicen los cambios que realmente necesitas.

El proceso interno sigue un orden lógico para evitar contradicciones:

Recoge el texto: Toma el mensaje que ha llegado al componente.
Limpieza básica: Si lo has configurado, elimina los espacios vacíos que estén al principio o al final del texto (por ejemplo, quita los espacios innecesarios en una dirección).
Eliminación de acentos: Si lo deseas, convierte letras con acentos (como “é”, “ñ”, “ü”) a sus versiones sin acento (“e”, “n”, “u”). Esto es útil para búsquedas estandarizadas.
Cambio de mayúsculas/minúsculas: Ajusta el formato del texto para que esté todo en minúsculas, todo en mayúsculas o con la primera letra de cada palabra en mayúscula (estilo título).
Reemplazos personalizados:
- Puedes cambiar los espacios normales por otros caracteres (por ejemplo, convertir espacios en guiones para crear URLs amigables).
- Puedes buscar un texto específico y reemplazarlo por otro (por ejemplo, cambiar la palabra “viejo” por “actual”).

Al finalizar, el texto sale completamente transformado según tus instrucciones para ser usado en el siguiente paso de tu automatización.

Conexión y Credenciales

Este componente NO requiere credenciales ni conexiones externas. Todo el procesamiento ocurre localmente dentro de Nappai y es instantáneo.

Entradas

Para configurar este componente, solo necesitas ingresar el texto que deseas modificar y elegir las reglas de formato que prefieras. No es necesario seleccionar un “modo de mapeo” complejo, ya que funciona de manera directa y sencilla.

Campos de Entrada

Message: [El texto original que deseas transformar. Este es el punto de partida para cualquier operación de formato.]
Case Conversion: [Permite elegir cómo quieres que se escriba el texto: todo en minúsculas, todo en mayúsculas, o la primera letra de cada palabra en mayúsculas. Si no seleccionas nada, el texto mantendrá su formato original.]
Remove Accents: [Activa o desactiva la función de quitar los acentos y diacríticos. Útil si necesitas estandarizar datos para búsquedas exactas o para evitar problemas de codificación. Ejemplo: “café” se convierte en “cafe”.]
Trim Whitespace: [Al activar esta opción, el componente eliminará automáticamente cualquier espacio vacío que aparezca al principio o al final del texto. Esto ayuda a que los datos se vean más limpios y ordenados.]
Replace Spaces: [Activa la función para cambiar los espacios normales por otro símbolo (como un guion o un guion bajo). Esto es muy común para crear nombres de archivos o URL amigables.]
Replace Spaces With: [Aquí escribes el carácter específico que deseas que reemplace a los espacios (por ejemplo, un guion - o un guion bajo _). Este campo solo aparece si activas la opción “Replace Spaces”.]
Replace Characters: [Activa la función de reemplazo avanzado, que te permite buscar un texto específico y cambiarlo por otro.]
Number of Replacements: [Indica cuántos pares de “buscar y reemplazar” quieres configurar. Puedes definir hasta 5 reglas diferentes a la vez.]
Find: [Escribe aquí el texto que deseas buscar y cambiar. Podrás escribir en hasta 5 campos diferentes si has aumentado el número de reemplazos.]
Replace with: [Escribe el texto nuevo que debe aparecer en lugar del texto original. Si dejas este campo vacío, el componente simplemente eliminará el texto que encontraste.]

Salidas

Formatted Message: [El texto final, completamente transformado y listo para ser usado. Este resultado puede conectarse a otros nodos para enviar correos, guardar en bases de datos o ser analizado por IA.]

Ejemplo de Respuesta JSON

Si el componente recibe un texto de entrada como " El café es bueno " y lo configuras para eliminar acentos, quitar espacios y poner todo en mayúsculas, el resultado que verías sería: json { “text”: “EL CAFE ES BUENO” }

Conectividad

Este componente es muy versátil y suele conectarse lógicamente en los siguientes puntos de un flujo de automatización:

Como etapa inicial de limpieza: Se conecta comúnmente después de nodos que recopilan datos crudos (como formularios web o importaciones de hojas de cálculo) y antes de procesamientos complejos de IA o guardado en bases de datos.
Preparación para URLs o Archivos: Al usar la opción de “Replace Spaces”, se conecta frecuentemente a nodos que generan enlaces web o nombres de archivos, asegurando que estos no tengan espacios vacíos que puedan causar errores.
Antes de la Generación de Respuestas: Puede estar ubicado antes de que la IA redacte una respuesta final para asegurar que los datos de referencia estén estandarizados.

Ejemplo de Uso

Escenario: Preparación de nombres de clientes para un reporte

Tienes una lista de clientes cuyos nombres vienen con errores de formato, como " Juan Pérez " o " maría gómez ". Quieres un reporte limpio.

Conecta la lista de nombres al nodo Text Formatter.
Activa Trim Whitespace para quitar los espacios sobrantes.
Activa Replace Spaces y en el campo “Replace Spaces With” escribe un guion - si necesitas crear códigos de cliente.
Conecta la salida Formatted Message a un nodo que genere el reporte final.

Resultado: "Juan-Pérez" y "maría-gómez".

Consejos y Mejores Prácticas

Orden de las operaciones: Recuerda que el componente aplica las acciones en un orden específico (limpieza básica -> acentos -> mayúsculas/minúsculas). Si necesitas un orden diferente, considera usar componentes separados.
Uso de acentos: Usa Remove Accents solo si realmente es necesario para tu base de datos o búsqueda. Si el texto va destinado a ser leído por personas, mantener los acentos asegura una lectura correcta y natural.
Reemplazos vacíos: Si dejas el campo “Replace with” vacío al usar reemplazos personalizados, el componente actuará como una herramienta de “eliminación”, borrando el texto que encuentres. Úsalo con cuidado.
Prueba antes de automatizar: Antes de aplicar estos cambios a miles de registros, prueba el nodo con una sola línea de texto para verificar que el resultado es el que esperas.

Consideraciones de Seguridad

Este componente no interactúa con servicios externos ni almacena información sensible. El procesamiento es local y no presenta riesgos de seguridad inherentes más allá del manejo estándar de datos dentro de Nappai. Asegúrate de no ingresar información confidencial (como contraseñas o datos bancarios) en campos de texto que serán visibles en tu flujo de trabajo.