insight-topic:fetch-list
Index
Main
Spirit
Logicsheet
insight:
operations
insight-topic:
create
rename
fetch
fetch-tree
fetch-list
current
get-id
get-name
get-fqname
insight-publication:
create
make-default
fetch
fetch-list
get-id
get-state
get-format
get-topic
fetch-fragments
get-fragment-path
get-fragment-locator

Description

Namespace : insight-topic="http://shaman.paris5.fr/xsp/insight-topic"

Element name : insight-topic:fetch-list

Purpose : Retrieves a list of Topic whose have a given Topic for parent.

Inner scope

Current Topic node : For each tree node representing a Topic, a current Topic is defined inside the representing tag.


Parameters

         Name           Role Mandatory Remarks
from-id Sets the Id of the Topic to get the tree from. No, if enclosing tag defines a Topic. Exclusive with from-fqname.
from-fqname Sets the full-qualified name of the Topic to get the tree from (root Topic has FQName '/'). No, if enclosing tag defines a Topic. Exclusive with from-id.
Should be used for tests only. As a matter of fact, a Topic name can change during Topic's life, making its FQName changing. So it is not a reliable information, Topic Id should be preferred instead whenever possible.
recurse Indicates if Topic list should be extracted recursively. No. Default is false

Examples

Example 1

Create two Topics '1' and '2' under the root Topic, and display the list of Topics under root as XHTML.

<insight:operations>

  <insight-topic:create parent-id="0" name="1" />
  <insight-topic:create parent-id="0" name="2" />

  <ul>
    <insight-topic:fetch-list from-id="0" >
      <li>
        Topic FQName : <insight-topic:get-fqname/> <br/>
      </li>
    </insight-topic:fetch-list>
  </ul>

</insight:operations>

This gives the following XHTML output :

<ul>
  <li>
    Topic FQName : /1 <br/>
  </li>
  <li>
    Topic FQName : /2 <br/>
  </li>
</ul>



Copyright 2002 Laurent Caillette and l'Université René Descartes, Paris 5.
All rights reserved.