Skip to main content

 Element reference

Service API elements from <alias> to <workflow>



A discussion or comment thread.

The <discussion> element is a container for a list of <comment> elements that are part of the same discussion thread.

This model for the <discussion> element is used as a base for the <task> element.

Usage context

Permitted content<comment>, <group>, <locator>, <uri>
Permitted parent<discussions>


This element defines the following attributes:

idxs:longyesThe ID of the discussion
lastcommentdatexs:dateTimenoThe date of the last comment
lastcommentidxs:longnoThe ID of the last comment
replycountxs:intnoThe number of replies in the thread
titlexs:stringnoThe title of the discussion (250)
All the discussion attributes are generated from the comments in the discussion. With the exception of the @id attribute, they are susceptible to change every time a new comment (in other words, a reply) is made to the discussion thread.


The PageSeeder database identifier for the discussion. It is always an immutable positive long value that is unique on a specific PageSeeder server within the set all members.

The discussion ID is the same as the ID of the first comment (which initiated the discussion) and is immutable in practice.


The date the last comment was created. This value changes every time a reply is made to the discussion.


The ID of the last comment in the discussion. This value changes every time a reply is made to the discussion.


This attribute indicates how many replies have been made to the discussion, which is the same as the total number of comments minus one. This value changes every time a reply is made to the discussion.


The title of the discussion is the title of the last comment in the discussion. It does not usually change, but can be modified if a reply has a new title. It is limited to 250 characters.



XML Schema

<xs:element name="discussion" type="discussion"/>

<xs:complexType name="discussion">
    <xs:choice minOccurs="0">
      <xs:element name="group"     type="group-basic" />
        <xs:element name="uri"     type="uri" />
        <xs:element name="locator" type="locator"  minOccurs="0" />
    <xs:element name="comment"     type="comment"  minOccurs="0"
  <xs:attribute name="id"              type="id" use="required"/>
  <xs:attribute name="lastcommentdate" type="xs:dateTime"/>
  <xs:attribute name="lastcommentid"   type="id"/>
  <xs:attribute name="replycount"      type="xs:int"/>
  <xs:attribute name="title"           type="comment-title"/>

<xs:simpleType name="comment-title">
  <xs:restriction base="xs:string">
    <xs:maxLength value="250"/>

Relax Schema

element discussion {
   attribute id              { xs:long },
   attribute lastcommentdate { xs:dateTime }?, 
   attribute lastcommentid   { xs:long }?, 
   attribute replycount      { xs:boolean }?,
   attribute title           {  text { maxLength = "250"} }?,


No change since initial API release.

Created on , last edited on