Symbian3/PDK/Source/GUID-215528EA-E12E-590A-9C17-394F36F2C268.dita
author Dominic Pinkman <dominic.pinkman@nokia.com>
Fri, 13 Aug 2010 16:47:46 +0100
changeset 14 578be2adaf3e
parent 5 f345bda72bc4
permissions -rw-r--r--
Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
14
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
     1
<?xml version="1.0" encoding="utf-8"?>
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
     2
<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
     3
<!-- This component and the accompanying materials are made available under the terms of the License 
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
     4
"Eclipse Public License v1.0" which accompanies this distribution, 
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
     5
and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
     6
<!-- Initial Contributors:
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
     7
    Nokia Corporation - initial contribution.
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
     8
Contributors: 
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
     9
-->
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    10
<!DOCTYPE concept
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    11
  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    12
<concept xml:lang="en" id="GUID-215528EA-E12E-590A-9C17-394F36F2C268"><title>Data Compatibility</title><prolog><metadata><keywords/></metadata></prolog><conbody><section id="GUID-73C845B7-DB6F-5298-90AF-952639947140"><title>Database File Format</title> <p>The database file format is unchanged from previous versions of the Contacts Model. </p> </section> <section id="GUID-05D5048D-9524-5F6E-8303-14DEBCF6D43C"><title>Database Files Stored on Removable Media</title> <p>Databases stored on removable media using a device with the previous version of the Contacts Model are not accessible by a device using the new version of the Contacts Model. Similarly, databases stored on removable media using devices with the new version of the Contacts Model are not accessible by a device using the previous version. </p> </section> <section id="GUID-216963ED-C45E-58CF-BF96-3AF2DA252F8A"><title>Database Restore</title> <p>Databases restored from a backup made using a device with the previous version of the Contacts Model are not accessible by a device using the new version of the Contacts Model. Similarly, databases restored from a backup using a device with the new version of the Contacts Model are not accessible by a device using the previous version. </p> </section> <section id="GUID-AB126CBE-4399-5F1D-8117-C651BE3943AE"><title>Database File Locations</title> <p>The previous version of the Contacts Model stored database files in the secure DBMS directory: </p> <p> <i>c:\private\100012a5\DBS_100065FF_</i> <i>&lt;dbname&gt;.cdb</i>  </p> <p>This directory is no longer used since the new Contacts Model does not use the secure DBMS directory. The new version of the Contacts Model stores database files in: </p> <p> <i>c:\private\10003a73\&lt;dbname&gt;.cdb</i>  </p> </section> <section id="GUID-EFEB0C77-1256-5FCC-9913-C55715034D24"><title>Backup Registration Files</title> <p>Backup registration files remain in the <i>C:\private\10003a73</i> directory. </p> <p>In the previous version of the Contacts Model there was one pre-created file for backup/restore of the initialisation file and contacts databases: </p> <codeblock id="GUID-C24C1FA1-5058-5BAA-AC5C-14FA2A041EE5" xml:space="preserve">&lt;?xml version="1.0" standalone="yes"?&gt;
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    13
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    14
&lt;!--
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    15
    Copyright (c) Symbian Software Ltd 2004-2005. All Rights Reserved
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    16
--&gt;
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    17
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    18
&lt;backup_registration&gt;
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    19
 &lt;passive_backup base_backup_only="yes"&gt;
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    20
  &lt;include_file name = "cntmodel.ini"/&gt;
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    21
 &lt;/passive_backup&gt;
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    22
 &lt;dbms_backup database="contacts.cdb" policy="100065FF"/&gt;
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    23
&lt;/backup_registration&gt;</codeblock> <p>A separate backup registration file was created at run time for each additional contacts database, for example: </p> <codeblock id="GUID-FC6E03FD-0CED-56AA-BA3C-44B8E667BD5F" xml:space="preserve">&lt;backup_registration&gt;
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    24
 &lt;dbms_backup database="anotherdb.cdb" policy="100065FF"/&gt;
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    25
&lt;/backup_registration&gt;</codeblock> <p>In the new Contacts Model there is a separate file automatically generated for each data file (initialisation file and each contacts database, including the default database). </p> <p>For example, the backup registration file (<i>backup_registration_CntModel_ini.xml</i>) for the initialisation file would have the following contents: </p> <codeblock id="GUID-8129FCD8-91A4-5C22-87D6-0F8A7E5AF91F" xml:space="preserve">&lt;?xml version="1.0" standalone="yes"?&gt;
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    26
&lt;backup_registration&gt;
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    27
 &lt;passive_backup base_backup_only="yes"&gt;
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    28
  &lt;include_file name="CntModel.ini"/&gt;
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    29
 &lt;/passive_backup&gt;
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    30
&lt;/backup_registration&gt;</codeblock> <p>The backup registration file (<i>backup_registration_default_cdb.xml</i>) for the default database <i>default.cdb</i> would have the following contents: </p> <codeblock id="GUID-45E0868D-5E42-5077-84B4-C08D28CC436C" xml:space="preserve">&lt;?xml version="1.0" standalone="yes"?&gt;
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    31
&lt;backup_registration&gt;
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    32
    &lt;passive_backup base_backup_only="yes"&gt; 
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    33
  &lt;include_file      name="default.cdb"/&gt; 
578be2adaf3e Week 32 contribution of PDK documentation content. See release notes for details. Fixes bug Bug 3582
Dominic Pinkman <dominic.pinkman@nokia.com>
parents: 5
diff changeset
    34
 &lt;/passive_backup&gt;
1
25a17d01db0c Addition of the PDK content and example code for Documentation_content according to Feature bug 1607 and bug 1608
Dominic Pinkman <Dominic.Pinkman@Nokia.com>
parents:
diff changeset
    35
&lt;/backup_registration&gt;</codeblock> <p>Note that there is no reference to DBMS in the new file since we do not use the secure DBMS directory in the new Contacts Model. </p> </section> </conbody></concept>