Comment content

Home

Comment content

Lists the elements in the Atom entry document of a comment. All elements are in the http://www.w3.org/2005/Atom namespace, except those that are prefixed as follows:

td

In the urn:ibm.com/td namespace.

snx

In the http://www.ibm.com/xmlns/prod/sn namespace.

Comment elements

Element How treated on input Description
<id> Required on PUT request. Unique identifier of a comment formatted following the URN specification.
<td:uuid> Ignored Unique identifier of a comment. Provide this value as the {comment-id} when constructing the resource from which to retrieve a file comment. This ID is created by the server when you post a comment.
<title type="text"> Optional Title of the comment in text format. The type attribute is optional; type="text" is the default and only format allowed.
<category scheme="tag:ibm.com,2006:td/type" term="comment" label="comment"/> Required Identifies a comment document Atom entry.
<link rel="alternate" type="text/html" href="alternate_url"> Ignored A direct link to the comment within the Files Web application. Operations supported on the value of the href attribute:

GET: HTML for display in browser.

<link rel="self" type="application/atom+xml" href="self_url"> Ignored Use the Web address in the href attribute to obtain an Atom entry document containing a complete Atom representation of this file. The following operation is supported:

GET: Use the Web address to obtain full representation of the comment as an Atom entry document.

<link rel="edit" href="edit-url"> Ignored Use the Web address in the href attribute to obtain a complete representation of this comment entry. If you are a comment author or file owner, the following operations are supported:

GET: Use the Web address to obtain a full representation of this comment as an Atom entry document.
PUT: Use the Web address to update this comment.
DELETE: Use the Web address to delete this comment.

<content type="text"> Required Text of this comment. The type attribute is optional; type="text" is the default and only format allowed.
<td:created> Optional Creation timestamp in Atom format.
<td:modified> Optional The date that the comment was last updated. Timestamp in Atom format.
<updated> Ignored The date that the comment was last updated, as defined in the Atom specification.
<published> Ignored The date the comment was initially published, as defined in the Atom specification.
<td:modifier> Optional The person who last modified the comment. Contains the person's name, snx:userid, and e-mail address (if exposed).
<author> Ignored The person who created the comment.

Files Atom entry types

Related reference

Create a comment
Retrieving a comment
Updating a comment
Delete a comment

+
Search Tips | Advanced Search

Element	How treated on input	Description
<id>	Required on PUT request.	Unique identifier of a comment formatted following the URN specification.
<td:uuid>	Ignored	Unique identifier of a comment. Provide this value as the {comment-id} when constructing the resource from which to retrieve a file comment. This ID is created by the server when you post a comment.
<title type="text">	Optional	Title of the comment in text format. The type attribute is optional; type="text" is the default and only format allowed.
<category scheme="tag:ibm.com,2006:td/type" term="comment" label="comment"/>	Required	Identifies a comment document Atom entry.
<link rel="alternate" type="text/html" href="alternate_url">	Ignored	A direct link to the comment within the Files Web application. Operations supported on the value of the href attribute: GET: HTML for display in browser.
<link rel="self" type="application/atom+xml" href="self_url">	Ignored	Use the Web address in the href attribute to obtain an Atom entry document containing a complete Atom representation of this file. The following operation is supported: GET: Use the Web address to obtain full representation of the comment as an Atom entry document.
<link rel="edit" href="edit-url">	Ignored	Use the Web address in the href attribute to obtain a complete representation of this comment entry. If you are a comment author or file owner, the following operations are supported: GET: Use the Web address to obtain a full representation of this comment as an Atom entry document. PUT: Use the Web address to update this comment. DELETE: Use the Web address to delete this comment.
<content type="text">	Required	Text of this comment. The type attribute is optional; type="text" is the default and only format allowed.
<td:created>	Optional	Creation timestamp in Atom format.
<td:modified>	Optional	The date that the comment was last updated. Timestamp in Atom format.
<updated>	Ignored	The date that the comment was last updated, as defined in the Atom specification.
<published>	Ignored	The date the comment was initially published, as defined in the Atom specification.
<td:modifier>	Optional	The person who last modified the comment. Contains the person's name, snx:userid, and e-mail address (if exposed).
<author>	Ignored	The person who created the comment.