Forum topic entry content 

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

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> Ignored The date an entry was published as defined in the Atom specification.
<updated> Ignored The date an entry was updated as defined in the Atom specification.
<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.


Parent topic

Communities Atom entry types

Related reference
Create a community forum topic programmatically
Retrieve a community forum topic programmatically
Update a community forum topic programmatically
Delete a community forum topic programmatically


   

 

});