A document draft also provides a feed on its comments. There
are three views that show the state of any drafts in the library: Working
Drafts, Submitted Drafts, and Drafts to Approve.
The draft feed has the following URL pattern:
<protocol
://<host
:<port
/library/<library
uuid
/draft/<draft uuid
/feed
For example, a URL might look like this:
http://example.com/dm/atom/library/08ca5f0044ab2d6a858eed71ca20d4cf/draft/
b7894c8044f70cc78f5ddf70327bdb4c/feed
The HTTP request looks like this:
GET /dm/atom/library/08ca5f0044ab2d6a858eed71ca20d4cf/draft
/b7894c8044f70cc78f5ddf70327bdb4c/feed
HTTP/1.1 Host: example.com User-Agent: Thingio/1.0
And the HTTP response contains an Atom feed document that
looks like this:
<?xml version="1.0"
encoding="UTF-8"?
<feed
xml:base="http://example.com/dm/atom/library/08ca5f0044ab2d6a858eed71ca20d4cf/"
xml:lang="en" xmlns="http://www.w3.org/2005/Atom" xmlns:td="urn:ibm.com/td"
<!-- Information about server implementation --
<generator uri="http://example.com/dm/atom"
version="1.0"
Teamspace Documents</generator
<!-- Unique id for this feed --
<id
urn:lsid:ibm.com:td:b7894c8044f70cc78f5ddf70327bdb4c</id
<!-- Link to retrieve this feed --
<link href="draft/b7894c8044f70cc78f5ddf70327bdb4c/feed"
rel="self"
</link
<!-- Link to view this feed entries in browser
--
<link href="http://example.com/wps/mypoc?uri=dm:b7894c8044f70cc78f5ddf70327bdb4c&verb=view"
rel="alternate"
</link
<!-- Paging links --
<link href="draft/b7894c8044f70cc78f5ddf70327bdb4c/feed?pagesize=10&page=2"
rel="next"
</link
<!-- Collection description for the draft collection
--
<collection href="draft/b7894c8044f70cc78f5ddf70327bdb4c/feed"
xmlns="http://purl.org/atom/app#"
<atom:title type="text" xmlns:atom="http://www.w3.org/2005/Atom"
My
Draft</atom:title
<accept
text/*,entry</accept
</collection
<!-- Current user's permission on this collection
--
<td:permissions
add,view,delete,delete_soft,edit</td:permissions
<!-- Creator of this draft --
<author
<uri
uid=jsmith,ou=example,o=organization</uri
<name
John Smith</name
<email
jsmith@example.com</email
</author
<!-- Title of the draft --
<title type="text"
My
Draft</title
<!-- Last modified date of the draft --
<updated
2007-04-13T15:44:46.109Z</updated
<!-- This is a comment entry --
<entry
<!-- Unique id of this comment entry --
<id
urn:lsid:ibm.com:td:4e05cb0044f7e4f1937e932188721110</id
<!-- Link to obtain this comment entry --
<link href="draft/b7894c8044f70cc78f5ddf70327bdb4c/comment/4e05cb0044f7e4f1937e932188721110/entry"
rel="self"
</link
<!-- Link to view the comment in browser --
<link href="http://example.com/wps/mypoc?uri=dm:4e05cb0044f7e4f1937e932188721110&verb=view"
rel="alternate"
</link
<!-- Link to modify the metadata of the comment
--
<link href="draft/b7894c8044f70cc78f5ddf70327bdb4c/comment/4e05cb0044f7e4f1937e932188721110/entry"
rel="edit"
</link
<!-- Link to update the comment --
<link href="draft/b7894c8044f70cc78f5ddf70327bdb4c/comment/4e05cb0044f7e4f1937e932188721110/media"
rel="edit-media"
</link
<!-- Category indicates that this is a comment
--
<category term="comment" scheme="tag:ibm.com,2006:td/type"
label="comment"
</category
<!-- Current user's permission on the comment --
<td:permissions
add,view,delete,delete_soft,edit</td:permissions
<!-- Comment creator --
<author
<uri
uid=jsmith,ou=example,o=organization</uri
<name
John Smith</name
<email
jsmith@example.com</email
</author
<!-- Comments typically don't have title --
<title type="text"
</title
<!-- Creation date of the comment --
<published
2007-04-13T22:20:53.422Z</published
<!-- Last modified date of the comment --
<updated
2007-04-13T22:20:53.422Z</updated
<!-- Comment entries include formatted dates --
<published td:displaydate="Friday at 06:20
pm"
</published
<updated td:displaydate="Friday at 06:20 pm"
</updated
<!-- User modifiable creation date --
<td:created
2007-05-13T19:03:25.500Z</td:created
<!-- User modifiable modification date --
<td:modified
2007-05-13T19:03:25.500Z</td:modified
<!-- Last modified person --
<td:modifier
<td:uri
uid=jdoe,ou=example,o=organization</td:uri
<td:name
John Doe</td:name
<td:email
jdoe@example.com
</td:email
</td:modifier
<!-- Comment entries contain inline content --
<content type="html"
<div
This
is the text of comment</
</content
</entry
</feed