Ajuda da extensão ViewCSV

O arquivo não abre

• Maior que 52.428.800 bytes (50 MB): divida o arquivo ou use um programa instalado no computador.
• “Esta é uma pasta de trabalho do Excel ou de outro programa de planilhas”: salve como CSV UTF-8 no programa de planilhas e abra esse arquivo.
• “Parece um arquivo binário”: arquivos compactados (.gz) precisam ser descompactados antes; PDF não é aceito.
• Mais de 1.000.000 de linhas, 1.000 colunas ou 5.000.000 de células: se o número de colunas parecer errado, o delimitador provavelmente está errado (veja abaixo).

Acentos trocados ou o arquivo “não é um texto UTF-8 válido”

O ViewCSV detecta UTF-8 e UTF-16 com marca de ordem de byte (BOM). Exportações mais antigas costumam usar outra codificação: no Windows em português, o “CSV (separado por vírgula)” do Excel normalmente salva em Windows-1252, enquanto o “CSV UTF-8” salva em UTF-8. Se “ç” e “ã” aparecem como símbolos estranhos ou a abertura falha, a codificação é a causa mais provável.

1. Abra “Configurações de importação” (na tela inicial ou na barra superior, depois que um arquivo estiver aberto).
2. Escolha a codificação em que o arquivo foi salvo — para arquivos brasileiros, quase sempre Windows-1252 (Europa Ocidental); a lista também tem Windows-1250, Windows-1251, Shift_JIS, EUC-KR e GB18030.
3. Abra o arquivo de novo ou clique em “Ler de novo”. Nada é convertido. Bytes que não servem em UTF-8 ou UTF-16 geram um erro; outras codificações podem aceitar bytes errados sem aviso, então, se as letras continuarem estranhas, tente outra codificação.

Ficou tudo numa coluna só

O delimitador não foi reconhecido. Em “Configurações de importação”, escolha vírgula, ponto e vírgula, tabulação ou barra vertical e leia o arquivo de novo. Arquivos salvos com ponto e vírgula e vírgula decimal, como o Excel costuma gravar com as configurações regionais do Brasil, abrem normalmente; os valores só ficam como texto, como 49,90.

“Um valor entre aspas… não termina”

Falta uma aspa dupla no arquivo, a partir da linha indicada na mensagem. Se puder, corrija o arquivo. Para ver os dados mesmo assim, desmarque “Usar aspas duplas como qualificador de texto” em “Configurações de importação”; as aspas passam a ser lidas como caracteres comuns. Com texto colado, a própria mensagem oferece o botão “Abrir com as aspas como texto”.

Colar dados

• O pop-up da barra de ferramentas aceita até 4.194.304 caracteres. Para textos maiores, abra a aba do ViewCSV e use “Colar texto” lá (até 52.428.800 caracteres).
• Linhas copiadas de uma planilha normalmente vêm separadas por tabulação; o ViewCSV detecta isso.
• Linhas vazias são ignoradas e contadas num aviso acima da tabela.

“Encontrar tabelas” não mostra nada, ou não mostra a tabela que você vê

• Só tabelas HTML de verdade são encontradas. Muitos sites, como painéis de lojas e de bancos, desenham grades com outros elementos; essas não podem ser lidas. Copie o texto e cole, ou procure no site uma opção de exportar em CSV.
• Tabelas dentro de frames de outro site, tabelas ocultas e tabelas de layout com uma só célula são ignoradas. No máximo 50 tabelas aparecem na lista.
• Se a página carrega mais linhas conforme você rola ou muda de página, só as linhas presentes na página naquele momento são lidas.
• “A tabela da página mudou” ou “não consegue mais ler aquela página”: a página foi recarregada ou alterada. Volte a ela e escolha “Encontrar tabelas” de novo.
• Células mescladas são divididas e o valor se repete em cada célula que elas ocupavam; um aviso informa quantas foram.

“O ViewCSV não consegue ler esta página”

Os navegadores não deixam extensões lerem as próprias páginas internas (configurações, nova aba, loja de extensões) nem algumas páginas protegidas. Arquivos do seu computador abertos numa aba também ficam de fora: abra-os com “Escolher arquivo” na aba do ViewCSV.

Um link de CSV não abre

• O acesso não foi liberado: escolha “Permitir e abrir” de novo e aceite a pergunta do navegador para aquele site.
• “Este link redireciona para outro endereço”: o ViewCSV não segue redirecionamentos. Abra o link no navegador e use o endereço final, ou baixe o arquivo.
• “O site exige login” (erro 401 ou 403): o ViewCSV não envia o seu login. Baixe o arquivo pelo navegador.
• “O link devolveu uma página da web, não um arquivo CSV”: o link leva a uma página de login ou de download, não ao arquivo.
• Arquivo grande demais ou download acima de 60 segundos, nome de usuário ou senha no link, ou endereço da sua rede local: o download é recusado.
• Em todos os casos, você pode baixar o arquivo pelo navegador e abri-lo com “Escolher arquivo”.

Exportação

• As exportações são em UTF-8. Deixe a opção de BOM UTF-8 ligada (ela já vem ligada) se o Excel mostrar ç, ã ou outros acentos errados.
• A exportação em CSV usa por padrão o mesmo delimitador do arquivo; escolha outro na janela Exportar. Os valores são gravados exatamente como estão, sem reformatação.
• “Proteger contra fórmulas de planilha” (ligado por padrão) coloca um apóstrofo antes das células que começam com =, +, - ou @ (ou com as formas de largura total desses sinais, uma tabulação ou um retorno de carro) e não são números simples, para que a planilha as mostre como texto em vez de executá-las. Desligue se precisar do texto original exato, por exemplo para carregar o arquivo num banco de dados.
• A exportação em JSON é uma lista (array) de objetos, com todos os valores como texto (string). Colunas sem nome viram “Column N” e nomes repetidos ganham “(2)”, “(3)”.
• Escolha se quer exportar as linhas exibidas (depois da pesquisa e dos filtros, na ordem atual) ou todas as linhas, e se quer deixar de fora as colunas ocultas.
• Exportações acima de 209.715.200 bytes (200 MB) são recusadas: filtre linhas ou oculte colunas antes.

O arquivo original e as alterações não salvas

O ViewCSV nunca altera o arquivo original nem a página da web. Edições, linhas excluídas e colunas renomeadas existem só na aba do ViewCSV até você exportar, e Desfazer reverte as últimas 200 alterações. Classificar, pesquisar e filtrar só mudam o que você vê. Fechar ou recarregar a aba descarta as alterações (o navegador pergunta antes), e mudar as “Configurações de importação” lê os dados de novo e também as descarta.

Uma coluna de valores é classificada como texto

Só são reconhecidos como número os decimais simples com ponto, como 1234.5 ou -0.75. Vírgula decimal (49,90), separador de milhar, R$, expoentes e datas ficam como texto, e uma coluna com zeros à esquerda (CEP, CPF, códigos) é texto de propósito. Atenção: 1.250 escrito no padrão brasileiro é lido como o decimal 1.25. O texto é classificado em ordem natural, então 2 continua vindo antes de 10.