Skip to content
This repository was archived by the owner on Oct 2, 2019. It is now read-only.

Commit c4344ad

Browse files
author
Eduardo Fullea
committed
MMS read report procedures
1 parent 326d1a0 commit c4344ad

File tree

1 file changed

+101
-18
lines changed

1 file changed

+101
-18
lines changed

index.html

Lines changed: 101 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -557,9 +557,9 @@ <h2><a>SmsManager</a> Interface</h2>
557557
report is received on this messaging service manager.</dd>
558558

559559
<dt class="no-docs">
560-
attribute EventHandler ondeliveryfailure
560+
attribute EventHandler ondeliveryerror
561561
</dt>
562-
<dd>Handles the <code>deliveryfailure</code> event of type
562+
<dd>Handles the <code>deliveryerror</code> event of type
563563
<a>DeliveryReportEvent</a>, fired when a new failure delivery
564564
report is received on this messaging service manager.</dd>
565565

@@ -722,7 +722,7 @@ <h3>Steps</h3>
722722
DT) parameter included in the SMS-STATUS-REPORT Protocol Data Unit
723723
[[!GSM-SMS]].
724724
<li><a>Queue a task</a> to <a>fire an event</a> named
725-
<a>deliverysuccess</a> or <a>deliveryfailure</a> respectively if the
725+
<a>deliverysuccess</a> or <a>deliveryerror</a> respectively if the
726726
delivery was successfull or not, with
727727
<ol>
728728
<li>the <code>messageID</code> attribute set to the
@@ -736,7 +736,7 @@ <h3>Steps</h3>
736736
</ol>
737737
<li><a>Queue a task</a> to fire a system message of type
738738
<code><a>DeliveryReport</a></code>named <a>deliverysuccess</a> or
739-
<a>deliveryfailure</a> respectively if the delivery was successfull or
739+
<a>deliveryerror</a> respectively if the delivery was successfull or
740740
not, with
741741
<ol>
742742
<li>the <code>messageID</code> attribute set to the
@@ -809,8 +809,8 @@ <h2>Event handlers</h2>
809809
<td>handles successful delivery reports</td>
810810
</tr>
811811
<tr>
812-
<td><strong><code>ondeliveryfailure</code></strong></td>
813-
<td><code><dfn>deliveryfailure</dfn></code></td>
812+
<td><strong><code>ondeliveryerror</code></strong></td>
813+
<td><code><dfn>deliveryerror</dfn></code></td>
814814
<td><a><code>DeliveryReportEvent</code></a></td>
815815
<td>handles failure delivery reports</td>
816816
</tr>
@@ -976,12 +976,26 @@ <h2><a>MmsManager</a> Interface</h2>
976976
report is received on this messaging service manager.</dd>
977977

978978
<dt class="no-docs">
979-
attribute EventHandler ondeliveryfailure
979+
attribute EventHandler ondeliveryerror
980980
</dt>
981-
<dd>Handles the <code>deliveryfailure</code> event of type
981+
<dd>Handles the <code>deliveryerror</code> event of type
982982
<a>DeliveryReportEvent</a>, fired when a new failure delivery
983983
report is received on this messaging service manager.</dd>
984984

985+
<dt class="no-docs">
986+
attribute EventHandler onreadsuccess
987+
</dt>
988+
<dd>Handles the <code>readsuccess</code> event of type
989+
<a>ReadReportEvent</a>, fired when a new succesful read report is
990+
received on this messaging service manager.</dd>
991+
992+
<dt class="no-docs">
993+
attribute EventHandler onreaderror
994+
</dt>
995+
<dd>Handles the <code>readerror</code> event of type
996+
<a>ReadReportEvent</a>, fired when a new failure read report is received
997+
on this messaging service manager.</dd>
998+
985999
<dt class="no-docs">
9861000
attribute EventHandler onserviceadded
9871001
</dt>
@@ -1268,15 +1282,15 @@ <h3>Steps</h3>
12681282
value of the X-Mms-Status element in the M-Delivery.ind Protocol
12691283
Data Unit [[!MMS13]] is 'Retrieved', or
12701284
<li>to 'error', in case of failed delivery, i.e. if the value of
1271-
the X-Mms-Status element in the the M-Delivery.ind Protocol Data
1285+
the X-Mms-Status element in the M-Delivery.ind Protocol Data
12721286
Unit [[!MMS13]] is 'Expired', 'Rejected' or 'Unreachable'.
12731287
</ol>
12741288
<li>set its <code>deliveryTimestamp</code> attribute to the delivery
12751289
time, i.e. the 'Date' field in the M-Delivery.ind Protocol Data Unit
12761290
[[!MMS13]], in case of successful delivery.
12771291
</ol>
12781292
<li><a>Queue a task</a> to <a>fire an event</a> named
1279-
<a>deliverysuccess</a> or <a>deliveryfailure</a> respectively if the
1293+
<a>deliverysuccess</a> or <a>deliveryerror</a> respectively if the
12801294
delivery was successfull or not, with
12811295
<ol>
12821296
<li>the <code>messageID</code> attribute set to the
@@ -1292,8 +1306,8 @@ <h3>Steps</h3>
12921306
same position of the <code>recipients</code> array.
12931307
</ol>
12941308
<li><a>Queue a task</a> to fire a system message of type
1295-
<code><a>DeliveryReport</a></code>named <a>deliverysuccess</a> or
1296-
<a>deliveryfailure</a> respectively if the delivery was successfull or
1309+
<code><a>DeliveryReport</a></code> named <a>deliverysuccess</a> or
1310+
<a>deliveryerror</a> respectively if the delivery was successfull or
12971311
not, with
12981312
<ol>
12991313
<li>the <code>messageID</code> attribute set to the
@@ -1310,6 +1324,63 @@ <h3>Steps</h3>
13101324
</ol>
13111325
</ol>
13121326

1327+
<p>Upon a read report of a previously sent MMS message being received, the
1328+
<a>user agent</a> MUST
1329+
<ol>
1330+
<li>Let <var>mmsMessage</var> be the instance of <code>MmsMessage</code>
1331+
to which this read report is related.
1332+
<li>For each of the items in the <code>deliveryInfo</code> array
1333+
attribute of <em>mmsMessage</em> whose <code>recipient</code>
1334+
attribute matches one of the recipients of the MMS to which the read
1335+
report is related,
1336+
<ol>
1337+
<li>set its <code>readStatus</code> attribute:
1338+
<ol>
1339+
<li>to 'success', in case the message has been read, i.e. if the
1340+
value of the X-Mms-Read-Status element in the M-Read-Orig.ind
1341+
Protocol Data Unit [[!MMS13]] is 'Read', or
1342+
<li>to 'error', in case the message has been deleted without being
1343+
read, i.e. if the value of the X-Mms-Status element in the
1344+
M-Read-Orig.ind Protocol Data Unit [[!MMS13]] is 'Deleted without
1345+
being read'.
1346+
</ol>
1347+
<li>set its <code>readTimestamp</code> attribute to the read
1348+
time, i.e. the 'Date' field in the M-Read-Orig.ind Protocol Data Unit
1349+
[[!MMS13]], in case the message has been read.
1350+
</ol>
1351+
<li><a>Queue a task</a> to <a>fire an event</a> named <a>readsuccess</a>
1352+
or <a>readerror</a> respectively if the message has been read or not, with
1353+
<ol>
1354+
<li>the <code>messageID</code> attribute set to the
1355+
<code>messageID</code> attribute of <em>mmsMessage</em>,
1356+
<li>the <code>serviceID</code> attribute set to the
1357+
<code>serviceID</code> attribute of <em>mmsMessage</em>,
1358+
<li>the <code>recipients</code> attribute set to the subset of the
1359+
original recipients of <em>mmsMessage</em>to which this read
1360+
report is related, and
1361+
<li>in case the message has been read, with each of the items in the
1362+
<code>readTimestamps</code> attribute set to the read time of
1363+
the MMS message by the corresponding recipient, i.e. that in the
1364+
same position of the <code>recipients</code> array.
1365+
</ol>
1366+
<li><a>Queue a task</a> to fire a system message of type
1367+
<code><a>ReadReport</a></code> named <a>readsuccess</a> or
1368+
<a>readerror</a> respectively if the message has been read or not, with
1369+
<ol>
1370+
<li>the <code>messageID</code> attribute set to the
1371+
<code>messageID</code> attribute of <em>mmsMessage</em>,
1372+
<li>the <code>serviceID</code> attribute set to the
1373+
<code>serviceID</code> attribute of <em>mmsMessage</em>,
1374+
<li>the <code>recipients</code> attribute set to the subset of the
1375+
original recipients of <em>mmsMessage</em>to which this read
1376+
report is related, and
1377+
<li>in case the message has been read, with each of the items in the
1378+
<code>readTimestamps</code> attribute set to the read time of
1379+
the MMS message by the corresponding recipient, i.e. that in the
1380+
same position of the <code>recipients</code> array.
1381+
</ol>
1382+
</ol>
1383+
13131384
<p> The <dfn><code>clear</code></dfn> method when invoked MUST run the
13141385
following steps:
13151386
<ol>
@@ -1369,11 +1440,23 @@ <h2>Event handlers</h2>
13691440
<td>handles successful delivery reports</td>
13701441
</tr>
13711442
<tr>
1372-
<td><strong><code>ondeliveryfailure</code></strong></td>
1373-
<td><code><dfn>deliveryfailure</dfn></code></td>
1443+
<td><strong><code>ondeliveryerror</code></strong></td>
1444+
<td><code><dfn>deliveryerror</dfn></code></td>
13741445
<td><a><code>DeliveryReportEvent</code></a></td>
13751446
<td>handles failure delivery reports</td>
13761447
</tr>
1448+
<tr>
1449+
<td><strong><code>onreadsuccess</code></strong></td>
1450+
<td><code><dfn>readsuccess</dfn></code></td>
1451+
<td><a><code>ReadReportEvent</code></a></td>
1452+
<td>handles successful read reports</td>
1453+
</tr>
1454+
<tr>
1455+
<td><strong><code>onreaderror</code></strong></td>
1456+
<td><code><dfn>readerror</dfn></code></td>
1457+
<td><a><code>ReadReportEvent</code></a></td>
1458+
<td>handles failure read reports</td>
1459+
</tr>
13771460
<tr>
13781461
<td><strong><code>onserviceadded</code></strong></td>
13791462
<td><code><dfn>serviceadded</dfn></code></td>
@@ -1757,7 +1840,7 @@ <h2><a>DeliveryReport</a> Interface</h2>
17571840
<dd>MUST return the identifier of the message to which this delivery
17581841
report is related.</dd>
17591842
<dt>readonly attribute DOMString[] recipients</dt>
1760-
<dd>MUST return an array contining the addresses of the subset of the
1843+
<dd>MUST return an array containing the addresses of the subset of the
17611844
original recipients of the message to which this delivery report is
17621845
related. As delivery reports related to just part of the recipients of the
17631846
MMS message are possible, this array may not contain the full list of
@@ -1796,7 +1879,7 @@ <h2><a>ReadReport</a> Interface</h2>
17961879
<dd>MUST return the identifier of the message to which this read
17971880
report is related.</dd>
17981881
<dt>readonly attribute DOMString[] recipients</dt>
1799-
<dd>MUST return an array contining the addresses of the subset of the
1882+
<dd>MUST return an array containing the addresses of the subset of the
18001883
original recipients of the message to which this read report is
18011884
related. As read reports related to just part of the recipients of the
18021885
MMS message are possible, this array may not contain the full list of
@@ -1840,7 +1923,7 @@ <h2><a>DeliveryReportEvent</a> Interface</h2>
18401923
<dd>MUST return the identifier of the message to which this delivery
18411924
report event is related.</dd>
18421925
<dt>readonly attribute DOMString[] recipients</dt>
1843-
<dd>MUST return an array contining the addresses of the subset of the
1926+
<dd>MUST return an array containing the addresses of the subset of the
18441927
original recipients of the message to which this delivery report event is
18451928
related. As delivery reports related to just part of the recipients of the
18461929
MMS message are possible, this array may not contain the full list of
@@ -1873,7 +1956,7 @@ <h2><a>ReadReportEvent</a> Interface</h2>
18731956
<dd>MUST return the identifier of the message to which this read
18741957
report event is related.</dd>
18751958
<dt>readonly attribute DOMString[] recipients</dt>
1876-
<dd>MUST return an array contining the addresses of the subset of the
1959+
<dd>MUST return an array containing the addresses of the subset of the
18771960
original recipients of the message to which this read report event is
18781961
related. As read reports related to just part of the recipients of the
18791962
MMS message are possible, this array may not contain the full list of

0 commit comments

Comments
 (0)