Cómo convertir CSV a JSON con nombres de campo

Qué puedes hacer con un CSV

Esta herramienta convierte texto CSV suministrado por ti en datos con formato JSON. Resulta útil cuando necesitas pasar filas y columnas a una estructura que puedas revisar, reutilizar o incorporar a otro flujo de trabajo, sin cargar un libro de Excel ni otro archivo binario. La primera fila puede utilizarse como nombres de campo, de modo que las filas posteriores se convierten en registros planos. [No realiza una transformación de esquema más compleja ni crea objetos anidados.]

Pasos para convertir el CSV

1. Prepara el contenido CSV como texto. Incluye una fila inicial con nombres de campo si quieres que las filas siguientes se conviertan en registros con esas claves. Por ejemplo, puedes usar nombre,ciudad en la primera fila y añadir después los datos correspondientes.

2. Pega el CSV en el campo de entrada de la herramienta. La entrada predeterminada está vacía y acepta contenido CSV proporcionado como texto.

3. Decide cómo tratar la primera fila. Con la asignación de encabezados activada, cuando hay más de una fila, la primera se reserva como nombres de campo y las posteriores se convierten en registros. Si la desactivas, cada fila analizada se trata como datos; esta opción es adecuada cuando la primera fila no contiene encabezados.

4. Ajusta la indentación numérica del JSON si lo necesitas. El valor predeterminado es 2, y esta configuración modifica la presentación del resultado con formato JSON.

5. Ejecuta la conversión y revisa el resultado. Una operación correcta informa de cuántos registros se han producido a partir de las filas analizadas. Si el contenido está vacío o solo contiene espacios, el resultado es una matriz JSON vacía y el recuento es cero.

Cómo leer el resultado y sus límites

Interpreta el resultado según la opción elegida para la primera fila. Con la asignación de encabezados, cada registro posterior se presenta como una estructura plana cuyos campos corresponden a los nombres de esa fila. Con la asignación desactivada, la primera fila también permanece dentro de los datos, por lo que no debes esperar que funcione como nombres de campo.

El recuento comunicado indica cuántos registros se han generado desde las filas procesadas. Las celdas se leen como texto: la conversión no implica cambios automáticos a números, fechas u otros tipos. Si el procesamiento provoca una excepción, la operación se marca como correcta, pero devuelve una matriz vacía, un recuento de cero y una descripción del error; por eso conviene revisar también esa descripción cuando el resultado no coincide con el CSV de partida.

Ejemplo práctico

Tienes un CSV con las columnas «nombre» y «ciudad», seguidas de varias filas de personas, y quieres convertirlo en registros JSON con esas dos claves.

Pega el contenido, activa la asignación de encabezados y ejecuta la conversión. Después, comprueba que la salida tiene una matriz de objetos y que el recuento corresponde a las filas posteriores procesadas.

Una matriz JSON de registros planos: los nombres de la primera fila aparecen como campos y cada fila posterior ocupa un registro; el resultado también muestra el recuento generado.

Limitaciones

• La entrada documentada es contenido CSV suministrado como texto; la herramienta no se describe aquí como conversor de libros de Excel binarios ni de otros archivos cargados.
• La conversión crea registros planos a partir de filas y celdas; no se ha establecido la creación de objetos anidados ni una transformación de esquema más amplia.
• Los valores de las celdas se leen como texto, sin conversión automática a números, fechas u otros tipos.

Errores frecuentes

• Si la primera fila aparece como nombres de campo cuando debía conservarse como datos, la asignación de encabezados está activada. Desactívala y vuelve a procesar el CSV para tratar todas las filas como datos.

Preguntas frecuentes

¿La primera fila del CSV se convierte en nombres de campo?

Cuando la asignación de encabezados está activada y hay más de una fila, la primera se utiliza como nombres de campo y las posteriores se convierten en registros. Si desactivas esa opción, todas las filas se tratan como datos.

¿Qué ocurre si no introduzco ningún CSV?

Si la entrada está vacía o solo contiene espacios, se obtiene una matriz JSON vacía y el recuento de registros es cero.

¿Qué resultado aparece si falla el procesamiento?

Si el procesamiento provoca una excepción, la operación se marca como correcta, pero devuelve una matriz vacía, un recuento de cero y una descripción del error.