O que é um ficheiro CSV?
CSV significa Comma Separated Values (Valores Separados por Vírgula). É um formato de ficheiro muito utilizado para representar dados em tabela de forma simples e legível.
Um ficheiro CSV organiza os dados em linhas e colunas, onde cada valor é separado por um delimitador – normalmente uma vírgula, mas em alguns casos pode ser um ponto e vírgula.
A primeira linha costuma conter os cabeçalhos, que definem os nomes das colunas e ajudam a interpretar os dados.
Exemplo de ficheiro 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
Neste exemplo temos uma tabela com quatro colunas: Name, Last Name, Age e City.
Cada linha contém informação de uma pessoa diferente. Os valores são separados por vírgulas.
Por exemplo, na primeira linha:
Nome = Luca
Apelido = Bianchi
Idade = 40
Cidade = Turim
Como inserir texto ou números com vírgulas
Se precisar introduzir um número como 1.000,54 num CSV, o programa pode interpretar que “1.000” é um valor e “54” pertence à coluna seguinte.
Para evitar este erro, coloque o valor entre aspas:
"1.000,54"
Assim, o software entende que se trata de um único valor.
Como deixar campos vazios
Algumas colunas são obrigatórias, mas outras são opcionais.
Se deixar um campo vazio, ainda precisa colocar a vírgula separadora para indicar que essa célula está em branco.
Exemplo:
Name,LastName,Age,City Sophia,Schmidt,,Berlin Yuki,Tanaka,35,Tokyo
Na primeira linha, o campo “Age” foi deixado vazio, mas a vírgula está presente para marcar o espaço da coluna.
Ferramentas para editar ficheiros CSV
Pode editar ficheiros CSV com diferentes softwares:
folhas de cálculo: Microsoft Excel, Google Sheets, LibreOffice Calc ou Apple Numbers.
editores de texto: Notepad (Windows), TextEdit (Mac) ou editores avançados como VS Code, Sublime Text ou Notepad++.
Como editar o ficheiro CSV da CryptoBooks usando um editor de texto
descarregue o modelo de ficheiro CSV a partir do link fornecido (já contém os cabeçalhos).
abra o ficheiro no editor de texto (Notepad no Windows, TextEdit no Mac).
mantenha a linha de cabeçalhos entre aspas (“”), para evitar que os espaços sejam interpretados como separadores.
carregue em Enter para criar uma nova linha.
preencha os valores necessários de acordo com as instruções do guia da CryptoBooks.
guarde o ficheiro.
Como editar o ficheiro CSV da CryptoBooks usando o Microsoft Excel
descarregue o modelo de ficheiro CSV a partir do link fornecido.
abra o ficheiro no Excel.
clique na coluna A para a selecionar.
vá ao menu Dados (Data) e escolha Texto para Colunas (Text to Columns).
selecione Delimitado (Delimited) > Seguinte (Next).
escolha Vírgula (Comma) > Seguinte (Next).
clique em Concluir (Finish).
a linha de cabeçalho aparecerá corretamente formatada.
vá até à célula A2 e insira os valores necessários.
guarde o ficheiro em formato CSV (Comma Delimited).
🚨 Problema comum com Excel
O Excel, por vezes, adiciona automaticamente aspas indesejadas no ficheiro CSV, tanto no cabeçalho como nas linhas.
Isso pode invalidar o ficheiro e impedir o carregamento no sistema.
Nestes casos, é necessário abrir o ficheiro num editor de texto e remover manualmente os erros.
