User Guide

Chapter 1: ColdFusion Tags 117
FILTERFILE
Optional. Specifies the name of a filter file and the name of the stanza tag within
that file that contains the LDAP filter string specification. You can specify either an
absolute path name or a simple file name to identify the file. If you use a simple
file name, CFLDAP looks for it in ColdFusion’s default LDAP directory. The default
LDAP directory is C:\cfusion\ldap. The filter file must be in LDAP filter file format
as defined in RCF-1558.
SORT
Optional. Indicates the attribute or attributes to sort query results by. Use a
comma to separate attributes if more than one attribute is specified.
SORTORDER
Optional. Specifies how to sort query results. Enter "nocase" for a case-insensitive
sort. By default, sorts are case-sensitive. You can also enter "asc" for an ascending
sort and "desc" for a descending sort. You can enter a combination of these, for
example, "nocase" and "asc".
DN
Required for ACTION="Add", Modify, ModifyDN, and Delete. Specifies the
distinguished name for update actions. Example: "cn=Barbara Jensen, o=Ace
Industry, c=US".
STARTROW
Optional. Used in conjunction with ACTION="Query". Specifies the first row of
the LDAP query that is to be inserted into the ColdFusion query. The default is 1.
See the Usage section for more information about the query object and query
variables.
MODIFYTYPE
Optional. Indicates whether to Add, Delete, or Replace an attribute within a multi-
value list of attributes, as follows:
• Add - appends the new attribute to any existing attributes.
• Delete - deletes the specified attribute from the set of existing attributes.
• Replace (default) - Replaces an existing attribute with the specified
attribute or attributes.
Note that you cannot add attributes that already exist or that are NULL.
REBIND
Optional. Yes or No. If you set REBIND to Yes, CFLDAP attempts to rebind the
referral callback and reissue the query via the referred address using the original
credentials. The default is No, which means referred connections are anonymous.
REFERRAL
Optional. Specifies the number of hops allowed in a referral. Valid values for this
are integers equal to or greater than zero. If you specify zero, you turn off
CFLDAP’s ability to use referred addresses; thus, no data is returned.