vcard-implementations: Difference between revisions

From Microformats Wiki
Jump to navigation Jump to search
(Apple Address Book exports CATEGORIES but does not import)
m (a little cleanup.)
Line 1: Line 1:
= vCard implementations =
<h1> vCard implementations </h1>


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


== Contributors==
== Contributors==
Line 7: Line 9:
* Brian Suda
* Brian Suda


== Products ==
== Microsoft Outlook ==
 
=== Microsoft Outlook ===


version? platform?
version? platform?


==== URL handling ====
=== URL handling ===


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


==== ADR handling ====
=== ADR handling ===


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


=== Windows Address Book (WAB) ===
== Windows Address Book (WAB) ==
Version 6.00.X Win98 and Win XP Pro
Version 6.00.X Win98 and Win XP Pro


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


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


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


==== PHOTO ====
=== PHOTO ===
Does not support Images
Does not support Images


==== NOTE ====
=== 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.
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.


=== Apple Address Book ===
== Apple Address Book ==


On both OSX.3 and OSX.4
On both OSX.3 and OSX.4


==== organization vs. individual ====
=== organization vs. individual ===


Summary: FN==ORG organization semantic supported for both import and export.
Summary: FN==ORG organization semantic supported for both import and export.
Line 51: Line 51:
Also treats imported vCards like that as organization contact info cards visibly in the UI.
Also treats imported vCards like that as organization contact info cards visibly in the UI.


==== geo (lack of support) ====
=== geo (lack of support) ===


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


==== adr (behaviour) ====
=== 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.
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 ====
=== categories ===


Behavior confirmed on OSX.3 so far.
Behavior confirmed on OSX.3 so far.
Line 68: Line 68:


However, when importing vCards, the CATEGORIES field is totally ignored.
However, when importing vCards, the CATEGORIES field is totally ignored.
* It does not add vCards with a category that matches a current Group to that Group.
# It does not add vCards with a category that matches a current Group to that Group.
* It does not create new Groups for vCards with new categories.
# It does not create new Groups for vCards with new categories.
* IT does not even add the CATEGORIES to the end of the notes field.
# 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 ===
== Evolution ==


On Linux.
On Linux.


==== geo (lack of support) ====
=== geo (lack of support) ===


* ichigo, Frederic to fill in details
* ichigo, Frederic to fill in details

Revision as of 23:45, 11 February 2006

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.

Contributors

  • Tantek Çelik
  • Brian Suda

Microsoft Outlook

version? platform?

URL handling

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

ADR handling

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

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.

Apple Address Book

On both OSX.3 and OSX.4

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.

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

Behavior confirmed on OSX.3 so far.

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.

  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)

  • ichigo, Frederic to fill in details