UIDs that Identify vCard Properties

Introduction

These tables list the UIDs that Symbian uses to identify vCard properties and property parameters. The mapping between vCard properties and Symbian-specific constants is done by the cntvcard component (cntvcard.dll).

The first column describes the properties and the second lists the property names as they appear in a vCard. The third and fourth columns list the corresponding Symbian UIDs. The combination of one or more field type UIDs and an optional mapping UID uniquely identify each property. Field type and vCard mapping UIDs are defined in cntdef.h.

Properties and UIDs

Description	vCard property	Field type UID	Mapping UID
PO Box	`ADR:` / Post Office Address	`KUidContactFieldPostOffice`	`KUidContactFieldVCardMapPOSTOFFICE`
Extended address	`ADR:`	`KUidContactFieldExtendedAddress`	`KUidContactFieldVCardMapEXTENDEDADR`
Street	`ADR:`	`KUidContactFieldAddress`	`KUidContactFieldVCardMapADR`
City	`ADR:`	`KUidContactFieldLocality`	`KUidContactFieldVCardMapLOCALITY`
Region	`ADR:`	`KUidContactFieldRegion`	`KUidContactFieldVCardMapREGION`
Postcode	`ADR:`	`KUidContactFieldPostcode`	`KUidContactFieldVCardMapPOSTCODE`
Country	`ADR:`	`KUidContactFieldCountry`	`KUidContactFieldVCardMapCOUNTRY`
Agent	`AGENT:`	None	`KUidContactFieldVCardMapAGENT`
Birthday	`BDAY:`	`KUidContactFieldBirthday`	`KUidContactFieldVCardMapBDAY`
Email	`EMAIL;INTERNET:`	`KUidContactFieldEMail`	`KUidContactFieldVCardMapEMAILINTERNET`
Formatted name	`FN:`	None	`KUidContactFieldVCardMapUnusedFN`
Longitude and latitude	`GEO:`	None	`KUidContactFieldVCardMapGEO`
Public encryption key	`KEY:`	None	`KUidContactFieldVCardMapKEY`
Label	`LABEL:`	None	`KUidContactFieldVCardMapLABEL`
Company logo	`LOGO:`	`KUidContactFieldPicture`	`KUidContactFieldVCardMapLOGO`
Email software	`MAILER:`	None	`KUidContactFieldVCardMapMAILER`
Title	`N:`	`KUidContactFieldPrefixName`	`KUidContactFieldVCardMapUnusedN`
First name	`N:`	`KUidContactFieldGivenName`	`KUidContactFieldVCardMapUnusedN`
Middle name	`N:`	`KUidContactFieldAdditionalName`	`KUidContactFieldVCardMapUnusedN`
Last name	`N:`	`KUidContactFieldFamilyName`	`KUidContactFieldVCardMapUnusedN`
Suffix	`N:`	`KUidContactFieldSuffixName`	`KUidContactFieldVCardMapUnusedN`
Notes	`NOTE:`	`KUidContactFieldNote`	`KUidContactFieldVCardMapNOTE`
Company	`ORG:`	`KUidContactFieldCompanyName`	`KUidContactFieldVCardMapORG`
Photograph	`PHOTO:`	`KUidContactFieldPicture`	`KUidContactFieldVCardMapPHOTO`
Last Revision	`REV:`	n/a – not stored in a field. See `CContactItem::SetLastModified()`.	`KUidContactFieldVCardMapNotRequired`
Occupation	`ROLE:`	None	`KUidContactFieldVCardMapROLE`
Sound	`SOUND:`	None	`KUidContactFieldVCardMapSOUND`
Given name pronunciation	`SOUND;X-IRMC-N:`	`KUidContactFieldGivenNamePronunciation`	`KUidContactFieldVCardMapUnusedN`
Family name pronunciation	`SOUND;X-IRMC-N:`	`KUidContactFieldFamilyNamePronunciation`	`KUidContactFieldVCardMapUnusedN`
Company name pronunciation	`SOUND;X-IRMC-ORG:`	`KUidContactFieldCompanyNamePronunciation`	`KUidContactFieldVCardMapORGPronunciation`
Tel	`TEL:`	`KUidContactFieldPhoneNumber`	`KUidContactFieldVCardMapTEL`
Fax	`TEL;FAX:`	`KUidContactFieldFax KUidContactFieldVCardMapFAX`	`KUidContactFieldVCardMapTEL`
Job title	`TITLE:`	`KUidContactFieldJobTitle`	`KUidContactFieldVCardMapTITLE`
Unique Identifier	`UID:`	n/a – not stored in a field. See `CContactItem::SetUidStringL()`.	`KUidContactFieldVCardMapNotRequired`
Web page	`URL:`	`KUidContactFieldUrl`	`KUidContactFieldVCardMapURL`
Version support	`VERSION:`	n/a – not stored in a field.	`KUidContactFieldVCardMapNotRequired`
USIM second name (*)	`X-EPOCSECONDNAME:`	`KUidContactFieldSecondName`	`KUidContactFieldVCardMapSECONDNAME`
SIP address	`X-SIP:`	`KUidContactFieldSIPID`	`KUidContactFieldVCardMapSIPID`
Other vCard extension properties	`X-`	None	`KUidContactFieldVCardMapUnknownXDash`
Assistant name	X-ASSISTANT	KUidContactFieldAssistant	KUidContactFieldVCardMapAssistant
Assistant phone	X-ASSISTANTTEL	`KUidContactFieldPhoneNumber`	KUidContactFieldVCardMapAssistantTel
Anniversary	X-ANNIVERSARY	KUidContactFieldAnniversary	KUidContactFieldVCardMapAnniversary
Spouse	X-SPOUSE	KUidContactFieldSpouse	KUidContactFieldVCardMapSpouse
Children	X-CHILDREN	KUidContactFieldChildren	KUidContactFieldVCardMapChildren
Class	X-CLASS	KUidContactFieldClass	KUidContactFieldVCardMapClass
Department	X-DEPARTMENT	KUidContactFieldDepartmentName	KUidContactFieldVCardMapDepartment

(*) This field stores an additional representation of the contact's name, such as a nickname or a different representation. An example is a Japanese contact which has a Romanised name and an alternative representation using kanji (pictogram) characters.

Property Parameters and UIDs, Grouped by Property

ADR:

vCard property parameter	Field type UID
`HOME`	`KUidContactFieldVCardMapHOME`
`WORK`	`KUidContactFieldVCardMapWORK`
`PREF`	`KUidContactFieldVCardMapPREF`

EMAIL:

vCard property parameter	Field type UID
`HOME`	`KUidContactFieldVCardMapHOME`
`WORK`	`KUidContactFieldVCardMapWORK`
`CELL`	`KUidContactFieldVCardMapCELL`
`INTERNET (*)`	`KUidContactFieldVCardMapINTERNET`
`PREF`	`KUidContactFieldVCardMapPREF`

(*) If HOME, WORK and CELL are absent then INTERNET is inserted by default.

KEY:

vCard property parameter	Field type UID
`X509`	`KUidContactFieldVCardMapX509`
`PGP`	`KUidContactFieldVCardMapPGP`

LABEL:

vCard property parameter	Field type UID
`DOM`	`KUidContactFieldVCardMapDOM`
`HOME`	`KUidContactFieldVCardMapHOME`
`WORK`	`KUidContactFieldVCardMapWORK`
`PREF`	`KUidContactFieldVCardMapPREF`

PHOTO:/LOGO:

vCard property parameter	Field type UID
`GIF`	`KUidContactFieldVCardMapGIF`
`CGM`	`KUidContactFieldVCardMapCGM`
`WMF`	`KUidContactFieldVCardMapWMF`
`BMP`	`KUidContactFieldVCardMapBMP`
`DIB`	`KUidContactFieldVCardMapDIB`
`PS`	`KUidContactFieldVCardMapPS`
`PMB`	`KUidContactFieldVCardMapPMB`
`PDF`	`KUidContactFieldVCardMapPDF`
`PICT`	`KUidContactFieldVCardMapPICT`
`TIFF`	`KUidContactFieldVCardMapTIFF`
`JPEG`	`KUidContactFieldVCardMapJPEG`
`MET`	`KUidContactFieldVCardMapMET`
`MPEG`	`KUidContactFieldVCardMapMPEG`
`MPEG2`	`KUidContactFieldVCardMapMPEG2`
`AVI`	`KUidContactFieldVCardMapAVI`
`QTIME`	`KUidContactFieldVCardMapQTIME`

TEL:

vCard property parameter	Field type UID
`HOME`	`KUidContactFieldVCardMapHOME`
`WORK`	`KUidContactFieldVCardMapWORK`
`PREF`	`KUidContactFieldVCardMapPREF`
`VOICE`	`KUidContactFieldVCardMapVOICE`
`CELL`	`KUidContactFieldVCardMapCELL`
`PAGER`	`KUidContactFieldVCardMapPAGER`
`BBS`	`KUidContactFieldVCardMapBBS`
`MODEM`	`KUidContactFieldVCardMapMODEM`
`CAR`	`KUidContactFieldVCardMapCAR`
`ISDN`	`KUidContactFieldVCardMapISDN`
`VIDEO`	`KUidContactFieldVCardMapVIDEO`
`MSG`	`KUidContactFieldVCardMapMSG`
`FAX`	(*)

(*) Fax numbers are not stored using a telephone number field type (KUidContactFieldPhoneNumber), but a fax field type (KUidContactFieldFax; mapping=KUidContactFieldVCardMapFAX).

URL:

vCard property parameter	Field type UID
`HOME`	`KUidContactFieldVCardMapHOME`
`WORK`	`KUidContactFieldVCardMapWORK`

X-SIP:

vCard property parameter	Field type UID
`POC`	`KUidContactFieldVCardMapPOC`
`SWIS`	`KUidContactFieldVCardMapSWIS`
`VOIP`	`KUidContactFieldVCardMapVOIP`

Example

The following example demonstrates how a contact item (newCard) is created and assigned fields of different types using some of the UIDs listed in the tables above.

#include <cntitem.h>
#include <cntfield.h>
#include <cntfldst.h>
#include <cntdef.h>
#include <cntdef.hrh> 

// Create a contact card and add a work phone number. Numeric values are 
// stored in a text field (storage type = KStorageTypeText).

CContactCard* newCard = CContactCard::NewLC();
_LIT(KWorkNumber,"02071234567");
// First create the field to hold the phone number
CContactItemField* phonefield=CContactItemField::NewLC(KStorageTypeText); 
// Set the field types and mapping UIDs for a work phone number property
phonefield->AddFieldTypeL(KUidContactFieldPhoneNumber);
phonefield->AddFieldTypeL(KUidContactFieldVCardMapWORK); 
// Make it the preferred number
phonefield->AddFieldTypeL(KUidContactFieldVCardMapPREF);
phonefield->SetMapping(KUidContactFieldVCardMapTEL);
// Add the telephone number to the field and the field to the card
phonefield->TextStorage()->SetTextL(KWorkNumber);
newCard->AddFieldL(*phonefield); // newCard takes ownership
CleanupStack::Pop(); // phonefield

// Add a birthday property. Date property values are stored using "date/time" 
// fields (storage type=KStorageTypeDateTime).

CContactItemField* birthdayfield=CContactItemField::NewLC(KStorageTypeDateTime);
birthdayfield->AddFieldTypeL(KUidContactFieldBirthday);
birthdayfield->SetMapping(KUidContactFieldVCardMapBDAY);
// Set birthday - 10 Jan 1970
birthdayfield->DateTimeStorage()->SetTime(TDateTime(1970,EJanuary,9,0,0,0,0));
newCard->AddFieldL(*birthdayfield); // newCard takes ownership
CleanupStack::Pop(); // birthdayfield