diff -r 4d198a32ac7d -r d4809db37847 plugins/org.symbian.tools.wrttools.doc.WebDeveloper/html/GUID-92D152D3-E29A-4010-B5A0-9D37A0369A21.html --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/plugins/org.symbian.tools.wrttools.doc.WebDeveloper/html/GUID-92D152D3-E29A-4010-B5A0-9D37A0369A21.html Thu Aug 19 17:48:04 2010 -0700 @@ -0,0 +1,130 @@ + + +Criteria for +exporting a contact

Criteria for +exporting a contact

+

The criteria object specifies the contact +to export and optionally the source database.

+

The criteria object has two main properties: Type and Data. +These are described in the following table. Properties enclosed in brackets +are optional.

+

Note: All string values in the object are Unicode.

+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Table: Criteria object properties
+

Property

+
+

Description

+
+

Type

+
+

Value

+
+

criteria.Type

+
+

Specifies the type of contact information to export. This is always "Contact".

+
+

string

+
+

Possible values:

+
    +
  • "Contact"

  • +
+
+

criteria.Data

+
+

Specifies the contact to export.

+
+

object

+
+

Object with the properties specified below

+
+

[criteria.Data.DBUri]

+
+

Specifies the contacts database from which the contact is exported.

+

If this property is not specified, the default database is used.

+
+

string

+
 
+

criteria.Data.DestinationFile

+
+

Specifies the full path and file name of the target file to which the +contact is exported. The target file is created during the export and only +contains the exported contact.

+

Note:

    +
  • The target file will be in vCard format. For an example of +this format, see below.

  • +
  • The target file can have any file extension or no extension. +Typically, the extension is .vcf.

  • +
  • If the full path is not specified, the target file is created +in the private folder of the process.

  • +
+
+
+

string

+
+

The string cannot exceed 256 characters.

+
+

criteria.Data.id

+
+

Specifies the unique identifier of the contact to export.

+
+

string

+
 
+

vCard format example

+
BEGIN:VCARD
+VERSION:2.1
+N:Smith;John
+FN:John Smith
+ORG:Company Inc.
+TITLE:CEO
+TEL;WORK:VOICE:(555) 111-1111
+TEL;HOME;VOICE:(555) 222-2222
+ADR;WORK:;;Wall Street;New York City;NY;12345;United States of America
+LABEL;WORK;ENCODING=QUOTED-PRINTABLE:Wall Street=0D=0ANew York City, NY 12345=0D=0AUnited States of America
+ADR;HOME:;;Broadway;New York City;NY;12345;United States of America
+LABEL;HOME;ENCODING=QUOTED-PRINTABLE:Broadway=0D=0ANew York City, NY 12345=0D=0AUnited States of America
+EMAIL;PREF;INTERNET:john.smith@company.com
+REV:2008042T195243Z
+END:VCARD
+
+
\ No newline at end of file