openHierarchyLevel (webtop script and webtop tray applets)

Syntax

String openHierarchyLevel(String location)

Description

Obtains the members of a group object and makes the contents available for scripting.

For location, use the full TFN name of the group to open.

Returns "OK" if the operation succeeds, or "Error" if it fails.

The parent of the group must be open for any group to open correctly.

This method can be used with either the webtop script applet or the webtop tray applet.

Examples

verdict = applet.openHierarchyLevel(".../_ens/o=Indigo Insurance/cn=Applications");
if (verdict == "OK")
    alert("Contents of application group downloaded!");
else
    alert("Error!");

Obtains the members of the Applications group, and displays a dialog reporting success or failure.

Related topics
  • Webtop script applet
  • Webtop tray applet
  • closeHierarchyLevel (webtop script and webtop tray applets)
  • getCurrentIteratorElement (webtop script and webtop tray applets)
  • getNextIteratorElement (webtop script and webtop tray applets)
  • getIteratorHasMoreElements (webtop script and webtop tray applets)
  • getIteratorForHierarchyLevel (webtop script and webtop tray applets)
  • getIteratorForAllOpenHierarchyLevels (webtop script and webtop tray applets)
  • killIterator (webtop script and webtop tray applets)