Una dirección vCard tiene siete partes, y una columna de CSV una

El punto y coma que no separa

En una vCard la estructura la llevan los puntos y coma desnudos y el contenido escapa los suyos. Una empresa llamada Sarl Dupont, Martin et fils se escribe Sarl Dupont\, Martin et fils, con barra invertida incluida, precisamente para que un lector distinga esa coma de un separador. Lo mismo vale para los puntos y coma dentro de un valor y para los saltos de línea dentro de una nota. Divide una línea de vCard por un punto y coma o una coma corrientes y partes nombres en dos — de ahí un analizador que recorre la línea y respeta las barras invertidas en vez de llamar a split.

El plegado de línea es la segunda trampa y es invisible en un editor. Una propiedad larga se corta a 75 octetos y continúa en la línea siguiente con un espacio inicial: una nota de 149 caracteres puede ocupar tres líneas y leerse como tres campos rotos para quien divida por saltos de línea. Bien desplegada vuelve entera, con el escapado intacto — es lo que muestra el visor y lo que el CSV se lleva después.

Qué dirección tomar, y cuándo

Coge el CSV cuando la respuesta que buscas sea una lista: quién está en qué empresa, cuántos contactos no tienen correo, qué números empiezan aún por un prefijo antiguo. Una hoja de cálculo es la forma adecuada para esas preguntas y una vCard una mala. Coge la exportación JSON cuando otra cosa vaya a leerla: conserva las listas de teléfonos y correos como listas en vez de fundirlas en una celda, que es la diferencia entre un script que funciona y uno que adivina dónde cortar.

Preguntas frecuentes

Mis contactos importados no tienen ciudad ni código postal. ¿Por qué?

Porque pasaron por una hoja de cálculo. Una columna de dirección se convierte en una componente de dirección, y la componente que usa una vCard reconstruida es la calle — así que ciudad, región, código postal y país llegan vacíos aunque cada palabra siga ahí. Si necesitas esos campos rellenos, conserva el .vcf original o divide tú mismo la dirección en columnas distintas y complétalos en el destino tras importar.

¿Sobreviven los caracteres acentuados?

En las herramientas, sí: todo se lee y escribe en UTF-8. Donde suelen romperse es en una hoja de cálculo que abre el CSV con otra codificación, lo que convierte é en dos caracteres antes de que hayas hecho nada. Abre el archivo por el diálogo de importación de tu hoja eligiendo UTF-8 en vez de hacer doble clic, y comprueba un nombre acentuado antes de editar doscientos.

¿Hay una versión de vCard que deba preferir?

La 3.0 es lo que exportan casi todas las agendas y lo que todo el mundo lee, así que es la opción segura para mover contactos entre aplicaciones. La 4.0 es la norma actual y escribe algunos valores como URI — un teléfono puede llegar como tel:+33612345678, prefijo incluido — mientras que la 2.1, que aún producen teléfonos y clientes de correo antiguos, marca los tipos sin signo igual, TEL;CELL en vez de TEL;TYPE=CELL. Las herramientas leen las tres; al escribir, la 3.0 llega más lejos.