Um ficheiro CSV (Comma Separated Values) é um tipo de ficheiro, em texto, utilizado para, de forma simples permitir a leitura de tabelas.
A estrutura destes ficheiros é, verdadeiramente direta: a informação encontra-se organizada em linhas e colunas, nas quais os valores, apresentados em cada coluna, se encontram separados por caracteres, como vírgulas ou pontos e vírgula.
O ficheiro CSV inclui, ainda um cabeçalho o qual descreve cada coluna apresentada, o que facilita a compreensão dos dados apresentados.
Aqui podes encontrar um exemplo de como este ficheiro se apresenta:
Nome,Apelido,Idade,Cidade
Marco,Silva,30,Lisboa.
Ana,Lucas,25,Porto
Lucas,Monteiro,40,Viseu
No exemplo, temos uma tabela com quatro colunas, nomeadamente: Nome, Apelido, Idade e Cidade.
Cada linha representa um dado diferente, uma pessoa diferente. Por sua vez, os dados, encontram-se separados por vírgulas, pelo que o nome do sujeito é Marco, o seu apelido Silva, a sua idade 30 e a sua cidade Lisboa.
Uso de aspas
Em determinados casos, especialmente quando queres inserir um valor numérico que apresente casas décimais (e como tal, incuia uma vírgula, como por exemplo 1.250,50), irás necessitar de aspas por forma a não confundir o software aquando da leitura do ficheiro CSV. Sem as aspas, o software irá interpretar as vírgulas como se estas fossem um separador o qual indicia uma nova coluna.
Assim, para inserires um valor décima com uma vírgula, ao invés de esc reves 1.250,50, deves escrever "1.250,50".
Aqui podes encontrar um exemplo de como este ficheiro se apresenta:
Nome,Apelido,Idade,Salário
Marco,Silva,30,"1.550,50"
Ana,Lucas,25,"25.999,99"
Lucas,Monteiro,40,"3.425,75"
Campos em Branco
Os ficheiros CSV têm algumas colunas de preenchimento obrigatório, enquanto outras são opcionais e, por isso, podem ser deixadas em branco.
Neste caso, é ainda necessário inserir uma vírgula como separador para que o software saiba que deixou a célula correspondente a uma coluna opcional vazia e que está a passar para a célula seguinte.
Aqui está um exemplo de como fica um ficheiro CSV com a coluna "Idade" como opcional:
Aqui podes encontrar um exemplo de como este ficheiro se apresenta:
Nome,Apelido,Idade,Cidade
Marco,Silva,,Lisboa.
Ana,Lucas,25,Porto
Lucas,Monteiro,,Viseu
Neste exemplo, as linhas 1 e 3 não têm o valor da coluna "Age", que é opcional. No entanto, é adicionada uma vírgula extra para indicar a célula vazia correspondente à coluna "Age". Já a linha 2 inclui o valor da idade e segue o formato normal.
Como editar um ficheiro CSV no formato do CryptoBooks utilizando um editor de texto
Descarrega o ficheiro CSV a partir deste link. Este já apresenta o cabeçalho tal como pretendido pelo CryptoBooks.
Abre o ficheiro descarregado no software de edição que utilizes no teu computador (caso tenhas um Mac, o software será o TextEdit, por sua vez, se tiveres um computador Windows deverás utilizar o Notepad). O ficheiro CSV pré-preenchido apresenta-se nos seguintes moldes:
Nota: Mantenha a linha de cabeçalho entre aspas para evitar que o software interprete os espaços entre palavras como separadores de colunas.
Clica em Enter por forma a moveres o rato para uma linha em específico
Preenche com os valores necessários segundo as instruções que poderás encontrar neste artigo Guia para Compilares o ficheiro CSV do CryptoBooks | CryptoBooks ENG
Assim que tenhas inserido todas as linhas que pretendes importar, guarda o ficheiro.
Abaixo poderás encontrar, em inglês, o tutorial em vídeo:
Como editar um ficheiro CSV do Cryptobooks através do Excel
Descarrega o ficheiro CSV a partir deste link. Este já apresenta o cabeçalho tal como pretendido pelo CryptoBooks.
Abre o ficheiro no Excel.
O cabeçalho deverá apresentar-se da seguinte forma:
Clica na coluna A por forma a selecionares a coluna inteira.
No menu clica em "Dados" ou "Data" caso o teu Excel se encontre configurado em inglês.
Clica em "Texto para Colunas" / "Text to Columns".
Seleciona "Delimitado"/"Delimited" e posteriormente clica em "Seguinte"/"Next".
Seleciona "Vírgula"/"Comma" e clica em "Seguinte"/"Next".
Clica em "Terminar"/"Finish".
Agora, o teu cabeçalho será apresentado da seguinte forma:
Vai até à célula A2 e preenche a mesma com os valores necessários segundo as intruções do nossos guia: Guia para Compilares o ficheiro CSV do CryptoBooks | CryptoBooks ENG.
Assim que tenhas preenchido todas as linhas que pretendes importar, guarda o ficheiro através do seguintes passos:
Clica em "Ficheiro"/"File";
Clica em "Salvar como"/"Save As".
Seleciona a pasta onde queres guardar o ficheiro.
Seleciona o tipo de ficheiro "CSV (Separado por Vírgular"/"CSV (Comma Delimited)".
Clica em "Guardar"/"Save".
Abaixo poderás encontrar o tutorial em vídeo:
Potenciais complicações com o Excel!
Por vezes, ao criar e editar um ficheiro CSV com o Excel, podem ser feitas alterações automáticas que invalidam o ficheiro e impedem o seu carregamento.
Nessas situações, deves corrigir o ficheiro utilizando, para tal, um editor de texto.
O mesmo ficheiro, mas agora aberto através de um editor de texto
Nesta imagem poderás constatar que algumas aspas foram incorretamente adicionadas, tanto na linha do cabeçalho, como nas duas primeiras linhas.