- From: Maria Angeles Oteo via cvs-syncmail <cvsmail@w3.org>
- Date: Wed, 05 Jan 2011 11:07:59 +0000
- To: public-dap-commits@w3.org
Update of /sources/public/2009/dap/messaging
In directory hutz:/tmp/cvs-serv26170
Modified Files:
Overview.html
Log Message:
Included changes suggested by Dom
Index: Overview.html
===================================================================
RCS file: /sources/public/2009/dap/messaging/Overview.html,v
retrieving revision 1.26
retrieving revision 1.27
diff -u -d -r1.26 -r1.27
--- Overview.html 30 Nov 2010 15:45:21 -0000 1.26
+++ Overview.html 5 Jan 2011 11:07:57 -0000 1.27
@@ -58,7 +58,7 @@
<p>
- This specification defines an API that provides access to messaging functionality in the device, including SMS, MMS and email.
+ This specification defines an API that provides access to messaging functionality in the device, including SMS, MMS and e-mail.
</p>
@@ -88,7 +88,7 @@
<p class='note'>
- Since not all devices will have all messaging functionality (e.g. a phone may have only SMS and MMS while a PC may have only email) there is a need to indicate that conformant implementations need only expose available functionality.
+ Since not all devices will have all messaging functionality (e.g. a phone may have only SMS and MMS while a PC may have only e-mail) there is a need to indicate that conformant implementations need only expose available functionality.
</p>
@@ -108,7 +108,7 @@
The Messaging API defines a high-level interface to Messaging functionality,
- including SMS, MMS and Email. It includes APIs to create and send messages.
+ including SMS, MMS and e-mail. It includes APIs to create and send messages.
</p>
@@ -164,7 +164,7 @@
<p>
- This specification is limited to providing a scripting API for creating and sending messages. The supported messaging types include SMS, MMS and Email.
+ This specification is limited to providing a scripting API for creating and sending messages. The supported messaging types include SMS, MMS and e-mail.
</p>
@@ -172,7 +172,7 @@
<p class='note'>
- The specification does not replace RFCs for Mail or SMS URLs. The specification includes complementary functionality to these.
+ The specification does not replace RFCs for Mail or SMS URLs but provides complementary functionality to these.
</p>
@@ -240,7 +240,7 @@
<p>
- The specification supports three kinds of messages: SMS, MMS and E-mail. For each of them specific interfaces and data types have been defined and they will be detailed in the following section. The table below summarizes the attributes that are supported for each given message type.
+ The specification supports three kinds of messages: SMS, MMS and e-mail. For each of them specific interfaces and data types have been defined and they will be detailed in the following section. The table below summarizes the attributes that are supported for each given message type.
</p>
@@ -254,7 +254,7 @@
<th>MMS</th>
- <th>Email</th>
+ <th>e-mail</th>
</tr>
@@ -272,36 +272,12 @@
<tr>
- <td><code>timestamp</code></td>
-
- <td>X</td>
-
- <td>X</td>
-
- <td>X</td>
-
- </tr>
-
- <tr>
-
- <td><code>folder</code></td>
-
- <td>X</td>
+ <td><code>sentTime</code></td>
<td>X</td>
<td>X</td>
- </tr>
-
- <tr>
-
- <td><code>account Id</code></td>
-
- <td>-</td>
-
- <td>-</td>
-
<td>X</td>
</tr>
@@ -502,7 +478,7 @@
<dd>
- The MMS properties may include the "to", "cc", "bcc", "subject", "body" and "attachments" attributes.
+ The MMS properties may include the "to", "subject", "body" and "attachments" attributes.
</dd>
@@ -526,7 +502,7 @@
<dd>
- The E-mail properties may include the "to", "cc", "bcc", "subject", "body", "accountId", "priority" and "attachments" attributes.
+ The e-mail properties may include the "to", "cc", "bcc", "subject", "body", "priority" and "attachments" attributes.
</dd>
@@ -549,7 +525,6 @@
</section>
-
<section>
<h2><a>SMSMessage</a></h2>
@@ -563,24 +538,15 @@
<dl title='[NoInterfaceObject] interface SMSMessage : SMSProperties' class='idl'>
-
- <dt> readonly attribute DOMString id </dt>
-
- <dd>
-
- System set read-only unique identifier to assign to the SMS by the platform.
-
- </dd>
-
<dt>
- readonly attribute Date timestamp
+ readonly attribute Date sentTime
</dt>
<dd>
- A readonly time stamp that detemines the time the SMS was received, sent or created.
+ A readonly time stamp that detemines the time the SMS was sent. By default it is undefined and will be initialized when the message is successfully sent.
</dd>
@@ -600,27 +566,13 @@
- <dt>
-
- readonly attribute DOMString folder
-
- </dt>
-
- <dd>
-
- A readonly folder indicating the place where the SMS is stored. Some possible values may be "inbox", "sent", "draft", "outbox" or "deleted".
-
- </dd>
-
-
-
<dt>PendingOp send ()</dt>
<dd>
- Asynchronous method to request sending an message. Upon a successful invocation the message is delivered to the nnetwork. The <code>pendingOp</code> returns object allows canceling the sending of the message.
+ Asynchronous method to request sending an SMS. Upon a successful invocation the message is delivered to the network. The <code>pendingOp</code> returns object allows canceling the sending of the message.
<dl class='parameters'>
@@ -678,23 +630,15 @@
- <dt> readonly attribute DOMString id </dt>
-
- <dd>
-
- System set read-only unique identifier to assign to the MMS by the platform.
-
- </dd>
-
<dt>
- readonly attribute Date timestamp
+ readonly attribute Date sentTime
</dt>
<dd>
- A readonly time stamp that detemines the time the MMS was received, sent or created.
+ A readonly time stamp that detemines the time the MMS was sent. By default it is undefined and will be initialized when the message is successfully sent.
</dd>
@@ -712,27 +656,14 @@
</dd>
- <dt>
-
- readonly attribute DOMString folder
-
- </dt>
-
- <dd>
-
- A readonly folder indicating the place where the MMS is stored. Some possible values may be "inbox", "sent", "draft", "outbox" or "deleted".
-
- </dd>
-
-
-
+
<dt>PendingOp send ()</dt>
<dd>
- Asynchronous method to request sending an message. Upon a successful invocation the message is delivered to the nnetwork. The <code>pendingOp</code> returns object allows canceling the sending of the message.
+ Asynchronous method to request sending an MMS. Upon a successful invocation the message is delivered to the network. The <code>pendingOp</code> returns object allows canceling the sending of the message.
<dl class='parameters'>
@@ -782,7 +713,7 @@
<p>
- This interface describes generic functionality of E-mail message.
+ This interface describes generic functionality of e-mail message.
</p>
@@ -790,53 +721,34 @@
- <dt> readonly attribute DOMString id </dt>
-
- <dd>
-
- System set read-only unique identifier to assign to the E-mail by the platform.
-
- </dd>
<dt>
- readonly attribute Date timestamp
+ readonly attribute Date sentTime
</dt>
<dd>
- A readonly time stamp that detemines the time the SMS was received, sent or created.
+ A readonly time stamp that determines the time the e-mail was sent. By default it is undefined and will be initialized when the message is successfully sent.
</dd>
<dt>
- readonly attribute DOMString from
+ readonly attribute EmailAddress from
</dt>
<dd>
- The address of the E-mail sender.
+ The address and name of the e-mail sender. In order to fill-in this attribute, different criteria MAY be used to select the e-mail account:
+ e.g. use a pre-defined default account, promt the user to select the account...
</dd>
- <dt>
-
- readonly attribute DOMString folder
-
- </dt>
-
- <dd>
-
- A readonly folder indicating the place where the Email is stored. Some possible values may be "inbox", "sent", "draft", "outbox" or "deleted".
-
- </dd>
-
-
@@ -844,7 +756,7 @@
<dd>
- Asynchronous method to request sending an message. Upon a successful invocation the message is delivered to the network.
+ Asynchronous method to request sending an e-mail. Upon a successful invocation the message is delivered to the network.
The <code>pendingOp</code> returns object allows cancelling the sending of the message.
<dl class='parameters'>
@@ -893,7 +805,7 @@
- <section>
+ <section>
<h2><a>SMSProperties</a></h2>
@@ -913,9 +825,7 @@
The set of addresses of the recipients. For SMS these are phone numbers.
- </dd>
-
-
+ </dd>
<dt>
@@ -929,10 +839,6 @@
</dd>
-
-
-
-
</dl>
</section>
@@ -1019,43 +925,43 @@
<p>
- This interface captures the data fields in an E-mail message. See <a href='#supported-messaging-types'>Supported Messaging Types</a> for the list of attributes that must be supported for E-mail type.
+ This interface captures the data fields in an e-mail message. See <a href='#supported-messaging-types'>Supported Messaging Types</a> for the list of attributes that must be supported for e-mail type.
</p>
<dl title='[NoInterfaceObject] interface EmailProperties' class='idl'>
- <dt> attribute DOMString[] to
+ <dt> attribute EmailAddress[] to
</dt>
<dd>
- The set of e-mail addresses of the recipients. E-mail addresses MUST use the format specified in [[!EMAIL]].
+ The set of e-mail addresses and names of the recipients.
</dd>
- <dt> attribute DOMString[] cc
+ <dt> attribute EmailAddress[] cc
</dt>
<dd>
- The set of cc (carbon copy) addresses of the recipients. E-mail addresses MUST use the format specified in [[!EMAIL]].
+ The set of cc (carbon copy) addresses and names of the recipients.
</dd>
- <dt> attribute DOMString[] bcc.
+ <dt> attribute EmailAddress[] bcc
</dt>
<dd>
- The set of bcc (blind carbon copy) addresses of the recipients. E-mail addresses MUST use the format specified in [[!EMAIL]].
+ The set of bcc (blind carbon copy) addresses and names of the recipients.
</dd>
@@ -1086,22 +992,7 @@
</dd>
-
- <dt>
-
- attribute DOMString accountId
-
- </dt>
-
- <dd>
-
- Indicates the e-mail account ID/name associated with the message.
-
- </dd>
-
-
-
- <dt>
+ <dt>
attribute DOMString priority
@@ -1134,11 +1025,48 @@
</section>
+ <section>
+
+ <h2><a>EmailAddress</a></h2>
+
+ <p>
+
+ This interface captures the data fields in an e-mail address.
+
+ </p>
+
+ <dl title='[NoInterfaceObject] interface EmailAddress' class='idl'>
+
+ <dt> attribute DOMString address
+
+ </dt>
+
+ <dd>
+
+ The e-mail address. It MUST be a <b>valid e-mail address</b> as defined in [[!HTML5]].
+
+ </dd>
+
+ <dt>
+
+ attribute DOMString name
+
+ </dt>
+
+ <dd>
+
+ The name associated to the "address". It is an optional attribute and by default it is undefined.
+
+ </dd>
+
+ </dl>
+
+ </section>
- <section>
+ <section>
<h2><a>MessagingSuccessCB</a></h2>
@@ -1226,7 +1154,7 @@
<section>
- <h2><a>MessagingError</a> interface</h2>
+ <h2><a>MessagingError</a></h2>
<p class="note">
@@ -1268,18 +1196,6 @@
<dt>
- const unsigned short NOT_FOUND_ERROR = 2
-
- </dt>
-
- <dd>
-
- If no response information can be provided from the requested method.
-
- </dd>
-
- <dt>
-
const unsigned short TIMEOUT_ERROR = 3
</dt>
@@ -1389,10 +1305,13 @@
<h3>ToDo</h3>
<ul>
+ <li>Message subscription and reading.</li>
+
+ <li>Message and folder management.</li>
- <li>Account management</li>
+ <li>E-mail account management.</li>
- <li>Notion of default accounts</li>
+ <li>Notion of default accounts.</li>
</ul>
Received on Wednesday, 5 January 2011 11:08:03 UTC