> For the complete documentation index, see [llms.txt](https://docs.augelab.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.augelab.com/spanish/function-blocks/blocks-reference/data-logic/data-operations/string-merge.md).

# String Merge

Esta función fusiona múltiples entradas de texto en una única cadena combinada. Úsala para construir nombres de archivo, mensajes, etiquetas o cualquier texto compuesto a partir de entradas separadas.

## 📥 Entradas

`String` — Una de las entradas de texto a fusionar. El bloque acepta múltiples entradas `String`; la configuración por defecto proporciona dos.

## 📤 Salidas

`String` — El resultado fusionado, producido concatenando todas las entradas proporcionadas de izquierda a derecha.

## 🕹️ Controles

`Input size` — Elige cuántas entradas de texto expone el bloque. Aumentar esto añadirá más entradas `String`; disminuirlo eliminará entradas.

## ⚙️ Mecanismo de ejecución

* En cada ejecución, el bloque lee todas las entradas `String` disponibles (en el orden en que aparecen) y las concatena en un único valor de texto.
* El resultado concatenado se envía al socket de salida `String` para su uso posterior.
* Si una entrada está vacía o no se proporciona, no aporta caracteres al resultado final (se trata como una cadena vacía).

## 🎯 Features

* Recuento dinámico de entradas mediante el control `Input size` — adapta el número de entradas de texto a tu caso de uso.
* Concatenación simple y determinista — el orden predecible de las partes facilita la construcción de nombres y mensajes estructurados.
* Ligero e ideal para ensamblar cadenas a nivel de interfaz (nombres de archivo, etiquetas, líneas de registro).

## 📝 Usage tips

* Ordena las partes de texto de izquierda a derecha en el orden en que quieras que se fusionen.
* Usa entradas de texto descriptivas (por ejemplo: prefijo, separador, contador, timestamp) para construir nombres de archivo o identificadores claros.

## 💡 Tips and Tricks

* Combínalo con `String Input` para permitir la entrada manual de partes y luego fusionarlas para formar una etiqueta o nombre final.
* Usa `Number Input` junto con `String Merge` cuando necesites contadores incrementales en nombres de archivo.
* Añade un timestamp fusionando `Date-Time` (o valores de `Date-Time List`) para crear nombres de archivo únicos y trazables.
* Crea registros de exportación estructurados fusionando campos y enviando el resultado a `Data to JSON` o `CSV Export` para registro.
* Construye nombres de imagen dinámicos (prefijo + timestamp + índice) con `String Merge` y usa el resultado con `Image Logger` o `Image Write` para guardar imágenes con nombres informativos.
* Combínalo con `Choose Folder` o `File/Folder Operations` para ensamblar rutas completas para operaciones de archivo.

## 🛠️ Solución de problemas

* Si un resultado fusionado parece faltar partes, verifica el número de entradas `String` activas mediante el control `Input size` y asegúrate de que cada entrada esté conectada o contenga texto.
* Si faltan separadores, añade entradas de separador explícitas (por ejemplo, un guion o guion bajo) entre las partes antes de fusionar.