Specified that collection retrieval shall be matched on a full JID only.
Requirements and protocol flows for each of these use cases are defined below. The protocols to retrieve a list of collections and an indivdual collection both make extensive use of &xep0059;. Clients and servers SHOULD support all the features defined in that protocol.
To request a list of collections, the client sends a <list/> element. The 'start' and 'end' attributes MAY be specified to indicate a date range (the values of these attributes MUST be UTC and adhere to the DateTime format specified in XEP-0082). The 'with' attribute MAY be specified to limit the list to a single participating full JID, bare JID or domain.
-In addition, the client MAY match an exact bare JID &BAREJID; by setting the boolean 'exactmatch' attribute to a value of "true" or "1" &BOOLEANNOTE; -- for details, refer to the Exact JID Matching section of this document.
+Note: Collections are retrieved only based on the full JID of the conversation partner, not bare JIDs (which might result in returning multiple collections). Therefore, the <retrieve/> shall not possess the 'exactmatch' attribute, as can be done for other Message Archiving elements (see the Exact JID Matching section of this document).
If the 'with' attribute is omitted then collections with any JID are returned. If only 'start' is specified then all collections on or after that date should be returned. If only 'end' is specified then all collections prior to that date should be returned.
The client SHOULD use Result Set Management to limit the number of collections returned by the server in a single stanza, taking care not to request a page of collections that is so big it might exceed rate limiting restrictions.
To request a page of messages from a collection the client sends a <retrieve/> element. The 'with' and 'start' attributes specify the JID and the start time (see XEP-0082). Both attributes MUST be included to uniquely identify a collection.
+To request a page of messages from a collection the client sends a <retrieve/> element. The 'with' and 'start' attributes specify the participating full JID and the start time (see XEP-0082). Both attributes MUST be included to uniquely identify a collection.
In addition, the client MAY match an exact bare JID &BAREJID; by setting the boolean 'exactmatch' attribute to a value of "true" or "1" &BOOLEANNOTE; -- for details, refer to the Exact JID Matching section of this document.
The client SHOULD use Result Set Management to limit the number of messages returned by the server in a single stanza, taking care not to request a page of messages that is so big it might exceed rate limiting restrictions.
When the 'exactmatch' attribute is set to "true" or "1" on an element of <item/>, <list/>, <remove/>, or <retrieve/>, a 'with' value such as "example.com" matches that exact JID only rather than <*@example.com>, <*@example.com>, or <example.com/*>, and a 'with' value such as "localpart@example.com" matches that exact JID only rather than <localpart@example.com/*>.
+When the 'exactmatch' attribute is set to "true" or "1" on an element of <item/>, <list/>, or <remove/>, a 'with' value such as "example.com" matches that exact JID only rather than <*@example.com>, <*@example.com>, or <example.com/*>, and a 'with' value such as "localpart@example.com" matches that exact JID only rather than <localpart@example.com/*>.
When creating a new collection, it is RECOMMENDED that the client synchronizes the collection start time that it sends to the server with server time. This is important since the user may subsequently retrieve the archived collection using client machines whose UTC clocks are not synchronized with the client machine that uploaded the collection. (i.e. Either or both of the clients' UTC clocks may be wrong.) The client can achieve this synchronization with server time by using &xep0202; to estimate the difference between the server and client UTC clocks.
@@ -1435,7 +1441,6 @@