LDAP Servers and Fields

This information is only available in English.

The document describes the known LDAP fields exported by the LDAP server of the estos MetaDirectory and provides basic information about the server's features. It provides a brief introduction to the various LDAP contact attributes, the mandatory LDAP fields, the structure of the LDAP server search request and ways to adapt your own replicator to estos MetaDirectory.

Known estos MetaDirectory LDAP Fields
Attribute Assignment for Phone Books
Search requests to estos MetaDirectory LDAP server:
estos MetaDirectory LDAP Server's Controls and Extensions
How to adapt your own replicator to estos MetaDirectory

---

Known estos MetaDirectory LDAP fields:

LDAP Attribute	Readable Field Name Description	Type:	Mandatory Optional
LDAP Structure Attributes
createTimestamp	Creation time of the LDAP element	Generalized Time syntax	M
modifyTimestamp	Modification time of the LDAP element	Generalized Time syntax	M
creatorsName	The name of the creator of this LDAP element	Distinguished Name syntax	O
modifiersName	The name of the modifier of this LDAP element	Distinguished Name syntax	O
subschemaSubentry	Path to the LDAP schema description	Distinguished Name syntax	M
attributeTypes	Description of the attributes in use	Directory String syntax	O
objectClass	Entry type	OID syntax	O
objectClasses	Description of an objectClass attribute	Directory String syntax	M
name	Name of the current entry. Same value as cn, ou or dc, depending on the element	Directory String syntax	M
cn	Common name. Name of the current cn	Directory String syntax	O
ou	Organizational unit. Name of the current ou	Directory String syntax	O
dc	Directory context. Name of the current dc	Directory String syntax	O
namingContexts	Entry points to the LDAP tree	Distinguished Name syntax	O
defaultNamingContext	Default LDAP entry node dc=meta	Directory String syntax	O
metaVersion	MetaDirectory Version e.g. 2.0.0.176	Directory String syntax	O
databaseDescription	Additional description used by CTI software products for opening contacts in the source database. The field will contain additional information in its ou for a database.	Directory String syntax	O
distinguishedName	Fully qualified path to the current element within the LDAP server	Distinguished Name syntax	M
supportedLDAPVersion	Supported LDAP versions of the server	Integer syntax	O
supportedExtension	Supported extensions for this server	OID syntax	O
supportedControl	Supported controls for this server	OID syntax	O
LDAP contact attributes
databaseName	Name of the database	Directory String syntax	M
databaseType	Type of the source database	Integer syntax	M
entryIDDB	Identifier for the type of source database	Directory String syntax	M
entryIDStore	Specific information about the data source	Directory String syntax	M
entryID	Unique identifier for the record from the data source	Directory String syntax	M
cn	Common name	Directory String syntax	M
displayName	Display name	Directory String syntax	O
givenName	First name	Directory String syntax	O
sn	Last name	Directory String syntax	O
title	Title	Directory String syntax	O
company	Company	Directory String syntax	O
department	Department	Directory String syntax	O
physicalDeliveryOfficeName	Office room number	Directory String syntax	O
streetAddress	Company street address	Directory String syntax	O
postalCode	Company ZIP code	Directory String syntax	O
l	Company city	Directory String syntax	O
st	Company state	Directory String syntax	O
c	Company country	Directory String syntax	O
privateAddressStreet	Personal street address	Directory String syntax	O
privateAddressPostalCode	Personal ZIP code	Directory String syntax	O
privateAddressCity	Personal city	Directory String syntax	O
privateAddressState	Personal state	Directory String syntax	O
privateAddressCountry	Personal country	Directory String syntax	O
otherAddressStreet	Miscellaneous street address	Directory String syntax	O
otherAddressPostalCode	Miscellaneous ZIP code	Directory String syntax	O
otherAddressCity	Miscellaneous city	Directory String syntax	O
otherAddressState	Miscellaneous state	Directory String syntax	O
otherAddressCountry	Miscellaneous country	Directory String syntax	O
mail	Email	Directory String syntax	O
mail2	E-Mail 2	Directory String syntax	O
mail3	E-Mail 3	Directory String syntax	O
sipAddress	SIP address	Directory String syntax	O
url	Web page URL	Directory String syntax	O
telephoneNumber	Company phone	Directory String syntax	O
otherTelephone	Secondary company phone	Directory String syntax	O
telephoneNumberCompanyMain	Company main telephone	Directory String syntax	O
telephoneAssistant	Assistant's telephone	Directory String syntax	O
homephone	Home phone	Directory String syntax	O
otherHomePhone	Secondary home phone	Directory String syntax	O
telephonePrimary	Primary telephone	Directory String syntax	O
cell	Cell phone	Directory String syntax	O
telephoneCar	Car telephone	Directory String syntax	O
telephoneRadio	Radio telephone	Directory String syntax	O
pager	Pager phone number	Directory String syntax	O
telephoneCallback	Callback telephone	Directory String syntax	O
telephoneISDN	ISDN telephone	Directory String syntax	O
telephoneTTYTTD	TTYTTD telephone	Directory String syntax	O
facsimileTelephoneNumber	Company fax number	Directory String syntax	O
otherFacsimileTelephoneNumber	Home fax number	Directory String syntax	O
customerid	Customer ID	Directory String syntax	O
directWebLink	Direct web link	Directory String syntax	O
directOpenContact	Data for opening this contact	Directory String syntax	O
info	Comment	Directory String syntax	O
custom0	Custom 0	Directory String syntax	O
custom1	Custom 1	Directory String syntax	O
custom2	Custom 2	Directory String syntax	O
custom3	Custom 3	Directory String syntax	O
custom4	Custom 4	Directory String syntax	O
custom5	Custom 5	Directory String syntax	O
custom6	Custom 6	Directory String syntax	O
custom7	Custom 7	Directory String syntax	O
custom8	Custom 8	Directory String syntax	O
custom9	Custom 9	Directory String syntax	O
custom10	Custom 10	Directory String syntax	O
custom11	Custom 11	Directory String syntax	O
custom12	Custom 12	Directory String syntax	O
custom13	Custom 13	Directory String syntax	O
custom14	Custom 14	Directory String syntax	O
custom15	Custom 15	Directory String syntax	O
custom16	Custom 16	Directory String syntax	O
custom17	Custom 17	Directory String syntax	O
custom18	Custom 18	Directory String syntax	O
custom19	Custom 19	Directory String syntax	O
contactURL	URL for editing the contact	Directory String syntax	O
contactURLDescription	Description for the contactURL link	Directory String syntax	O
contactURL2	Secondary URL for opening the contact	Directory String syntax	O
contactURLDescription2	Description for the secondary contact URL link	Directory String syntax	O
contactURL3	Tertiary URL for opening the contact	Directory String syntax	O
contactURLDescription3	Description for the tertiary contact URL link	Directory String syntax	O
jpegPhoto	Binary JPEG data for the contact picture	JPeg image syntax	O
imagePath	URL for the contact picture	Directory String syntax	O
sourceModifyTimeStamp	Any timestamp information about when the data was changed in the data source	Directory String syntax	O

Attribute assignments for phone books:
The following list shows the phonebook database entries matching the LDAP database entries. The address information will be copied to the company address fields regardless of whether the source entry is a business or a personal contact.

Phone book entry	Legible LDAP field name	LDAP field
cn	Primary key	Record id for the phonebook database or an artificially created record id
displayName	Display name	This field value will be created while parsing the search results. You will not be able to search for this field value.
givenName	First name	Given name, if available
sn	Last name	Last name if available
company	Company	Company, if available
streetAdress	Company street address	Street address, if available
postalCode	Company address ZIP code	ZIP code, if available
l	Company city name	City, if available
telephoneNumber	Company phone	Company phone number, if available
otherTelephone	Secondary company phone	Secondary company phone number, if available
homePhone	Home phone	Home phone number, if available
otherhomePhone	Secondary home phone	Secondary home phone number, if available
facsimileTelephoneNumber	Company fax number	Company fax number, if available
otherfacsimileTelephoneNumber	Home fax number	Home fax number, if available
cell	Home phone	Cell phone number, if available

Search requests to estos MetaDirectory LDAP server:
The server can handle complex search requests to the backend LDAP databases. When searching databases created by replicators, you can search for any content within any field of the database. Searching phone books is subject to restrictions because search parameters sent to the phonebook APIs are limited. You cannot search phone books for display names, because the displayname field is being created while parsing the search results. Many LDAP database fields will not have any matching phone book database entry.

LDAP search requests, in general:
The search request parser can handle complex search requests. The LDAP backend knows the following comparison algorithms. Remember that phonebooks handle search requests differently and may not be able to find results to certain search requests.

Compare element	supported / unsupported
and	supported
or	supported
not	supported
equality	supported
greaterOrEqual	supported
lessOrEqual	supported
present	supported
substring filter	supported
approx. matching	unsupported
extensible matching	unsupported

Example search requests:

Search term	Result
(&(objectClass=contactperson) (|(homephone=+49815136856177) (mobile=+49815136856177) (pager=49815136856177)))	Contacts with the telephone number, "+49815136856177", in any of the fields: home phone, cell phone or pager.
(&(objectClass=contactperson) (|(sn=*Name*) (displayName=*Name*) (company=*Name*)) (|(homephone=+49815136856177) (mobile=+49815136856177) (pager=49815136856177)))	Contacts with "Name" in any position in the LDAP fields: sn, displayName or company; AND the telephone number, "+49815136856177", in any of the fields: home phone, cell phone or pager.
(&(objectClass=contactperson) (searchContact=Name))	This search request lets the estos MetaDirectory search for a contact in the fields setup using the Search Wizard. The wildcards will also be added to the search request according to the settings from the Search Wizard. Currently, the search result will NOT contain a searchContact element.
(&(objectClass=contactperson) (searchNumber=+49815136856177))	This search request lets the estos MetaDirectory search for a number in the fields setup using the Search Wizard. The wildcards will also be added to the search request according to the settings from the Search Wizard. Currently, the search result will NOT contain a searchNumber element.
(&(objectClass=contactperson) (searchIndividual=Name))	This search request lets the estos MetaDirectory search for a contact in the fields setup using the Search Wizard. Wildcards will automatically not be added to the search request for searchIndividual.

---

Controls and Extensions of the estos MetaDirectory LDAP server:
The following controls and extensions are supported by the LDAP server:

Type	Name	OID
Control	PagedResult	1.2.840.113556.1.4.319
Control	Virtual list view request	2.16.840.1.113730.3.4.9
Control	Virtual list view response	2.16.840.1.113730.3.4.10
Control	Server-side sort request	1.2.840.113556.1.4.473
Control	Server-side sort response	1.2.840.113556.1.4.474
Control	Request to not search phone books	1.3.6.1.4.1.10924.233.5
Control	Request to search phone books only	1.3.6.1.4.1.10924.233.6
Control	Notify client IP address	1.3.6.1.4.1.10924.233.7
Control	Define the phone number output format 0Unformatted international standard dialing format 1Unformatted international standard dialing, reduced internal numbers 2Legible 3Legible, reduced internal numbers 4dialable 5DIN5008:2005 6DIN5008:2005, reduced internal numbers 7Unformatted international standard dialing format, extensions punctuated using hyphens (-) 8Unformatted international standard dialing format, extensions punctuated using hyphens (-), reduced internal numbers	1.3.6.1.4.1.10924.233.8
Control	Search for items marked as "deleted"	1.3.6.1.4.1.10924.233.9

---

entryIDDB values of the estos MetaDirectory LDAP server:
The following list shows the list of known database types:

entryIDDB	Name or type
DB03	Outlook® / Exchange
DB05	IBM Notes®
DB06	ODBC
DB06	ODBC
DB07	LDAP
DB08	Active Directory®
DB14	Microsoft® CRM 1.2
DB16	Phone books EntryIDStore Phone book name 00000001 KlickTel Server 00000002 DasTelefonbuch Deutschland 00000003 TwixTel
DB17	Steps Business Solutions

---

databaseType values for the estos MetaDirectory LDAP server:
The following list shows the list of known database types:

databaseType	Name or type
0	text
1	Act 2000
2	Microsoft Outlook®
3	Microsoft® Exchange
4	IBM Notes®
5	ODBC
6	LDAP
7	Active Directory®
8	Novell Directory
9	MetaDirectory
14	DATEV SDD
15	Microsoft® CRM 1.2 contacts
16	Microsoft® CRM 1.2 accounts
18	Steps Business Solutions
19	DasTelefonbuch Deutschland
20	TwixTel
21	KlickTel Server
22	XML data
23	Active Directory®, outbound
24	XML, outbound
25	CSV, outbound
1000	Custom user replicator

---

How to adapt your own replicator to estos MetaDirectory:
To gain enough performance for replicating large contact archives, estos MetaDirectory does not support standard approaches to writing data to archives. Custom LDAP extensions allow you to push large quantities of contact data to the LDAP server. A software development kit describing how to use the custom extensions and how to write data to the LDAP archives has not yet been written.
Contact us to get detailed information about using the LDAP extensions.