insight-topic:rename
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:rename

Purpose : Renames a Topic. This will impact the Topic FQName, but not its Id.

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 rename. No, if enclosing tag defines a Topic. Exclusive with from-fqname.
from-fqname Sets the full-qualified name of the Topic to rename (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.
new-name The new name to set to the Topic. Yes

Examples

Example 1

Creates a Topic '1'under the root Topic, then renames it as 'one'. Topic name is shown as XHTML, before and after renaming.

<insight:operations>

  <insight-topic:create parent-id="0" name="1" >
    <p>
      Before renaming : <insight-topic:get-fqname/>
    </p>
  </insight-topic:create>

  <insight-topic:rename from-fqname="/1" new-name="one" >
    <p>
      After renaming : <insight-topic:get-fqname/>
    </p>
  </insight-topic:rename>

</insight:operations>

This gives the following XHTML output :

<p>
  Before renaming : /1
</p>
<p>
  After renaming : /one
</p>



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