Creating a toolbar

You can create a toolbar for a Delegated Administration Console page by using a combination of XML and Active Server Pages (ASP).

The following example shows the XML code used to create a toolbar:

<toolbar>
		<column cID="1" cType="2" cRolePri="0" cText="Manage Parent OU"
cHref="ManageOU.asp" cImgSrc="images/UpIcon.gif" cBitSettings="00000000" />
		<column cID="2" cType="1" cRolePri="0" cText="TreeView"
cHref="ViewAllNestedOrgs.asp" cImgSrc="images/TreePath.gif" cBitSettings="00000000" />
		<column cID="6" cType="1" cRolePri="0" cText="Search"
cHref="Search.asp" cLevelsDeep="" ImgSrc="images/Search1.gif"cBitSettings="00000000" /> 
		<column cID="6" cType="1" cRolePri="5000" cText="Dump Attribs"
cHref="DumpAttribs.asp" cImgSrc="" cBitSettings="00000000" />
		<column cID="6" cType="1" cRolePri="5000" cText="View ACL"cHref="ViewACL.asp"
cImgSrc="" cBitSettings="00000000" AppliesTo="hosting" notAppliesTo="domain" />
</toolbar>

Definitions

toolbar: Defines the toolbar elements.

column: Represents an element of the toolbar.

• cID: Represents the ID number for this element.
• cType: Defines the Type of Element (0=Text, 1=Image).
• cRolePri: Defines the minimum Role Priority Number (RPN) needed to view this element.
• cText: Defines the name for this element that is displayed for the user.
• cHref: Defines the target URL for this action.
• cLevelsDeep: Optional. Defines the number of levels under the hosting container in which a button can be rendered. When this setting is blank, the button can be rendered from within a container located any number of levels under hosting. When set to 0, the button can be rendered only from within hosting. When set to 1, the button is displayed from within a container located one level under hosting.
• cImgSrc: Defines the Source Location of an image for this element. This should be set to blank ("") if the cType=0.
• AppliesTo: (String) Determines whether or not an item is displayed based on a check against the current Object Type of the object being managed. If the AppliesTo value is set to "hosting,reseller", an item shows only if the item currently being managed is of one of those types.
• notAppliesTo: (String) Determines whether or not an item is displayed based on a check against the current Object Type of the Object being managed. If the notAppliesTo value is set to customer, the item shows only if the current object being managed is not of this type. This setting overrides the AppliesTo attribute.
• cBitSettings: Defines a list of options by bit setting. Reserved.

The following example shows the ASP code used to create a toolbar:

'  Call the function that will write the title to the title bar and also
'  create the Toolbar with the information found in the xml doc passed in.
'  The location of the xml doc is: /Lib/Loc/UITemplates/
Call WAT_ToolBar_Build("manageUser.xml")