Home >	Contents >	Index >

Template Tags TOC   |    Alpha TOC   |    Tag Family TOC   |    Purpose TOC   |    Annotated TOC   |    Index

dir:search

Searches for entries matching the specified attributes.

Syntax

<dir:search 
      list="matches" 
      context="common ancestor"
      [operator=(and|or)]>
  <dir:argument name="attribute name" value="attribute value"/>
</dir:search>

Parameters

list (required)

List in which the distinguished names of the matching entries are returned. The list contains a single column called NAME.

context (required)

Overrides the value of the parent in the property file CS.Property.dir.peopleParent for type=user. Specify this argument for searching under groups, or under a branch of the user tree.

operator (optional)

Determines if the matching entries must contain all and or one or more or of the specified attribute/value pairs. The default is and.

dir:argument name (required)

The name of the attribute to be matched.

dir:argument value (required)

Value of the attribute to be matched.

Error Numbers

The possible values of errno include:

Value	Description
-15004	Implementation doesn't support this operation
-15005	Unexpected naming exceptions from JNDI provider.
-15006	A required property missing, or class name specified for factory classes is in error.
-15007	Unexpected schema violation errors from JNDI provider.
-15008	General error in the syntax of an IName.
-15009	Unexpected invalid attribute exceptions from JNDI provider
-15010	Unexpected invalid attribute id exceptions from JNDI provider.
-15011	Unexpected invalid attribute value exceptions from JNDI provider.
-15012	User does not have permission to perform the operation.
-15014	Unexpected JNDI read error.
-15015	Unexpected JNDI write error.
-15016	JNDI attribute already in use.
-15023	Unexpected JNDI connection errors.
-15024	Required attribute missing.
-15025	Unknown error.
-15030	SQL error.
-15031	Query failed.
-15036	Missing or invalid child argument tags for tag.

Example

<dir:search list='searchlist' operator="OR"
            context='<%=ics.GetProperty("peopleparent", "dir.ini", 
            true) %>'>
<dir:argument name='<%=ics.GetProperty("th.AttributeManager",  
              "dir.ini", true)%>'
              value='<%=ics.GetVar("SearchValue")%>'/>
<dir:argument name='<%=ics.GetProperty("th.AttributeManager",  
              "dir.ini", true)%>'
               value='<%=ics.GetVar("SearchValue2")%>'/>
</dir:search>
       <ics:if condition='<%=ics.GetErrno()==0%>'>
       <ics:then>
       <p><b>SEARCH REQUEST FOUND <ics.listget
       listname="searchlist" fieldname="#numRows"/> MATCHES FOR <ics:getvar name="SearchValue"/> and <ics:getvar name="SearchValue2"/></b></p>
       <table border=1 cellpadding=2 cellspacing=0>
       <tr bgcolor=blue><td><font face=tahoma color=white
       size=+1><b>USER DN's</font></td></tr>
<ics:listloop listname="searchlist">
       <tr><td><font face=tahoma size=-1><ics:listget
             listname="searchlist" fieldname="NAME"/></font></td></tr>
</ics:listloop>
</table>
</ics:then>
<ics:else>
<p><b>SEARCH FOR <ics:getvar name="SearchValue"/> 
Failed!</b> No Matches Found!
Error=<ics:geterrno/></p>
</ics:else>
</ics:if>

		Home >	Contents >	Index >
	Oracle JSP Tag Reference Copyright (c) 2013, 2019, Oracle and/or its affiliates. All rights reserved.