> 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/data-type-converter.md).

# Data Type Converter

Un bloque sencillo para cambiar el tipo de dato de un valor entrante, de modo que los bloques siguientes reciban el formato esperado. Usa este bloque cuando necesites garantizar que un valor se trate como número, texto, lista, dictionary, batch o boolean para un procesamiento o exportación posterior.

## 📥 Entradas

`Generic` — Cualquier tipo de dato de entrada (texto, número, lista, batch, etc.). Proporciona aquí el valor que quieres convertir.

## 📤 Salidas

`Generic` — El valor convertido al tipo objetivo seleccionado. Usa esta salida para alimentar otros bloques que esperan un tipo de dato específico.

## 🕹️ Controles

`Convert to` — Desplegable donde eliges el tipo destino. Opciones disponibles: `Integer`, `Boolean`, `String`, `Float`, `Batch`, `List`, y `Dictionary`.

## 🎨 Características

* Convierte valores escalares entre tipos comunes (número, texto, boolean).
* Envuelve un elemento en `List` o `Batch` cuando los bloques siguientes requieren una colección.
* Si seleccionas `Dictionary` y la entrada es un texto JSON válido, intenta parsearlo a un diccionario.
* Comportamiento defensivo: cuando falta la entrada o es incompatible, el bloque entrega un valor por defecto seguro e indica el problema.

## 📝 Instrucciones de uso

1. Conecta la fuente de datos a la entrada `Generic`.
2. Elige el tipo destino deseado con el desplegable `Convert to`.
3. Usa la salida `Generic` del bloque como entrada para los bloques posteriores que requieran el tipo elegido.

Escenarios comunes:

* Convertir texto ingresado por el usuario a número antes de aplicar bloques matemáticos.
* Convertir una cadena JSON a `Dictionary` antes de exportar o leer campos.
* Envolver un elemento único en `List` o `Batch` para que bloques que manejan colecciones puedan procesarlo.

(Consejo: usa `String Input` o `Number Input` como fuentes simples al probar conversiones)

## 📊 Evaluación

Al ejecutarse, el bloque lee la entrada actual y la entrega en el formato seleccionado. Si la conversión no es posible, devuelve un valor por defecto seguro y registra la condición para atención.

## 💡 Consejos y trucos

* Usa `Debug Input` para inspeccionar valores crudos antes de convertir y así elegir el tipo adecuado.
* Si esperas valores ausentes, coloca `Is None` antes de este bloque para detectarlos y `Replace None` para insertar un valor de reserva.
* Al preparar payloads estructurados para logs o APIs, combina `String Merge` o `Data to JSON` con este bloque para obtener datos bien formateados.
* Para flujos por lotes, empareja este bloque con `Batch Concatenation`, `Get Batch Size` o `Debatch` para inspeccionar o aplanar contenidos luego de la conversión.
* Después de convertir a `Dictionary`, persiste o comparte resultados usando `Data Write Local`, `Data Write Global` o exporta vía `CSV Export`.

## 🛠️ Solución de problemas

* Si la conversión falla o la salida parece sin cambios, verifica la entrada con `Debug Input` para confirmar su tipo y contenido.
* Si la conversión a `Dictionary` no funciona, asegúrate de que la entrada sea un texto JSON válido (comillas, comas, llaves correctas).
* Al trabajar con `Batch` o `List`, confirma que el tipo destino seleccionado (`List` vs `Batch`) coincide con lo que esperan los bloques siguientes; usa `Get Batch Size` para verificar el contenido del batch.
* Para conversiones booleanas inesperadas, asegúrate de que la cadena o número siga una convención clara true/false (por ejemplo, `0`/`1` o `true`/`false`).