Community articleStand-alone forum reply entry content
Added by IBM contributorIBM on June 27, 2014
Rate this article 1 starsRate this article 2 starsRate this article 3 starsRate this article 4 starsRate this article 5 stars

Lists the elements in an Atom entry that represents a reply to a forum topic.
Tags: commapi



Lists the elements in an Atom entry that represents a reply to a forum topic.

All elements are in the http://www.w3.org/2005/Atom namespace, except those that are prefixed as follows:

thr

In the http://purl.org/syndication/thread/1.0 namespace.

Table 1. Forum topic reply entry elements

Element
How treated on input
Description
<id>
Ignored
Unique identifier of a reply to a forum topic.
<title>
Required
Title of a reply to a forum topic.
<category scheme="http://www.ibm.com/xmlns/prod/sn/type" term="forum-reply"/>
Required
Identifies the Atom entry as a reply to a forum topic.
<category scheme="http://www.ibm.com/xmlns/prod/sn/flags term="deleted" ">
Ignored
Identifies a deleted reply. When you delete a reply, the reply entry itself is not removed from the forum because it may have child replies; only its content is removed. If you delete a reply using the HTTP DELETE method, default text is added to indicate that the content of the reply has been removed. If you want to customize the text that is displayed, you can use the HTTP PUT method to replace the content of the entry with your custom content.
<category scheme="http://www.ibm.com/xmlns/prod/sn/flags" term="answer"/>
Required if you want to identify the reply as an answer.
If present, indicates that the reply is an answer to a question.
<thr:in-reply-to ref="..." type="..." href="parent_url" >
Required

Note: You must provide a value for the ref attribute; the href attribute is optional.
Use the web address in the href attribute to access the reply's parent entry. The following operation is supported:
GET
Use the web address in the href attribute to obtain the parent topic or reply as an Atom entry document.

Use the value of the source= attribute to work with the top level parent topic of this reply. The following operation is supported:
GET
Use the web address in the source attribute to obtain the top level parent topic as an Atom entry document.
<link rel="alternate" type="text/html" href="..."/>
Ignored
Use the web address in the href attribute to obtain a HTML representation of this forum topic entry that can be displayed in a web browser.
<link rel="self" href="..." />
Ignored
Use the web address in the href attribute to obtain an Atom entry document containing a complete representation of this forum topic reply. The following operation is supported:
GET
Use the web address in the href attribute to obtain a full representation of this forum topic reply as an Atom Entry document.
<link rel="edit" type="application/atom+xml" href="edit_url" />
Ignored
Use the web address in the href attribute to obtain an Atom entry document containing a complete representation of this forum topic reply. If you are an owner of the community the following operations are supported on the link address:
GET
Use the web address in the href attribute to obtain a full representation of this reply as an Atom entry document.
PUT
Use the web address in the href attribute to update this reply. You can also use PUT to mark a reply as deleted, by providing a deletion flag and a reason to be displayed, such as "Inappropriate content."
DELETE
Use the web address in the href attribute to delete this reply.
<content type="text/html">
Required
Content of the reply; may be empty.

Note: If the content is larger than 2KB, then a <summary> element with the first 2KB of the content is included instead, and an enclosure link which points at the full content is provided.
<published>
optional
The date an entry was published as defined in the Atom specification.

POST:
would be used when "X-Lconn-RunAs" header is used. the specified time would be the create time of the entry.

<updated>
optional
The date an entry was updated as defined in the Atom specification.

PUT:
would be used when "X-Lconn-RunAs" header is used. the specified time would be the content modified time of the entry

<author>
<name>
<email>
<snx:userid>
<snx:userState>
</author>
Ignored
The author of this community as defined in the Atom specification. If IBM® Connections is configured to prevent email addresses from being displayed, then the <email> element is not supported; provide the <snx:userid> instead. Otherwise, <email> can be used. The <name> and <snx:userState> elements are ignored on input.
<category scheme="http://www.ibm.com/xmlns/prod/sn/flags" term="NotRecommendedByCurrentUser"/>
Ignored
A flag to show if current user has recommended the topic.
If this entry is recommended by current user, then 'NotRecommendedByCurrentUser' element will not show up.
<link rel="recommendations" type="application/atom+xml" href="..." snx:recommendation="number_of_recomendations_in_this_topic"/>
Ignored
Use the web address in the href attribute to obtain an Atom entry document containing a complete representation of this recommendation entry of this topic.
The following operations are supported:

GET
Use the web address in the href attribute to obtain a full representation of recommendations of this topic as an Atom entry document.
PUT
Use the web address in the href attribute to recommend(like) this forum topic.
DELETE
Use the web address in the href attribute to un-recommend(unlike) the forum topic.


Note: There are no tags associated with forum topic replies.