listObjects
The listObjects tag creates an Info*Engine group containing elements that are the relative distinguished names of the LDAP directory entries located directly under the specified base directory entry. Each element in the group consists of one attribute which is the distinguished name relative to the base entry.
If there are no entries directly under the specified base entry, the group returned is empty.
You name the Info*Engine group that is created using the GROUP_OUT parameter on a nested
param tag. For more information, see the
param tag.
You also specify the required parameter by nesting the param tag in this tag block.
Syntax
<iedir:listObjects uri="base_level_URL">
<iedir:param name="GROUP_OUT" data="group_name"/>
</iedir:listObjects>
Attribute Descriptions
Required Attributes: uri
uri
Specifies an LDAP URL that identifies the base directory entry to use when searching for entries. For example, entering the following URL identifies the “myCompany.com” host sets the base entry at “myHost.myState.myCompany.com”:
ldap://myCompany.com/dc=myHost,dc=myState,dc=myCompany,dc=com
This attribute is required.
Example
The following example declares that the page uses tags from the Info*Engine directory tag library and that the tags have the iedir prefix. The listObjects tag block creates the “ldap_myHost” group from entries in the directory service located at “myCompany.com” under the “dc=myHost,dc=myCompany,dc=com” base entry:
<%@ taglib uri="http://www.ptc.com/infoengine/taglib/directory"
prefix="iedir" %>
<iedir:listObjects
uri="ldap://myCompany.com/dc=myHost,dc=myCompany,dc=com">
<iedir:param name="GROUP_OUT" data="ldap_myHost"/>
</iedir:listObjects>