¿Qué es un archivo CSV?
CSV significa Comma Separated Values (valores separados por comas). Es un formato de archivo comúnmente utilizado para representar datos tabulares de manera sencilla y legible.
Un archivo CSV organiza los datos en filas y columnas, donde cada valor está separado por un delimitador, normalmente una coma o, en algunos casos, un punto y coma.
La primera fila suele contener los encabezados (headers), que definen los nombres de las columnas y ayudan a que los datos sean más comprensibles.
Ejemplo de cómo se ve un archivo CSV
Name,LastName,Age,City
Luca,Bianchi,40,Turin
Aisha,Khan,28,Dubai
Yuki,Tanaka,35,Tokyo
Sophia,Schmidt,32,Berlin
Amara,Okafor,27,Lagos
Liam,O'Connor,38,Dublin
En este ejemplo, tenemos una tabla con cuatro columnas: Name, LastName, Age y City.
Cada fila contiene la información de una persona distinta. Los valores de cada columna están separados por comas.
Por ejemplo, en la primera fila, el nombre es Luca, el apellido Bianchi, la edad 40 y la ciudad Turin.
Conceptos útiles sobre el formato CSV
En esta sección encontrarás dos conceptos muy importantes sobre los archivos CSV:
cómo insertar texto o números que contengan comas en un archivo CSV
cómo dejar campos vacíos
Manejo de comas en los campos CSV: "Comillas"
Imagina que necesitas escribir un número como 1.000,54 en un archivo CSV.
Si lo dejas así, el software que lea el archivo pensará que 1.000 pertenece a un campo y 54 al siguiente, porque interpreta la coma como un separador entre columnas.
Para evitar este problema, debes encerrar el número entre comillas:
"1.000,54"
De este modo, el software entiende que 1.000,54 es un solo valor y lo mantiene junto en una única columna.
Campos vacíos
Los archivos CSV tienen algunas columnas obligatorias y otras opcionales que pueden dejarse vacías.
Cuando dejas una columna opcional vacía, aun así debes poner una coma como separador.
Esto indica al software que esa celda está vacía y que debe pasar a la siguiente columna.
Ejemplo de CSV con una columna opcional (“Age”):
Name,LastName,Age,City
Sophia,Schmidt,,Berlin
Yuki,Tanaka,35,Tokyo
En este caso, el valor de Age no se incluye en la primera fila, pero se añade una coma adicional para indicar el campo vacío.
La segunda fila sí incluye el valor y sigue el formato normal.
Herramientas para editar un archivo CSV
Puedes editar un archivo CSV utilizando diferentes tipos de software, según tus necesidades y preferencias:
programas de hojas de cálculo
aplicaciones como Microsoft Excel, Google Sheets, LibreOffice Calc o Apple Numbers te permiten abrir, editar y guardar archivos CSV en un formato de tabla más visual y sencillo de manejar.editores de texto
Editores simples como Notepad (Windows), TextEdit (Mac) o editores más avanzados como VS Code, Sublime Text o Notepad++ también pueden utilizarse para editar archivos CSV directamente como texto plano.
En las siguientes secciones explicamos cómo editar el archivo CSV de CryptoBooks con un editor de texto o con Excel.
Herramientas para editar un archivo CSV
Para editar correctamente el formato CSV de CryptoBooks para conexiones personalizadas usando un editor de texto, sigue estos pasos:
descarga el archivo CSV de plantilla desde este enlace. Ya contiene los encabezados requeridos.
abre el archivo con el editor de texto de tu ordenador (en Mac se llama TextEdit, en Windows Notepad).
Así se ve el archivo prellenado con la fila de encabezado:
mantén la fila de encabezado entre comillas ("") para evitar que el software interprete los espacios como separadores de columnas.
pulsa Enter para pasar a una nueva línea.
rellena los valores necesarios siguiendo las instrucciones del artículo: Guía para Compilar el CSV de CryptoBooks
una vez que hayas introducido todas las filas que quieras importar, guarda el archivo.
Cómo editar el archivo CSV de CryptoBooks usando Excel
descarga el archivo CSV de plantilla desde este enlace. Ya contiene los encabezados requeridos.
abre el archivo con Microsoft Excel. Así se ve el archivo con la fila de encabezado prellenada.
haz clic en la columna A para seleccionarla por completo.
en el menú de navegación, haz clic en Datos
haz clic en Texto en columnas
selecciona Delimitado y haz clic en Siguiente
elige Coma y haz clic en Siguiente
haz click en Finalizar
ahora tu fila de encabezado se mostrará correctamente separada en columnas.
ve a la celda A2 y rellena los valores necesarios siguiendo las instrucciones del artículo: Guía para Compilar el CSV de CryptoBooks
Una vez completadas todas las filas que quieras importar, guarda el archivo siguiendo estos pasos:
Haz clic en Archivo
Haz clic en Guardar como
Selecciona la carpeta donde guardar el archivo
Asegúrate de que el tipo de archivo seleccionado sea CSV
Haz clic en Guardar
🚨 Posible problema con Excel
A veces, al crear o editar un archivo CSV con Excel, se producen cambios automáticos que invalidan el archivo y evitan que se pueda subir correctamente.
En esos casos, deberás comprobar y corregir el archivo usando un editor de texto.
Ejemplo de formato incorrecto por cambios automáticos:
El archivo parece correcto cuando se ve en Excel.
Pero al abrir el mismo archivo con un editor de texto, se observa que se han añadido comillas de forma errónea, tanto en el encabezado como en las primeras filas.
En estos casos, deberás eliminar los errores manualmente en el editor de texto antes de subir el archivo.