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

TREEMANAGER

Calls the TreeManager servlet.

Syntax

<TREEMANAGER>
   <[ARGUMENT
 NAME="somearg" VALUE="somevalue"]/>
   <[CGIARGUMENT
 NAME="somecgiarg" 
                VALUE="somecgivalue"]/>
</TREEMANAGER>

Parameters

ARGUMENT (optional)

Arguments passed to the TreeManager as it is called.

CGIARGUMENT (optional)

CGI arguments passed to the TreeManager.

SCOPED

Valid options for this attribute are as follows:

• GLOBAL - The default behavior
• LOCAL - Arguments passed in are restored (or destroyed) on return from the call.
• STACKED - The child only sees the explicit arguments passed in and can only return values in that same namespace.

Description

The TREEMANAGER tag calls the TreeManager servlet. The GLOBAL value of the SCOPED parameter does not protect input variables. Using LOCAL or STACKED for the SCOPED argument protects those variables from change, but disallows sharing of input space. Use <CGIARGUMENT NAME="name"/> to specify that specific CGI parameters be made available to the CatalogManager. Use ARGUMENT for specific string values.

By omitting SCOPED (or setting it to LOCAL) you can cause the CatalogManager to share all the existing input variables without scoping. Note that this means specified arguments overwrite existing variables. Using SCOPED="shared" means that you need not specify any argument; CGIARGUMENTS, specifically, are ignored. Note that variables set since program execution began are reset to the original values passed on the URL line. Use with care.

Use CGIARGUMENT to specify that specific CGI parameters be made available to EvalServer. Use ARGUMENT for specific string values.

Several TREEMANAGER commands (addchild , addchildren , findnode , getchildren , getnode , getparent , listtrees , nodepath ) return a list. Each of those commands has a treename argument. The name of the returned list is the value passed in the treename argument. In the following example, the tree name and the returned list name is MyTree:

<TREEMANAGER>
      <ARGUMENT NAME="ftcmd" VALUE="getparent"/>
      <ARGUMENT NAME="treename VALUE="MyTree"/>
      <ARGUMENT NAME="node" VALUE="Variables.MyParent"/>
</TREEMANAGER>

The following columns are common to lists returned from every command:

• nid - Tree node ID.

• nparentid - Parent tree node ID. 0 (zero) means it is a root node.

• nrank - Application-specific rank of the node.

• otype - Object table referenced by this node.

• oid - Object ID referenced by this node.

• oversion - Reserved for future use by Oracle.

• ncode - Application-specific code related to the node.

Refer to a specific command for more information about the list that is returned by that command.

The following is a list of commands that you use with the TREEMANAGER tag:

• addchild

• addchildren

• copychild

• createtree

• delchild

• delchildren

• deletetree

• findnode

• getchildren

• getnode

• getparent

• listtrees

• movechild

• nodepath

• setobject

• validatenode

• verifypath

Error Numbers

There are no possible errno for this tag.

Example

<SETVAR
 NAME="errno" VALUE="0"/>
<TREEMANAGER>
  <ARGUMENT
 NAME="ftcmd" VALUE="addchild" />
  <ARGUMENT
 NAME="treename" VALUE="TreetestTree"/>
  <ARGUMENT
 NAME="nparentid" 
    VALUE="Variables.testroot" />
  <ARGUMENT
 NAME="otype" VALUE="TreetestObjects"/>
  <ARGUMENT
 NAME="oid" VALUE="3" />
  <ARGUMENT
 NAME="oversion" VALUE="1" />
  <ARGUMENT
 NAME="nrank" VALUE="2" />
  <ARGUMENT
 NAME="ncode" VALUE="0" />
</TREEMANAGER>  
<!-- Check status -->
  <IF COND="Variables.errno=0">
    <THEN>
      Child of:
      <CSVAR
 NAME="Variables.testroot/> 
      successfully added.
    </THEN>
  </IF>

See Also

DEBABBLE
CATALOGMANAGER

		Home >	Contents >	Index >
	Oracle XML Tag Reference Copyright (c) 2013, Oracle and/or its affiliates. All rights reserved.