org.symbian.tools.wrttools.doc.WebDeveloper/html/GUID-92D152D3-E29A-4010-B5A0-9D37A0369A21.html
author Eugene Ostroukhov <eugeneo@symbian.org>
Tue, 11 May 2010 18:12:49 -0700
changeset 331 7e0aa6ca3db1
parent 229 716254ccbcc0
permissions -rw-r--r--
Removed 'beta' from the about screen


<!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>