Reference for the iman tag library.

-The iman tag library is a collections of tags to help developers write iManager plugins.
-For sample code see the "properties-jsp-taglibs" example in the iManager 2.0 SDK.
-For general JSTL (Java Standard Tag Library) reference see http://www.manning-source.com/books/bayern/bayern_apxA.pdf

TagDescription
mvedMulti Value String Editor; Used to display/modify multi-valued fields. Has support for XML data and string lists (packed strings). Also supports the OS widget for lists of eDir object names.
mvedScriptsMulti Value String Editor Header. Must be included in the head tag if using the mved.
osObject Selector. Great widget for picking eDir objects.
osScriptsObject Selector Scripts. Must be included in the head tag when using the OS widget.
osFooterObject Selector Footer. Must be include outside the last form tag at the bottom of the page (generally just before the closing html tag).
eMFrameScriptsStandard Scripts. Should be included on every page.
cancelBtnCancel Button. Displays a cancel button. When pressed by the user, the framework is notified the task is completed and returns to the appropriate place.
barDisplays the horizontal bar across the page.
taskHeaderTask Header
includeincludes using locator.
mooMode builds the select box (replace, add, remove, ignore)
dumpdump request attributes and params
toScriptencodes the body for javascript
urlEncodeencodes the body for a url
buttonadds a button with src and alt
wizardHeaderCreates a header for common look and feel of wizards
helpIconCreates an icon that when click on will open the specified help file in a new window.


Tag: mved
Description: Multi Value String Editor; Used to display/modify multi-valued fields. Has support for XML data and string lists (packed strings). Also supports the OS widget for lists of eDir object names.
AttributeRequiredDescription
name*each mved on the page must have a unique name to identify it.
modeThe mved supports three different modes (mvsel, mvie, mvtxt). If developers do not specifiy a mode, the mved will pick the mode best suited for the current device. This helps when single sourcing JSP files across multiple devices
widthwidth of the control in pixels
bgColorBackground color of page around the mved. Default is white.
readonlyThis will gray out the text and disable the control.
objectTypeNameSet this to an OS typeFilter (ex. "User", "*", etc) to show the OS.
enforceUniqueForces all values in the list to be unqiue
ignoreCaseOnly applies if enforeUnique is true. If ignoreCase is true "ABC" and "abc" cannot both be added to the list.
sizeOnly applies when mode=mvsel. This is the number of rows to display in the select box.
numbersOnlyOnly allows the user to add numeric values to the list.
upperBoundOnly allows users to add numeric values below the upperBound
lowerBoundOnly allows users to add numeric values above the lowerBound
minLengthOnly allows users to add strings longer than minLength
maxLengthOnly allows users to add strings shorter than maxLength
xmlxml as a string. The root node can be anything, but it must have child nodes of name value. The text in these values nodes will be displayed to the user.
historyApplies when objectTypeName has been set. The history button will be displayed next to the OS when this is true.


Tag: mvedScripts
Description: Multi Value String Editor Header. Must be included in the head tag if using the mved.
AttributeRequiredDescription
modemvsel, mvtext, or mvie. This is optional and will default to mved best for current device.


Tag: os
Description: Object Selector. Great widget for picking eDir objects.
AttributeRequiredDescription
typeFilter*Comma delimited string with valid types. Example: "User,Group" or "*"
controlName of html control to return result to.
historyIf true the history button will appear next to the OS.
callBackName of javascript method to call with the result. The javascript method must take the control name and a an array of strings as parameters.
advancedSelectionAllow advanced selection (custom filters by attribute values)
initialContextThe initial place in the eDir tree to start the search. This will default to the last place the user searched.
isOSAllowedName of javascript callback method that is called when the user clicks on the OS button. Return false if you don't want the OS to open.
mode
multiSelectIf true the OS will allow the user to select multiple objects
nameFilterInitial name filter
resultsPerPageThe default number of results to show. Larger results will result in longer page load time.
searchSubContainersInitial value for sub container search.
searchOnStartupThis will run a search without the any user intevention
showSubClassesShows class in the filter and ALL DERIVED classes.
typeFilterCallBackName of a Javascript callback method that will be called when the user clicks the OS. The method should return a String[] of the class names.
altTextAlt text for the OS button.
iconNameIcon name for the OS button.


Tag: osScripts
Description: Object Selector Scripts. Must be included in the head tag when using the OS widget.


Tag: osFooter
Description: Object Selector Footer. Must be include outside the last form tag at the bottom of the page (generally just before the closing html tag).


Tag: eMFrameScripts
Description: Standard Scripts. Should be included on every page.


Tag: cancelBtn
Description: Cancel Button. Displays a cancel button. When pressed by the user, the framework is notified the task is completed and returns to the appropriate place.


Tag: bar
Description: Displays the horizontal bar across the page.


Tag: taskHeader
Description: Task Header
AttributeRequiredDescription
title*Title to be displayed on the task header.
iconUrlurl of the icon to display on the header. This should be of the form "dirxml/MyIcon.gif".
iconAltalt text for the icon


Tag: include
Description: includes using locator.
AttributeRequiredDescription
page*Pass in "dirxml/MyPage.jsp" and this will be located for the current device and included.


Tag: mooMode
Description: builds the select box (replace, add, remove, ignore)
AttributeRequiredDescription
name*
multi*
value*


Tag: dump
Description: dump request attributes and params


Tag: toScript
Description: encodes the body for javascript


Tag: urlEncode
Description: encodes the body for a url


Tag: button
Description: adds a button with src and alt
AttributeRequiredDescription
name
key*ex. ok, cancel, etc. This will work for all images in DevResources.properties that have an entry button.xxx.image
onClickjavascript to run when button clicked
typeSUBMIT or IMG; default is IMG


Tag: wizardHeader
Description: Creates a header for common look and feel of wizards
AttributeRequiredDescription
titleThe title for the wizard.
subtitleThe subtitle for the wizard
iconUrlThe icon url for the icon in the header.
helpFileName of a help file. If this is set then a help icon will show up in the top right corner.
instructionAdditional instructions.


Tag: helpIcon
Description: Creates an icon that when click on will open the specified help file in a new window.
AttributeRequiredDescription
helpFile*