Community articleStandalone forum topic entry content
Added by IBM contributorIBM | Edited by IBM contributordeveloperWorks Lotus Team 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

No abstract provided.

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

snx

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

Table 1. Forum topic entry elements

Element
How treated on input
Description
<id>
Ignored
Unique identifier of a forum topic.
<title>
Required
Forum topic title.
<category scheme="http://www.ibm.com/xmlns/prod/sn/type" term="forum-topic"/>
Required
Identifies the Atom entry as a forum topic.
<category scheme="http://www.ibm.com/xmlns/prod/sn/flags" term="pinned"/>
Required if you want the topic to be added to the top of the forum thread.
Adds the topic as a top-level entry at the top of the forum thread.
<category scheme="http://www.ibm.com/xmlns/prod/sn/flags" term="locked"/>
Required if you want to lock the topic.
If present, indicates that the topic is locked.
<category scheme="http://www.ibm.com/xmlns/prod/sn/flags" term="question"/>
Required if you want to identify the topic as a question.
If present, indicates that the topic is a question.
<category scheme="http://www.ibm.com/xmlns/prod/sn/flags" term="answered"/>
Required if you want to indicate that the associated question has been answered.
If present, indicates that the topic is a question that has been answer. Combine this element with the <category scheme="http://www.ibm.com/xmlns/prod/sn/flags" term="question"/> element to represent an answered question.
<category term="tag_name"/>
Ignored
Represents a tag the owner has applied to the topic. Repeats for multiple tags.
<link rel="replies" type="application/atom+xml" href="..." />
Ignored
Use the web address in the href attribute to work with replies to this forum topic. The following operations are supported:
GET
Use the web address in the href attribute to obtain a feed of topic replies. You can subscribe to this address in a feed reader to keep up to date on the discussion of this topic. Using links in the replies feed you can update the replies or delete them.
POST
Use the web address in the href attribute to create a reply to the topic with the HTTP POST method.
<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 return a complete representation of this forum topic 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 entry topic. If you are an owner of the community, the following operations are supported:
GET
Use the web address in the href attribute to obtain a full representation of this forum topic as an Atom entry document.
PUT
Use the web address in the href attribute to update this forum topic. You can also use PUT to mark a topic as deleted, and provide a custom reason for the deletion to be displayed in place of the topic, such as "Deleted due to inappropriate content." If you use PUT to delete the topic, include the deleted category tag in the entry content.
DELETE
Use the web address in the href attribute to delete the forum topic including all replies.
<content type="html">
Required
A description of the forum topic; 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.
<link rel="recommendations" type="application/atom+xml" snx:recommendation="0"/>
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.
<category term="ThreadRecommendationCount" label="0"/>
ignored
specify the number of recommendations to this topic thread, which mean the recommendations to this topic and its replies.