Home >	Contents >	Index >
Template Tag TOC  |   Alpha TOC  |   Tag Family TOC  |   Purpose TOC  |   Annotated TOC  |   Index

---

TREEMANAGER.nodepath

Traverses the tree beginning at the parent of the current node, returning a list of all ancestor nodes within this same tree.

Syntax

<TREEMANAGER>
   <ARGUMENT NAME="ftcmd" VALUE="nodepath"/>
   <ARGUMENT NAME="treename" VALUE="name"/>
   <ARGUMENT NAME="node" VALUE="nodeid"/>
</TREEMANAGER>

Parameters

ftcmd (required)

Value must be set to nodepath.

treename (required)

Name of the tree.

node (required)

Node ID of the node.

The list represents the path of the node backwards to its root node (that is, the first record added is the immediate parent of the node, the next row is that parent's parent, and so forth). It stops at a root node in the tree.

The node is not included in the returned data, only the parent's. An empty table/list can be returned if node is a top-level node; that is, if its parent is 0. The name of the list that is constructed is stored in the value of the Variables.treename.

Description

The nodepath command traverses the tree beginning at the parent of the current node, returning a list of all ancestor nodes within this same tree.

Note This command does not span trees. In other words, the path to a node is always within the tree. If a node is pointed to by a node from another tree, it is not in the node path.

errno

The possible values of errno include:

Value	Description
-3	No access privileges to table.
-103	No table.
-105	Database error.
-110	Invalid tree name.

Example

<SETVAR NAME="errno" VALUE="0"/>
<TREEMANAGER>
   <ARGUMENT NAME="ftcmd" VALUE="nodepath"/>
   <ARGUMENT NAME="treename" VALUE="TreetestTree"/>
   <ARGUMENT NAME="node" VALUE="Variables.traceme"/>
</TREEMANAGER>

<IF COND="IsError.Variables.errno=false">
   <THEN>
      <TABLE  cellspacing="2" cellpadding="2" border="1" rules="all">
         <TR>
            <TD><FONT COLOR="#000080">
               <B>parent id</B></FONT>
            </TD>
         </TR>
      <LOOP LIST="Variables.treename">
         <TR>
            <TD>
               <CSVAR NAME="Variables.treename.nid"/>
            </TD>
         </TR>
      </LOOP>
      </TABLE>
   </THEN>
   <ELSE>
      <BR/> No nodes<BR/>
   </ELSE>
</IF>

		Home >	Contents >	Index >
	FatWire XML Tag Reference Copyright 2005 by FatWire Software All rights reserved.