This commit is contained in:
Peter Saint-Andre 2013-06-05 14:59:04 -06:00
parent 1f7b08ee34
commit 0a967a52bf
1 changed files with 7 additions and 2 deletions

View File

@ -177,7 +177,7 @@
<li>&lt;request/&gt; -- included in a content message by a sending entity that wishes to know if the content message has been received, i.e., delivered to a client controlled by the intended recipient.</li>
<li>&lt;received/&gt; -- included in an ack message by a receiving entity that wishes to inform the sending entity that the content message has been received, i.e., delivered to a client controlled by the intended recipient.</li>
</ul>
<p>Specifically, the receiving entity shall return an ack message containing the &lt;received/&gt; extensino if the content message has been delivered to a client controlled by the intended recipient. In general, a client will return a receipt only if the client has processed the content message (e.g., if the client has presented the content message to a human user or has completed any automated processing of the content message, such as generation of an error response if the application determines that the content message cannot be handled). However, the Message Delivery Receipts protocol does not provide notification that a human user has read or understood the content message, that an automated system has completed processed or acted upon the message, etc.</p>
<p>Specifically, the receiving entity shall return an ack message containing the &lt;received/&gt; extension if the content message has been delivered to a client controlled by the intended recipient. In general, a client will return a receipt only if the client has processed the content message (e.g., if the client has presented the content message to a human user or has completed any automated processing of the content message, such as generation of an error response if the application determines that the content message cannot be handled). However, the Message Delivery Receipts protocol does not provide notification that a human user has read or understood the content message, that an automated system has completed processed or acted upon the message, etc.</p>
<p>The following is an example of a content message that includes a request for return receipt.</p>
<example caption='A content message with receipt requested'><![CDATA[
<message
@ -189,7 +189,12 @@
</message>
]]></example>
<p class='box'>Note: A sender MUST include an 'id' attribute on every content message that requests a receipt, so that the sender can properly track ack messages.</p>
<p>The recipient shall generate an ack message if and only if (1) it supports the Message Delivery Receipts protocol and (2) it is configured to return receipts, either globally or for this recipient (otherwise it MUST NOT return a receipt and SHOULD NOT return an error).</p>
<p>The recipient shall generate an ack message if and only if:</p>
<ol>
<li>it supports the Message Delivery Receipts protocol; and</li>
<li>it is configured to return receipts, either globally or for this recipient.</li>
</ol>
<p>Otherwise it MUST NOT return a receipt and SHOULD NOT return an error.</p>
<example caption='A message delivery receipt'><![CDATA[
<message
from='kingrichard@royalty.england.lit/throne'