Noções básicas de vCard 4.0: o formato text/vcard para troca de contatos

O que é

Um vCard (RFC 6350, tipo de mídia text/vcard) é uma sequência de linhas de conteúdo terminadas em CRLF, entre BEGIN:VCARD e END:VCARD, cada uma no formato NAME;PARAM=value:value. VERSION:4.0 deve vir imediatamente após BEGIN:VCARD; FN (o nome de exibição formatado) é a única outra propriedade obrigatória. N contém o nome estruturado em cinco componentes separados por ponto e vírgula (sobrenomes; prenomes; nomes adicionais; prefixos honoríficos; sufixos honoríficos). TEL, EMAIL, ADR, URL, ORG, TITLE, PHOTO, BDAY, NOTE, UID e REV são opcionais e, em sua maioria, repetíveis, com os parâmetros TYPE (work, home) e PREF para distingui-los e ordená-los por preferência. O conjunto de caracteres é UTF-8 e não pode ser substituído; uma vírgula, um ponto e vírgula ou uma barra invertida dentro de um valor é escapada com uma barra invertida; as linhas de conteúdo devem ser dobradas em 75 octetos, inserindo CRLF seguido de um caractere de espaço em branco. A RFC 7095 define o jCard, o mesmo modelo de dados como uma estrutura de arrays em JSON.

Por que importa

Os vCards circulam por códigos QR, assinaturas de e-mail, sincronização via CardDAV e importações em CRM. A maioria das falhas ocorre no nível do formato: um FN ausente, uma vírgula sem escape no nome de uma empresa que divide o valor, sintaxe da versão 3.0 misturada com parâmetros da 4.0, ou uma foto embutida como base64 de vários megabytes que nenhum código QR consegue comportar.

Como aplicar

• Gere no mínimo VERSION:4.0, FN e N; monte o N a partir de campos estruturados, em vez de dividir um nome de exibição nos espaços, o que falha em muitas convenções de nomes.
• Escreva TEL como URI tel: em formato internacional (TEL;TYPE=work;VALUE=uri:tel:+41…), EMAIL com um TYPE e ADR com seus sete componentes em ordem (caixa postal; endereço complementar; rua; localidade; região; código postal; país), deixando os componentes vazios como strings vazias entre os pontos e vírgulas.
• Defina UID (uma URN ou URL estável por contato) e REV (um carimbo de data/hora) para que os clientes que sincronizam atualizem o registro em vez de duplicá-lo.
• Referencie as fotos por URL nos cartões destinados a códigos QR; embuta-as apenas em arquivos trocados diretamente.
• Valide importando em dois aplicativos de contatos diferentes; erros de escape e de dobra de linha aparecem como campos truncados ou fundidos.

Armadilhas

Presumir que todo importador fala 4.0: muitos ainda esperam as convenções da 3.0, então mantenha-se nas propriedades e grafias de parâmetros amplamente suportadas. Terminações de linha convertidas para LF por um editor de texto. Ordem ocidental fixa de nomes em FN para nomes que não a seguem. Guardar os contatos com o vCard como fonte da verdade, em vez de campos estruturados que o geram.