Symbian3/PDK/Source/GUID-7514DD31-E82B-49FD-916F-A9DF12D97204.dita
changeset 1 25a17d01db0c
child 3 46218c8b8afa
equal deleted inserted replaced
0:89d6a7a84779 1:25a17d01db0c
       
     1 <?xml version="1.0" encoding="utf-8"?>
       
     2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
       
     3 <!-- This component and the accompanying materials are made available under the terms of the License 
       
     4 "Eclipse Public License v1.0" which accompanies this distribution, 
       
     5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
       
     6 <!-- Initial Contributors:
       
     7     Nokia Corporation - initial contribution.
       
     8 Contributors: 
       
     9 -->
       
    10 <!DOCTYPE concept
       
    11   PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
       
    12 <concept id="GUID-7514DD31-E82B-49FD-916F-A9DF12D97204" xml:lang="en"><title>URI
       
    13 List pre-configuration DTD</title><prolog><metadata><keywords/></metadata></prolog><conbody>
       
    14 <p>The DTD of URI List pre-configuration and a description of each element
       
    15 is given below. </p>
       
    16 <codeblock id="GUID-67F71BCC-0F66-54C9-AFB1-D3107A0D5751" xml:space="preserve">&lt;!--
       
    17 Uri List pre-configuration Document Type Definition.
       
    18 
       
    19 Copyright Symbian Software Pvt Ltd 2007. All rights reserved.  
       
    20 --&gt;
       
    21 
       
    22 &lt;?xml version="1.0" encoding="UTF-8" ?&gt;
       
    23 &lt;!ELEMENT URIList (WAPPush, Browser, PushEMail, DevPro)&gt; 
       
    24 &lt;!ELEMENT WAPPush (Whitelist, Blacklist)&gt;
       
    25 &lt;!ELEMENT Browser (Whitelist, Blacklist)&gt;
       
    26 &lt;!ELEMENT PushEMail (Whitelist, Blacklist)&gt;
       
    27 &lt;!ELEMENT DevPro (Whitelist, Blacklist)&gt;
       
    28 &lt;!ELEMENT Whitelist (Record)&gt;
       
    29 &lt;!ELEMENT Blacklist (Record)&gt;
       
    30 &lt;!ELEMENT Record ( Uri, Permission, FavouriteName)&gt;
       
    31 &lt;!ELEMENT Uri (#PCDATA)&gt;
       
    32 &lt;!ELEMENT Permission (#PCDATA)&gt;
       
    33 &lt;!ELEMENT FavouriteName (#PCDATA)&gt;
       
    34 </codeblock>
       
    35 <section id="GUID-9C0AF039-8B09-4CCA-8D49-80710F86801A"><title>ELEMENT &lt;URIList&gt;</title><table rowheader="firstcol" id="GUID-D5A47A13-9D5A-41E4-BFAA-92183DE99D48">
       
    36 <tgroup cols="2"><colspec colname="col1" colwidth="0.50*"/><colspec colname="col2" colwidth="1.50*"/>
       
    37 <tbody>
       
    38 <row>
       
    39 <entry><p>Element</p> </entry>
       
    40 <entry><p>&lt;!ELEMENT URIList (WapPush, Browser, PushEMail, DevPro)&gt;</p></entry>
       
    41 </row>
       
    42 <row>
       
    43 <entry><p>Semantics</p> </entry>
       
    44 <entry><p>&lt;URIList&gt; is the root element. It should contain at least one
       
    45 of &lt;WapPush&gt;, &lt;Browser&gt;, &lt;PushEMail&gt;, or &lt;DevPro&gt; elements mandatorily.</p></entry>
       
    46 </row>
       
    47 </tbody>
       
    48 </tgroup>
       
    49 </table></section>
       
    50 <section id="GUID-648CEFB8-1C62-4F51-A3E0-BC224D350825"><title>ELEMENT &lt;WapPush&gt;</title><table rowheader="firstcol" id="GUID-87911539-2AD8-40A9-88D8-2C217F4AB5A1">
       
    51 <tgroup cols="2"><colspec colname="col1" colwidth="0.50*"/><colspec colname="col2" colwidth="1.50*"/>
       
    52 <tbody>
       
    53 <row>
       
    54 <entry><p>Element</p> </entry>
       
    55 <entry><p>&lt;!ELEMENT WAPPush (Whitelist, Blacklist)&gt;</p></entry>
       
    56 </row>
       
    57 <row>
       
    58 <entry><p>Semantics</p> </entry>
       
    59 <entry><p>&lt;WapPush&gt; element indicates that the URIs being pre-configured
       
    60 are of WapPush service type. It should contain at least one of &lt;EBlackList&gt;
       
    61 or &lt;EWhiteList&gt; elements mandatorily.</p></entry>
       
    62 </row>
       
    63 </tbody>
       
    64 </tgroup>
       
    65 </table></section>
       
    66 <section id="GUID-BA3FB267-439E-4A7F-966D-FAAC2299194E"><title>ELEMENT &lt;Browser&gt;</title><table rowheader="firstcol" id="GUID-7C092F82-1F6D-4A21-9C5F-D083601BF6AB">
       
    67 <tgroup cols="2"><colspec colname="col1" colwidth="0.50*"/><colspec colname="col2" colwidth="1.50*"/>
       
    68 <tbody>
       
    69 <row>
       
    70 <entry><p>Element</p> </entry>
       
    71 <entry><p>&lt;!ELEMENT Browser (Whitelist, Blacklist)&gt; </p></entry>
       
    72 </row>
       
    73 <row>
       
    74 <entry><p>Semantics</p> </entry>
       
    75 <entry><p>&lt;Browser&gt; element indicates that the URIs being pre-configured
       
    76 are of Browser service type. It should contain at least one of &lt;EBlackList&gt;
       
    77 or &lt;EWhiteList&gt; elements mandatorily.</p></entry>
       
    78 </row>
       
    79 </tbody>
       
    80 </tgroup>
       
    81 </table></section>
       
    82 <section id="GUID-CA49F5F8-E3A0-473A-82C2-0DEF77CA69DF"><title>ELEMENT &lt;PushEMail&gt;</title><table rowheader="firstcol" id="GUID-8EBDE89A-23EB-43E2-84CF-72ED3AF44E77">
       
    83 <tgroup cols="2"><colspec colname="col1" colwidth="0.50*"/><colspec colname="col2" colwidth="1.50*"/>
       
    84 <tbody>
       
    85 <row>
       
    86 <entry><p>Element</p> </entry>
       
    87 <entry><p>&lt;!ELEMENT PushEMail (Whitelist, Blacklist)&gt; </p></entry>
       
    88 </row>
       
    89 <row>
       
    90 <entry><p>Semantics</p> </entry>
       
    91 <entry><p>&lt;PushEMail&gt; element indicates that the URIs being pre-configured
       
    92 are of PushEMail service type. It should contain at least one of &lt;EBlackList&gt;
       
    93 or &lt;EWhiteList&gt; elements mandatorily.</p></entry>
       
    94 </row>
       
    95 </tbody>
       
    96 </tgroup>
       
    97 </table></section>
       
    98 <section id="GUID-9991C922-7241-4943-AC17-CD0DA493F203"><title>ELEMENT &lt;DevPro&gt;</title><table rowheader="firstcol" id="GUID-545CEFEE-5517-4276-96A3-0F2B56975897">
       
    99 <tgroup cols="2"><colspec colname="col1" colwidth="0.50*"/><colspec colname="col2" colwidth="1.50*"/>
       
   100 <tbody>
       
   101 <row>
       
   102 <entry><p>Element</p> </entry>
       
   103 <entry><p>&lt;!ELEMENT DevPro (Whitelist, Blacklist)&gt; </p></entry>
       
   104 </row>
       
   105 <row>
       
   106 <entry><p>Semantics</p> </entry>
       
   107 <entry><p>&lt;DevPro&gt; element indicates that the URIs being pre-configured
       
   108 are of DeviceProvisioning service type. It should contain at least one of
       
   109 &lt;EBlackList&gt; or &lt;EWhiteList&gt; elements mandatorily.</p></entry>
       
   110 </row>
       
   111 </tbody>
       
   112 </tgroup>
       
   113 </table></section>
       
   114 <section id="GUID-22CF6040-C3DE-4FE0-AA6B-72034935B404"><title>ELEMENT &lt;Whitelist&gt;</title><table rowheader="firstcol" id="GUID-68B7C3B8-2A10-4035-816B-EB931083B4B1">
       
   115 <tgroup cols="2"><colspec colname="col1" colwidth="0.50*"/><colspec colname="col2" colwidth="1.50*"/>
       
   116 <tbody>
       
   117 <row>
       
   118 <entry><p>Element</p> </entry>
       
   119 <entry><p>&lt;!ELEMENT Whitelist (Record)&gt; </p></entry>
       
   120 </row>
       
   121 <row>
       
   122 <entry><p>Semantics</p> </entry>
       
   123 <entry><p>&lt;Whitelist&gt; element indicates that the URIs being pre-configured
       
   124 should be whitelisted. It should contain at least one &lt;Record&gt; element
       
   125 mandatorily.</p></entry>
       
   126 </row>
       
   127 </tbody>
       
   128 </tgroup>
       
   129 </table></section>
       
   130 <section id="GUID-CEB0D4F4-E473-4A94-96D0-C6B3EB80B0FE"><title>ELEMENT &lt;Blacklist&gt;</title><table rowheader="firstcol" id="GUID-E23EE882-AC43-49F1-AA24-F218313843D6">
       
   131 <tgroup cols="2"><colspec colname="col1" colwidth="0.50*"/><colspec colname="col2" colwidth="1.50*"/>
       
   132 <tbody>
       
   133 <row>
       
   134 <entry><p>Element</p> </entry>
       
   135 <entry><p>&lt;!ELEMENT Blacklist (Record)&gt; </p></entry>
       
   136 </row>
       
   137 <row>
       
   138 <entry><p>Semantics</p> </entry>
       
   139 <entry><p>&lt;Blacklist&gt; element indicates that the URIs being pre-configured
       
   140 should be blacklisted. It should contain at least one &lt;Record&gt; element
       
   141 mandatorily.</p></entry>
       
   142 </row>
       
   143 </tbody>
       
   144 </tgroup>
       
   145 </table></section>
       
   146 <section id="GUID-6121F640-4C83-45F3-8BB9-C76B5FFAEB54"><title>ELEMENT &lt;record&gt;</title><table rowheader="firstcol" id="GUID-B78160E0-D214-4FD0-9265-80F10074A3B0">
       
   147 <tgroup cols="2"><colspec colname="col1" colwidth="0.50*"/><colspec colname="col2" colwidth="1.50*"/>
       
   148 <tbody>
       
   149 <row>
       
   150 <entry><p>Element</p> </entry>
       
   151 <entry><p>&lt;!ELEMENT Record ( Uri, Permission, FavouriteName)&gt; </p></entry>
       
   152 </row>
       
   153 <row>
       
   154 <entry><p>Semantics</p> </entry>
       
   155 <entry><p>&lt;Record&gt; element contains the URI and its properties. It should
       
   156 contain mandatory element &lt;Uri&gt; and can optionally contain &lt;Permission&gt;
       
   157 and &lt;favouriteName&gt; elements. For each URI to be added to the URI List,
       
   158 one &lt;Record&gt; element should be created.</p></entry>
       
   159 </row>
       
   160 </tbody>
       
   161 </tgroup>
       
   162 </table></section>
       
   163 <section id="GUID-CDCEBB07-0606-45A3-B910-422FF3DEDB39"><title>ELEMENT &lt;Uri&gt;</title><table rowheader="firstcol" id="GUID-D4C291FB-068C-4CEF-BA34-82F4CD84F38F">
       
   164 <tgroup cols="2"><colspec colname="col1" colwidth="0.50*"/><colspec colname="col2" colwidth="1.50*"/>
       
   165 <tbody>
       
   166 <row>
       
   167 <entry><p>Element</p> </entry>
       
   168 <entry><p>&lt;!ELEMENT Uri (#PCDATA)&gt; </p></entry>
       
   169 </row>
       
   170 <row>
       
   171 <entry><p>Semantics</p> </entry>
       
   172 <entry><p>&lt;Uri&gt; specifies the URI to be added to URI List. This should
       
   173 not be null. The URI format should be compliant with RFC 3986.</p></entry>
       
   174 </row>
       
   175 </tbody>
       
   176 </tgroup>
       
   177 </table></section>
       
   178 <section id="GUID-A780D581-EE24-4218-841D-5F145C98113F"><title>ELEMENT &lt;Permission&gt;</title><table rowheader="firstcol" id="GUID-0893651F-0506-434F-BAA1-0CAFC8D077BC">
       
   179 <tgroup cols="2"><colspec colname="col1" colwidth="0.50*"/><colspec colname="col2" colwidth="1.50*"/>
       
   180 <tbody>
       
   181 <row>
       
   182 <entry><p>Element</p> </entry>
       
   183 <entry><p>&lt;!ELEMENT Permission (#PCDATA)&gt; </p></entry>
       
   184 </row>
       
   185 <row>
       
   186 <entry><p>Semantics</p> </entry>
       
   187 <entry><p>&lt;Permission&gt; specifies the access level of Uri. It should be
       
   188 set to either “EReadOnly” or “EReadWrite”. The read-only URIs cannot be deleted
       
   189 or modified. If not specified by default, the access level of Uri is set to
       
   190 “EReadWrite” .</p></entry>
       
   191 </row>
       
   192 </tbody>
       
   193 </tgroup>
       
   194 </table></section>
       
   195 <section id="GUID-F42A70DA-DF9E-491D-BD20-BA43175F979C"><title>ELEMENT &lt;FavouriteName&gt;</title><table rowheader="firstcol" id="GUID-481448D7-38A4-41DB-A81A-29EBEE408632">
       
   196 <tgroup cols="2"><colspec colname="col1" colwidth="0.50*"/><colspec colname="col2" colwidth="1.50*"/>
       
   197 <tbody>
       
   198 <row>
       
   199 <entry><p>Element</p> </entry>
       
   200 <entry><p>&lt;!ELEMENT FavouriteName (#PCDATA)&gt; </p></entry>
       
   201 </row>
       
   202 <row>
       
   203 <entry><p>Semantics</p> </entry>
       
   204 <entry><p>&lt;FavouriteName&gt; specifies the URI’s favourite name to be added
       
   205 to the URI List. This is an optional element.</p></entry>
       
   206 </row>
       
   207 </tbody>
       
   208 </tgroup>
       
   209 </table></section>
       
   210 </conbody></concept>