org.symbian.tools.wrttools.doc.WebDeveloper/html/GUID-92D152D3-E29A-4010-B5A0-9D37A0369A21.html
author tasneems@symbian.org
Fri, 05 Mar 2010 19:11:15 -0800
changeset 229 716254ccbcc0
permissions -rw-r--r--
Fixed 2046: WRTKit help topics. Fixed 2170: Added support for Web Developer Library. Fixed 1952: Event Trigger icons unreadable


<!DOCTYPE html
  PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"/><meta name="copyright" content="(C) Copyright 2009"/><meta name="DC.rights.owner" content="(C) Copyright 2009"/><meta name="DC.Type" content="mobileconcept"/><meta name="DC.Title" content="Criteria for exporting a contact"/><meta name="DC.Relation" scheme="URI" content="GUID-7C69DDA4-16F1-4A8F-BDB2-4CB0015B4E81"/><meta name="DC.Relation" scheme="URI" content="GUID-65AAF569-D347-462B-B59A-9D7CA184AB9C"/><meta name="DC.Relation" scheme="URI" content="GUID-A5853293-7B83-4CCE-9C29-B2B8F0CD8A18"/><meta name="DC.Relation" scheme="URI" content="GUID-CA7C3A7B-6733-47E0-9C6F-FBFB0993F034"/><meta name="DC.Format" content="XHTML"/><meta name="DC.Identifier" content="GUID-92D152D3-E29A-4010-B5A0-9D37A0369A21"/><title>Criteria for
exporting a contact </title><script type="text/javascript">
      function initPage() {}
    </script><link href="../PRODUCT_PLUGIN/book.css" rel="stylesheet" type="text/css"/><link href="css/s60/style.css" rel="stylesheet" type="text/css" media="all"/></head><body onload="initPage();"><div class="body"><div class="contentLeft prTxt"><h1 class="pageHeading" id="GUID-92D152D3-E29A-4010-B5A0-9D37A0369A21"><span>Criteria</span> for
exporting a contact</h1><div>
<p>The <code>criteria</code> object specifies the contact
to export and optionally the source database.</p>
<p>The <code>criteria</code> object has two main properties: <code>Type</code> and <code>Data</code>.
These are described in the following table. Properties enclosed in brackets
are optional.</p>
<div class="note"><p><strong class="note_title">Note: </strong>All string values in the object are Unicode.</p>
</div>
<div class="tablenoborder"><a name="GUID-27D13E3F-7AF6-485F-ABE7-0B385A55B0CD"><!----></a><table cellpadding="4" cellspacing="0" summary="" id="GUID-27D13E3F-7AF6-485F-ABE7-0B385A55B0CD" frame="border" border="1" rules="all"><caption><strong>Table: </strong><span>Criteria</span> object properties</caption>

<thead align="left">
<tr class="title "><th class="cellrowborder" valign="top" width="25%" id="d0e33906">
<p>Property</p>
</th><th class="cellrowborder" valign="top" width="25%" id="d0e33911">
<p>Description</p>
</th><th class="cellrowborder" valign="top" width="25%" id="d0e33916">
<p>Type</p>
</th><th class="cellrowborder" valign="top" width="25%" id="d0e33921">
<p>Value</p>
</th></tr>
</thead>
<tbody>
<tr class="">
<td class="cellrowborder" valign="top" width="25%" headers="d0e33906 ">
<p><code>criteria.Type</code></p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="d0e33911 ">
<p>Specifies the type of contact information to export. This is always <code>"Contact"</code>.</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="d0e33916 ">
<p>string</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="d0e33921 ">
<p>Possible values:</p>
<ul>
<li><p><code>"Contact"</code></p></li>
</ul>
</td>
</tr>
<tr class="bg ">
<td class="cellrowborder" valign="top" width="25%" headers="d0e33906 ">
<p><code>criteria.Data</code></p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="d0e33911 ">
<p>Specifies the contact to export.</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="d0e33916 ">
<p>object</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="d0e33921 ">
<p>Object with the properties specified below</p>
</td>
</tr>
<tr class="">
<td class="cellrowborder" valign="top" width="25%" headers="d0e33906 ">
<p><code>[criteria.Data.DBUri]</code></p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="d0e33911 ">
<p>Specifies the contacts database from which the contact is exported.</p>
<p>If this property is not specified, the default database is used.</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="d0e33916 ">
<p>string</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="d0e33921 ">&nbsp;</td>
</tr>
<tr class="bg ">
<td class="cellrowborder" valign="top" width="25%" headers="d0e33906 ">
<p><code>criteria.Data.DestinationFile</code></p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="d0e33911 ">
<p>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.</p>
<div class="note"><p><strong class="note_title">Note: </strong></p><ul>
<li><p>The target file will be in vCard format. For an example of
this format, see below.</p></li>
<li><p>The target file can have any file extension or no extension.
Typically, the extension is <code>.vcf</code>.</p></li>
<li><p>If the full path is not specified, the target file is created
in the private folder of the process.</p></li>
</ul>
</div>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="d0e33916 ">
<p>string</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="d0e33921 ">
<p>The string cannot exceed 256 characters.</p>
</td>
</tr>
<tr class="">
<td class="cellrowborder" valign="top" width="25%" headers="d0e33906 ">
<p><code>criteria.Data.id</code></p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="d0e33911 ">
<p>Specifies the unique identifier of the contact to export.</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="d0e33916 ">
<p>string</p>
</td>
<td class="cellrowborder" valign="top" width="25%" headers="d0e33921 ">&nbsp;</td>
</tr>
</tbody>
</table></div>
<div><h3>vCard format example</h3>
<pre class="codeblock" id="GUID-86CAC11C-B873-492A-BF2F-21A65987EBF9">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</pre>
</div>
</div></div></div><div class="footer"><hr/><div class="copy">© Nokia 2009.</div></div></body></html>