Fundamentos de vCard 4.0: el formato text/vcard para intercambiar contactos

Qué es

Una vCard (RFC 6350, tipo de medio text/vcard) es una secuencia de líneas de contenido terminadas en CRLF entre BEGIN:VCARD y END:VCARD, cada una con la forma NAME;PARAM=value:value. VERSION:4.0 debe seguir inmediatamente a BEGIN:VCARD; FN (el nombre de presentación con formato) es la única otra propiedad obligatoria. N contiene el nombre estructurado en cinco componentes separados por punto y coma (apellidos; nombres de pila; otros nombres; prefijos honoríficos; sufijos honoríficos). TEL, EMAIL, ADR, URL, ORG, TITLE, PHOTO, BDAY, NOTE, UID y REV son opcionales, la mayoría repetibles, con parámetros TYPE (work, home) y PREF para distinguirlas y ordenarlas por preferencia. El juego de caracteres es UTF-8 y no puede sobrescribirse; una coma, un punto y coma o una barra invertida dentro de un valor se escapan con una barra invertida; las líneas de contenido deberían plegarse a los 75 octetos insertando CRLF más un carácter de espacio en blanco. El RFC 7095 define jCard, el mismo modelo de datos en una estructura de array JSON.

Por qué importa

Las vCard viajan por códigos QR, firmas de correo electrónico, sincronización CardDAV e importaciones a sistemas CRM. La mayoría de los fallos son a nivel de formato: un FN ausente, una coma sin escapar en el nombre de una empresa que divide el valor, sintaxis de la versión 3.0 mezclada con parámetros de 4.0, o una foto incrustada como base64 de varios megabytes que ningún código QR puede contener.

Cómo aplicarlo

• Emitir como mínimo VERSION:4.0, FN y N; construir N a partir de campos estructurados en lugar de dividir un nombre de presentación por los espacios, lo que falla en muchas convenciones de nomenclatura.
• Escribir TEL como un URI tel: en forma internacional (TEL;TYPE=work;VALUE=uri:tel:+41…), EMAIL con un TYPE, y ADR con sus siete componentes en orden (apartado de correos; dirección extendida; calle; localidad; región; código postal; país), dejando los componentes vacíos como cadenas vacías entre los puntos y coma.
• Fijar UID (una URN o URL estable por contacto) y REV (una marca de tiempo) para que los clientes que sincronizan actualicen en lugar de duplicar.
• Referenciar las fotos mediante URL en las tarjetas destinadas a códigos QR; incrustarlas solo en los archivos que se intercambian directamente.
• Validar importando en dos aplicaciones de contactos distintas; los errores de escape y de plegado se manifiestan como campos truncados o fusionados.

Trampas

Suponer que todo importador habla 4.0: muchos aún esperan las convenciones de 3.0, así que conviene mantenerse en las propiedades y las grafías de parámetro ampliamente admitidas. Los finales de línea convertidos a LF por un editor de texto. El orden de nombre occidental fijo en FN para nombres que no lo siguen. Guardar los contactos con la vCard como fuente de verdad en lugar de campos estructurados que la generan.