Week 28 contribution of SDK documentation content. See release notes for details. Fixes bugs Bug 1897 and Bug 1522.
<?xml version="1.0" encoding="utf-8"?>
<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
<!-- This component and the accompanying materials are made available under the terms of the License
"Eclipse Public License v1.0" which accompanies this distribution,
and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
<!-- Initial Contributors:
Nokia Corporation - initial contribution.
Contributors:
-->
<!DOCTYPE concept
PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<concept id="GUID-7514DD31-E82B-49FD-916F-A9DF12D97204" xml:lang="en"><title>URI
List pre-configuration DTD</title><prolog><metadata><keywords/></metadata></prolog><conbody>
<p>The DTD of URI List pre-configuration and a description of each element
is given below. </p>
<codeblock id="GUID-67F71BCC-0F66-54C9-AFB1-D3107A0D5751" xml:space="preserve"><!--
Uri List pre-configuration Document Type Definition.
Copyright Symbian Software Pvt Ltd 2007. All rights reserved.
-->
<?xml version="1.0" encoding="UTF-8" ?>
<!ELEMENT URIList (WAPPush, Browser, PushEMail, DevPro)>
<!ELEMENT WAPPush (Whitelist, Blacklist)>
<!ELEMENT Browser (Whitelist, Blacklist)>
<!ELEMENT PushEMail (Whitelist, Blacklist)>
<!ELEMENT DevPro (Whitelist, Blacklist)>
<!ELEMENT Whitelist (Record)>
<!ELEMENT Blacklist (Record)>
<!ELEMENT Record ( Uri, Permission, FavouriteName)>
<!ELEMENT Uri (#PCDATA)>
<!ELEMENT Permission (#PCDATA)>
<!ELEMENT FavouriteName (#PCDATA)>
</codeblock>
<section id="GUID-9C0AF039-8B09-4CCA-8D49-80710F86801A"><title>ELEMENT <URIList></title><table rowheader="firstcol" id="GUID-D5A47A13-9D5A-41E4-BFAA-92183DE99D48">
<tgroup cols="2"><colspec colname="col1" colwidth="0.50*"/><colspec colname="col2" colwidth="1.50*"/>
<tbody>
<row>
<entry><p>Element</p> </entry>
<entry><p><!ELEMENT URIList (WapPush, Browser, PushEMail, DevPro)></p></entry>
</row>
<row>
<entry><p>Semantics</p> </entry>
<entry><p><URIList> is the root element. It should contain at least one
of <WapPush>, <Browser>, <PushEMail>, or <DevPro> elements mandatorily.</p></entry>
</row>
</tbody>
</tgroup>
</table></section>
<section id="GUID-648CEFB8-1C62-4F51-A3E0-BC224D350825"><title>ELEMENT <WapPush></title><table rowheader="firstcol" id="GUID-87911539-2AD8-40A9-88D8-2C217F4AB5A1">
<tgroup cols="2"><colspec colname="col1" colwidth="0.50*"/><colspec colname="col2" colwidth="1.50*"/>
<tbody>
<row>
<entry><p>Element</p> </entry>
<entry><p><!ELEMENT WAPPush (Whitelist, Blacklist)></p></entry>
</row>
<row>
<entry><p>Semantics</p> </entry>
<entry><p><WapPush> element indicates that the URIs being pre-configured
are of WapPush service type. It should contain at least one of <EBlackList>
or <EWhiteList> elements mandatorily.</p></entry>
</row>
</tbody>
</tgroup>
</table></section>
<section id="GUID-BA3FB267-439E-4A7F-966D-FAAC2299194E"><title>ELEMENT <Browser></title><table rowheader="firstcol" id="GUID-7C092F82-1F6D-4A21-9C5F-D083601BF6AB">
<tgroup cols="2"><colspec colname="col1" colwidth="0.50*"/><colspec colname="col2" colwidth="1.50*"/>
<tbody>
<row>
<entry><p>Element</p> </entry>
<entry><p><!ELEMENT Browser (Whitelist, Blacklist)> </p></entry>
</row>
<row>
<entry><p>Semantics</p> </entry>
<entry><p><Browser> element indicates that the URIs being pre-configured
are of Browser service type. It should contain at least one of <EBlackList>
or <EWhiteList> elements mandatorily.</p></entry>
</row>
</tbody>
</tgroup>
</table></section>
<section id="GUID-CA49F5F8-E3A0-473A-82C2-0DEF77CA69DF"><title>ELEMENT <PushEMail></title><table rowheader="firstcol" id="GUID-8EBDE89A-23EB-43E2-84CF-72ED3AF44E77">
<tgroup cols="2"><colspec colname="col1" colwidth="0.50*"/><colspec colname="col2" colwidth="1.50*"/>
<tbody>
<row>
<entry><p>Element</p> </entry>
<entry><p><!ELEMENT PushEMail (Whitelist, Blacklist)> </p></entry>
</row>
<row>
<entry><p>Semantics</p> </entry>
<entry><p><PushEMail> element indicates that the URIs being pre-configured
are of PushEMail service type. It should contain at least one of <EBlackList>
or <EWhiteList> elements mandatorily.</p></entry>
</row>
</tbody>
</tgroup>
</table></section>
<section id="GUID-9991C922-7241-4943-AC17-CD0DA493F203"><title>ELEMENT <DevPro></title><table rowheader="firstcol" id="GUID-545CEFEE-5517-4276-96A3-0F2B56975897">
<tgroup cols="2"><colspec colname="col1" colwidth="0.50*"/><colspec colname="col2" colwidth="1.50*"/>
<tbody>
<row>
<entry><p>Element</p> </entry>
<entry><p><!ELEMENT DevPro (Whitelist, Blacklist)> </p></entry>
</row>
<row>
<entry><p>Semantics</p> </entry>
<entry><p><DevPro> element indicates that the URIs being pre-configured
are of DeviceProvisioning service type. It should contain at least one of
<EBlackList> or <EWhiteList> elements mandatorily.</p></entry>
</row>
</tbody>
</tgroup>
</table></section>
<section id="GUID-22CF6040-C3DE-4FE0-AA6B-72034935B404"><title>ELEMENT <Whitelist></title><table rowheader="firstcol" id="GUID-68B7C3B8-2A10-4035-816B-EB931083B4B1">
<tgroup cols="2"><colspec colname="col1" colwidth="0.50*"/><colspec colname="col2" colwidth="1.50*"/>
<tbody>
<row>
<entry><p>Element</p> </entry>
<entry><p><!ELEMENT Whitelist (Record)> </p></entry>
</row>
<row>
<entry><p>Semantics</p> </entry>
<entry><p><Whitelist> element indicates that the URIs being pre-configured
should be whitelisted. It should contain at least one <Record> element
mandatorily.</p></entry>
</row>
</tbody>
</tgroup>
</table></section>
<section id="GUID-CEB0D4F4-E473-4A94-96D0-C6B3EB80B0FE"><title>ELEMENT <Blacklist></title><table rowheader="firstcol" id="GUID-E23EE882-AC43-49F1-AA24-F218313843D6">
<tgroup cols="2"><colspec colname="col1" colwidth="0.50*"/><colspec colname="col2" colwidth="1.50*"/>
<tbody>
<row>
<entry><p>Element</p> </entry>
<entry><p><!ELEMENT Blacklist (Record)> </p></entry>
</row>
<row>
<entry><p>Semantics</p> </entry>
<entry><p><Blacklist> element indicates that the URIs being pre-configured
should be blacklisted. It should contain at least one <Record> element
mandatorily.</p></entry>
</row>
</tbody>
</tgroup>
</table></section>
<section id="GUID-6121F640-4C83-45F3-8BB9-C76B5FFAEB54"><title>ELEMENT <record></title><table rowheader="firstcol" id="GUID-B78160E0-D214-4FD0-9265-80F10074A3B0">
<tgroup cols="2"><colspec colname="col1" colwidth="0.50*"/><colspec colname="col2" colwidth="1.50*"/>
<tbody>
<row>
<entry><p>Element</p> </entry>
<entry><p><!ELEMENT Record ( Uri, Permission, FavouriteName)> </p></entry>
</row>
<row>
<entry><p>Semantics</p> </entry>
<entry><p><Record> element contains the URI and its properties. It should
contain mandatory element <Uri> and can optionally contain <Permission>
and <favouriteName> elements. For each URI to be added to the URI List,
one <Record> element should be created.</p></entry>
</row>
</tbody>
</tgroup>
</table></section>
<section id="GUID-CDCEBB07-0606-45A3-B910-422FF3DEDB39"><title>ELEMENT <Uri></title><table rowheader="firstcol" id="GUID-D4C291FB-068C-4CEF-BA34-82F4CD84F38F">
<tgroup cols="2"><colspec colname="col1" colwidth="0.50*"/><colspec colname="col2" colwidth="1.50*"/>
<tbody>
<row>
<entry><p>Element</p> </entry>
<entry><p><!ELEMENT Uri (#PCDATA)> </p></entry>
</row>
<row>
<entry><p>Semantics</p> </entry>
<entry><p><Uri> specifies the URI to be added to URI List. This should
not be null. The URI format should be compliant with RFC 3986.</p></entry>
</row>
</tbody>
</tgroup>
</table></section>
<section id="GUID-A780D581-EE24-4218-841D-5F145C98113F"><title>ELEMENT <Permission></title><table rowheader="firstcol" id="GUID-0893651F-0506-434F-BAA1-0CAFC8D077BC">
<tgroup cols="2"><colspec colname="col1" colwidth="0.50*"/><colspec colname="col2" colwidth="1.50*"/>
<tbody>
<row>
<entry><p>Element</p> </entry>
<entry><p><!ELEMENT Permission (#PCDATA)> </p></entry>
</row>
<row>
<entry><p>Semantics</p> </entry>
<entry><p><Permission> specifies the access level of Uri. It should be
set to either “EReadOnly” or “EReadWrite”. The read-only URIs cannot be deleted
or modified. If not specified by default, the access level of Uri is set to
“EReadWrite” .</p></entry>
</row>
</tbody>
</tgroup>
</table></section>
<section id="GUID-F42A70DA-DF9E-491D-BD20-BA43175F979C"><title>ELEMENT <FavouriteName></title><table rowheader="firstcol" id="GUID-481448D7-38A4-41DB-A81A-29EBEE408632">
<tgroup cols="2"><colspec colname="col1" colwidth="0.50*"/><colspec colname="col2" colwidth="1.50*"/>
<tbody>
<row>
<entry><p>Element</p> </entry>
<entry><p><!ELEMENT FavouriteName (#PCDATA)> </p></entry>
</row>
<row>
<entry><p>Semantics</p> </entry>
<entry><p><FavouriteName> specifies the URI’s favourite name to be added
to the URI List. This is an optional element.</p></entry>
</row>
</tbody>
</tgroup>
</table></section>
</conbody></concept>