Home > Contents > 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 behaviorLOCAL
- 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. TheGLOBAL
value of theSCOPED
parameter does not protect input variables. UsingLOCAL
orSTACKED
for theSCOPED
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 toLOCAL
) you can cause the CatalogManager to share all the existing input variables without scoping. Note that this means specified arguments overwrite existing variables. UsingSCOPED="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. UseARGUMENT
for specific string values.Several
TREEMANAGER
commands (addchild , addchildren , findnode , getchildren , getnode , getparent , listtrees , nodepath ) return a list. Each of those commands has atreename
argument. The name of the returned list is the value passed in thetreename
argument. In the following example, the tree name and the returned list name isMyTree
:<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
Home > Contents > Index > ![]()
Oracle XML Tag Reference
Copyright (c) 2013, 2018, Oracle and/or its affiliates. All rights reserved.