Web service API

How to use PageSeeder's Web service API

<thread>

Summary

A process thread in PageSeeder.

Usage context

Permitted content<message>, thread specific XML
Permitted parent<threads>

Attributes

This element includes the following attributes.

NameTypeRequiredDescription
idxs:stringyesThe ID of the thread
namexs:stringyesThe human friendly name of the thread.
usernamexs:stringnoThe username of the user who started the thread.
groupidxs:longnoThe ID of the context group.
statusenumnoThe thread status

@id

The PageSeeder identifier for the thread. It can be used to specify a thread in a request to PageSeeder.

@name

A thread name, describing what the thread does.

@username

The username of the member who owns the thread, it is optional as some threads are launched by PageSeeder.

@groupid

The ID of the group where the thread was launched, some threads are server wide so this attribute is optional.

@status

The current status of the thread, only specified if the thread has been started. The value is one of the following:

  • "initialised"
  • "inprogress"
  • "error"
  • "warning"
  • "cancelled"
  • "completed"
  • "failed"

A thread is considered as finished if its status is "completed", "cancelled" or "failed".

Examples

<thread id="9aa2ac4f69e4bbce00501f7f411eb761"
      name="Moving thread for group dev-group"
  username="bjones"
   groupid="42"
    status="completed">
  <message>Successfully moved 237 files/folders</message>
  <progress total="474" current="474"/>
</thread>
<thread id="f4851a942a5d95fec02c132d00cc5a3a"
        name="Validation thread for group dev-group"
        username="asmith"
        groupid="135"
        status="inprogress">
  <message>Document /ps/dev/group/documents/pages/hr/pg143_hires.jpg is valid.</message>
  <progress total="709" current="636"/>
</thread>

Schema

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

<xs:complexType name="thread" mixed="true">
  <xs:sequence>
    <xs:any minOccurs="0" maxOccurs="unbounded" processContents="skip"/>
  </xs:sequence>
  <xs:attribute name="id"       type="xs:string" use="required"/>
  <xs:attribute name="name"     type="xs:string" use="required"/>
  <xs:attribute name="username" type="xs:string" /> 
  <xs:attribute name="groupid"  type="xs:long" /> 
  <xs:attribute name="status"   type="thread-status" />
</xs:complexType>

<xs:simpleType name="thread-status">
  <xs:restriction base="xs:string">
    <xs:enumeration value="initialised" />
    <xs:enumeration value="inprogress" />
    <xs:enumeration value="cancelled" />
    <xs:enumeration value="warning" />
    <xs:enumeration value="error" />
    <xs:enumeration value="failed" />
    <xs:enumeration value="completed" />
  </xs:restriction>
</xs:simpleType>

 

 

Compatibility

See also

Created on , last edited on