Uma morada vCard tem sete partes, e uma coluna de CSV tem uma

O ponto e vírgula que não separa

Numa vCard a estrutura é levada por pontos e vírgulas nus e o conteúdo escapa os seus. Uma empresa chamada Sarl Dupont, Martin et fils escreve-se Sarl Dupont\, Martin et fils, barra invertida incluída, precisamente para que quem lê distinga essa vírgula de um separador. O mesmo vale para os pontos e vírgulas dentro de um valor e para as quebras de linha dentro de uma nota. Divide uma linha de vCard por um ponto e vírgula ou uma vírgula correntes e partes nomes ao meio — daí um analisador que percorre a linha e respeita as barras invertidas em vez de chamar split.

A dobragem de linha é a segunda armadilha e é invisível num editor. Uma propriedade longa é cortada aos 75 octetos e continuada na linha seguinte com um espaço inicial: uma nota de 149 caracteres pode ocupar três linhas e ler-se como três campos partidos para quem divida pelas quebras de linha. Bem desdobrada volta inteira, com o escape intacto — é o que o visualizador mostra e o que o CSV leva a seguir.

Que direção tomar, e quando

Escolhe o CSV quando a resposta que queres for uma lista: quem está em que empresa, quantos contactos não têm e-mail, que números começam ainda por um indicativo antigo. Uma folha de cálculo é a forma certa para essas perguntas e um vCard uma má. Escolhe a exportação JSON quando outra coisa a for ler: guarda as listas de telefones e e-mails como listas em vez de as fundir numa célula, que é a diferença entre um script que funciona e um que adivinha onde cortar.

Perguntas frequentes

Os meus contactos importados não têm cidade nem código postal. Porquê?

Porque passaram por uma folha de cálculo. Uma coluna de morada torna-se uma componente de morada, e a componente que um vCard reconstruído usa é a rua — por isso cidade, região, código postal e país chegam vazios embora cada palavra continue lá. Se precisares desses campos preenchidos, guarda o .vcf original ou divide tu próprio a morada em colunas distintas e completa-os no destino depois de importar.

Os caracteres acentuados sobrevivem?

Nas ferramentas, sim — tudo é lido e escrito em UTF-8. Onde costumam partir é numa folha de cálculo que abre o CSV noutra codificação, o que transforma é em dois caracteres antes de teres feito o que quer que seja. Abre o ficheiro pela caixa de importação da tua folha escolhendo UTF-8 em vez de fazer duplo clique, e confere um nome acentuado antes de editares duzentos.

Há uma versão de vCard a preferir?

A 3.0 é o que quase todos os livros de endereços exportam e o que toda a gente lê, por isso é a escolha segura para mover contactos entre aplicações. A 4.0 é a norma atual e escreve alguns valores como URI — um telefone pode chegar como tel:+33612345678, prefixo incluído — enquanto a 2.1, ainda produzida por telefones e clientes de correio antigos, marca os tipos sem sinal de igual, TEL;CELL em vez de TEL;TYPE=CELL. As ferramentas leem as três; a escrever, a 3.0 viaja mais longe.