Summary
This document describes how to specify Lightweight Directory Access Protocol (LDAP) attributes for Express Directory operations.
Requirements
If you are unfamiliar with the LDAP attributes for your site, see “Looking up Attributes in Your LDAP Directory” in CTX109444 – Application Gateway Administration Guide 6.01 for information on a free LDAP browser that displays the structure of your LDAP directory and its attributes.
Background
The Operation > Voice Office > Directory page also contains settings that specify the LDAP attributes to be displayed in Express Directory and to be used to control Voice Office application operations.
Procedure
To specify LDAP attributes:
1. Complete the LDAP Attributes fields as follows:
Field | Description |
Name | The full name (typically, the common name) to be displayed in Express Directory or used by other Voice Office applications. Name defaults to "cn" and is typically set to "cn" or "displayName". |
Surname | The last name to be used by Voice Office applications. For correct display the surname (sn) must match the “last name” portion of the cn attribute. Is displayed in the directory as Surname (last name), followed by the delimiter ", " and the First Name. For example, Denz, Manuel. Defaults to "sn". |
First Name | The first name to be used by Voice Office applications. For correct display the First Name must match the “first name” portion of the cn attribute. Defaults to "givenName". |
The Email address. Defaults to "mail". | |
Telephone Labels and Fields | You can specify one to three Telephone numbers to be displayed by Express Directory and Visual Voicemail. The three fields default to "telephoneNumber", "mobile", and "ipPhone". These can be changed to any other attribute representing the phone number that you wish to display (such as "homePhone"). If your directory contains multiple entries for the chosen attribute, Express Directory displays all of them. The labels that you enter will display in Express Directory. By default, the telephone number displayed is the full number, along with any prefixes configured for each directory and configured globally. If a telephone number is too long to fit on the telephone screen, the number will not display. To shorten the number, consider removing spaces or omitting the label. For some sites the telephone numbers need to be customized, for example, to display only the last four digits. You can customize the telephone numbers. If your site requires further customization, Citrix Technical Support can create a server upgrade with a Customized LDAP Plug-in that changes the display of telephone numbers. |
Title | Title information. Defaults to "title". |
Department | Department information to be displayed in Express Directory and Visual Voicemail. The Application Gateway also uses a phone’s extension to look up the corresponding Department in the directory. Zone Paging uses the Department information to update the zone list. Broadcast Server uses the Department information to update the distribution list. Defaults to "department". |
Search Filter | The LDAP search filter used to limit the results returned to the Application Gateway. Defaults to "objectClass=*". You can specify more than one search filter. |
Search LDAP Directory by | The attributes to be used during a search. You can select one or more of the following attributes: Name (first and last name), Surname (last name), and First Name. |
Dial Prefix | You can specify a dial prefix with each LDAP directory. When a number from Telephone Field 1 is dialed, Express Directory will prepend to the phone number any prefix from the dialing rules specified on the IP Phone page followed by this directory-specific dial prefix. (This prefix does not apply to Telephone Fields 2 or 3.) For example, suppose that you have two directories, A and B. A call to directory A requires the prefix “5” and a call to directory B requires the prefix “6”. All calls require a “9” to be dialed first, so the dialing rule specified on the IP Phone page is “9”. Thus, the number dialed for a call to directory A would be “95number” and the number dialed for a call to directory B would be “96number”. If the same dial prefix is used for all directories, you can specify it on the IP Phone page for all directories. |
2. Click Submit.
3. Continue as follows:
• To configure another LDAP directory, select the source number from Configure Source and specify the connection and attribute information for that source.
• To configure a directory in CSV format, select the source number from Configure Source and see “Configuring the Application Gateway to Use Directory Files in CSV Format” in CTX109444 – Application Gateway Administration Guide 6.01.