Home >	Contents >	Index >

Template Tags TOC   |    Alpha TOC   |    Tag Family TOC   |    Purpose TOC   |    Annotated TOC   |    Index

---

ics:treemanager.findnode

Gets a list of nodes from a tree using the ics:treemanager command.

Syntax

<ics:treemanager>
      <ics:argument name="ftcmd" value="findnode"/>
      <ics:argument name="treename" value="name"/>
      [<ics:argument name="where" value="column names"/>]
      [<ics:argument name="column name" value="value"/>]
      [<ics:argument name="orderby" value="tree column"/>]
</ics:treemanager>

Parameters

ftcmd (required)

Value must be set to findnode.

treename (required)

Name of the tree.

where (optional)

Values of the column names containing data to use in constructing the query. Only variables whose column names appear in this list are used in constructing the query, and only columns referring to objects are allowed. If you specify the where parameter, you must specify the column name parameter.

Legal values are as follows:

• otype
• oid
• oversion

column name (optional)

If you specify the where parameter, you must specify this parameter to indicate the value of the column name. For example,
<ics:argument name="oid" value="10234562312">

orderby (optional)

Specifies the tree column in which to sort results.

Wildcards are not allowed in any of the variables being searched for. If a % is found in a variable whose column is specified as part of the search, it is ignored.

The name of the list that is constructed is stored in the value of the variable, treename (that is, Variables.treename).

Description

The findnode command gets a list of nodes from a tree. This is meant to perform a fast lookup of nodes referring to specific objects.

errno

The possible values of errno include:

Value	Description
-3	No access privileges to table.
-103	No table.
-110	Invalid tree name.
-111	No nodes.

Example

This code finds a given node in the AssetRelationTree with a given oid.

<ics:setvar name="my_oid_value" value="1030473770134"/>
<ics:treemanager>
  <ics:argument name="ftcmd" value="findnode"/>
  <ics:argument name="treename" value="AssetRelationTree"/>
  <ics:argument name="where" value="oid"/>
  <ics:argument name="oid" value='<%=ics.GetVar("my_oid_value")%>'/>
</ics:treemanager>

See Also

The following ics:treemanager command:

ics:treemanager.getchildren

		Home >	Contents >	Index >
	FatWire JSP Tag Reference Copyright 2005,2006,2007 by FatWire Software All rights reserved.