vcard-implementations

(Difference between revisions)

Jump to: navigation, search
m (N: distinction)
(Microsoft Outlook)
Line 51: Line 51:
When exporting a vCard, copies FN into N when N is blank.  Does not do this when importing a vCard.
When exporting a vCard, copies FN into N when N is blank.  Does not do this when importing a vCard.
 +
 +
Outlook 2003 does not handle comma separation in the properties of N. For this vCard.
 +
 +
<pre>
 +
BEGIN:VCARD
 +
FN;CHARSET=UTF-8:Mr. Dr. John Maurice Benjamin Doe Ph.D.\, J.D.
 +
N;CHARSET=UTF-8:Doe;John;Maurice,Benjamin;Mr.,Dr.;Ph.D.,J.D.
 +
END:VCARD
 +
</pre>
 +
 +
The result in Outlook is:
 +
 +
Mr.,Dr. Mr. Dr. John Maurice Benjamin Doe Ph.D.\, J.D.
==== TEL ====
==== TEL ====

Revision as of 20:56, 7 February 2007

vCard implementations

In the development of hCard and proxies like X2V, we have discovered various behaviors and quirks of vCard implementations. See also the vcard-errata.

Contents


Contributors

Microsoft Outlook

version? platform?

single import

Outlook (either 2003 or 2007 beta version) appears to only support one vCard per VCF. There are some third-party products that attempt to fix this [1]

URL handling

URL without non-standard TYPE parameter seems to be ignored.

ADR handling

Appears to not support the post-office-box sub-property of ADR.

Escaped Commas

Outlook 2003 does not strip the backslashes from escaped commas (i.e., SR-PS\, Inc.) on import.

Microsoft Outlook 2003

The following was verified on Outlook 2003 SP2 running on Windows XP Pro SP2

URL

URL is changed to URL;HOME: and is not visible anywhere normally in Outlook. It is visible in the Contact Properties window under the "All Fields" when selecting "Frequently-used fields" from the "Select from:" drop-down box. It is also exported when exporting as a vCard.

ADR

ADR; is changed to ADR;POSTAL:

ADR; is copied to LABEL;POSTAL;ENCODING=QUOTED-PRINTABLE: with city/state/zip changed to use carriage return and comma seperation. IE:

ADR;CHARSET=utf-8:;;address1;city;state;zip;

is changed to:

ADR;POSTAL:;;address1;city;state;zip
LABEL;POSTAL;ENCODING=QUOTED-PRINTABLE:address1=0D=0Acity, state zip

N

When exporting a vCard, copies FN into N when N is blank. Does not do this when importing a vCard.

Outlook 2003 does not handle comma separation in the properties of N. For this vCard.

BEGIN:VCARD
FN;CHARSET=UTF-8:Mr. Dr. John Maurice Benjamin Doe Ph.D.\, J.D.
N;CHARSET=UTF-8:Doe;John;Maurice,Benjamin;Mr.,Dr.;Ph.D.,J.D.
END:VCARD

The result in Outlook is:

Mr.,Dr. Mr. Dr. John Maurice Benjamin Doe Ph.D.\, J.D.

TEL

Drops TEL if TYPE is not specified.

TEL;TYPE=work: is changed to TEL;WORK;VOICE:

GEO (lack of support)

GEO is dropped.

LOGO (lack of support)

Will not import or export vCard image references, but does support images internally in it's own contact management system.

Windows Address Book (WAB)

Version 6.00.X Win98 and Win XP Pro

vCard ENCODING

UTF-8 encoded vCard import prompts error as unrecognised vCard format. US ASCII 20127 encoded vCard successfully imported

ADR

If you do NOT specify TYPE=HOME,WORK,... then no address information is imported

TEL

If you do NOT specify TYPE=HOME,WORK,... then no address information is imported

PHOTO

Does not support Images

NOTE

According to the example in the RFC spec, all commas should be escaped, but WAB does not Un-escape them, leaving \, in the notes field.

Microsoft Entourage

On Mac OS X. Entourage versions 10 and 11.

general comments


Apple Address Book

On Mac OS X 10.3 (Panther) and 10.4 (Tiger).

general comments

organization vs. individual

Summary: FN==ORG organization semantic supported for both import and export.

For organization contact info, sets the FN and ORG to the name of the organization and N to empty on exported vCards.

Also treats imported vCards like that as organization contact info cards visibly in the UI.

geo (lack of support)

The GEO field is ignored on imported vCards. It is only saved as part of the NOTE.

source (lack of support)

The SOURCE property is not supported on imported vCards. It is only saved as part of the NOTE.

logo (lack of support)

The LOGO property is totally ignored and not even saved as part of the NOTE.

photo (limitations)

The PHOTO property can only take inline encoded data. URL values for are ignored.

url (limitations)

Only ONE URL property value is supported (whereas multiple *should* be supported, just like EMAIL).

adr (behaviour)

If you do NOT specify which type of address information it is (like HOME or WORK) it is assumed to be a WORK address.

categories (behaviour)

Behavior confirmed on versions:

Summary: Exports native "Groups" as vCard CATEGORIES. Ignores CATEGORIES field when importing a vCard.

The UI lets you create distinct "Groups" which you can then drag contacts into. Contacts can be in more than one group. Upon exporting a contact that is in one or more Groups, those Groups are listed in the CATEGORIES field.

However, when importing vCards, the CATEGORIES field is totally ignored by Address Book.

  1. It does not add vCards with a category that matches a current Group to that Group.
  2. It does not create new Groups for vCards with new categories.
  3. It does not even add the CATEGORIES to the end of the notes field.

Though presumably it SHOULD do #1 and #2. Would also be nice if it simply let you edit the groups/categories for a contact simply as a list of tags for that contact.

Evolution

On Linux.

geo (lack of support)

Nokia series 60 address book

Line endings

The Contacts application on Nokia series 60 handsets will only open vCards with Windows (\r\n) line endings. Any other line ending styles will cause an error message.

This is actually reasonable behaviour because the vCard spec explicitly states \r\n should be used, but many applications will accept \n delimited vCards without complaint, and may microformat services produce \n delimited output.

vcard-implementations was last modified: Wednesday, December 31st, 1969

Views